Querying summary and detail information for pending and active requests

Use the F OAM,QUERY,options command to display:

A summary of active file system requests
A summary of active optical requests
A summary of active tape requests
A summary of waiting file system requests
A summary of waiting optical requests
A summary of waiting tape requests
Detailed information concerning active file system requests
Detailed information concerning active optical requests
Detailed information concerning active tape requests
Detailed information concerning waiting file system requests
Detailed information concerning waiting optical requests
Detailed information concerning waiting object tape requests

The following command syntax shows the QUERY command:


                                               .-SUMMARY,-.   
>>-+-MODIFY-+--OAM,----QUERY,----+-ACTIVE,--+--+-DETAIL,--+----->
   '-F------'                    '-WAITING,-'  '-SUMMARY,-'   

>--+-ALL----+--------------------------------------------------><
   +-READ---+   
   +-WRITE--+   
   +-DELETE-+   
   +-EJECT--+   
   +-ENTRY--+   
   +-AUDIT--+   
   +-LABEL--+   
   '-REMAP--'

Recommendation: OAM is the default name of the cataloged procedure in your SYS1.PROCLIB. If a name other than OAM is used for the cataloged procedure, use that name in the QUERY statement. For example, MODIFY procname_name,QUERY,ACTIVE,SUMMARY.

The following are the keyword descriptions of the QUERY command:

QUERY

Specifies a request to display information about active and waiting requests. The abbreviation for this command, Q, can also be used.

ACTIVE

Indicates that only information about active requests, those currently being processed, is displayed. The abbreviation for this command, A, can also be used. Either the ACTIVE or WAITING keyword must be specified on the QUERY statement.

WAITING

Indicates that only information about requests waiting to be processed are to be displayed. The abbreviation for this command, W, can also be used. Either the WAITING or ACTIVE keyword must be specified on the QUERY command. This information includes any waiting requests that have been sent to other instances of OAM in the OAMplex for processing.

SUMMARY

Indicates that only summary information about the requested category is displayed. If neither the SUMMARY nor the DETAIL keyword is specified on the QUERY command, only summary information is displayed for the requested category. The abbreviation for this command, S, can also be used. This summary information also includes any waiting requests that have been sent to other instances of OAM in the OAMplex for processing. SUMMARY is the default.

DETAIL

Indicates that only detailed information about the requested category (ACTIVE or WAITING) is displayed. If neither the DETAIL nor the SUMMARY keyword is specified on the QUERY command, only summary information is displayed for the requested category. The abbreviation for this command, D, can also be used. Query detail messages are written to the hard copy log so that the WTO buffers are not overrun, which causes a system degradation. One of the following keywords is required when the DETAIL keyword is specified:

ALL: Indicates that detail information for either all active or all waiting (depending on the prior specification in the command) requests are to be displayed.
READ: Indicates that detail information for all READS (active or waiting) is displayed.
WRITE: Indicates that detail information for either all WRITES (active or waiting) is displayed.
DELETE: Indicates that detail information for all DELETES (active or waiting) is displayed.
EJECT: Indicates that detail information for all EJECTS (active or waiting) is displayed.
ENTRY: Indicates that detail information for all ENTRIES (active or waiting) is displayed.
AUDIT: Indicates that detail information for all AUDITS (active or waiting) is displayed.
LABEL: Indicates that detail information for all LABELS (active or waiting) is displayed.
REMAP: Indicates that detail information for all REMAPS (active or waiting) is displayed.

Note: The OAM QUERY command is passed to the OAM address space through the MVS MODIFY system command. All messages that are sent as a result of the OAM QUERY command are sent to the system console from which the command originated, except for the QUERY DETAIL messages. They are sent to the system log only, not the console. The system operator must be aware that entering a F OAM,QUERY,ACTIVE,DETAIL or a F OAM,QUERY,WAITING,DETAIL command can result in a significant number of messages if there is a significant backlog of OAM requests processing or waiting for execution.

Related reading: For further information about messages that are associated with the OAM QUERY command, see z/OS MVS System Messages, Vol 4 (CBD-DMO).

To query OAM to provide information about active file system, optical, and tape requests, enter the following command:

F OAM,QUERY,ACTIVE
 
       or
 
F OAM,QUERY,ACTIVE,SUMMARY

The following information is displayed only if optical libraries are defined in the active configuration:

CBR1720I OPTICAL ACTIVE SUMMARY
----------- OPTICAL REQUESTS CURRENTLY BEING PROCESSED--------------
 READS  WRITES  DELETES  ENTERS  EJECTS  AUDITS  LABELS
