COMMAND_ID - UCMD Manager configuration option
Description
The COMMAND_ID option specifies an ID (identifier) that is used to identify the unit of work represented by the UCMD Manager, UCMD Server, and user command.
The command ID is saved by the Universal Broker to help associate a UCMD Server component with the UCMD Manager that requested it to execute.
Usage
Method | Syntax | IBM i | UNIX | Windows | z/OS |
Command Line, Short Form | -C id | | | | |
Command Line, Long Form | -cmdid id | | | | |
Environment Variable | UCMDCMDID id | | | | |
Configuration File Keyword | command_id id | | | | |
STRUCM Parameter | CMDID(id) | |
Values
id can be any value.
If id is an asterisk ( * ), the UCMD Manager will generate a unique command ID.
Generated command IDs have the format WORKID-DATE-TIME-RAND, where:
- WORKID is the UCMD Manager's work ID
- DATE is the current date, in YYMMDD format
- TIME is the current time, in HHMM format
- RAND is a randomly-generated 4-byte value, represented as an 8-character hexadecimal string.
IBM i | If id contains non-alphanumeric characters (including spaces), it must be enclosed in single ( ' ) quotation marks. To include a single quotation mark in the command ID, use two single quotation marks ( '' ). |
|---|---|
HP NonStop | If id contains spaces, it must be enclosed in single ( ' ) or double ( " ) quotation marks. |
Windows | If id contains spaces, it must be enclosed in double ( " ) quotation marks. |
UNIX | If id contains spaces, it must be enclosed in single ( ' ) or double ( " ) quotation marks. |
z/OS | If id contains spaces, it must be enclosed in single ( ' ) or double ( " ) quotation marks. |
If no value is saved for COMMAND_ID in the UCMD Manager configuration file, id is set to the value of either:
- COMMAND option
- SCRIPT_FILE option