Command line interface to CSM
Use the CSM command line interface to manually monitor the state of CSM objects.
When an object group is defined in the local repository, you are asked to specify a command prefix. This unique value is used by CSM to determine which subsystem manages the command that is entered.
When you browse an object group definition, you will see an entry for the group’s command prefix. For example, the following figure shows the settings for group KMZ1.
Figure 1. Command prefix settings for group KMZ1
COMMAND ===> TGT --- KMZ1
Group Name ===> KMZ1
Command Prefix ===> CSMKM___________
Rule information:
Ruleset Dataset ===> BAOKMZ.AAO63.KMZ1.UBBPARM___________________
Ruleset Id ===> G2 Rule Prefix ===> ACM1 Suffix ===> 0001
Object Statistics:
Audit ===> Y (Y/N)
Dataset Name ===> BAOKMZ.KMZ1.OFFLOAD_________________________
Disposition ===> MOD
Application information:
Author ===> BAOKMZ2
Description ===> Group List for SYSD Again______
Last Built by BAOKMZ2 on 07/07/2000 at 12:48:52
Last Modified by BAOKMZ2 on 06/23/2000 at 11:43:33
Enter END command to process and return or CANCEL to leave
The command prefix specified for this group is CSMKM. Therefore, any commands to group KMZ1 through the interface must be prefixed with CSMKM.
In this example, where a CSM-enabled MainView AutoOPERATOR subsystem is using a repository that contains group KMZ1, you can issue commands from an MVS console against the CSM objects managed by group KMZ1.
Commands to the interface have the following format:
user_specified_prefix command objectname parm1 parm2
where the following commands can be issued:
Table 1. Command line interface commands and parameters
Command | Purpose | Parameter 1 | Parameter 2 |
|---|---|---|---|
STOP | stops an object | no entry EARLY LOGICAL LOGICALE | no entry DEP NODEP |
START | starts an object | no entry EARLY LOGICAL LOGICALE | no entry REQNOREQ |
CANCEL | cancels execution of an object | none | none |
BOUNCE | stops and then immediately starts an object | none | none |
MOVE | transfers monitoring and management from CSM enabled subsystem to another Execution of the object moves from one MVS image to another, if necessary. | Either the ID of the group to transfer control to or the value LOCAL, for the local group | none DEP NODEP (the default) |
RESET | resets object state to that specified in the object’s schedule | none | none |
STATUS | reports the desired and actual state of one or more objects If an object name is not specified then all objects in a particular group are reported | none | none |
ENABLE | enables processing of a group for a local subsystem | Group ID to enable | SSID to enable group on |
DISABLE | disables processing of a group for a local subsystem | none | none |
ENABLE-OBJECT | enables an object to be controlled by CSM | objectname | none |
DISABLE-OBJECT | disables an object to be controlled by CSM | objectname | none |
In the case of the START and STOP commands, the values in the Parameter 1 column are based on the input parameters to the CSMACT EXEC. When a user starts an object with the interface command
user_specified_prefix START AAOCSM01 EARLY
CSMACT is scheduled on the appropriate subsystem with the following parameters:
AAOCSM01 UPEARLY NOREQ
Some examples follow.
- Object group KMZ1 manages AAOCSM01. The group’s command prefix is CSMKM. To stop AAOCSM01 and its children:
Example: CSMKM STOP AAOCSM01 DEP
- To move object AAOCSM08 from group KMZ1 to group KMZ2. The group prefix for KMZ1 is CSMKM. The group prefix for KMZ2 is CSMK2.
Example: CSMKM MOVE AAOCSM08 KMZ2
- To bounce object AAOCSM09 and the group KMZ2 that monitors it:
Example: CSMK2 BOUNCE AAOCSM09
- To check the status of all of the objects monitored by group KMZ1:
Example: CSMKM STATUS
- To disable object group KMZ1 which is running on subsystem KMZ1:
Example: CSMKM DISABLE
- Object group KMZ1 manages AAOCSM22. The group’s command prefix is CSMKM. To start only AAOCSM22 but not its parents:
Example: CSMKM STOP AAOCSM22 NOREQ
- To move object AAOCSM08 from group KMZ1 to group KMZ2. The group prefix for KMZ1 is CSMKM. The group prefix for KMZ2 is CSMK2.
Example: CSMKM MOVE AAOCSM08 KMZ2
- To move object AAOCSM08 and its dependents from group KMZ1 to group KMZ2. The group prefix for KMZ1 is CSMKM. The group prefix for KMZ2 is CSMK2.
Example: CSMKM MOVE AAOCSM08 KMZ2 DEP