Updating fields in the DB2 Volume Table and the Tape Volume Table

Use the F OAM,UPDATE,VOLUME command to allow users to update specific fields in a volume record that are related to an optical or tape volume that is used for OAM object storage. You can use this command in place of the SPUFI option to make the changes. Stop and start the OAM address space for the changes to take effect.

Requirement: The volume requested for the update request must reside in a library that is either controlled by the OAM on which the command was entered or not controlled by any OAM at this time.

The following MVS command syntax updates valid fields in the DB2 Volume Table or the Tape Volume Table:


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

>--OAM,UPDATE,-+-VOLUME-+-,volser,field,value,field,value------><
               '-VOL----'

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

UPDATE: Specifies that an update is requested to a volume record related to an optical or tape volume used for object storage.
VOLUME: Indicates whether this update command is for an optical or tape volume.
volser: Indicates the specific volume serial number targeted for the update.
field: Specifies the specific field in the DB2 Volume Table or the Tape Volume Table that is targeted for the update.
value: Specifies the value to be assigned to the field as a result of the update.

Table 1 shows the valid fields, field values, and value descriptions for updating optical volumes:

Table 1. Field values for optical volumes
Field	Valid values	Definition of value
LOSTFLAG	OFF	The volume lost flag will be reset. This is the only valid value for the LOSTFLAG operand.
EXPDATE	yyyymmdd	A valid date that specifies the scheduled expiration date for the volume. If all objects on this volume are not yet expired or deleted, OSMC automatically recalculates this date when the volume is selected for expiration, unless this volume belongs to the Object Backup storage group. This value might be recalculated if an object is stored to this volume prior to the expiration of the volume.
FULL	Y N P	Indicates that this volume is full, however, this volume's full status will be reevaluated during subsequent OAM initialization and might be marked not full (FULL='N'). Indicates that this volume is not full, however, this volume’s full status will be reevaluated during subsequent OAM initialization and might be marked full (FULL='Y'). Indicates that this volume has been marked permanently full by the `F OAM,UPDATE,VOLUME` command, so this volume’s full status will not be reevaluated during subsequent OAM initialization and is retained across OAM initialization.
READABLE	Y N	Indicates that this volume is readable. Indicates that this volume is not readable.
WRITABLE	Y N	Indicates that this volume can be written to. Indicates that this volume cannot be written to.
WRITPROT	Y N	Indicates that this volume is write protected. Indicates that this volume is not write protected.

Table 2 shows the valid fields, field values, and value descriptions for updating object tape volumes:

Table 2. Field values for object tape volumes
Field	Valid values	Definition of value
LOSTFLAG	OFF	The volume lost flag will be reset. OFF is the only valid value for the LOSTFLAG operand.
EXPDATE	yyyymmdd	A valid date that specifies the scheduled expiration date for the volume. If all objects on this volume are not yet expired or deleted, OSMC automatically recalculates this date when the volume is selected for expiration, unless this volume belongs to the Object Backup storage group. This value might be recalculated if an object is stored to this volume prior to the expiration of the volume.
FULL	Y N P	Indicates that this volume is full. Indicates that this volume is not full, or that it is not writable. (See SETOAM keyword definitions for STORAGEGROUP subparameters for a discussion of the TAPEPERCENTFULL parameter.) Note: OAM recalculates the PERCENTFULL and FULL status for volumes during initialization. Indicates that this volume has been marked permanently full by the F OAM,UPDATE,VOLUME command, so this volume's full status will not be reevaluated during subsequent OAM initialization and is retained across OAM initialization.
PFULL	0–100	Decimal value in the range of 0 to 100 that specifies the current percentage full for this object tape volume. This value might be recalculated by OAM initialization or after a write request to this volume.
READABLE	Y N	Indicates that this volume is readable. Indicates that this volume is not readable.
WRITABLE	Y N	Indicates that this volume is writable. Indicates that this volume is not writable.