IMS Version 9

/RECOVER

Format

Read syntax diagramSkip visual syntax diagram/RECOVER Command: ADD

>>-+-/RECOVER-+--ADD--+----------------------------+------------>
   '-/REC-----'       '-+-RCVTOKEN-+--recoveryname-'
                        '-RCK------'

   .-OFFLINE---.
>--+-----------+--+---------+--+-------------------------+------>
   +-STAGLOBAL-+  +-USEDBDS-+  '-SMSOPTS--+------------+-'
   '-STALOCAL--'  '-USEAREA-'             '-optionname-'

           .----------.
           V          |
>--+-AREA----areaname-+-------+--------------------------------><
   |          .-----------.   |
   |          V           |   |
   +-CAGROUP----groupname-+---+
   |     .--------.           |
   |     V        |           |
   +-DB----dbname-+-----------+
   |       .----------------. |
   |       V                | |
   +-DBDS----dbname--ddname-+-+
   |          .-----------.   |
   |          V           |   |
   +-DBDSGRP----groupname-+---+
   |           .-----------.  |
   |           V           |  |
   '-RECOVGRP----groupname-+--'

Read syntax diagramSkip visual syntax diagram/RECOVER Command: REMOVE

>>-+-/RECOVER-+--REMOVE--+-RCVTOKEN-+--recoveryname------------->
   '-/REC-----'          '-RCK------'

>--+---ALLENTRIES-------------+--------------------------------><
   |       .----------.       |
   |       V          |       |
   +-AREA----areaname-+-------+
   |        .-----------.     |
   |        V           |     |
   +-CAGRP----groupname-+-----+
   |     .--------.           |
   |     V        |           |
   +-DB----dbname-+-----------+
   |       .----------------. |
   |       V                | |
   +-DBDS----dbname--ddname-+-+
   |          .-----------.   |
   |          V           |   |
   +-DBDSGRP----groupname-+---+
   |           .-----------.  |
   |           V           |  |
   '-RECOVGRP----groupname-+--'

Read syntax diagramSkip visual syntax diagram|/RECOVER Command: START
|
|>>-+-/RECOVER-+--START--+-RCVTOKEN-+--recoveryname-------------->
|   '-/REC-----'         '-RCK------'
|
|   .-ERRORABORT-.
|>--+------------+--+------------+--+--------+------------------->
|   '-ERRORCONT--'  '-READNUM--n-'  '-VERIFY-'
|
|   .-OFFLINE---.
|>--+-----------+--+--------------------------------------------+-><
|   +-STAGLOBAL-+  '-RCVTIME--time-stamp--+-------------------+-'
|   '-STALOCAL--'                         '-PITR--+---------+-'
|                                                 '-NOCHECK-'
|
Read syntax diagramSkip visual syntax diagram|/RECOVER Command: STOP through  TERMINATE
|
|>>-+-/RECOVER-+-+-STOP--+-ALLENTRIES-+--+------+-+-------------><
|   '-/REC-----' |       '-ALLENT-----'  '-SAVE-' |
|                '-TERMINATE----------------------'
|

Environments and Keywords

Table 140 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 140. Valid Environments for the /RECOVER Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/RECOVER X X
ADD X X
ALLENTRIES X X
AREA X X
CAGROUP X X
DB X X
DBDS X X
DBDSGRP X X
ERRORABORT X X
ERRORCONT X X
NOCHECK X X
OFFLINE X X
PITR X X
RCVTIME X X
RCVTOKEN X X
READNUM X X
RECOVGRP X X
REMOVE X X
SMSOPTS X X
STAGLOBAL X X
STALOCAL X X
START X X
STOP X X
USEAREA X X
USEDBDS X X
|VERIFY X X

Usage

/RECOVER commands are used with the recovery list of database data sets and areas.

In an IMSplex, the /RECOVER command initiates the operation of the Database Recovery facility. OM sends the /RECOVER command to one IMS.

/RECOVER ADD

Usage

The /RECOVER ADD command is used to add database data sets and areas to a list (recovery list) of database data sets and areas to be recovered using the Online Recovery Service. The database data sets and areas can be specified as database data sets, areas, databases, or groups.

|Successful completion of a /RECOVER ADD command results in the specified database data sets and areas being |added to a recovery list. Database data sets and areas can be added to a recovery |list by specifying one or more database data sets, databases, change |accumulation groups (CAGROUP), database data set groups (DBDSGRP), or recovery |groups (RECOVGRP). If a database or group is specified, all database data sets |and areas making up the database or group are added to a recovery |list. If the a specified database is a master database for a partitioned HALDB, |all database data sets from all partitions that make up the HALDB are |added to a recovery list. All groups (including databases) are defined |in DBRC.

