DMCS (MSM)

Purpose of Command

The Distributed Manager Command Support (DMCS) command is used to send commands to the network topology agent. The command processor can be part of your automated network operations or an extension to the command facility. The DMCS command obtains required information about the target object, then builds and sends the correct command.

Operand Descriptions

APPL

The name of the network management application that processes the command string. This name is the same as the application name used on the NetView® RUNCMD APPL keyword.

For NetView for AIX® networks, this is the name of the service point application registered to the AIX NetView Service Point. The service point application name is defined when the options for host connection daemons are set up in NetView for AIX. You can get the service point application name from your NetView for AIX system programmer.

CMD

The command string that is sent to the agent. The string can contain substitution variables for attribute names. A substitution variable can be any attribute on the RODM object specified in the RODMxxx keyword or a NetView global variable. Enclose RODM object substitution variables in percent signs (%); for example: %1.2.840.6203.7.0%. Enclose NetView global variables in pairs of percent signs (%%); for example: %%FLC_DEF_AUTOTASK%%.

MultiSystem Manager obtains the value of RODM object variables from RODM and substitutes them in the string. Therefore, all attributes specified in the command string must exist on the specified object.

MultiSystem Manager obtains the value of NetView global variables from the NetView program and substitutes them in the string. If a specified variable is null in NetView, MultiSystem Manager does not make the substitution, but still issues the command.

The total length of the command, including the values substituted for the other keywords, cannot exceed the maximum length restriction of 240 characters for the RUNCMD.

RODMAPPL

The user application ID used to access the RODM that contains the topology and status data. The ID is case-sensitive and must be entered exactly as created with RACF®.

The application ID for MultiSystem Manager is set during NetView initialization. Specify this keyword only if you are overriding the ID used by MultiSystem Manager, or if you have not coded the COMMON.FLC_RODMAPPL statement in the CNMSTYLE member.

You can use the DISPTOPO command to determine the application ID for the RODM being used by MultiSystem Manager.

RODMCLASSNAME

The RODM class name of the object that is the target of the command.

RODMNAME

The name of the RODM where topology and status information is stored. This is normally the RODM used by MultiSystem Manager. For MultiSystem Manager this is the one- to eight-character name that was specified on the COMMON.FLC_RODMNAME statement in the CNMSTYLE member. Specify this statement only if you want to override the RODM name used by MultiSystem Manager, or if the statement in the CNMSTYLE member was not coded.

You can use the DISPTOPO command to determine the name of the RODM being used by MultiSystem Manager.

RODMOBJECTID

The RODM object ID (ObjectID) of the object. The object ID is 16 characters that represent an 8-byte hexadecimal field; for example: 00010027EC211161.

You can enter either the RODM object ID or the RODM class name and object name combination. MultiSystem Manager uses the object ID in the commands that it builds during command facility processing, because it can determine the ID based on the resource you selected in the view. If you are entering this command from the command line or an automated procedure, use the RODM class name and object name combination.

RODMOBJECTNAME

The RODM object name of the object that is the target of the command.

SP

The name of the service point that processes this command.

Usage Notes

• The MSM tower must be enabled in the CNMSTYLE member to successfully run this command.
• The CMD parameter is positional and must be coded last.
• Do not code the APPL or RODMAPPL keywords for MultiSystem Manager command sets.
• If MultiSystem Manager determines that a RMTCMD must be used, based on the object that was selected, an asterisk (*) is used in the RMTCMD OPERID parameter. When it processes the RMTCMD, the local NetView system looks for a task on the remote NetView system that is owned by the operator and attempts to issue the command under that task. If this fails, the NetView program uses the operator's ID as the task name.