The DSHOSTS member, located in the Control-M PARM library, specifies the host and agent parameters.
The CTMDSRN utility searches DSHOSTS for the logical host name defined in the HOST parameter. If the host name is found, the utility retrieves the definition of this logical host name to run a script or command there.
The CTMDSRN utility uses the value of the PORT parameter specified in DSHOSTS. If no value is specified, CTMDSRN uses the default value defined in SUBMITDS.
Every host definition begins with the HOST field and ends at either the beginning of the next definition or the end of the file.
In general, every field in the host definitions must be defined in the positions from 1 to 71. Each definition begins on a new line and ends with a space. The free space in the line can be used for a comment.
The DIRECTORY field is an exception to the above rule. The value of this field can use several lines, but cannot contain any comments. If the 72nd position on a line of this field contains a character, the character is included in the value and the value continues onto the next line, starting from the 1st position.
The field names are case insensitive, but their values are case sensitive.
Lines with an asterisk character (*) in the 1st column are interpreted as comments.
Empty lines are ignored.
Table 116 Structure of DSHOSTS member
Parameter |
Description |
---|---|
HOST = logical_host_name |
Logical host name. Maximum length – 64 characters. |
REAL_HOST=host_name |
Real host name or IP address. Maximum length – 64 characters. |
AGENTNAME=agent_name |
Logical agent name. Maximum length – 64 characters. |
DEFAULT_USER=userDS |
User name. Maximum length – 32 characters. |
DIRECTORY=directory_name |
The utility uses this directory to upload scripts and data. It must be created on the agent computer. The Control-M/Agent must have full access to this directory. Maximum length - 200 characters. |
PORT=xxxx |
Specify the Control-M/Agent "server_to_agent" port. Optional. If omitted, the utility takes a value from the SUBMITDS member in the Control-M PARM library. Number between 1025 and 65000. |
Figure 28 Example of a DSHOSTS member
|
|
|
|
|
|
|
Parent Topic |