|Database data sets and areas must be registered with |DBRC to be recovered with the IMS Recovery Services. If the database data set, |area, or group name is not known to DBRC, it is not added to a recovery |list and a message is issued.

If a database data set or area specified in a /RECOVER ADD command (individually or as part of a group) is already on a recovery list, processing for the duplicate is ignored and a message is issued. Other database data sets and areas that are not duplicates are processed normally.

This command can be issued in IMS DBCTL and IMS DB/DC environments.

Examples of using the /RECOVER ADD command are shown in:

| |
OFFLINE
|
With this option, the database remains offline from the IMS |system at the completion of the recovery. This option is used to |allow the database administrator to verify that the recovery has |completed successfully and the databases are ready for use. This |is the default if it is not specified on the /RECOVER START command. | |

The IMS system performing the recovery has EXCLUSIVE authorization |of the database to perform the recovery. The OFFLINE option allows |the IMS system to unauthorize the databases at the completion of |the recovery without issuing a START command. This will leave the databases available for processing. |If a PITR option has been used in a recovery, the database data |set in the RECON is IMAGE COPY NEEDED.

|
|
STAGLOBAL
|
This option is used when the full function database(s) and |Fast Path areas are used in a SYSPLEX data sharing environment. |A /START DB command with the GLOBAL option is issued on the IMS system |which ran the recovery for all full function databases affected |by recovery. A /START AREA command with the GLOBAL option is used on the IMS system |which ran the recovery for all Fast Path areas recovered. This option makes |the database(s) available to IMS transactions as soon as all the |DBDSs in the recovery list have been recovered. Authorization to |use the database is returned to IMS. |
|
STALOCAL
|
This option is used when the DRF is being executed in the |operational IMS system where the database(s) is used. A /START DB command is issued on the IMS system which ran the recovery |for all full function databases affected by recovery. A /START AREA is issued on the IMS system which ran the recovery for all |Fast Path areas recovered. Fast Path databases' are not |started with the /START DB command. Only one option needs to be specified and it applies |to all DBDSs and areas added to the recovery list. |
|
USEDBDS or USEAREA
|
These options are for Fast Path areas, full function, |and HALDB DBDS. When specified, DRF does not need to restore the |image copy before applying log updates. You can use this option |when you restore image copies prior to recovery. | | |
Note:
|
You must restore non-standard image copies prior |to recovery.
| |

This parameter determines whether or not DRF will restore the |image copy for a DBDS before applying log updates.

|
|
RCVTOKEN | RCK
|
Specifies the unique identifier associated with |a recovery list that the /RECOVER ADD command operates against. RCVTOKEN is optional. If it is |not specified, IMS generates a recovery name. However, if the command |is intended to add entries to an existing recovery list, RCVTOKEN |must be specified with the intended recovery list token recoveryname. |When RCVTOKEN is specified in a command, it must come before any |keywords that identify the names of database data sets, areas, or |groups. | |
|
recoveryname
|
|Specifies the unique recovery token |associated with the recovery list that the /RECOVER ADD command operates against. This token can be up to eight characters |in length. |
|
|
|
SMSOPTS
|
Specifies that the DFSMSdss options are to be associated with |the entries being added to the recovery list. The options are only |used when restoring image copies created by the Image Copy 2 utility. | |
|
optionname
|
Specifies a unique SMS option. | |
|
DELCAT
|
Specifies that the data set is to be restored using the DFSMSdss |optional keyword, DELETECATALOGENTRY. | |

Caution: This option is to be used with |extreme care. DELCAT is required if SMSOPTS is supplied. This option allows you |to recover from a scenario where entire volumes are lost but the |catalog entries remain. When this option is specified, SMS deletes |the prior catalog entries for the database data sets and areas being |restored as part of recovery. Refer to the DFSMSdss Storage Administration Reference manual before |using this option. Read the caution under the DELETECATALOGENTRY |option of the RESTORE command.

