Return and Reason Codes

When the HZSCPARS 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.

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 HZSCPARS Macro
Return Code	Reason Code	Equate Symbol Meaning and Action
0	—	Equate Symbol: HZSCPARSRc_OK Meaning: Requested information returned Action: None required
4	—	Equate Symbol: HZSCPARSRc_Warn Meaning: Warning Action: Refer to action under the individual reason code.
4	xxxx0401	Equate Symbol: HZSCPARSRsn_NotLocated Meaning: For the CHECKPARM request, the parameter was not found. Action: None required.
4	xxxx0402	Equate Symbol: HZSCPARSRsn_NoParms Meaning: For the PARSE request, the input parameter length was 0. Action: None required.
8	—	Equate Symbol: HZSCPARSRc_InvParm Meaning: HZSCPARS request specifies incorrect parameters. Action: Refer to action under the individual reason code.
8	xxxx0801	Equate Symbol: HZSCPARSRsn_BadParmLen Meaning: The parameter length exceeded the maximum of 4096. Action: Specify a valid parameter length.
0C	—	Equate Symbol: HZSCPARSRc_EnvError Meaning: Environmental Error Action: Refer to action under the individual reason code.
0C	xxxx0C01	Equate Symbol: HZSCPARSRsn_SyntaxError Meaning: A syntax error was detected. A message was issued about the problem. Action: Use HZSFMSG REQUEST=STOP,REASON=BADPARM to indicate that the check cannot proceed because of a parameter error.