z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Starting a recovery for an optical or tape volume

z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
SC23-6866-00

The following fragment shows the syntax for the RECOVERY command. For the complete syntax for all F OAM,START commands, see Starting OSMC functions.
Read syntax diagramSkip visual syntax diagram
>>-+-MODIFY-+--------------------------------------------------->
   '-F------'   

                                    .-,BACKUP1-.               
>--OAM,-+-START-+-,-RECOVERY,volser-+----------+-+---------+---><
        '-S-----'                   '-,BACKUP2-' '-,DELETE-'   

To recover an optical or tape volume:

  1. Enter the following RECOVERY command:
    F OAM,START,RECOVERY,volser,BACKUP1

    where volser is the volume serial number of one of the volumes that is being recovered.

    If more than one backup copy of the objects exists, you can select whether to use the first or second backup copy for the recovery by specifying BACKUP1 or BACKUP2 on the F OAM,START,RECOVERY command when recovering a PRIMARY volume. If you omit BACKUP1 and BACKUP2, OAM recovers the first backup copy of the object by default.

    To recover a primary volume, all of the backup volumes containing backup copies of the object on the primary volume are needed whether they are optical or tape. Also, to recover a backup volume, each Object storage group must be searched for objects that have a backup copy on the backup volume to be recovered. For each of these objects, the primary copy is used to recover the backup volume. The primary copy of these objects could be on disk (DB2 or file system), optical, or tape. The Volume Recovery utility must identify the optical and tape volumes that are needed for the recovery.

    Requirement: The RECOVERY command has the following requirements:
    • The optical or tape volume that is specified on the command is not controlled by another OAM within the OAMplex.
    • Unmounted shelf-resident volumes must be available to the instance of OAM on which the command was entered.

    If the member name associated with the optical or tape volume serial number specified on this command is not the member name for this instance of OAM, the command fails. OAM issues message CBR1068I.

    _______________________________________________________

  2. The system issues the following messages:
    CBR1000I OAM START command execution scheduled.
     
    CBR9800I  OAM Volume Recovery starting for volumes volser1 and volser2.
     
    CBR9827I  OAM Volume Recovery. The following TAPE volumes are needed
              for recovery: volser1 volser2 volser3 volser4 volser5
              volser6 volser7 volser8 volser9
    
    CBR9824I  OAM Volume Recovery. The following OPTICAL volumes are needed
              for recovery: volser1 volser2 volser3 volser4 volser5
              volser6 volser7 volser8 volser9.

    Message CBR9800I indicates that volume recovery has started for volumes volser1 and volser2. In situations where a tape volume is being recovered, volser2 is labeled as N/A.

    Message CBR9824I gives you a list of optical volumes to retrieve that are identified by volser-n. This message allows you to get the optical volumes that are needed for recovery processing.

    Message CBR9827I gives you a list of tape volumes to retrieve that are identified by volser-n. This message allows you to get the tape volumes that are needed for recovery processing.

    _______________________________________________________

  3. For the volumes listed in messages CBR9827I and CBR9824I, the system issues the following message:
    CBR9810D  Reply ‘QUIT’ to terminate or ‘GO’ to proceed with recovery.

    _______________________________________________________

  4. If all the volumes are not available, reply QUIT to terminate recovery, and start again when the volumes have been retrieved.

    If you reply QUIT to CBR9810D, the system issues the following messages:

    CBR9862I Volume Recovery status for volumes volser1 and volser2 is not available.
    CBR9819I OAM Volume Recovery is ending for volumes volser1 and volser2

    _______________________________________________________

  5. If the volumes are available, reply GO to CBR9810D.

    _______________________________________________________

  6. The system issues the following message for each optical volume listed in message CBR9824I:
    CBR4400A Mount volume volser on drive drive-name. 
     Shelf location is shelfloc.

    _______________________________________________________

  7. The system issues the following message for each tape volume that is listed in the message CBR9827I:
    IEC501A M drive-Addr,volser,label,,,,data_set_name.

    Message CBR9824I might identify volumes that are either library-resident or shelf-resident optical volumes. The system automatically mounts the library-resident optical volumes; therefore, a mount message is not issued for them. The mount message CBR4400A requests only shelf-resident optical volumes for recovery.

    _______________________________________________________

  8. Mount the optical volume that is identified by volser in message CBR4400A and any tape volumes identified by volser in message IEC501A.

    When recovery is complete, the system issues the following message:

    CBR9819I OAM Volume Recovery is ending for volumes volser1 and volser2

    _______________________________________________________

The following is a sample of the F OAM,START,RECOVERY,volser command:
F OAM,S,RECOVERY,WG360A,BACKUP2

CBR1000I OAM S command execution scheduled.                            
CBR9800I OAM Volume Recovery starting for volumes WG360A and WG360B.    
CBR9827I OAM Volume Recovery.                                        
The following TAPE volumes are needed for recovery:                     
 TNN005                                                                 
CBR9824I OAM Volume Recovery.                                       
The following OPTICAL volumes are needed for recovery:                  
 WG688A                                                                 
CBR9810D Reply 'QUIT' to terminate or 'GO' to proceed with recovery.

If you reply GO, the system issues the following messages:
                                                                
CBR9852I Volume Recovery Utility processing objects in storage group GROUP22 
         for volume WG360A. 
IEC501A M 1D04,TNN005,SL,COMP,OAM,OAM,OAM.BACKUP2.DATA 
CBR4401I Volume WG830B mounted on drive P9D3. 
CBR9863I Volume Recovery status for volumes WG360A and WG360B. 
  Total: 5, Attempted: 5, Successful: 5, Unsuccessful: 0, Remaining: 0.
CBR9819I OAM Volume Recovery is ending for volumes WG360A and WG360B.    

If you reply QUIT, the system issues the following messages:
                                     
CBR9862I Volume Recovery status for volumes WG360A and WG360B is not available.                                                           
CBR9819I OAM Volume Recovery is ending for volumes WG360A and WG360B.

If any errors occur during the volume recovery process, additional messages might be issued identifying the errors.

Message CBR9863I provides statistics for volume recovery status. The statistics include: Total, Attempted, Successful, Unsuccessful, and Remaining. These statuses have the following meanings:
Total
The total number of objects found on volser1 and volser2
Attempted
The total number of objects for which processing has begun in this utility for volser1 and volser2
Successful
The total number of objects successfully recovered for volser1 and volser2 and written to other volumes
Unsuccessful
The total number of attempted objects for which processing has begun in this utility, but which were not successfully recovered for volser1 and volser2. This number represents the number of objects that started processing but did not complete successfully.
Remaining
The total number of objects that were not recovered.
The text of the message follows:
CBR9863I Volume Recovery status for volumes volser1 and volser2. 
          Total: total, Attempted: attempted, Successful: successful
          Unsuccessful: unsuccessful, Remaining: remaining
If you attempt to recover a primary volume containing one or more objects that do not have backup copies at the requested level, OAM issues message CBR9864I. Processing will continue for objects that do have a backup, but the DELETE option, if specified, is ignored since not all objects could be recovered.
CBR9864I A total of object-count objects on volumes volser and volser2 do not have 
         a {1st|2nd} backup copy.

For a description of the messages, see z/OS MVS System Messages, Vol 4 (CBD-DMO).

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014