|
|
|
|
|
|
AREA
|
Specifies that one or more Fast Path areas are to |be added to a recovery list. | |
|
areaname
|
Specifies a unique Fast Path area. |
|
|
|
CAGROUP
|
Specifies that one or more change accumulation groups, |as defined in the RECON data sets, are to have their database data sets and |areas added to a recovery list. | |
|
groupname
|
Specifies that the database data sets and areas belonging |to the named CA group are to be added to the recovery list. |
|
|
|
DB
|
Specifies that all the areas or full function database data sets |for one or more databases are to be added to a recovery list. | |
|
dbname
|
Specifies the database and the associated database |data sets or areas that are to be added to a recovery list. |
|
|
|
DBDS
|
Specifies that one or more full function database data sets are to be added |to a recovery list. | |
|
dbname ddname
|
Specifies a full function database data set is to be added to |a recovery list. Full function database data sets are specified with the /RECOVER ADD DBDS command as an ordered pair. The first member of the pair |is the database name. The second member is the DD name. If more |than one full function database data set is specified, the complete ordered |pair must be specified for each database data set. All parameters must be separated |by at least one blank space. |
|
|
|
DBDSGRP
|
Specifies that one or more DBDS groups as defined |in the RECON data sets will have their database data sets and areas added to |a recovery list. | |
|
groupname
|
Specifies that the database data sets and areas belonging |to the named DBDS group are to be added to the recovery list. |
|
|
|
RECOVGRP
|
Specifies that the listed groups are recovery groups. |A recovery group is a group of full-function databases, DEDB areas, |or both that the user defines to IMS as related. All DBDSs that |make up the full-function databases and all the DEDB areas making |up the recover groups specified in the command are added to a recovery |list. | |

For additional information on recovery groups, see the IMS Version 9: DBRC Guide and Reference and the IMS Version 9: Administration Guide: Database Manager.

| |
|
groupname
|
Specifies the unique name of the group whose database data sets and |areas are to be added to a recovery list. |
|
|

/RECOVER REMOVE

Usage

|A /RECOVER REMOVE command removes some or all database data sets and areas from the recovery |list. It can only be issued prior to issuing the /RECOVER START command. Use the /RECOVER STOP command to remove entries after recovery has started.

If /RECOVER REMOVE is issued with one or more databases or groups, all database data sets and areas that are part of the database or group specified are removed from the recovery list. If a /RECOVER REMOVE command results in the removal of every data set or area entry from the recovery list, the recovery list is eliminated.

This command executes in IMS DBCTL and IMS DB/DC environments.

Examples of using the /RECOVER REMOVE command are shown in:

| |
RCVTOKEN | RCK
|
Specifies the unique identifier associated with |the recovery list that the /RECOVER REMOVE command operates against. The RCVTOKEN keyword must come |before any keywords that identify the names of database data sets, |areas, or groups. | |
|
recoveryname
|
|Specifies the unique recovery token |associated with the recovery list that the /RECOVER REMOVE command operates against. This token can be up to eight characters |in length. |
|
|
ALLENTRIES
Specifies that the recovery list is to be eliminated.
AREA
Specifies that one or more Fast Path areas are to be removed from the recovery list.
areaname
Specifies a unique Fast Path area.
CAGROUP
Specifies that the database data sets and areas of one or more change accumulation groups as defined in the RECON data sets are to be removed from the recovery list.
groupname
Specifies that the database data sets and areas belonging to a specific CA group are to be removed from the recovery list.
DATAGROUP
Specifies that the database data sets and areas of one or more database groups (as defined in the RECONs) are to be removed from the recovery list.
groupname
Specifies the database data sets and areas of the unique group name that are to be removed from the recovery list.
DB
Specifies that the full function database data sets or Fast Path areas making up one or more databases are to be removed from the recovery list.
dbname
Specifies database data sets or areas of the database that are to be added to a recovery list.
DBDS
Specifies that one or more full function database data sets are to be removed from the recovery list.
dbname
Specifies the database data sets or areas of the database that are to be removed from the recovery list.
ddname
Specifies the DD name of the database data set. If DBDS is specified on the /RECOVER REMOVE command, dbname and ddname must be specified together.
DBDSGRP
Specifies that the database data sets and areas of one or more DBDS groups as defined in the RECON data sets are to be removed from the recovery list.
groupname
Specifies the database data sets and areas of the group that are to be removed from the recovery list.
RECOVGRP
Specifies that this group is a recovery group. All DBDSs that make up the full-function databases and all the DEDB areas are removed from the recovery list.
groupname
Specifies the database data sets and areas of the database that are to be removed from the recovery list.

/RECOVER START

Usage

|Use the /RECOVER START command to start the recovery process for all the members |of a recovery list, which includes performing the following tasks:

|Only one /RECOVER START command is allowed to execute in one IMS at a time. If DRF |is to run in conjunction with multiple IMSs simultaneously, ensure |that log contention situations do not occur. To avoid log contention |situations, ensure that recovery instances that would read the same |log data sets do not execute simultaneously in multiple IMSs.

|You can choose to automatically /START any or all members of the recovery list after successful |completion of recovery, either on all IMS systems on which they |are defined or just the one where the recovery is executed.

