Starting OSMC functions

Use the F OAM,START command to start the following OSMC functions:

Storage management cycle for all or specific Object or Object Backup storage groups
Library space management cycle for an optical library
DASD space management cycle for an Object storage group
Volume Recovery utility
Single Object Recovery utility
Move Volume utility
Tape recycle

The following MVS command syntax starts the OSMC functions:


>>-+-MODIFY-+--------------------------------------------------->
   '-F------'   

>--OAM,-+-START-+-,-+-DASDSM,storage-group-name-----------------------------+-><
        '-S-----'   +-LIBMGT,library-name-----------------------------------+   
                    |                 .-,BACKUP1-.                          |   
                    +-RECOVERY,volser-+----------+-+---------+--------------+   
                    |                 '-,BACKUP2-' '-,DELETE-'              |   
                    +-MOVEVOL,volser-+----------+---------------------------+   
                    |                +-,RECYCLE-+                           |   
                    |                '-,DELETE--'                           |   
                    |                                     .-,BACKUP1-.      |   
                    +-OBJRECV,collection-name,object-name-+----------+-OSMC-+   
                    |                                     '-,BACKUP2-'      |   
                    +-RECYCLE,scope-+---------+-+--------+-+-,DISPLAY-+-----+   
                    |               '-,PV=nnn-' '-,TSL=x-' '-,LIM=nn--'     |   
                    '-STORGRP,storage-group-name----------------------------'

DASDSM,storage-group-name

Starts an OSMC DASD space management cycle for the specified Object storage group that is named storage-group-name.

LIBMGT,library-name

Starts an OSMC library management cycle for an optical library that is named library-name. OAM must control the library on the system where the command was entered.

MOVEVOL,volser[,RECYCLE | ,DELETE]

Starts the OSMC Move Volume utility for the source volume with volume serial number volser. Use the MOVEVOL command to migrate objects from a primary or backup source volume to one or more target volumes, or to delete a scratch volume from the OAM inventory. If you omit the RECYCLE or DELETE option, the migrated volume remains in the same Object or Object Backup storage group, and all volume record fields in the OCDB remain the same.

RECYCLE: Recycles the optical platter or rewritable tape volume after moving the objects off the cartridge. When the MOVEVOL command completes, OAM recycles the tape volume or optical platter using the parameters that are specified in the SETOAM TAPERECYCLEMODE or SETOPT OPTICALREINITMODE statement in the CBROAMxx member of PARMLIB.
DELETE: Deletes the optical platter or tape volume after the objects are moved off of the cartridge. After the MOVEVOL command completes and no objects remain on the cartridge, the tape volume or optical platter is deleted from the OAM configuration database. The DELETE option overrides any parameters that are specified in the SETOAM TAPERECYCLEMODE or the SETOPT OPTICALREINITMODE statement in the CBROAMxx member of PARMLIB.
When an optical volume is deleted, OAM displays message CBR2153I. When a tape volume is deleted, OAM displays message CBR2165I for a rewritable tape volume, or message CBR2173I for a WORM tape volume. These messages can be used to signal the tape management system that the tape volume can be returned to MVS scratch status for reuse if the tape volume is rewritable or to handle the WORM tape volume according to the installation procedures for expired WORM media. You can automate this message to notify the tape management system to return the tape volume to MVS scratch status.

OBJRECV,collection-name,object-name,BACKUP1 | BACKUP2

Starts the OSMC Single Object Recovery utility for the object that is named object-name, in the collection that is named collection-name. When you want to recover a primary copy of an object, and you have specified BACKUP1 on the START command for object recovery, OAM creates the recovery from the first backup copy of the object. If you have specified BACKUP2, OAM creates the recovery from the second backup copy of the object. BACKUP1 is the default if you have specified neither BACKUP1 nor BACKUP2.

RECOVERY,volser[,BACKUP1 | ,BACKUP2][,DELETE]

Starts the OSMC Volume Recovery utility for either a tape volume with volume serial number volser or an optical platter with volume serial number volser and its opposite side.

The RECOVERY command verifies that another instance of OAM in an OAMplex is not controlling the volume that is to be recovered. If another instance of OAM is controlling the volume, OAM displays message CBR1068I and cancels the RECOVERY command.

Volumes that belong to an Object Backup storage group are recovered from the primary copies of the objects. If the volume belongs to an Object Backup storage group, OAM ignores the BACKUP1 and BACKUP2 parameters.

