Using the UPDATE command to set SETOAM, SETOSMC, and SETOPT values

You can change most of the current values of the SETOAM, SETOSMC, and SETOPT statements using the F OAM,UPDATE command without having to restart OAM. This command can also define settings of most of the SETOAM, SETOSMC, and SETOPT values if a CBROAMxx PARMLIB member was not used at OAM startup. This command provides dynamic processing that provides another method (other than using the CBROAMxx PARMLIB member) for customizing your object tape and optical storage.

If you used a CBROAMxx PARMLIB member at OAM initialization, you can use the OAM UPDATE command to change the current settings for SETOAM, SETOSMC, and SETOPT for the duration of the OAM session. If OAM is restarted, in most cases, the settings from the CBROAMxx PARMLIB member override any SETOAM, SETOSMC, or SETOPT values modified by an update command.

Exception: If you restart OAM and no specific statements exist in the CBROAMxx PARMLIB member for a given storage group and a previous UPDATE SETOPT, SETOSMC, or SETOAM command was issued to update a field for that storage group, the value assigned by the update might be retained.

The following is the syntax for the F OAM,UPDATE,SETOAM | SETOPT | SETOSMC command:


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

>--OAM,UPDATE,-+-SETOAM--+-,scope,field,value,field,value------><
               +-SETOPT--+                                  
               '-SETOSMC-'

Note: There is a maximum of seven pairs of field and value updates allowed on one UPDATE command.

The following are the descriptions of the keywords used in this command:

SETOPT | SETOAM | SETOSMC

Specifies the command parameter being updated. Use:

SETOAM to update settings for the tape level of the OAM storage hierarchy.
SETOPT to update general rules or options that span the disk, optical, and tape levels of the OAM storage hierarchy.
SETOSMC to update settings for OSMC processing.

Note: The values of the SETDISK statement, which specify the file system settings, are static values and cannot be changed with the UPDATE command.

scope

Specifies which storage groups will be affected by the update. Valid values are ALL or the name of a storage group defined in the active SMS configuration. If ALL is specified, the global default, if applicable, is updated for each object storage group in the active SMS configuration. If the name of a storage group is specified, only that storage group is updated with the setting value changes. Only one storage group can be specified with a single UPDATE command.

field

Specifies specific keyword in the SETOAM or SETOPT statement that is being updated.

value

Specifies the new value for the specified field. This value must conform to the same conditions and restrictions that apply to the CBROAMxx PARMLIB member in SYS1.PARMLIB, with the following exceptions:

The OPREINIT (OPTICALREINITMODE) keyword values are GROUP and OAMSCR when this keyword is issued with the UPDATE command. This is due to an 8-character restriction on the input values.
The TCOMP (TAPECOMPACTION / NOTAPECOMPACTION) keyword values are Y (indicating TAPECOMPACTION) or N (indicating NOTAPECOMPACTION) when this keyword is issued with the UPDATE command.
The TRECYC (TAPERECYCLEMODE) keyword values are GROUP, OAMSCR, and MVSSCR when this keyword is issued with the update command. OAMSCR represents the OAMSCRATCH value. MVSSCR represents the MVSSCRATCH value.