Return and Reason Codes

z/OS MVS Programming: Workload Management Services

Return and Reason Codes

z/OS MVS Programming: Workload Management Services
SC34-2663-00

Return and Reason Codes

When the IWMCNTN 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 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 23. Return and Reason Codes for the IWMCNTN Macro
Return Code	Reason Code	Equate Symbol, Meaning, and Action
0	—	Equate Symbol: IwmRetCodeOk Meaning: Successful completion. Action: None required.
4	—	Equate Symbol: IwmRetCodeWarning Meaning: Successful completion, unusual conditions noted.
4	xxxx00447	Equate Symbol: IwmRsnCodeRequestListEntryWarning Meaning: The processing of at least one of the request list entries has caused a warning. Refer to the return code and reason code stored for this request list entry. Action: SRM continues with the request list processing.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters.
8	xxxx0803	Equate Symbol: IwmRsnCodeDisabled Meaning: Caller is disabled. Action: Avoid requesting this function while disabled.
8	xxxx0804	Equate Symbol: IwmRsnCodeLocked Meaning: Caller is locked. Action: Avoid requesting this function while locked.
8	xxxx080B	Equate Symbol: IwmRsnCodeBadPl Meaning: Error accessing parameter list. Action: Check for possible storage overlay.
8	xxxx0824	Equate Symbol: IwmRsnCodeAmode24 Meaning: The caller invoked the service but was in 24-bit addressing mode. Action: Request this function only when you are in 31-bit addressing mode.
8	xxxx0825	Equate Symbol: IwmRsnCodeAscModeNotPrimary Meaning: The caller invoked the service but was not DAT on primary ASC mode. Action: Avoid requesting this function in this environment.
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list is not valid. Action: Check for possible storage overlay of the parameter list.
8	xxxx0888	Equate Symbol: IwmRsnCodeBadRequestList Meaning: The request list does not pass verification. No request in the request list was processed. Action: Check the return and reason codes in the request list.
8	xxxx0889	Equate Symbol: IwmRsnCodeBadResourceIdLen Meaning: The length of the resource id must not exceed 264 bytes. Action: Specify a correct resource id length.
8	xxxx088C	Equate Symbol: IwmRsnCodeBadRequestListVersion Meaning: The version specified in the request list is not supported Action: Specify a correct request list version.
8	xxxx088D	Equate Symbol: IwmRsnCodeBadRequestListLength Meaning: The specified request list length is too small to carry the specified number of request entries. Action: Specify a correct request list length or correct the entry count.
8	xxxx08A6	Equate Symbol: IwmRsnCodeBadRequestListEntry Meaning: The processing of at least one of the request list entries failed. Refer to the return code and reason code stored for this request list entry. SRM continues with the request list processing. Action: Check the return and reason codes in the request list.
8	xxxx08A7	Equate Symbol: IwmRsnCodeBadResource Meaning: The resource ID was not found in the topology for INVOCATIONTYPE=ENDOFCONTENTION. Action: Specify a correct resource ID.
10	—	Equate Symbol: IwmRetCodeCompError Meaning: Component error. Action: No action required. The function may be successful if invoked again.

Notices | Terms of use | Support | Contact z/OS | zFavorites