Displaying OAM status

Use the DISPLAY SMS,OAM command to display OAM address space status. The syntax of the DISPLAY SMS,OAM command follows:


>>-+-DISPLAY-+--SMS,OAM--+----------------+--------------------><
   '-D-------'           '-,L=-+-a------+-'   
                               +-name---+     
                               '-name-a-'

OAM: Displays OAM status.
,L={a | name | name-a}: Specifies where to display the results of the inquiry: the display area (L=a), the console name (L=name), or both the console name and the display area (L=name-a). The name parameter can be an alphanumeric character string.

To display OAM status, enter the following command:

     DISPLAY SMS,OAM

The following information is displayed:

 
CBR1100I OAM status:
TAPE  TOT  ONL  TOT  TOT  TOT  TOT  TOT   ONL    AVL   TOTAL
      LIB  LIB  AL   VL   VCL  ML   DRV   DRV    DRV   SCRATCH
      nnn  ooo  ppp  qqq  rrr  sss  ttttt uuuuu  vvvvv wwwwwwww
 
exit-name PROCESSING (ENABLED | DISABLED | BYPASSED | OPERATOR DISABLED).
CBROAM: parmlib-suffix

A display of the OAM address space status is generated. If you have defined both optical and tape libraries in the SMS configuration, both optical and tape information are generated in this display. For a sample of the CBR1100I message that includes optical information, see z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support.

The fields in the data line specify the number of each tape library resource as follows:

nnn: Total number of tape libraries defined in the active SMS configuration (excluding the Peer-to-Peer Virtual Tape Server distributed libraries) that are connected to the current system (referred to in the following explanations as a connected tape library). The current system is the system on which the DISPLAY SMS,OAM command is entered. For the number of distributed libraries that are defined to the system, refer to the status line towards the bottom of the display.
ooo: Number of connected tape libraries that are online (excluding the Peer-to-Peer Virtual Tape Server distributed libraries).
ppp: Total number of connected automated tape library dataservers.
qqq: Number of connected Virtual Tape Servers (excluding the Peer-to-Peer VTSs).
rrr: Number of connected Peer-to-Peer Virtual Tape Server composite libraries.
sss: Number of connected manual tape libraries.
ttttt: Total number of tape drives, known to the current system, residing in the connected tape libraries. Includes tape drives in both automated tape library dataservers, Virtual Tape Servers and manual tape libraries.
uuuuu: Total number of tape drives, known to the current system and residing in the connected tape libraries, that are online.
vvvvv: Total number of tape drives, known to the current system and residing in the connected tape libraries, that are online and not allocated.
wwwwwwww: Total number of scratch volumes of all media types in the connected tape libraries. This includes scratch volumes in the automated, manual, and virtual tape libraries.
CBROAM: parmlib-suffix: This field displays the suffix of the CBROAMxx PARMLIB member that was in effect during OAM initialization.

If there are Peer-to-Peer VTS subsystems defined to the system, the following status line is displayed reflecting the number of distributed libraries that are associated with the composite libraries above:

There are also numvdl-lib VTS distributed libraries defined.

For OAM tape library installation exits, the following fields are displayed in the status messages:

exit-name

The name of the exit for which status is being displayed. This can be CBRUXENT, CBRUXEJC, CBRUXCUA, or CBRUXVNL. This line is repeated for each installation exit.

ENABLED

The exit is enabled and executes when the requested function is required.

DISABLED

The exit is disabled due to an error or an abend in the installation exit. For CBRUXCUA, the exit is disabled for CUA PRIVATE to SCRATCH requests only.

BYPASSED

The exit returned a return code 16 indicating that the request function is to continue without calling the exit for all other exits. For CBRUXVNL, either the exit returned a return code 16 indicating that it was not to be called again, or an error (or abend) occurred in the exit and the exit will not invoke.

OPERATOR DISABLED

For CBRUXENT, you have requested to disable the cartridge entry processing by issuing the LIBRARY DISABLE,CBRUXENT command.

For CBRUXVNL, you have requested to disable the volume not in library installation exit by issuing the LIBRARY DISABLE, CBRUXVNL command. The CBRUXVNL installation exit is not invoked during job processing.

You can enable an installation exit that has been OPERATOR DISABLED, using the LIBRARY RESET command or a system IPL.

The following is a sample of DISPLAY SMS,OAM status:

 
CBR1100I OAM status:
TAPE  TOT   ONL  TOT  TOT  TOT  TOT  TOT   ONL   AVL   TOTAL
      LIB   LIB   AL   VL  VCL   ML  DRV   DRV   DRV   SCRTCH
        8     7    3    2    3    0  368   355    78     1225
There are also 6 VTS distributed libraries defined.
CBRUXCUA PROCESSING ENABLED.
CBRUXEJC PROCESSING ENABLED.
CBRUXENT PROCESSING ENABLED.
CBRUXVNL PROCESSING ENABLED.
CBROAM: 19

Note: If both optical libraries and tape libraries are defined in the SMS configuration, the optical library information is displayed first, followed by the tape library information.