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

>>-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)
/*