|If ERRORABORT is in effect, the recovery list will |not start until all the DBDSs in the list can be authorized for |recovery. This is not true if the ERRORCONT parameter is specified |on the /RECOVER START command. Instead, the recovery will continue.

|If coordinated online change removes from the system |any database data set or area that has been previously added to |a recovery list, message DFS4266I with reason code NOT FOUND will be issued after the /RECOVER START command for that recovery list is entered.

Examples of using the /RECOVER START command are shown in:

RCVTOKEN | RCK
Specifies the token of the recovery list that will be processed. When RCVTOKEN is specified in a command, it must come before any keywords that identify the names of database data sets, areas, or groups.
recoveryname
|Specifies the unique recovery token |associated with the recovery list to be processed. This token can |be up to eight characters in length.
ERRORABORT
Specifies that recovery stops for all entries in the recovery list if recovery of any database data set can not be completed. ERRORABORT is the default.
ERRORCONT
Specifies that recovery is to continue if recovery is able to complete processing for any database data set.
READNUM n
Specifies the number of input devices used in parallel during recovery. Image copies are restored using the number of input devices specified by n. When image copies are restored, log data sets are read using the number of input devices specified by n.
| |
VERIFY
|
Specifies the report only execution and obtains a list of |the log, change accumulation, and image copy data sets required |to process recovery for the associated recovery list. This option |allows users to perform set up procedures before invoking the recovery |process. |
| |
OFFLINE
|
This option leaves all the databases offline after |the recovery is complete. When the recovery is complete, DRF will |unauthorize the databases. This leaves the databases in a state |that allows normal DBRC processing. |
| |
STAGLOBAL
|
This option is used in a sysplex data sharing environment |or with two IMSs sharing data on the same central processing complex |(CPC). A /START DB command with the GLOBAL option is issued internally for DL/I |databases and a /START AREA command with the GLOBAL option is issued for the Fast Path |areas. OFFLINE, STALOCAL, or STAGLOBAL options specified on the /RECOVER START command are used only for database data sets and areas that |were added and did not have any of those options specified. |
| |
STALOCAL
|
This option is used to start the databases on the IMS system |that ran the DRF recovery. A /START DB command with the LOCAL option is issued internally. |
RCVTIME
Specifies the time stamp to which a point in time or time stamp recovery is to be performed.

For information about time stamp recovery characteristics, see IMS Version 9: Utilities Reference: Database and Transaction Manager.

time-stamp
|The time-stamp must have a format that is recognizable |to IMS. For additional information on acceptable time stamp formats, |see the IMS Version 9: DBRC Guide and Reference. Note the UTC offset |portion of a time stamp cannot be specified using a symbolic value |in this command. | |

