Return and Reason Codes

When the system returns control to the caller, GPR 15 (and retcode, if you coded RETCODE) contains the return code and GPR 0 (and rsncode, if you coded RSNCODE) contains the reason code.

Table 1. Return and Reason Codes for the IXLZSTR Macro
Hexadecimal Return Code	Hexadecimal Reason Code	Meaning and Action
00	None	Meaning: IXLZSTR completed successfully and returned the requested information in the data area provided. Action: None
04	04	Meaning: Not all requested data could be returned in the data area provided because the data area was not large enough. Action: To retrieve the remainder of the data, invoke IXLZSTR again with the same keywords and the RESTOKEN as input to the macro.
08	04	Meaning: The STRNAME specified on the IXLZSTR macro does not appear in the dump. Action: Correct STRNAME, if incorrect, and reissue the IXLZSTR macro.
08	08	Meaning: The STRNAME specified on the IXLZSTR macro appears in the dump, but the STRDUMPID specified does not appear in the dump Action: Correct STRDUMPID, if incorrect, and reissue the IXLZSTR macro.
08	0C	Meaning: No coupling facility data appears in the dump. Action: Ensure that you have specified the correct dump.
08	10	Meaning: ANSAREA specified on the IXLZSTR macro does not meet the minimum storage requirement for the request. Action: Recalculate the amount of storage required for the type of request you are submitting and reissue the IXLZSTR macro.
08	14	Meaning: The data does not appear in the dump because the attributes of the requested data does not match the attributes of the structure type. Action: Correct the attributes specified and reissue the IXLZSTR macro.
08	18	Meaning: The range specification on the IXLZSTR macro is not valid. The starting value is greater than the ending value. Action: Correct the range values and reissue the IXLZSTR macro.
0C	04	Meaning: Environmental error. Unable to obtain system storage. Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM® support personnel.
10	04	Meaning: Failure in IXLZSTR processing. Some storage could not be obtained in the dump data set. Action: Save the return code information and contact the IBM support center.