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.
• Verify that the system name specified is the same as the name of your DB2 subsystem.
• Ensure that the high-level qualifier on the //OUT DD JCL statement matches the naming standard at your installation.

If you do not modify CBRAPROC, 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

   //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 parameters:

APLAN

Specifies the name of the DB2 application plan for LCS. CBROAM is the name of the DB2 application plan specified when an SQL BIND command was issued for the LCS OAM configuration database request modules (DBRMs).

EJECT

Specifies 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 parameter values on this keyword are as follows:

• LRW—least recently written date for the volume. The volumes are ejected based on how long it has been since an object has been written on the volumes, regardless of how often objects are being read from the volume. The volumes which have the oldest least recently written date are ejected to make room for the additional volumes requested. This is the default parameter.
• LRM—least recently mounted date for the volume. The volumes which are in the slot for the longest time without being mounted are ejected to make room for the additional volumes requested.

MAXS

The MAXS parameter in the OAM cataloged procedure specifies the maximum number of Object or Object Backup storage group tasks that can be processed concurrently during an OSMC storage management cycle. If storage management cycles for groups overlap, you can use the MAXS parameter to limit resource consumption. When determining the value for MAXS, take into consideration the number of optical and tape drives that are available for storage management processing to avoid drive contention. If MAXS is not specified, a default of 2 is assigned. See OAM cataloged procedure parameter (MAXS) for more information about the MAXS parameter.

Requirement: If concurrent processing includes Object storage groups writing to tape volumes, you must specify the correct corresponding (global level) MAXTAPERETRIEVETASKS and MAXTAPESTORETASKS values on the SETOAM statement. For more information concerning these keywords, see SETOAM keyword definitions for global level.

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.

OSMC

Specifies whether to initialize OSMC when OAM initializes. When YES, OSMC initializes when OAM initializes; when NO, OSMC is prevented from initializing when OAM initializes. (Operator commands requiring OSMC do not execute; the storage management cycle does not run.)

REST

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

• Yes—If REST=YES is specified, when OAM is notified that an SCDS activation has occurred, OAM automatically restarts. 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.
• No—If REST=NO is specified, when OAM is notified that an SCDS activation has occurred, OAM continues processing normally. 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. See Restarting the OAM address space for details concerning this command.

UNLOAD

Unloads the least recently used 3995 optical disk drive, inside an IBM 3995 optical library, after the number of seconds of inactivity specified on the keyword. This unload only occurs if no available optical drives are 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.

The valid parameter values on this keyword are as follows:

• 0 to 9998 specifies the number of seconds of inactivity before the demount might occur.
• 9999 specifies that the cartridge is not to be demounted during periods of inactivity. This is the default.

Restriction: The UNLOAD keyword applies only to 3995 optical disk drives that are library-resident.