Enhanced Command Syntax (PERform)

Enhanced Commands › Issuing an Enhanced Command › Enhanced Command Syntax (PERform)

Enhanced Command Syntax (PERform)

To perform the requested action on the specified MUFs or on the specified URTs and display the results, enter an enhanced command in the following format.

►►─ transaction-ID ─ PERform,action ─┬────────────────┬───────────────────────►◄
                                     └─ ,SYSid(aaaa) ─┘
►►─┬┬ ,MUF(nn) ───────────┬─┬─ CONnect ────┬───────────────────┬──────────────►◄
   ││  MSIDname(*) ───────┤ ├─ DISconnect ─┤                   │
   │└─ MSIDname(xxxxxxxx) ┘ └─ IMMediate ──┘                   │
   ├─┬─ STARTup ──┬────────────────────────────────────────────┤
   │ └─ SHUTdown ─┘                                            │
   └─ ,URT(nnnn) ─┬─ AUTO ────┬─┬──────────────────────┬───────┘
                  ├─ DEFer ───┤ └─ ,SIDname(xxxxxxxx) ─┘
                  ├─ CLOSE ───┤
                  ├─ NEWcopy ─┤
                  ├─ OPEN ────┤
                  └─ REStart ─┘

transaction-ID

Specifies the transaction ID defined in the CICS System Definition File (CSD) for invoking CA Datacom CICS Services functions to monitor and control resources in an MRO environment.

To perform an action, DBEC is the default transaction ID that precedes an enhanced command.

PERform

Indicates the enhanced command is to perform an action. PER and P are valid abbreviations.

Note: You can issue any DBEC PERFORM command from the console.

,action

The command must include one of the following actions:

For URTs: AUTO, DEFer, CLOSE, NEWcopy, OPEN, or REStart (DEF, NEW, and RES are valid abbreviations.)
For Systems: STARTup or SHUTdown (START and SHUT are valid abbreviations.)
For MUFs: CONnect, DISconnect, or IMMediate (CON, DIS, and IMM are valid abbreviations.)

MUF(nn)

(Optional) Identifies the MUFs on which the action is performed. This number corresponds to the relative number of the DBCSID macro that is appended to the DBCVTPR macro assembly.

Note: Omit this parameter for system actions STARTup and SHUTdown, and for URT actions AUTO, DEFer, CLOSE, NEWcopy, OPEN, and REStart. Also, omit this parameter if the MSIDNAME(xxxxxxxx) is used to qualify the MUF.

MSIDname(xxxxxxxx)

(Optional) Identifies the MUFs on which the action is performed. This value corresponds to the SIDNAME parameter of the DBCSID macro that is appended to the DBCVTPR macro assembly. The xxxxxxxx can be * for all MUFs or it can be qualified with a value that begins with a default for all matching MUFs.

Note: Omit this parameter for system actions STARTup and SHUTdown, and for URT actions AUTO, DEFer, CLOSE, NEWcopy, OPEN, and REStart. Also, omit this parameter if the MUF(nn) is used to qualify the MUF.

,SIDname(xxxxxxxx)

(Optional) Specify one MUF SID name on which to perform the URT or System action. Alternately, specify a generic SID name that is composed of any number of leading characters of SID names followed by an asterisk (*) to specify a range of MUFs. If not specified, the command applies to all MUFs. (Omit for commands with MUF(nn) or MSIDname(xxxxxxxx).) This option is only available with URT(nnnn) commands. (SID is a valid abbreviation.)

,URT(nnnn)

(Optional) Identifies the URT on which the action is performed. Omit for actions STARTup and SHUTdown, and for MUF actions CONnect, DISconnect, and IMMediate.

,SYSid(aaaa)

(Optional; only used in MRO environments) Specify one remote CICS system ID on which to perform the action, or an * (asterisk) to specify all systems in the MRO environment. If not specified, the command applies to the local system only. SYS is a valid abbreviation.

If the command, as entered, contains an error, the CA Datacom CICS Services displays the following help panel.

      SYSID = CXDS       CA Datacom CICS Services        APPLID = A31ICXDS     
DBEC                                                                           
DC01002I - INVALID COMMAND FORMAT                                              
                  FUNCTION          ACTION/LIMITER            MUF              
                  |                 |                         |                
   FORMAT:   DBEC AAAAAAA,BBBBBBBBB,CCCCCCCCCCCCC,DDDDDDDDDDD,EEEEEEEEEEEEEEEEE
                          |                       |                            
                          OBJECT                  SYSTEM                       
                                                                               
FUNCTIONS: INQUIRE,INQ,I   OBJECTS: MUF(2)   URT(4)     TBL(0210) <= SPECIFIC  
           PERFORM,PER,P            MUF(1?)  URT(001?)  TBL(01??) <= RANGE     
                                    MUF(??)  URT(????)  TBL(????) <= ALL       
                                    MSID(DBSIDPR)                 <= SPECIFIC  
                                    MSIDNAME(DBSID*)              <= RANGE     
                                    MSID(*)                       <= ALL       
ACTION : OPEN    CLOSE  NEWCOPY   RESTART  DEFER  AUTO  STARTUP  SHUTDOWN      
         CONNECT DISCONNECT IMMEDIATE                                          
LIMITER: OPEN CLOSE UNOPENED OPENING CLOSING  DEFER  AUTO  NOCSD  SQL  DYN  PLT
         CONNECT CONNECTING DISCONNECT DISCONNECTING UNCONNECTED STATS         
                                                                               
SYSTEM:             <= BLANK-LOCAL CICS    MUF (URT OR TBL ONLY): <= BLANK-ALL 
        SYSID(AAAA) <= SPECIFIC CICS            SIDNAME(XXXXXXXX) <= SPECIFIC  
        SYSID(*)    <= ALL CICS SYSTEMS         SIDNAME(XXXX*)    <= RANGE

If the help panel appears, enter the complete command on the command line with the displayed syntax and valid values.
- All enhanced commands can be invoked with the DBEC transaction ID.
- Only those enhanced commands which include the INQUIRE function can be invoked with the DBEX transaction ID. DBEX cannot be used to invoke a command to perform an action.
- The values for OBJECT, ACTION, SIDNAME and SYSTEM can be entered in any order.
- For INQUIRE commands, the limiter value is supplied in the position described for ACTION(CCCCCCCCCCCCC).
- It is important to follow the syntax diagram when entering your inquiry or perform action. Otherwise, your requested results may not yield the inquiry display or perform action that you intended to be executed.
When you press Enter, an Inquiry display appears. The INQ,TBL(nnnn) command invokes the Table-level Inquiry display. Any MUF PERform command or INQ,MUF(nn) or INQ,MSIDname(xxxxxxxx) command invokes the MUF-level Inquiry display.
Note: The status of any MUF displayed in this manner is current as of the time of the last request processed by that MUF. For example, if the last request processed by a MUF was 90 seconds ago, a DBEC I,MUF (or MSIDname(xxxxxxxx)) or DBEX I,MUF (or MSIDname(xxxxxxxx)) request displays the status of that MUF as it was 90 seconds ago.