Reformatting a 3995 optical disk

Use the OAM reformat utility (the TSO/E command OAMUTIL) to perform various tasks against a 3995 optical disk cartridge to reclaim usable space on the cartridge. To invoke this utility, run the CBRSAMUT SAMPLIB job or issue a TSO/E command to start the utility. (See CBRSAMUT for a sample job that can be used within your installation.) This utility allows you to perform the following tasks:

Reformat one or both sides of a 3995 optical disk cartridge.
Reformat and rename the volume serial number of one or both sides of an optical disk cartridge.
Return the volumes back to the SCRATCH storage group (only when there is a request for both sides of the optical disk to be reformatted) to be used for subsequent write requests.

The reformat utility can be run regardless of whether the volume is inside or outside a 3995 optical library, the volume belongs to an Object or an Object Backup storage group, or the media is rewritable or WORM. Reformatting rewritable media reclaims the used space; however, reformatting WORM media cannot reclaim the used space.

For reformatting volumes belonging to an Object storage group, this utility can be run conditionally (using the NOFORCE parameter) or unconditionally (using the FORCE parameter). For reformatting volumes belonging to an Object Backup storage group, this utility can only be run unconditionally (using the FORCE parameter).

When a conditional request is submitted for an OAM PRIMARY optical volume, OAM checks to see if any active primary copies of objects on the volume exist before performing the reformat. If any active object is found, the request fails.

When a conditional request is submitted for an OAM BACKUP optical volume, the request fails for the reformat.

This utility can only be run unconditionally (using the FORCE parameter) for optical volumes that belong to an OAM BACKUP storage group.

When an unconditional request is submitted, there is no verification of whether there are any nonexpired objects still on the volume prior to the operation being performed. The volume is reinitialized if the OAM environment permits it at the time of the request. It is therefore recommended, that before submitting an unconditional reformat request, you should select all Object Directory entries for objects that reside on the requested volume (using SPUFI) to verify that the object can be deleted. Or, you can use the Move Volume utility to move all the objects off the requested volume before performing the reformat. Once an unconditional reformat request is executed successfully, all objects on the requested volume, regardless if the objects are owned by OAM, are all erased or discarded.

Attention: If you use the FORCE parameter or the unconditional form of the format command, be aware that once you request a reformat of the optical disk, there is no reversal. If OAM issues any error messages indicating DB2 or other problems, you are responsible for ensuring that all objects that resided on this volume are no longer referenced in the OAM object directory table.

For a reformat command to execute successfully, the following OAM environment must exist:

No write, relabel, or reformat requests are scheduled for the requested volume.
No eject request is scheduled (for the requested volume or its opposite side).
The volume is not write protected and is not marked not writable.
In an OAMplex environment, the requested volume is controlled by the instance of OAM on which the reformat request was entered.

The following is the syntax for the OAMUTIL REFORMAT command:


                                  .-ONE--.   
>>-OAMUTIL--REFORMAT--old_volser--+------+---------------------->
                                  '-BOTH-'   

>--+----------------------+--+----------------------+----------->
   '-NEWVOL1(new_volser1)-'  '-NEWVOL2(new_volser2)-'   

                              .-NOSCRATCH-.  .-NOFORCE-.   
>--+-----------------------+--+-----------+--+---------+-------><
   '-DRIVENAME(drive_name)-'  '-SCRATCH---'  '-FORCE---'

The following is a description of each of the keywords for this command:

old_volser: Indicates the volume serial number of the volume to be reformatted. The FORCE keyword is required if old_volser belongs to an Object Backup storage group.
ONE | BOTH: An optional parameter. ONE indicates only one side of optical cartridge should be reformatted. This is the default.
BOTH indicates that both sides of the optical disk cartridge should be reformatted.
NEWVOL1(new_volser1): An optional parameter that indicates the new volume serial number for side one of the optical disk cartridge. If not specified, there is no change to the volume serial number of side one of the optical disk cartridge.
NEWVOL2(new_volser2): An optional parameter that indicates the new volume serial number for side two of the optical disk cartridge. If not specified, there is no change to the volume serial number of side two of the optical disk cartridge.
DRIVENAME(drive_name): An optional parameter that indicates a specified operator-accessible drive that is capable of processing this request. This parameter is valid only if the requested optical disk volume is shelf-resident. If this parameter is not specified, or if the requested optical disk volume is library-resident, OAM selects an optical drive in the SMS ACDS capable of processing this request.
NOSCRATCH | SCRATCH: An optional parameter that indicates which storage group the volume should be placed in after reformatting. NOSCRATCH indicates that the volume should remain in the same storage group to which it was assigned before the successful completion of the reformat execution. This is the default.
SCRATCH indicates that both volumes on an optical disk cartridge should be placed in the SCRATCH storage group on successful execution of the reformat request.
NOFORCE | FORCE: An optional parameter that indicates what type of reformat request is being run. NOFORCE indicates that the reformat request is conditional. The utility must verify the existence of any backup copies or active primary copies of objects on the volume before performing the reformat. If these objects exist on the volume, the reformat fails. This is the default.
FORCE indicates that the reformat request is unconditional. This parameter allows you to physically erase all copies of objects on a rewritable optical disk cartridge or discard all copies of objects on a WORM optical disk cartridge without first verifying if there are any backup copies or active primary copies of objects on the volume. The volume is reinitialized even if there are nonexpired objects on the volume. The FORCE option is required when reformatting a volume belonging to an Object Backup storage group.

To reformat a requested optical disk volume, enter the following TSO/E command:

OAMUTIL REFORMAT old_volser BOTH

This system issues the following messages:

CBR4401I Volume old_volser1 mounted on drive drive-name.
 
CBR4465I Volumes old_volser1 and old_volser2 are being reformatted on drive
         drive-name.
 
CBR4401I Volume old_volser2 mounted on drive drive-nam.
 
CBR4462I Volume old_volser1 has been reformatted to new_volser1.
 
CBR4462I Volume old_volser2 has been reformatted to new_volser2.

The following conditions exist upon successful completion of this command:

All object directory entries for the requested volumes are deleted from the 3995 controller, the Object Directory Table, and the Deleted Objects Table.
All space used by the erased objects are reclaimed for rewritable optical disk volumes.
If SCRATCH is specified, both volumes on the optical disk cartridge are returned to the SCRATCH storage group.
If NEWVOL1 is specified, a new row for this new volume serial number for the first side of the optical disk cartridge is added to the Volume Table. The row for the old volume serial number of the requested volume is deleted from the Volume Table. If NEWVOL1 is not specified, the row for the requested volume in the OAM Volume Table is updated.
If NEWVOL2 is specified and it is a both side reformat, a new row for the new volume serial number for the second side of the optical disk cartridge is added to the Volume Table. The row in the Volume Table for the old volume serial number is deleted. If NEWVOL2 is not specified or the request is for a one side reformat, the row in the Volume Table for the opposite side of the requested volume is updated.

For information concerning messages generated from this command, see MVS System Messages.