Use the OAM RESTART command to restart the OAM address space. During restart processing, OAM matches the constructs and definitions that are used to those that are found in the active SMS configuration.

This command provides the ability to avoid having to do a STOP and START of the OAM address space and allows the OAM address space to retain its current ASID.

To restart the OAM address space without first stopping OAM, enter the following RESTART command:

F OAM,RESTART,parm=value,parm=value,...

You can issue this command when the parameter RESTART=NO is specified on the OAM procedure statement, which prevents OAM from automatically restarting the address space after a change is made to the SMS configuration. The time that OAM is notified of the SCDS activation depends on the time interval specified with the INTERVAL keyword in the IGDSMSxx PARMLIB member. If the change to the SMS configuration affects OAM and a restart of the OAM address space is required, you can issue this command in place of issuing a STOP and START command.

The following command syntax shows the RESTART command. Use the OAM parameter to specify which CBROAMxx PARMLIB member is used during initialization.

>>-+-MODIFY-+--OAM,--RESTART,--+------------------+------------><
   '-F------'                  +-OAM--=--xx-------+   
                               +-OSM--=--+-YES--+-+   
                               |         +-NO---+ |   
                               |         '-FAST-' |   
                               +-REST--=--+-YES-+-+   
                               |          '-NO--' |   
                               +-MAXS--=--nn------+   
                               +-EJECT--=--+-W-+--+   
                               |           '-M-'  |   
                               '-UNL--=--nnnn-----'   

OAM

OAM=xx specifies the suffix of the CBROAMxx PARMLIB member that OAM should process during OAM address space initialization. The two alphanumeric characters (xx) must immediately follow the OAM=keyword in the PARM field. If the two characters immediately following the OAM=keyword are invalid or not specified, error message CBR0025I is issued. OAM only reads PARMLIB member CBROAMxx if the OAM=keyword is specified on the PARM field of the JCL EXEC statement in the OAM cataloged procedure. If no OAM=keyword is specified on the PARM field of the JCL EXEC statement, no PARMLIB member is read by OAM and object tape storage is not active. If the object tape storage is not active, OAM cannot read any objects back or write any new objects to tape until OAM is initialized with a valid OAM=xx specification, and a valid corresponding CBROAMxx PARMLIB member. OAM processes PARMLIB member CBROAMxx during OAM address space initialization.

OSM

Indicates whether or not OSMC is initialized at the same time as OAM after the RESTART command has been issued. The valid values for this parameter are as follows:

YES

OAM initializes with OSMC.

NO

OAM initializes without OSMC

FAST

OAM initializes with OSMC. However, OAM bypasses the collection audit, delaying it until OSMC storage group processing is done.

REST

Determines whether OAM should automatically restart when it receives notification that a new SCDS is activated. The valid values for this parameter are as follows:

YES

OAM automatically restarts when a new SCDS is activated.

NO

OAM does not automatically restart when a new SCDS is activated.

MAXS

MAXS=nn specifies the maximum number of OSMC storage management tasks that can be active at one time, where nn is a number value 1–99. The value given for MAXS must not exceed the number of optical and tape drives that is available for storage management processing. If the MAXS parameter is not specified, a default of 2 is assigned.

If concurrent processing includes Object storage groups writing to tape volumes, the correct corresponding (global level) MAXTAPERETRIEVETASKS and MAXTAPESTORETASKS values on the SETOAM statement must be specified.

EJECT

Used to determine which volumes are ejected from an optical library when the library is full and there is a request to add additional volumes to the library. The valid values for this parameter are as follows:

W

This value indicates that Library Space Management is to use the least recently written algorithm when selecting a volume to be ejected from an optical library.

M

This value indicates that Library Space Management is to use the least recently mounted algorithm when selecting a volume to be ejected from an optical library.

UNL

UNL=nnnn specifies the number of seconds of inactivity that OAM waits before unloading an optical drive in a library in order to keep at least one drive empty. This unload only occurs if there are no available optical drives within this library. That is, there are no empty online and operational drives. Thus, during periods of inactivity, you can cause at least one drive to be ready to accept the next mount request without first having to do a demount.

For more information about the MAXS parameter and related SETOAM keywords, see OAM cataloged procedure parameter (MAXS).