Return and Reason Codes

When the HZSFMSG macro returns control to your program:

GPR 15 (and retcode, when you code RETCODE) contains a return code.
When the value in GPR 15 is not zero, GPR 0 (and rsncode, when you code RSNCODE) contains a reason code.

Macro HZSZCONS provides equate symbols for the return and reason codes.

The following table identifies the hexadecimal return and reason codes and the equate symbol associated with each reason code. IBM® support personnel may request the entire reason code, including the xxxx value.

Table 1. Return and Reason Codes for the HZSFMSG Macro
Return Code	Reason Code	Equate Symbol Meaning and Action
0	—	Equate Symbol: HzsfmsgRc_OK Meaning: The request completed successfully. Action: None required
8	—	Equate Symbol: HzsfmsgRc_InvParm Meaning: HZSFMSG request specifies incorrect parameters. Action: Refer to action under the individual reason code.
8	xxxx0837	Equate Symbol: HzsfmsgRsn_ErrorLimitExceeded Meaning: The check routine has abended too many times, messages will not be processed. Action: Fix the check routine.
0C	—	Equate Symbol: HzsfmsgRc_EnvError Meaning: Environmental Error Action: Refer to action under the individual reason code.
0C	xxxx0C01	Equate Symbol: HzsfmsgRsn_IBMHCNotActive Meaning: IBM Health Checker for z/OS® is not active Action: Re-issue the request when the service is available
10	—	Equate Symbol: HzsfmsgRc_CompError Meaning: Component Error. An associated dump and logrec entry has been created using abend 290 and the reason code. Action: Refer to action under the individual reason code.
10	xxxx1001	Equate Symbol: HzsfmsgRsn_IntError Meaning: Unexpected internal error Action: Report the problem to the system programmer
10	xxxx1013	Equate Symbol: HzsfmsgRsn_MsgTblError Meaning: The message table could not be processed. Action: Report the problem to the system programmer
10	xxxx1014	Equate Symbol: HzsfmsgRsn_Pqe_NotValid Meaning: The Pqe control block could not be found. Action: Report the problem to the system programmer
10	xxxx1015	Equate Symbol: HzsfmsgRsn_BadMsgTblSegment Meaning: A message variable is incorrectly defined in the message table. Action: Report the problem to the system programmer
10	xxxx1017	Equate Symbol: HfmsgAbend_BadMsgTblOutLen Meaning: The message table contains data that incorrectly defines a Maxlen value. The table is corrupted. Action: Report the problem to the system programmer
10	xxxx1018	Equate Symbol: HzsfmsgAbend_MsgTblMissingNewLine Meaning: The message table contains data that allows a WTO line to exceed 71 characters. The table is corrupted Action: Report the problem to the system programmer
10	xxxx1019	Equate Symbol: HzsfmsgRsn_HckLog_NotValid Meaning: The Hcklog control block contains errors. Action: Report the problem to the system programmer