OPCAQRY

Purpose

The OPCAQRY command displays the status of TWS Automation operations, including all commands that are received via the request interface. It displays all command requests processed within the defined time limit.

Syntax

Read syntax diagramSkip visual syntax diagramOPCAQRYsubsystem REQ=DETAILTARGET=system_namedomain_IDsaplex_name*ALLOUTMODE=LINEAUTONETLOG

Parameters

subsystem
The name of the subsystem. Unless you specify REQ=DETAIL, more than one subsystem name as well as a wildcard can be specified. The wildcard can be, for example, SAP*, *SAP or *SAP*
Note: This parameter has no effect for requests with a type of 'COMMAND'.
REQ=DETAIL
Displays TWS-related information for the specified subsystem. The resource name is mandatory when REQ=DETAIL is specified.
Note: This parameter is not applicable for requests with a type of 'COMMAND'.
TARGET
For information on the TARGET parameter, see TARGET Parameter.
OUTMODE
For information on the OUTMODE parameter, see OUTMODE Parameter.

Restrictions and Limitations

The OPCAQRY command can only be used when SA z/OS® is initialized.

Examples

If you enter the OPCAQRY command without the REQ=DETAIL parameter, a panel similar to Figure 1 is displayed. The panel shows information about TWS-controlled subsystems that match the filter criteria.
Figure 1. OPCAQRY Command Dialog Panel
 EVJKYQRY                  SA z/OS  - Command Dialogs     Line  1     of 3      
 Domain ID   = IPSFP      -------- OPCAQRY   ---------    Date = 04/29/06       
 Operator ID = NETOP1          System  = KEY4             Time = 18:08:27       
                                                                                
 CMD:  D Details     R Reset                                                    
                                                                                
 CMD Subsystem   System   Application      Request  Date     Time  Status       
 --- ----------- -------- ---------------- -------- -------- ----- ------------ 
     OPCAO1      KEY4     OPCAO#TESTAD     STOP     04/28/06 17:00 Complete     
     OPCAO2      KEY4     OPCAO#TESTAD     RECYCLE  04/28/06 17:14 Complete     
     RMF         KEY4     OPCAO#TESTAD     STOP     04/29/06 18:05 In progress  
                 KEY4     OPCAO#TESTAD     COMMAND  04/29/06 18:07 In progress  

                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
  PF1=Help    PF2=End      PF3=Return                               PF6=Roll    
                           PF9=Refresh                             PF12=Retrieve
  • The Cmd field allows you to specify command codes to invoke another command dialog. The following command codes are available:
    D
    Shows the TWS operation details for the subsystem.
    R
    Resets the timer and completion flags to a null value, and unlocks a specific subsystem after a user error has been detected and corrected. By resetting the timer and completion flags, SA z/OS again accepts requests from TWS.
  • The Status field shows the status of the request or command in SA z/OS.

    For a request this is either complete, incomplete, timeout, in progress, or no request.

    A status of timeout indicates that the operation is marked in error because it did not complete within the time limit set by the system programmer in the OPCA code entry.

    A status of incomplete indicates that the operation did not achieve the expected status set by the system programmer in the OPCA code entry.

    Complete and no request are considered normal statuses.

    For a command, the statuses are:

    In progress
    The command has been received
    In error
    The command completed but failed
    Complete
    The command completed successfully
    Timeout
    The command did not finish in time
    Waiting
    The command finished processing but is now waiting for completion

The FIND/RFIND and SORT subcommands are supported. See Varying the Format of the Command Output for information.

If you enter command code D for a subsystem or specify the REQ=DETAIL option, a panel similar to Figure 2 is displayed.

Figure 2. OPCAQRY Command Dialog Panel Showing Details for a Command
 EVJKYQR1                  SA z/OS  - Command Dialogs     Line  1     of 17     
 Domain ID   = IPSFP      -------- OPCAQRY   ---------    Date = 04/29/06       
 Operator ID = NETOP1          System  = KEY4             Time = 18:10:48       
                                                                                

  Application           : OPCAO#TESTAD
  Workstation           : NV04
  Operation number      : 10
  IA Time               : 04/28/06 17:00
  Job Name              : OPCAO1
  Owner                 : NETOP1

  Arrived in SA z/OS    : 04/28/06 17:00
  Command               : INGREQ CICS2/APl/SYS1 REQ=START OUTMODE=LINE VERIFY=NO
  Status                : In progress
  Task                  : CMD1

  Checking Routine      : CMD1$CHCK
  Maximum wait time     : 00:30
  Maximum return code   : 0


 Command ===>
  PF1=Help     PF2=End      PF3=Return                            PF6=Roll
                            PF9=Refresh                          PF12=Retrieve
If the command is in an error condition, the details that are displayed are similar to those in Figure 3.
Figure 3. OPCAQRY Command Dialog Panel Showing Details for a Command in Error
 EVJKYQR1                  SA z/OS  - Command Dialogs     Line  1     of 17     
 Domain ID   = IPSFP      -------- OPCAQRY   ---------    Date = 04/29/06       
 Operator ID = NETOP1          System  = KEY4             Time = 18:10:48       
                                                                                

  Application           : OPCAO#TESTAD
  Workstation           : NV04
  Operation number      : 10
  IA Time               : 04/28/06 17:00
  Job Name              : OPCAO1
  Owner                 : NETOP1

  Arrived in SA z/OS    : 04/28/06 17:00
  Command               : INGLIST * OUTMODE=LINE
  Status                : In error
  Task                  : Task
 
  Error code            : U007
  Error message         : AOF227I UNABLE TO PROCESS INGLIST - COMMAND NOT
                          PERFORMED DUE TO USER EXIT

  Checking Routine      : CMD1$CHCK
  Maximum wait time     : 00:30
  Maximum return code   : 0

 Command ===>
  PF1=Help     PF2=End      PF3=Return                            PF6=Roll
                            PF9=Refresh                          PF12=Retrieve