TS/MP 2.5 System Management Manual

NOTE: For configuring PATHMON-controlled objects in TS/MP 2.5 PATHMON environment,
PDMCOM or PATHCOM can be used. However, it is recommended to use PDMCOM (instead of
PATHCOM) because it can communicate with multiple PATHMONs simultaneously. For more
information, see the TS/MP 2.5 Release Supplement.
Using the SET and ADD Commands
Whether you create objects for a new environment or add objects to a restarted environment, the
technique is the same, as follows:
1. Define the attributes for the object, using a SET command parameter for each attribute.
As you define these attributes, PATHCOM checks them for syntax errors. PATHCOM saves
the attributes in memory, pending your request to add the object. In many cases, you can
choose to accept default values supplied by PATHCOM.
When creating objects, be sure to set proper defaults so that objects are created in the
appropriate location. When creating Guardian server classes, use the CMDVOL command to
set the default node, volume, and subvolume for the expansion of any file names. When
creating OSS servers, use the CMDCWD command to record an OSS directory to be used to
resolve relative file names specified for OSS server attributes. For more details on these
commands, see “CMDVOL Command” (page 138) and “CMDCWD Command” (page 137).
If you do not specify a node name as part of the file name for a process or device in a
configuration, the default node for the file-name expansion is affected by any values you
specify for the NODEINDEPENDENT attribute of the SET PATHWAY command or for the node
portion of the CMDVOL command. The node name used is the node on which the PATHMON
process is currently running if any one of this situations applies:
• You set the NODEINDEPENDENT attribute of the SET PATHWAY command to ON and
you omit the node name in the parameter.
• You set the node name to \* in a CMDVOL command and you omit the node name in the
parameter.
• You specify \* for the node name in the parameter.
For more information on the NODEINDEPENDENT attribute, see the description of the SET
PATHWAY command in “PATHMON Environment Control Commands” (page 150).
2. Add the object with the ADD command.
The PATHMON process writes the object’s name and definition to the PATHMON configuration
file, inserting this information in the space allocated for it when the file was created. The object
definition recorded in the configuration file includes attribute values assigned by default as
well as those that you specified in your SET commands.
The object name you assign in the ADD command is used in later PATHCOM commands that refer
to the object. For more information about names, see “Choosing Names for PATHMON-Controlled
Objects” (page 61).
NOTE: You cannot configure remote OSS servers in your PATHMON configuration. Although
PATHCOM allows you to ADD an OSS server configured on a remote node, PATHMON cannot
START a remote OSS server.
To illustrate the relationship between the SET and ADD functions, suppose that you want to define
and add a SERVER identified by the name SERVER-X. You first define the attributes by using a
series of SET SERVER commands or by accepting default attribute values from PATHCOM:
= SET SERVER PROCESSTYPE OSS
= SET SERVER CREATEDELAY 1 MINS
= SET SERVER MAXSERVERS 2
56 Configuring Objects in a PATHMON Environment