RCDS: Create a RCDS report

Keywords

BACKUP

A report is written with information about each registered backup in the RCDS. This can be used to see which backups are available for forward recovery.

COPY

A report is written with information about each registered mvslog copy in the RCDS. This can be used to see which mvslog copies can be used for forward recovery.

RECOVERY

A report is written with information about each registered VSAM sphere in the RCDS when the sphere was opened and closed. This can be used to see when spheres were active and to specify start and stop times for forward recovery.

UNDO

A report is written with information about undo logging made for each batch job/step.

CHECK

This parameter is used to ensure that a check is made that all the resources required for forward recovery are cataloged.

When used with the BACKUP parameter, all the backups are checked to see if they are cataloged or not.

When used with the COPY parameter, all log copies are checked to see if they are cataloged or not.

When used with the RECOVERY parameter, all VSAM spheres that are printed in the recovery report are checked to see if they are cataloged or not.

When used with the UNDO parameter, CHECK is ignored.

SCAN (YES, NO)

CICS® VR might need to perform a log-of-logs scan to get the latest information for a recovery report. SCAN(YES) allows a log-of-logs scan. SCAN(NO) prevents a log-of-logs scan. The default is SCAN(YES).

Note:

This keyword can only be specified together with the RECOVERY parameter.

STARTTIME(timestamp)

This parameter specifies the time that the utility uses as a start time for the data lookup. This can be useful to limit the amount of data produced in the report. If STARTTIME is missing, the RCDS REPORT uses all information that is older than the specified STOPTIME.

timestamp

Must be in the format yyyy/ddd/hh/mm/ss, where:

yyyy

Is the four digit year number (2001)

ddd

Is the day of the year (001–366)

hh

Is the hour of the day (00–23)

mm

Is the number of minutes (00–59)

ss

Is the number of seconds (00–59)

You can separate these values with a slash (/), period (.), or colon (:). You can also omit the separator character. For example:

STARTTIME(2001.159/:23:00)

You cannot substitute commas, blanks, and so on, for the time values, but you can omit values from the right. For example, if you specify STARTTIME(2001.159), CICS® VR assumes that the time segment is 00:00:00.

STOPTIME(timestamp)

This parameter specifies the time that the RCDS REPORT uses to stop the data lookup. If the parameter is omitted, the RCDS REPORT uses the current time as the stop time. The timestamp must have the same format as used for STARTTIME.

ALL31

This is an optional parameter. It specifies that the report utility can carve memory up to the bar i.e., up to 2GB storage to generate the report. It’s recommended using this parameter to avoid S878 abend during the report generation process.

Keywords

ALL31

This is an optional parameter. It specifies that the report utility can carve memory up to the bar i.e., up to 2GB storage to generate the report. It’s recommended using this parameter to avoid S878 abend during the report generation process.

Usage notes

Sample output reports are provided in the CICS® VR User's Guide.