Area Recovery Retry control statement

Area Recovery Retry control statements are used by IMS DEDB Fast Recovery to recover areas selectively without affecting other areas.

If a connectivity error occurs during an IMS DEDB Fast Recovery execution for which CFRET=Y is specified, and a block-level data-sharing VSO area is being recovered, IMS DEDB Fast Recovery gives up the recovery for the area but does not make the area unavailable. After removing the cause of the error, prepare a set of Area Recovery Retry control statements to recover the areas selectively and thus prevent other areas from being affected. The RETRY (CFreason) status for such an area is shown in the DEDB Area Status list. CFreason indicates the cause of the error.

In the first run of IMS DEDB Fast Recovery, a skeleton of Area Recovery Retry control statement can be generated in the data set that is specified by the RETLIST DD statement. In the second run, that is, when IMS DEDB Fast Recovery is run only for selected areas, IMS DEDB Fast Recovery takes in the Area Recovery Retry control statements from the data set that is specified in the AREASLCT DD statement.

Related reading: See the description of the RETLIST DD statement in JCL requirements.
Subsections:

Rules for Area Recovery Retry control statement

  • A control statement and a keyword are coded in free format (columns 1–72) in an 80-byte record.
  • A control statement with an asterisk (*) in column 1 is treated as a comment.
  • The first line must contain only one-character string, INCLUDE or EXCLUDE.
    INCLUDE
    Specifies the names of the areas to be recovered in the subsequent lines.
    EXCLUDE
    Specifies the names of the areas not to be recovered in the subsequent lines.
  • The second or later lines have area names. Each name is separated from other names by one or more blanks.
  • The maximum number of area names that can be specified is 1000.

Examples of Area Recovery Retry control statement

If IMS DEDB Fast Recovery is to recover only the specified areas, the statement is as follows:

//AREASLCT   DD   *
INCLUDE
* THE FOLLOWING AREAS ARE RECOVERED
AREA0001 AREA0002 AREA0003 AREA0004 AREA0005 AREA0006
AREA0007 AREA0008 AREA0009 AREA0010 AREA0011 AREA0012
/*

If IMS DEDB Fast Recovery is to recover all areas except for the areas specified, the statement is as follows:

//AREASLCT   DD   *
EXCLUDE
* THE FOLLOWING AREAS ARE NOT RECOVERED
AREA0001 AREA0002 AREA0003 AREA0004 AREA0005 AREA0006
AREA0007 AREA0008 AREA0009 AREA0010 AREA0011 AREA0012
/*