Additionally, the timestamp must by surrounded by single quotation marks |('). For example: |

|
/RECOVER START RCVTOKEN R1 RCVTIME '022671213156'
PITR
Specifies that a timestamp recovery (TSR) will be performed to the time specified with the RCVTIME parameter regardless if there are any active database allocations for the specified database data sets.
NOCHECK
If a portion of the database data sets making up a database are in the recovery list being started, NOCHECK specifies that the Online Recovery Service will not stop a timestamp recovery or a timestamp recovery to any prior point in time (PITR) if one of the following situations occurs:

/RECOVER STOP

Usage

|A /RECOVER STOP command stops recovery for all database data sets and areas on the recovery |list. The command can only be issued for a recovery list that has |had /RECOVER START issued against it. If the /RECOVER STOP is issued before the /RECOVER START command, it is rejected. If it is issued after the /RECOVER START command, recovery is stopped for all database data sets in |the recovery list. After a /RECOVER STOP command successfully processes, subsequent /RECOVER STOP commands are rejected.

If /RECOVER STOP ALLENT is issued, all recovery processing for the affected recovery list halts, and the existing recovery list is deleted.

Examples of using the /RECOVER STOP command are shown in:

ALLENTRIES
Specifies that recovery is to be aborted for all database data sets and areas (all entries) in the recovery list.
SAVE
Specifies that the recovery list is not to be deleted when recovery is stopped. This parameter is only allowed with the ALLENT parameter after recovery has been initiated with the /RECOVER START command.
AREA
Specifies that recovery processing is to be stopped for the specified Fast Path areas.
areaname
Specifies a unique Fast Path area.
CAGROUP
Specifies that recovery processing is to be stopped for the database data sets and areas making up the specified change accumulation groups as defined in the RECON data sets.
groupname
Specifies the unique name of the group whose database data sets and areas are to have recovery processing be stopped.
DATAGROUP
Specifies that recovery processing is to be stopped for database data sets and areas making up the specified database groups as defined in the RECON data sets.
groupname
Specifies the unique name of the group whose database data sets and areas are to have recovery processing be stopped.
DB
Specifies that recovery processing is to be stopped for the full function database data sets or Fast Path areas that make up the specified databases.
dbname
Specifies the database whose database data sets or areas are to be added to a recovery list.
DBDS
Specifies that recovery processing is to be stopped for the specified full function database data sets.
dbname
Specifies the database whose database data sets or areas are to be added to a recovery list.
ddname
The 8 character identifier associated with the data set name and data set characteristics. dbname and ddname must be specified together if DBDS is specified on the /RECOVER REMOVE command.
DBDSGRP
Specifies that recovery processing is to be stopped for the database data sets and areas making up the specified DBDS groups as defined in the RECON data sets.
groupname
Specifies the unique name of the group whose database data sets and areas are to have recovery processing be stopped.
RECOVGRP
Specifies that this group is a recovery group. A recovery group is a group of full-function databases or DEDB areas that are considered to be related. All DBDSs that make up the full-function databases and all the DEDB areas are removed from the recovery list.
groupname
Specifies the unique name of the group whose database data sets and areas are to have recovery processing be stopped.

/RECOVER TERMINATE

Usage

|The TERMINATE option will delete all lists in BEING |BUILT status and terminate the DRS address space.

|If a recovery is in progress the recovery will ignore |the /RECOVER TERMINATE command and continue to process. When it completes, another /RECOVER TERMINATE command is required. It will not take effect automatically. |If you would like to force DRF down while a recovery is running, |you must issue the /RECOVER STOP ALLENT command first. This will stop the recovery and then you can |enter the /RECOVER TERMINATE command to terminate the DRF address space.

An example of using the /RECOVER TERMINATE command is shown in Example for /RECOVER TERMINATE Command

Examples

Examples for /RECOVER ADD Commands

The COMMAND IN PROGRESS message is issued for /RECOVER ADD commands but is not shown in the following examples.

Example 1 for /RECOVER ADD Command

|In this example, a /RECOVER ADD STALOCAL command is issued for full function database data sets. Following a |successful recovery of the database data sets, the database is started |on the IMS that runs the recovery. |

|
/REC ADD STALOCAL DBDS DBNAME1 DDNAME1 DBNAME2 DDNAME2
|DFS4299I FRD6011I THE FOLLOWING ENTRIES ARE ADDED TO THE RECOVERY LIST:
|DFS4299I FRD6003I DBNAME1 DDNAME1
|DFS4299I FRD6003I DBNAME2 DDNAME2

Example 2 for /RECOVER ADD Command

In this example, a /RECOVER ADD command is issued for full function database data sets. One of the database data sets is not registered in RECON and is rejected.

|/RECOVER ADD DBDS DBNAME1 DDNAME1 DBNAME1 DDNAME2
|DFS4299I FRD6011I THE FOLLOWING ENTRIES ARE ADDED TO THE RECOVERY LIST:
|DFS4299I FRD6003I DBNAME1 DDNAME1
|DFS4299I FRD6010W UNABLE TO ADD TO RECOVERY LIST, NOT FOUND IN RECON, DBNAME2 DDNAME2

Example 3 for /RECOVER ADD Command

In this example, a /RECOVER ADD command is issued for full function database data set. The database that database data set belongs to is still authorized to two IMSs.

/RECOVER ADD DBDS DBNAME1 DDNAME1
DFS4299I FRD6011I THE FOLLOWING ENTRIES ARE ADDED TO THE RECOVERY LIST:
DFS4299I FRD6003I DBNAME1 DDNAME1
DFS4299I FRD6003I DBNAME1 DDNAME1 AUTHORIZED BY IMS1
DFS4299I FRD6003I DBNAME1 DDNAME1 AUTHORIZED BY IMS2

Example 4 for /RECOVER ADD Command

Databases can be specified as a whole with the /RECOVER ADD DB command. In this example, a full function database and a Fast Path database have all their database data sets and areas, respectively, added to the recovery list.

/REC ADD DB FFDB1 FPDB2
DFS4299I FRD6011I THE FOLLOWING ENTRIES ARE ADDED TO THE RECOVERY LIST:
DFS4299I FRD6003I FFDB1 DDNAME1
DFS4299I FRD6003I FFDB1 DDNAME2
DFS4299I FRD6003I DBAREA3 DDAREA3
DFS4299I FRD6003I DBAREA4 DDAREA4

Example 5 for /RECOVER ADD Command

If more than one DATAGROUP is specified, the group names must be separated by at least one blank space. In this example, a /RECOVER ADD command is issued for two database groups.

/REC ADD DATAGROUP GRPNAME1 GRPNAME2
DFS4299I FRD6011I THE FOLLOWING ENTRIES ARE ADDED TO THE RECOVERY LIST:
DFS4299I FRD6003I DBNAME3 DDNAME3
DFS4299I FRD6003I DBNAME4 DDAREA4
DFS4299I FRD6003I DBNAME5 DDNAME5
DFS4299I FRD6003I DBNAME6 DDAREA6
DFS4299I FRD6003I DBNAME7 DDNAME7
DFS4299I FRD6003I DBNAME8 DDAREA8

Example 6 for /RECOVER ADD Command

If one or more RECOVGRP is specified, the group names must be separated by at least one blank. In this example, a /RECOVER ADD command is issued for two recovery groups.

/REC ADD RECOVGRP GRPNAME1 GRPNAME2
DFS4299I FRD6011I THE FOLLOWING ENTRIES ARE ADDED TO THE RECOVERY LIST:
DFS4299I FRD6003I DBNAMEA DDNAMEA
DFS4299I FRD6003I DBNAMEB DDAREAB
DFS4299I FRD6003I DBNAMEC DDNAMEC
DFS4299I FRD6003I DBNAMED DDAREAD
DFS4299I FRD6003I DBNAMEE DDNAMEE
DFS4299I FRD6003I DBNAMEF DDAREAF

Examples for /RECOVER REMOVE Command

The command IN PROGRESS message is issued for /RECOVER commands but is not shown in these examples.

Example 1 for /RECOVER REMOVE Command

|As with the /RECOVER ADD command, full function database data sets and Fast Path areas are specified |with the /RECOVER REMOVE DBDS command. With the DBDS option, each full function database data set must |be specified as an ordered pair. Each element must be separated |by at least one blank space. The first element of the pair is the |database name. The second element is the DDNAME. In this example, |a /RECOVER REMOVE command is issued for a single full function database data set. |

|
/RECOVER REMOVE RCVTOKEN DFS00001 DBDS DBNAME1 DDNAME1
| 
|DFS4299I FRD6016I THE FOLLOWING ENTRIES WERE REMOVED FROM THE RECOVERY LIST:
|DFS4299I FRD6003I DBNAME1 DDNAME1

If more than one full function database data set is specified in a /RECOVER REMOVE DBDS command, each dbname/ddname ordered pair must be separated by at least one blank space.

/RECOVER REMOVE RCVTOKEN DFS00001 DBDS DBNAME1 DDNAME1 DBNAME3 DDNAME3
 
DFS4299I FRD6016I THE FOLLOWING ENTRIES WERE REMOVED FROM THE RECOVERY LIST:
DFS4299I FRD6003I DBNAME1 DDNAME1
DFS4299I FRD6003I DBNAME3 DDNAME3

Example 2 for /RECOVER REMOVE Command

In this example, a /RECOVER REMOVE command is issued for a single Fast Path area that was not added to the recovery list.

|/REC REMOVE RCVTOKEN DFS00001 AREA DDAREA1
| 
|DFS4299I FRD6018W UNABLE TO REMOVE AREA DDAREA1: NOT IN RECOVERY LIST

Example 3 for /RECOVER REMOVE Command

In this example, a /RECOVER REMOVE command is issued for a full function database and Fast Path database. All full function database data sets and Fast Path areas making up the two databases are removed from the recovery list.

/REC REMOVE RCVTOKEN DFS00001 DB FFDB1 FFDB2
 
DFS4299I FRD6016I THE FOLLOWING ENTRIES WERE REMOVED FROM THE RECOVERY LIST:
DFS4299I FRD6003I FFDB1 DDNAME1
DFS4299I FRD6003I FFDB1 DDNAME2
DFS4299I FRD6003I DBAREA3 DDAREA3
DFS4299I FRD6003I DBAREA4 DDAREA4

Example 4 for /RECOVER REMOVE Command

In this example, a /RECOVER REMOVE command is issued to stop recovery for the entire recovery list.

/REC REMOVE RCVTOKEN DFS00001 ALLENT
 
DFS4299I FRD6016I THE FOLLOWING ENTRIES WERE REMOVED FROM THE RECOVERY LIST:
DFS4299I FRD6003I DBNAME1 DDNAME1
DFS4299I FRD6003I DBNAME2 DDNAME2
DFS4299I FRD6003I DBAREA1 DDAREA1
DFS4299I FRD6003I DBNAME3 DDNAME3
DFS4299I FRD6003I DBAREA4 DDAREA4
DFS4299I FRD6003I DBNAME5 DDNAME5
DFS4299I FRD6003I DBAREA6 DDAREA6
DFS4299I FRD6003I DBAREA7 DDAREA7
DFS4299I FRD6003I DBAREA8 DDAREA8
DFS4299I FRD6017I RECOVERY LIST IS NOW EMPTY

Examples for /RECOVER START Command

The command IN PROGRESS message is issued for /RECOVER commands but is not shown in the following examples.

Example 1 for /RECOVER START Command

In this example, /RECOVER START initiates recovery for the database data sets and areas from previous examples. Recovery continues until it completes or until one of the database data sets or areas is operable.

|/REC START RCVTOKEN RCVTKN1 ERRORCONT
|DFS4299I FRD6021I RECOVERY STARTED FOR:
|DFS4299I FRD6003I DBNAME1 DDNAME1
|DFS4299I FRD6003I DBNAME2 DDNAME2
|DFS4299I FRD6003I DBAREA1 DDAREA1
|DFS4299I FRD6003I DBNAME3 DDNAME3
|DFS4299I FRD6003I DBAREA4 DDAREA4
|DFS4299I FRD6003I DBAREA5 DDAREA5
|DFS4299I FRD6003I DBAREA6 DDAREA6
|DFS4299I FRD6003I DBNAME7 DDNAME7
|DFS4299I FRD6003I DBAREA8 DDAREA8

Example 2 for /RECOVER START Command

In this example, /RECOVER START RCVTOKEN initiates recovery for the database data sets and areas owned by the recovery token RCVTKN2.

/REC START RCVTOKEN RCVTKN2
DFS4299I FRD6021I RECOVERY STARTED FOR:
DFS4299I FRD6003I DBNAME1 DDNAME1
DFS4299I FRD6003I DBNAME2 DDNAME2
DFS4299I FRD6003I DBAREA1 DDAREA1
DFS4299I FRD6003I DBNAME3 DDNAME3
DFS4299I FRD6003I DBAREA4 DDAREA4
DFS4299I FRD6003I DBAREA5 DDAREA5
DFS4299I FRD6003I DBAREA6 DDAREA6
DFS4299I FRD6003I DBNAME7 DDNAME7
DFS4299I FRD6003I DBAREA8 DDAREA8

Example 3 for /RECOVER START Command

In this example, /RECOVER START RCVTOKEN OFFLINE READNUM 6 initiates recovery for the database data sets and areas from previous examples. Recovery will not continue if any error is detected for any member of the recovery list. The database data sets and areas remain offline after recovery completes.

/RECOVER START RCVTOKEN RCVTKN2 OFFLINE READNUM 6
DFS4299I FRD6021I RECOVERY STARTED FOR:
DFS4299I FRD6003I DBNAME1 DDNAME1
DFS4299I FRD6003I DBNAME2 DDNAME2
DFS4299I FRD6003I DBAREA1 DDAREA1
DFS4299I FRD6003I DBNAME3 DDNAME3
DFS4299I FRD6003I DBAREA4 DDAREA4
DFS4299I FRD6003I DBAREA5 DDAREA5
DFS4299I FRD6003I DBAREA6 DDAREA6
DFS4299I FRD6003I DBNAME7 DDNAME7
DFS4299I FRD6003I DBAREA8 DDAREA8

Example 4 for /RECOVER START Command

In this example, /RECOVER START RCVTOKEN ERRORCONT RCVTIME time-stamp is issued. TSR continues until it completes or until one of the database data sets or areas undergoing recovery encounters an error. After recovery completes, a message is issued listing each database data set and area successfully recovered.

|/REC START RCVTOKEN RCVTKN2 ERRORABORT RCVTIME '020011015257' NOCHECK
|DFS4299I FRD6021I RECOVERY STARTED FOR RCVTKN2, ERRORABORT, TSR
|DFS4299I FRD6003I DBNAME1 DDNAME1
|DFS4299I FRD6003I DBNAME2 DDNAME2
|DFS4299I FRD6003I DBAREA1 DDAREA1
|DFS4299I FRD6003I DBNAME3 DDNAME3
|DFS4299I FRD6003I DBAREA4 DDAREA4
|DFS4299I FRD6003I DBAREA5 DDAREA5
|DFS4299I FRD6003I DBAREA6 DDAREA6
|DFS4299I FRD6003I DBNAME7 DDNAME7
|DFS4299I FRD6003I DBAREA8 DDAREA8
|    ...
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME1 DDNAME1
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME2 DDNAME2
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA1 DDAREA1
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME3 DDNAME3
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA4 DDAREA4
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA5 DDAREA5
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA6 DDAREA6
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME7 DDNAME7
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA8 DDAREA8
|DFS4277I RECOVERY COMPLETE FOR:  RCVTKN2

Example 5 for /RECOVER START Command

In this example, /RECOVER START RCVTOKEN RCVTIMEtime-stamp PITR is issued. Point-in-time recovery will continue until it completes or until one of the database data sets encounters an error. A message is issued listing the database data sets and areas that were not in the recovery list, but might need recovery using point-in-time recovery.

|/REC START RCVTOKEN RCVTKN2 RCVTIME '020011015257' PITR
|DFS4299I FRD6021I RECOVERY STARTED FOR RCVTKN2, ERRORCONT, PITR
|DFS4299I FRD6003I DBNAME1 DDNAME1
|DFS4299I FRD6003I DBNAME2 DDNAME2
|DFS4299I FRD6003I DBAREA1 DDAREA1
|DFS4299I FRD6003I DBNAME3 DDNAME3
|DFS4299I FRD6003I DBAREA4 DDAREA4
|DFS4299I FRD6003I DBAREA5 DDAREA5
|DFS4299I FRD6003I DBAREA6 DDAREA6
|DFS4299I FRD6003I DBNAME7 DDNAME7
|DFS4299I FRD6003I DBAREA8 DDAREA8
|    ...
|DFS4299I FRD6024A GROUP MEMBER DBNAME9 DDNAME9 NOT IN RECOVERY LIST: MEMBER OF A GROUP
|DFS4299I FRD6024A GROUP MEMBER DBNAMEA DDNAMEA NOT IN RECOVERY LIST: MEMBER OF A GROUP
|DFS4299I FRD6024A GROUP MEMBER DBAREAB DDAREAB NOT IN RECOVERY LIST: MEMBER OF A GROUP
|DFS4299I FRD6024A GROUP MEMBER DBNAMEC DDNAMEC NOT IN RECOVERY LIST: MEMBER OF A GROUP
|    ...
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME1 DDNAME1
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME2 DDNAME2
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA1 DDAREA1
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME3 DDNAME3
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA4 DDAREA4
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA5 DDAREA5
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA6 DDAREA6
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBNAME7 DDNAME7
|DFS4299I FRD4031I DATASET RESTORE COMPLETE:  DBAREA8 DDAREA8
|DFS4277I RECOVERY COMPLETE FOR:  RCVTKN2

Examples for /RECOVER STOP Command

The COMMAND IN PROGRESS message is issued for /RECOVER commands but is not shown in the following examples.

Example 1 for /RECOVER STOP

In this example, a /RECOVER STOP command is issued to stop recovery for the entire recovery list.

|/REC STOP ALLENT
|DFS4299I FRD6032I THE FOLLOWING ENTRIES WILL HAVE RECOVERY STOPPED:
|DFS4299I FRD6003I DBNAME1 DDNAME1
|DFS4299I FRD6003I DBNAME2 DDNAME2
|DFS4299I FRD6003I DBAREA1 DDAREA1
|DFS4299I FRD6003I DBNAME3 DDNAME3
|DFS4299I FRD6003I DBAREA4 DDAREA4
|DFS4299I FRD6003I DBNAME5 DDNAME5
|DFS4299I FRD6003I DBAREA6 DDAREA6
|DFS4299I FRD6003I DBAREA7 DDAREA7
|DFS4299I FRD6003I DBAREA8 DDAREA8
|DFS4299I FRD6033I ALL ENTRIES IN RECOVERY LIST, ARE BEING STOPPED

Example 2 for /RECOVER STOP

In this example, a /RECOVER STOP ALLENT SAVE is issued after a /RECOVER START command.

|/REC STOP ALLENT SAVE
|DFS4299I FRD6032I THE FOLLOWING ENTRIES WILL HAVE RECOVERY STOPPED:
|DFS4299I FRD6003I DBNAME1 DDNAME1

Example 3 for /RECOVER STOP

In this example, a /RECOVER STOP ALLENT command is issued with no recovery in progress.

|/REC STOP ALLENT
|DFS4299I FRD6031E UNABLE TO STOP ALLENT: RECOVERY NOT IN PROGRESS

Example for /RECOVER TERMINATE Command

|In this example, a /RECOVER TERMINATE command is issued with no recovery in progress. |

|
/RECOVER TERMINATE
|DFS4299I FRD4202I DATABASE RECOVERY DATA MANAGER TERMINATION COMPLETE

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004