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.
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----'
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 |
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 |
Indicates that this volume is readable. |
WRITABLE | Y |
Indicates that this volume can be written to. |
WRITPROT | Y |
Indicates that this volume is write protected. |
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 |
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 |
Indicates that this volume is readable. |
WRITABLE | Y |
Indicates that this volume is writable. |