HCHECK output
The HCHECK function report is written to the RPTHCHEK output DD.
If you do not specify the RPTHCHEK DD in the JCL , it will be dynamically allocated to SYSOUT=*. You can also have the output report written to SYSOUT, or to a data set. The characteristics of the output are RECFM=FBA,LRECL=133. Or, you can have the output report written to the IMS Tools Knowledge Base by specifying the REPORT(ITKBOUT(YES)) keyword and parameter.
Note: REPORT(ITKBOUT(YES) is the default.
The following figure shows a sample HCHECK report:
IMS Recovery Solution Pack V2.1.0 (5655-V86)
IMS DATABASE FACILITY EXTENDED FUNCTIONS HEALTH CHECKER REPORT Run Time: 11/05/2021 12:30
********************************************************************************
-> Invocation Parameters
********************************************************************************
FUNCTION NUMBER DAYS HOURS START DATE/TIME END DATE/TIME
----------------------------------------------------------------------------------------------------------------
CARUN 2021.309 10:01:01.100000 -08:00 2021.309 10:02:02.100000 -08:00
ICNEED
********************************************************************************
-> Database List
********************************************************************************
DATABASE AREA/PART DD TYPE DSN PART-TYPE OLR-PARTNER
-----------------------------------------------------------------------------------------------------------------------
F2O1P1 F2O1P11 FF IMSTOOL.IMSRE.QA.Q91A.F2O1P1.F2O1P11
H1O1P3 H1O1P31 H1O1P31X HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.X00001 INDEX
H1O1P3 H1O1P31 H1O1P31L HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.L00001 ILE
H1O1P3 H1O1P31 H1O1P31A HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.A00001 DATA
H1O1P3 H1O1P32 H1O1P32X HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.X00002 INDEX
H1O1P3 H1O1P32 H1O1P32L HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.L00002 ILE
H1O1P3 H1O1P32 H1O1P32A HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.A00002 DATA
H1O1P3 H1O1P33 H1O1P33X HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.X00003 INDEX
H1O1P3 H1O1P33 H1O1P33L HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.L00003 ILE
H1O1P3 H1O1P33 H1O1P33A HALD IMSTOOL.IMSRE.QA.Q91A.H1O1P3.A00003 DATA
********************************************************************************
-> Health Checker Report
********************************************************************************
DBD DDN/AREA TYPE FUNCTION HEALTH CHECKER MESSAGE(S) * = "WITHIN SPECIFIED RANGE"
----------------------------------------------------------------------------------------------------------------
F2O1P1 F2O1P11 FF CARUN CA group has no valid CA run *
H1O1P31 H1O1P31A HALD ICNEED Image Copy is Needed
H1O1P33 H1O1P33A HALD ICNEED Image Copy is Needed
The major report sections are described here with their headings:
- Invocation Parameters
- This section of the report shows the options that were used by HCHECK processing. In this example you can see that the CARUN and ICNEED options were specified. Any parameters that you specified for the options are also displayed. In the example of CARUN, a range was specified.
- Database List
- This section of the report shows the databases that were processed
in this run. The report headings and descriptions are listed here:
- DATABASE
- This column lists the names of the databases that were processed.
- AREA/PART
- This column lists the area names for fast path databases or the partition names for HALDB databases. This column is blank for full-function databases.
- DD
- This column shows the DD name that is associated with this area, partition, or full-function database.
- TYPE
- This column lists the type of databases that were processed. Valid values are FF for full-function databases, FP for fast path areas, and HALD for HALDB partitions.
- DSN
- This column lists the data set names that are associated with this area, partition, or full function database.
- PART-TYPE
- For HALDB partitions, this column specifies the type of data set. Valid values are INDEX for the index portion of the HALDB, ILE for the index list element (or ILDS) portion of the HALDB, or DATA for the data portion of the HALDB.
- OLR-PARTNER
- For HALDB partitions that are IMS Online Reorganization (OLR) capable, this column specifies the OLR partner DD name that is associated with the partition.
- Health Checker Report
- This section includes a line for any condition that HCHECK identifies
as a problem. The report headings and their descriptions are:
- DBD
- This column specifies the database name for which the condition was identified. If the database is a HALDB type, this column indicates the partition name.
- DDN/AREA
- This column specifies the DD name (for full-function or HALDB databases), or the fast path area name for which the condition was identified.
- TYPE
- This column indicates the type of database that was processed. Valid values are FF (for full-function database), FP (for Fast Path area), and HALD ( for HALDB partition).
- FUNCTION
- This column indicates the HCHECK option that is associated with the condition.
- HEALTH CHECKER MESSAGE(S)
- This column indicates the condition that was identified by HCHECK.
Possible values and their meanings are listed in the next table. An
asterisk in the message column indicates that the condition is associated
with a specified range.
Table 1. Health checker messages and their issuing functions Message Function No Image Copy has been taken ICNONE No Image Copy taken, but SLB exists. Note: This includes SLBs for which there is no Image Copy record in the RECON.
ICNONE Image Copy is Needed ICNEED Image Copy is Recommended ICREC No Batch Image Copy taken * MINBAT No Batch IC taken, but SLB exists * MINBAT No Online Image Copy taken * MINONL No Online IC taken, but SLB exists * MINONL DB has EEQE, so recovery may be needed EEQE DB is not in a Change Accumulation group DBNOTCA HALDB is not initialized HALDBNOTINIT No Area Data Set is defined NOADSDEFINE No Area Data Set is available NOADSAVAIL One or more Area Data Sets are unavailable NOADSAVAIL Backout is needed BACKOUT Minimum CA records not available * MINCARECS No corresponding SECLOG for PRILOG SECLOG No corresponding SECSLDS for PRISLDS SECSLD CA group has no valid CA run * CARUN HALDB has Prohibit Authorization status PROAUTH Primary IC has no valid secondary IC * PISEC HALDB partition is disabled HALDBDISABLEDPART DB Recovery Asset(s) not catalogued - SLB VERIFY DB Recovery Asset(s) not catalogued VERIFY LOG Recovery Asset(s) not catalogued VERIFY CA Recovery Asset(s) not catalogued VERIFY Recovery Asset(s) not catalogued VERIFY