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 IWM4MRLT 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 81. Return and Reason Codes for the IWM4MRLT Macro
Return Code	Reason Code	Equate Symbol Meaning and Action
0	—	Equate Symbol: IwmRetCodeOk Meaning: Successful completion.
4	—	Equate Symbol: IwmRetCodeWarning Meaning: Successful completion, unusual conditions noted.
4	xxxx0402	Equate Symbol: IwmRsncodeNoMonEnv Meaning: Input monitoring token indicates no monitoring environmen was established.
4	xxxx0406	Equate Symbol: IwmRsncodeNoParEnv Meaning: No parent monitoring environment was established. The input dependent monitoring environment is now related to the Home address space.
8	—	Equate Symbol: IwmRetCodeInvocError Meaning: Invalid invocation environment or parameters
8	xxxx0802	Equate Symbol: IwmRsnCodeXmemUserKeyTkn Meaning: Caller is in cross-memory mode while the token was obtained in user key.
8	xxxx0803	Equate Symbol: IwmRsnCodeDisabled Meaning: Caller is disabled
8	xxxx0804	Equate Symbol: IwmRsnCodeLocked Meaning: Caller is locked
8	xxxx080B	Equate Symbol: IwmRsnCodeBadPl Meaning: Error accessing parameter list.
8	xxxx081A	Equate Symbol: IwmRsnCodeCallerNotAuthDepEnv Meaning: Caller is not authorized to update the dependent monitoring environment
8	xxxx0820	Equate Symbol: IwmRsnCodeBadMonEnv Meaning: Monitoring environment does not pass verification.
8	xxxx0822	Equate Symbol: IwmRsnCodeBadParEnv Meaning: Parent monitoring environment does not pass verification.
8	xxxx0823	Equate Symbol: IwmRsnCodeDatoff Meaning: Caller invoked service while DATOFF
8	xxxx0824	Equate Symbol: IwmRsnCodeAmode24 Meaning: Caller invoked service but was was in 24 bit addressing mode.
8	xxxx0825	Equate Symbol: IwmRsnCodeAscModeNotPrimary Meaning: Caller invoked service but was not DAT on Primary ASC mod
8	xxxx0827	Equate Symbol: IwmRsnCodeRsvdNot0 Meaning: Reserved field in parameter list was non-zero
8	xxxx0828	Equate Symbol: IwmRsnCodeBadVersion Meaning: Version number in parameter list is not valid.
8	xxxx0829	Equate Symbol: IwmRsnCodeBadOptions Meaning: Parameter list omits required parameters or supplies mutually exclusive parameters or provides data associated with options not selected.
8	xxxx087E	Equate Symbol: IwmRsnCodeRoMonEnv Meaning: Monitoring environment is report only
8	xxxx087F	Equate Symbol: IwmRsnCodeRoParEnv Meaning: Parent monitoring environment is report only
8	xxxx08A4	Equate Symbol: IwmRsnCodeBPParEnv Meaning: Parent monitoring environment is buffer pool management only
10	—	Equate Symbol: IwmRetCodeCompError: Meaning: Component error

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