Troubleshooting postinstallation errors
The postinstallation jobs are DFHMAINJ and DFHMASET and both can return response codes other than 0.
Procedure
- If you are running the DFHMAINJ sample job with validation
enabled and it fails with a return code other than 0:
- Check the job output for any messages that are prefixed with DFHMAI. They indicate which parameter values have caused a problem.
- Fix the problem and rerun the job.
- If you are running DFHMAINJ without validation enabled
and the job fails with a return code other than 0:
- Check the job output to see which error messages were issued. They will give you an indication of what caused the job to fail. Update the values in DFHMAINJ.
- Uncomment the section that is marked in DFHMAINJ to
delete the customized libraries when the job is next invoked.
//*-------------------------------------------------------- //* To rereun DFHMAINJ, uncomment this step to delete the - //* data sets before recreating them. - //* - //* It is vitally important that an empty SCIZSAMP - //* data set exists before executing the REXX step. - //* @BA32131A - //*-------------------------------------------------------- //*SYSD2 EXEC PGM=IKJEFT01 //*SYSUDUMP DD SYSOUT=* //*SYSTSPRT DD SYSOUT=* //*SYSPRINT DD SYSOUT=* //*SYSTSIN DD * //* DEL 'hlqual.SCIZSAMP' //* DEL 'hlqual.SCIZLOAD' //* DEL 'hlqual.SCIZMAC' - Enable validation for the job by changing novalidate to validate on the DFHMAINR invocation statement in the //REXX step.
- Rerun DFHMAINJ. If you still see a return code other than 0, check the job output for DFHMAI messages. They will tell you why the job is invalid. Fix the job as appropriate.
- Comment out the delete statements in DFHMAINJ and then rerun it. When you run the job with validation enabled, the libraries are not customized when there is an error so you do not hvae to include the deletion statements.
- If you are running the DFHMASET job, a return code other
than 0 might be returned for some of the steps.
- If you see a return code of 4, accompanied by error message IGYDS0001 when compiling DFHMADCD, DFHMADCI, and DFHMAVUP, this error message is acceptable for these steps.
- If you have specified compiler options OPTIMIZE(STD) or OPTIMIZE(FULL), a return code of 4, accompanied by error message IGYOP3091-W, is also acceptable for these steps.
- If you see a return code that is not 0 or 4, contact IBM Software Support, providing a copy of the DFHMASET job that you used and the CICS job log.
Example
dfhcr_troubleshoot_install.html |
Last updated: Sunday, 4 June 2017