CL Command Reference - ADDCMDCRQA
CL Command List > ADDCMDCRQA Reference
Description:
The Add Command Change Request Activity (ADDCMDCRQA) command adds an activity to a change request description to run a command on one or more managed systems.
The activity can be conditioned so that it only runs after one or more other activities have completed (successfully or unsuccessfully). The activity can also be scheduled to run at a date and time in the future.
Restrictions:
1. You must have *CHANGE authority to the change request description and *EXECUTE authority to the library.
2. If a node list (NODL) value is specified, the node list can only contain entries that have a value of *SNA for the address type.
Notes:
The following notes provide information on how the command works.
1. Authorization to the product specified on the activity is not verified until the activity runs.
2. All conditions must be satisfied before the activity can run.
3. The start times indicate when the activity can be started. Actual start times can be later due to network and system delays.
Examples:
Example 1: Adding an Activity
ADDCMDCRQA CRQD(MYLIB/CR1) ACTIVITY(ACT01) CMD(STRSBS QCMN)
This example shows how activity ACT01 is added to change request description CR1 in library MYLIB to start the QCMN subsystem on the central site system. The activity runs as soon as the change request is submitted.
Example 2: Adding an Activity for a Node list
ADDCMDCRQA CRQD(MYLIB/CR2) ACTIVITY(ACT01) CMD(STRSBS QSNADS)
NODL(MYLIB/STORES) CPNAME(*NONE) RTNSPLF(*FAIL)
This example shows how activity ACT01 starts the subsystem QSNADS on the systems identified in the STORES node list in the library MYLIB. The example also asks for the spooled file to be returned to the central site system if the command fails.
Example 3: Adding an Activity for Two Systems
ADDCMDCRQA CRQD(MYLIB/CR3) ACTIVITY(ACT01) CMD(PRODLIB/RUNREPORTS)
CPNAME((STORENET STOREA) (STORENET STOREB))
USRPRF(REPORTOPER) PASSWORD(OPERPASS) ENCODE(*YES)
This example shows how activity ACT01 runs the detail reports for STOREA and STOREB in the STORENET network. The report runs under the REPORTOPER user profile on the managed systems. Because the user profile and a password are supplied, the request will be encoded when sent to the managed system.