The IBM Tools Base Diagnostics Aid is a tool that can help you collect the necessary diagnostic information to resolve a problem before you contact IBM Software Support.
The Tools Base Diagnostics Aid (HKTUDIAG) is the IBM utility documented in Part 6 of the IBM Tools Base: IMS Tools Common Services User's Guide and Reference. If you have a problem you think is not a user error, you run the aid to collect the necessary information, attach the resulting Load Module APAR Status report to other diagnostic documents such as the job dump list, and report the error to IBM. The report shows the latest APAR fixes applied to each module of the IMS Tools components, and the aid also produces a Journal Messages report about the job.
The chapters cover how to run the aid with a JCL stream, including the EXEC statement and the STEPLIB, LOADLIB, HKTPRINT and HKTRPRT DD statements; the two output reports and the fields of the Load Module APAR Status report; the IMS Tools load modules supported by the aid; and the HKTnnnx message format with its severity codes, explanations, system actions and user responses.
| Diagnostics Aid program name | HKTUDIAG |
|---|---|
| Journal Messages report output data set | HKTPRINT |
| Load Module APAR Status report output data set | HKTRPRT |
| Report record format | 133-byte, fixed-length records |
| STEPLIB library data set | ITB.SHKTLOAD |
| Message identifier format | HKTnnnx |
| Message severity W | Warning to alert you to a possible error condition |
| Return code when the process ends with warning | 4 |
It is used to collect the necessary information when you have a problem you think is not a user error, so the report can be attached to other diagnostic documents before you report the error to IBM.
It generates a Journal Messages report and a Load Module APAR Status report.
None is shown in the APAR Number field.
It indicates that the message is a warning to alert you to a possible error condition; processing then ends with a return code of 4.