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