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.
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.