3 Modify,
if necessary, and then run CBRAPROC SAMPLE member
Sample jobs are provided in SAMPLIB to assist you in making the
needed additions to PROCLIB. Before running each SAMPLIB member:
- Update the JOB statement.
- Ensure that the high-level qualifier on the //OUT DD JCL statement matches the naming standard at your installation.
- Review usage of the RESTART parameter and the optional
OAM=XX parameter (for use with the SETTLIB command statement).
Run SAMPLIB member CBRAPROC (see
SAMPLIB member CBRAPROC) to create member OAM in PROCLIB.
The following member is created as the default:
//OAM PROC OSMC=YES,MAXS=2,UNLOAD=9999,EJECT=LRW,REST=YES
//IEFPROC EXEC PGM=CBROAM,REGION=0M,
// PARM=('OSMC=&OSMC,APLAN=CBROAM,MAXS=&MAXS,',
// 'UNLOAD=&UNLOAD,EJECT=&EJECT,RESTART=&REST')
//SYSABEND DD SYSOUT=A
Note: In general, the default can be used because most
of the parameters are applicable only if OAM is used to store objects.
However, if you plan to use the SETTLIB command statement in the CBROAMxx
PARMLIB member, you must update this job step to include 'OAM=&OAM',
and you must supply the default OAM=
xx (where
xx is
the low order suffix of your CBROAMxx PARMLIB member) specification
on the PROC statement, as shown in this example:
//OAM PROC OSMC=YES,MAXS=2,UNLOAD=9999,OAM=xx,EJECT=LRW,REST=YES
//IEFPROC EXEC PGM=CBROAM,REGION=0M,
//PARM=('OSMC=&OSMC,APLAN=CBROAM,MAXS=&MAXS,UNLOAD=&UNLOAD',
// 'OAM=&OAM,EJECT=&EJECT,RESTART=&REST')
//SYSABEND DD SYSOUT=A
With the PARM=keyword, you can
specify values for the following tape library-related parameters:
- OAM (optional; used with the SETTLIB command)
- 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 the
SETTLIB defaults are used 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.
For more information on the SETTLIB command statement of the CBROAMxx
PARMLIB member, refer to SETTLIB statement for tape library settings.
- RESTART
- Specifies whether OAM should automatically restart when it receives
notification that a new SCDS is activated. The valid parameter values
on this keyword are:
- NO
- RESTART=NO specifies that OAM is to continue processing normally
when OAM is notified that an SCDS activation has occurred. Message
CBR0092I is issued to acknowledge that a new SCDS has been activated.
The installation should ensure that the OAM RESTART command is issued
if an OAM address space restart is necessary.
- YES
- RESTART=YES specifies that OAM is to automatically restart when
OAM is notified that an SCDS activation has occurred. This is the
default value. How soon OAM is notified of the SCDS activation depends
on the time interval that is specified with the INTERVAL keyword in
the IGDSMSxx PARMLIB member.
For more information concerning the RESTART parameter,
see Restarting OAM.
For information concerning the
other parameters associated with this procedure statement, refer to z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support.