Restarting OAM

OAM provides the ability for you to specify a RESTART option on the OAM started procedure statement (see the example in Updating the PROCLIB under Run SAMPLIB member CBRAPROC). This option indicates that OAM should or should not be restarted upon notification that a new SCDS has been activated. A new or changed SCDS does not always affect the configuration information that OAM uses; therefore, a restart of the OAM address space may not always be necessary each time a new or changed SCDS is activated. This option provides a choice to the customer to decide on the most efficient use of their OAM resources.

If you specify RESTART=YES (the default), OAM restarts automatically once it is notified that an SCDS activation has occurred. OAM completes work that is currently on its execution queues, requeues any work from outside the OAM address space to the input work queue, and terminates any work from within the OAM address space not currently executing. OAM rebuilds its internal control blocks to match the SMS definitions in the recently activated SCDS. When OAM is back to full capacity (restart complete), the work requeued to the input work queue begins processing.

Note: How soon OAM is notified of the SCDS activation depends on the time interval that you specify with the INTERVAL keyword in the IGDSMSxx PARMLIB member.

If you specify RESTART=NO, OAM continues processing without rebuilding its internal control blocks when it is notified that an SCDS activation has occurred.

Message CBR0092I acknowledges that a new SCDS has been activated.

CBR0092I  New SMS Source Control Data Set activated.  OAM address space
         restart may be required.

It is the responsibility of the installation to ensure that the OAM RESTART command is issued if an OAM address space restart is necessary.

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

By using this command, you can avoid having to perform STOP and START commands of the OAM address space. This command 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:


>>-+-MODIFY-+--OAM--,--RESTART--+---------+--------------------->
   '-F------'                   '-,OAM=xx-'   

>--+----------------+------------------------------------------><
   '-,REST=-+-NO--+-'   
            '-YES-'

OAM=xx

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. OAM reads PARMLIB member CBROAMxx only if the OAM= keyword is specified on the PARM field of the JCL EXEC statement in the OAM cataloged procedure. OAM processes PARMLIB member CBROAMxx during OAM address space initialization and for tape library processing is used for the optional SETTLIB support.

REST

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

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

YES: OAM automatically restarts when a new SCDS is activated.