RCU output
The output of the RCU function is written to the RPTRCU DD.
If you did not specify the RPTRCU DD in the JCL, it is dynamically allocated to SYSOUT=*. Report output can be written to SYSOUT or to a data set. The characteristics of the output are RECFM=FBA,LRECL=133. Report output can also be written to the IMS Tools Knowledge Base by specifying the REPORT(ITKBOUT(YES)) keyword and parameter.
The default is REPORT(ITKBOUT(YES)).
The RCU report consists of two main report sections. The following figure shows an example of the RCU report.
IMS DATABASE FACILITY EXTENDED FUNCTIONS V2.1.0 (5655-V86)
********************************************************************************
-> Invocation Parameters:
********************************************************************************
TIME: 2021.280 12:27:23.100000 -07:00
SOURCE: NONE
DELDISABLEPART: YES
***********************************************************************
-> Log Record Cleanup Report - Log Records Deleted
***********************************************************************
SSID Name Log Start Time
--------- -------------------------------
IMZ2 2021.287 20:11:14.500000 -07:00
IMZ1 2021.287 20:11:17.100000 -07:00
JCLBTCH1 2021.287 20:26:47.700000 -07:00
JCLBTCH2 2021.287 20:26:53.200000 -07:00
Record Type: Log # Records Deleted: 4
Record Type: Log # Records Modified: 0
***********************************************************************
-> Online Log Data Set Cleanup Report - OLDS Records Deleted
***********************************************************************
SSID Name Primary/Secondary
--------- -----------------
IMZ1 Primary
IMZ2 Primary
Record Type: OLDS # Records Deleted: 2
***********************************************************************
-> Subsystem Cleanup Report - SSYS Records Deleted
***********************************************************************
Subsys Name Subsys Type Subsys Status
----------- ----------- -------------
IMZ1 Online Normal
IMZ2 Online Normal
Record Type: Subsystem # Records Deleted: 2
***********************************************************************
-> Backout Record Cleanup Report - Backout Records Deleted
***********************************************************************
Record Type: Backout # Records Deleted: 0
***********************************************************************
-> Change Accum Execution Cleanup Report - CAs Deleted
***********************************************************************
Record Type: CA Execution # Records Deleted: 0
***********************************************************************
-> Database/DEDB Cleanup Report - Database(s) Modified
***********************************************************************
DBD/DEDB Name
-------------
CUSTD1
PCUST21
PCUST22
PCUST42
Record Type: DB # Records Modified: 4
***********************************************************************
-> Database Data Set Cleanup Report - DBDSs Modified
***********************************************************************
DBD/DEDB Name DDN/Area Name
------------- -------------
CUSTD1 CUSTD1
PCUST21 PCUST21A
PCUST21 PCUST21M
PCUST22 PCUST22A
PCUST42 PCUST42A
PCUST42 PCUST42M
Record Type: Database Data Sets # Records Modified: 6
***********************************************************************
-> Alloc Record Cleanup Report - ALLOC Records Deleted
***********************************************************************
DBD/DEDB Name DDN/Area Name Allocation Time
------------- ------------- -------------------------------
CUSTD1 CUSTD1 2021.287 20:20:09.432306 -07:00
CUSTD1 CUSTD1 2021.287 20:20:44.215129 -07:00
PCUST21 PCUST21A 2021.287 20:27:01.948396 -07:00
PCUST21 PCUST21A 2021.287 20:30:06.767713 -07:00
PCUST21 PCUST21A 2021.287 22:03:36.166819 -07:00
PCUST21 PCUST21A 2021.287 22:07:07.468367 -07:00
PCUST21 PCUST21M 2021.287 23:07:15.983751 -07:00
PCUST22 PCUST22A 2021.287 20:28:08.134886 -07:00
PCUST22 PCUST22A 2021.287 20:31:12.975831 -07:00
PCUST22 PCUST22A 2021.287 22:04:42.605166 -07:00
PCUST22 PCUST22A 2021.287 22:08:13.709894 -07:00
PCUST22 PCUST22A 2021.287 22:14:55.429617 -07:00
PCUST22 PCUST22A 2021.287 22:19:00.210476 -07:00
PCUST42 PCUST42A 2021.287 22:43:42.104709 -07:00
PCUST42 PCUST42M 2021.287 22:43:26.016135 -07:00
Record Type: Alloc # Records Deleted: 25
***********************************************************************
-> Image Copy Cleanup Report - IC Records Deleted
***********************************************************************
Record Type: Image Copy # Records Deleted: 0
***********************************************************************
-> DB Recovery Cleanup Report – RECOV Records Deleted
***********************************************************************
DBD/DEDB Name DDN/Area Name Recovery Run Time
------------- ------------- -------------------------------
CUSTD1 CUSTD1 2021.287 23:16:54.200000 -07:00
Record Type: Recovery # Records Deleted: 1
***********************************************************************
-> Reorganization Cleanup Report - REORG Records Deleted
***********************************************************************
DBD/DEDB Name DDN/Area Name Reorg Run Time
------------- ------------- -------------------------------
PCUST21 PCUST21A 2021.287 22:50:54.843375 -07:00
PCUST21 PCUST21A 2021.287 23:37:27.514491 -07:00
PCUST21 PCUST21M 2021.287 22:50:54.843375 -07:00
Record Type: Reorg # Records Deleted: 3
**********************************************************************
-> Disabled Partition Cleanup Report - Partition Records Deleted
**********************************************************************
Record Type: Disabled Part # Records Deleted: 0
***********************************************************************
-> No Image Copy Cleanup Report - DBDSs with No Image Copy
***********************************************************************
DBD/DEDB Name DDN/Area Name
------------- -------------
PCUST21 PCUST21M
PCUST42 PCUST42M
Record Type: No image copy # Records Listed: 2
***********************************************************************
-> No IC After REORG Cleanup Report - DBDSs With NO IC
DBD/DEDB Name DDN/Area Name REORG Run Time
------------- ------------- -------------------------------
PCUST22 PCUST22A 2021.269 00:58:38.900000 -07:00
PCUST42 PCUST42A 2021.269 00:58:39.000000 -07:00
Record Type: No IC after reorg # Records Listed: 2
The RCU report contains the following sections:
- Invocation Parameters
- This section of the report shows the options that RCU used for
its processing.
- TIME
- This field indicates the cleanup time.
- SOURCE
- This field displays whether to mark primary or secondary log or image copy records. In the previous example report, the SOURCE keyword was not specified, so NONE was displayed (which means that neither primaries or secondaries are marked in error).
- DELDISABLEPART
- This field displays whether any disabled partitions are deleted. In the previous example report, all disabled partitions would have been deleted.
The next section of the report describes the following groups of information:
- Log Record Cleanup Report - Log Records Deleted
- This section of the report shows information about the specific log records that were deleted or modified. The details shown are the SSID name and the Log Start Time of each log record. In addition, a total number of log records that were deleted and log records that were modified are reported.
- Online Log Data Set Cleanup Report - OLDS Records Deleted
- This section of the report shows information about the specific log records that were deleted or modified. The details that are listed are the SSID name and the Log Start Time of each log record. In addition, a total number of log records that were deleted and log records that were modified are reported.
- Subsystem Cleanup Report - SSYS Records Deleted
- This section of the report shows information about the specific subsystem (SSYS) records that were deleted. The details that are listed are the Subsystem name, subsystem type (online or batch), and the subsystem status. In addition, a total number of subsystem records deleted are reported.
- Backout Record Cleanup Report - Backout Records Deleted
- This section of the report shows the total number of Backout records that were deleted.
- Change Accum Execution Cleanup Report - CAs Deleted
- This section of the report shows the total number of Change Accumulation (CA) records that were deleted.
- Database/DEDB Cleanup Report - Database(s) Modified
- This section of the report shows the DBD or DEDB name of each DB record that was modified. In addition, a total number of database records that were modified is reported.
- Database Data Set Cleanup Report - DBDSs Modified
- This section of the report shows the DBD or DEDB name and the DDN or area name of each DBDS record that was modified. In addition, a total number of database data set records that were modified is reported.
- Alloc Record Cleanup Report - ALLOC Records Deleted
- This section of the report shows the DBD or DEDB name, the DDN or area name, and the allocation time of all allocation (ALLOC) records that were deleted. In addition, a total number of allocation records that were deleted is reported.
- Image Copy Cleanup Report - IC Records Deleted
- This section of the report shows the total number of image copy (IC) records that were deleted.
- DB Recovery Cleanup Report - RECOV Records Deleted
- This section of the report shows the DBD or DEDB name, the DDN or area name, and the recovery time of all RECOV records that were deleted. In addition, a total number of RECOV records that were deleted is reported.
- Reorganization Cleanup Report - REORG Records Deleted
- This section of the report shows the DBD or DEDB name, the DDN or area name, and the reorganization time of all of the REORG records that were deleted. In addition, a total number of REORG records that were deleted is reported.
- Disabled Partition Cleanup Report - Partition Records Deleted
- This section of the report shows the total number of HALDB disabled partitions that were deleted.
- No Image Copy Cleanup Report - DBDSs with No Image Copy
- This section of the report shows the DBD/DEDB name and the DDN/Area Name of all databases that have no image copies recorded in the RECONs. The database is not recoverable without at least one image copy. A total number of DBDSs that do not have IC records is reported.
- No IC After REORG Cleanup Report - DBDSs With No IC
- This section of the report shows the DBD or DEDB name, the DDN or area name, and the REORG run time of all databases that have no image copies recorded after a REORG record. The database might or might not have had the ICNEEDED flag on, depending on whether RCU deleted the image copy record or not. A database must have an image copy taken after a REORG. A total number of DBDSs that do not have IC records after a REORG is reported.