Contents of the Samples Directory

This article contains the following topics:
casm1401
This article contains the following topics:
You can modify several files in the $NX_ROOT/samples directory for use with various external interfaces. These files are grouped into various subdirectories. None of the files in the samples directory are executable as originally shipped.
How to Modify the Message Catalog
To modify the message catalog, complete the following steps:
  1. Refer to the format of pdm.xml that is located in $nx_root\bin.
  2. Create a customized copy of pdm.xml and place it in the $nx_root\msg_catalog directory.
  3. Add, modify, or add and modify messages in the XML message files from the previous step.
call_mgt
Contains samples for customization in request management.
  • gencr.frg
    This file can be used in conjunction with bop_cmd to create requests from a command line. All notifications and activity log entries will occur, however no Request Form will display on the server when created. You must use the -u parameter to execute gencr.frg with the bob_cmd utility. Be sure to read the gencr_readme.txt file to learn the syntax, and how to modify it if necessary. The file should be placed in $NX_ROOT/site/mods/interp, if the directory does not exist, you should create it. Example: bop_cmd -d domsrvr -u nsm -f gencr.frg "gencr( 'My Description' )"
  • iss_site.mod
    This file can be used to enable activity logging of site-adapted fields in issues. This file should be placed in $NX_ROOT/site/mods/majic after it has been changed for the site-adapted fields.
  • cr_site.mod
    This file can be used to enable activity logging of site-adapted fields in requests. This file should be placed in $NX_ROOT/site/mods/majic after it has been changed for the site-adapted fields.
  • chg_site.mod
    This file can be used to enable activity logging of site-adapted fields in change orders. This file should be placed in $NX_ROOT/site/mods/majic after it has been changed for the site-adapted fields.
  • gencr_readme.txt
    This file contains instructions on how to use the gencr.frg file.
  • chg_site.spl
    This file may be modified to change the mapping of attributes when creating a change order from a request. This file should be placed in $NX_ROOT/site/mods/majic after the appropriate changes have been made.
  • audlog_site.mod
    This file can be used to enable audit logging of site-adapted fields. This file should be placed in $NX_ROOT/site/mods/majic after it has been changed for the site-adapted fields.
  • Notify_add.spl (UNIX only)
    This file can be used to add the request’s log agent, assignee and group to the request notification list. This file should be placed in $NX_ROOT/site/mods/majic.
  • Notify_replace.spl (UNIX only)
    This file can be used to add the request’s log agent, assignee and group to the request notification list when they are changed. This file should be placed in $NX_ROOT/site/mods/majic.
data
This directory contains files depicting the Logical Data Model for most database tables in CA SDM. This data directory also includes sample data for Knowledge Management.
macro_lock
This file contains a spel fragment that can be run using a bop_cmd to turn off locks that are being held by macros.
multi-tenancy
This directory contains sample files for administering multi-tenancy.
pdmconf
  • web.xml.tpl
  • pdm_startup.tpl
  • pdm_edit_usage_notes.htm
  • alias_install.bat
  • web.cfg.tpl
  • pdm_startup.i.tpl
  • pdm_edit.pl
  • README_files
    All of these files are used by pdm_edit.pl to create startup files for a primary server and secondary servers that are configured to run a variety of daemons.
reporting
This directory contains documentation and samples for configuring offline reporting.
sdk
This directory contains a sample file for making CA SDM SOAP web service calls.
TableOfContents.doc further explains what is available, found in the following directory:
$NX_ROOT\samples\sdk\websvc
PKI_loginServiceManaged_JAVA_steps.doc and PKI_loginServiceManaged_PERL_steps.doc explain how to configure ServiceDesk for digital certificate logins in the following directory:
$NX_ROOT\samples\sdk\websvc\java\test1_pki
The following lists PERL and JAVA samples, examples, and locations:
  • PERL samples
    $NX_ROOT\samples\sdk\websvc\perl\test1_pki
    Example: loginServiceManaged() web service call
  • JAVA samples
    $NX_ROOT\samples\sdk\websvc\java\test1_pki
    Example: loginServiceManaged() and getBopsid() web service call
    $NX_ROOT\samples\sdk\websvc\java\test2_basic
    Example: Combined CreateRequest() and CreateChangeOrder() web service call
views
This directory contains database scripts uses for migration, multi-tenancy administration, and other processes.
Load Supplemental Content - sd_content.dat
Supplemental content for CA SDM is available in sd_content.dat. This data file contains Change Category and Root Cause records. To load the data from a command window, go to $NX_ROOT/data and run the following command:
pdm_load - f sd_content.dat