aaaaaa   bbbbbb  cccccc  dddddd  eeeeee  ffffff  gggggg

aaaaaa: Total number of object read requests from an optical volume currently being processed. This includes read requests being processed on this system that originated from another instance of OAM in an OAMplex.
bbbbbb: Total number of object write requests to an optical volume currently being processed. This includes write requests being processed on this system that originated from another instance of OAM in an OAMplex.
cccccc: Total number of object delete requests from an optical volume currently being processed.
dddddd: Total number of optical volume enter requests currently being processed.
eeeeee: Total number of optical volume eject requests currently being processed. This number also includes system initiated ejects.
ffffff: Total number of optical volume audit requests currently being processed.
gggggg: Total number of optical cartridge label requests currently being processed.

The following information is displayed only if a file system is defined in the active configuration:

CBR1745 FILE SYSTEM ACTIVE SUM:
CBR1746 ---- FILE SYSTEM REQUESTS CURRENTLY BEING PROCESSED ----
CBR1747 READS WRITES
CBR1748 aaaaaa bbbbbb

aaaaaa: Total number of object read requests from a file system directory currently being processed.
bbbbbb: Total number of object write requests to a file system directory currently being processed.

The following information is displayed for object tape requests only if there are SETOAM statements in the current OAM invocation:

CBR1730I TAPE OBJECT ACTIVE SUM:
---- OBJECT TAPE REQUESTS CURRENTLY BEING PROCESSED--------------
 READS  WRITES
aaaaaa   bbbbbb

The following fields in the data line specify the number of each resource currently being processed:

aaaaaa: Total number of object read requests from a tape volume currently being processed. This includes read requests being processed on this system that originated from another instance of OAM in an OAMplex.
bbbbbb: Total number of object write requests to a tape volume currently being processed.

To query OAM to provide information about waiting file system, optical, and tape requests, enter the following command:

F OAM,QUERY,WAITING
 
      OR
 
F OAM,QUERY,WAITING,SUMMARY

The following information is displayed only if a file system is defined in the active configuration:

CBR1745 FILE SYSTEM WAITING SUM:
CBR1746 ---- FILE SYSTEM REQUESTS WAITING FOR PROCESSING ----
CBR1747 READS WRITES
CBR1748 aaaaaa bbbbbb

aaaaaa: Total number of object read requests from a file system directory waiting to be processed.
bbbbbb: Total number of object write requests from a file system directory waiting to be processed.

The following information is displayed only if optical libraries are defined in the active configuration:

CBR1700I OPTICAL WAITING SUMMARY:
 
------------- OPTICAL REQUESTS WAITING FOR PROCESSING---------------------
READS    WRITES    DELETES   ENTERS    EJECTS    AUDITS    LABELS
aaaaaa   bbbbbb    cccccc    dddddd    eeeeee   ffffff     gggggg

The following fields in the data line specify the number of each resource waiting for execution:

aaaaaa: Total number of object read requests from an optical volume waiting to be processed. This includes read requests waiting to be processed on this system that originated from another instance of OAM in the OAMplex or read requests originated by this system, waiting to be processed by another instance of OAM in the OAMplex.
bbbbbb: Total number of object write requests to an optical volume waiting to be processed. This includes write requests waiting to be processed on this system that originated from another instance of OAM in the OAMplex or write requests originated by this system, waiting to be processed by another instance of OAM in the OAMplex.
cccccc: Total number of object delete requests from an optical volume waiting to be processed.
dddddd: Total number of optical volume enter requests waiting to be processed.
eeeeee: Total number of optical volume eject requests waiting to be processed. This number also includes system initiated ejected.
ffffff: Total number of optical volume audit requests waiting to be processed.
gggggg: Total number of optical cartridge label requests waiting to be processed.

The following information is also displayed for object tape requests only if there are SETOAM statements in the current OAM invocation:

CBR1710I TAPE OBJECT WAITING SUM:
 
----- OBJECT TAPE REQUESTS WAITING FOR PROCESSING----------
 READS  WRITES
aaaaaa   bbbbbb

The following fields in the data line specify the number of each resource waiting for execution:

aaaaaa: Total number of object read requests from a tape volume waiting to be processed. This includes read requests waiting to be processed on this system that originated from another instance of OAM in the OAMplex or read requests originated by this system, waiting to be processed by another instance of OAM in the OAMplex.
bbbbbb: Total number of object write requests to a tape volume waiting to be processed.