BACKUP1: When you want to recover all objects residing on a volume that belongs to an Object storage group and you have specified BACKUP1 on the START command for Volume Recovery, OAM creates the recovery from the first backup copies of the objects. If the volume or cartridge to be recovered belongs to an Object storage group and you have specified neither BACKUP1 nor BACKUP2, BACKUP1 is the default. Backup volumes are always recovered using the primary copies of the objects.
BACKUP2: When you want to recover all objects residing on a volume that belongs to an Object storage group and you have specified BACKUP2 on the START command for volume recovery, the recovery is made from the second backup copies of the objects. Backup volumes are always recovered using the primary copies of the objects.
DELETE: After the volume recovery is complete and no objects are left on the tape or on either side of the optical platter, the tape volume or optical platter is deleted from the OAM configuration database. If the volume resides in an optical library, it is ejected. The DELETE option overrides any parameters that are specified in the SETOAM TAPERECYCLEMODE or the SETOPT OPTICALREINITMODE statement in the CBROAMxx member of PARMLIB.
When an optical volume is deleted, OAM displays message CBR2153I. When a tape volume is deleted, OAM displays message CBR2165I. You can automate this message to notify the tape management system to return the tape volume to MVS scratch status.

RECYCLE,scope{,PV=xxx}{,TSL=x}[,LIM=yy|,DISPLAY]

Displays a list of candidate volumes that meet user-defined criteria to the hardcopy log, and in turn, automatically selects recycle candidate volumes and initiates the MOVEVOL with RECYCLE process on those candidates until either the user-specified limit is reached or no more volumes meeting criteria are available.

scope

Indicates one of the following:

Specified name of an object or object backup storage group, indicates that only tape volumes marked full, that belong to the specified object or object backup storage group, are considered candidates for this RECYCLE command.
(ALLGRP) all full tape volumes that belong to all primary object storage groups defined in the ACTIVE SCDS are considered candidates for this RECYCLE command.
(ALLBK1) all full tape volumes that belong to all first backup storage groups defined in the ACTIVE SCDS are considered candidates for this RECYCLE command.
(ALLBK2) all full tape volumes that belong to all second backup storage groups defined in the ACTIVE SCDS are considered candidates for this RECYCLE command.

PV

=nnn An optional keyword indicating the valid data threshold to be used in determining whether a volume is a candidate for RECYCLE. Full tape volumes that have a percentage of valid data less than or equal to nnn are candidates for RECYCLE. If PV=nnn is not specified, the percent valid to be used to determine RECYCLE candidates is derived from the PERCENTVALID default value as defined through the SETOAM command in the CBROAMxx PARMLIB member. Valid values for nnn are 0 to 100.

TSL

=x An optional parameter that indicates the tape sublevel that a recycle candidate volume must be associated with. The TSL parameter only applies to group volumes. If a scope of (ALLBK1) or (ALLBK2) is specified with the TSL parameter, the command fails. Valid values for x are:

A indicates all group volumes are recycle candidates. This is the default.
1 indicates only tape sublevel 1 group volumes are recycle candidates.
2 indicates only tape sublevel 2 group volumes are recycle candidates.

DISPLAY

An optional parameter that produces a list of volumes that meet criteria to be recycle candidates. This list is sorted by the percentage of valid data on each volume and is written to hardcopy system log through the CBR9875I message. This option does not initiate Recycle processing, and can be issued at anytime, whether a RECYCLE command is actively processing or not. The list of candidate volumes might be large as it shows all volumes that meet the user-specified criteria for RECYCLE.

If DISPLAY is not specified then LIM=nn must be specified.

LIM

=nn If the DISPLAY parameter is not specified, this keyword is required to indicate the maximum number of volumes to be selected for RECYCLE processing. Valid values for nn are 1 to 40.

If LIM=nn is not specified, then DISPLAY must be specified

STORGRP,storage-group-name

Starts an OSMC storage management cycle for one or more specified Object or Object Backup storage groups that are named storage-group-name, where storage-group-name can be:

The name of a specific Object or Object Backup storage group. For example, PAY2010.
A name with a single asterisk (‘*’) in the rightmost part of the name. This indicates that the request applies to all Object or Object Backup storage groups whose names match the characters to the left of the asterisk. For example, PAY*, which applies to all Object or Object Backup storage groups whose names start with PAY.
A single asterisk (‘*’) . which specifies every storage group defined in the ACDS as an Object or Object Backup storage group.

Note:

In an OAMplex, if a specific storage group is processed, OAM initiates OSMC processing of the specified storage group on the system where the command was entered.