RCDS: Create a RCDS report

Use the RCDS REPORT keyword to create a detailed report containing the information requested by options of the command.

Format

Read syntax diagramSkip visual syntax diagram
>>-RCDS--REPORT--(--+-BACKUP---+--)--+-------+------------------>
                    +-COPY-----+     '-CHECK-'   
                    +-RECOVERY-+                 
                    '-UNDO-----'                 

>--+---------------------+--+----------------------+------------>
   '-SCAN--(--+-YES-+--)-'  '-STARTTIME(timestamp)-'   
              '-NO--'                                  

>--+---------------------+-------------------------------------><
   '-STOPTIME(timestamp)-'   

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.

Usage notes

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

Example

This example produces a recovery report, containing all information from RCDS that is older than the current time.
RCDS REPORT(RECOVERY)
A sample job to create this report is as follows:
//*-------------------------------------------------------*/
//* Produce a report for recovery                         */
//*-------------------------------------------------------*/
//REPORT   JOB ,CICSVR,MSGCLASS=H,CLASS=A,MSGLEVEL=(1,1),
//             REGION=4096K,NOTIFY=USERID 
//PRINTREP EXEC PGM=DWWGJCDS 
//STEPLIB  DD DSN=DWW41.SDWWLOAD,DISP=SHR   /* CICSVR LOADLIB */
//DWWPRINT DD SYSOUT=*
//DWWMSG   DD SYSOUT=*
//DWWCON1  DD DSN=DWW.DWWCON1,DISP=SHR      /* RCDS */
//DWWCON2  DD DSN=DWW.DWWCON2,DISP=SHR      /* RCDS */
//DWWCON3  DD DSN=DWW.DWWCON3,DISP=SHR      /* RCDS */
//DWWIN    DD *
   RCDS REPORT(RECOVERY)
/*