z/OS MVS Programming: Workload Management Services
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Return and Reason Codes

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

Return and Reason Codes

When the IWMRPT macro returns control to your program:

  • GPR 15 (and retcode, if you coded RETCODE) contains a return code.
  • When the value in GPR 15 is not zero, GPR 0 (and rsncode, if you coded 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 123. Return and Reason Codes for the IWMRPT Macro
Return CodeReason CodeEquate Symbol, Meaning, and Action
0Equate Symbol: IwmRetCodeOk

Meaning: Successful completion.

Action: None required.

4Equate Symbol: IwmRetCodeWarning

Meaning: Successful completion, unusual conditions noted.

4xxxx0405Equate Symbol: IwmRsnCodeGoalNoMonEnv

Meaning: System is in goal mode but the input monitoring token indicates no monitoring environment was established, hence MVS™ did not receive the information.

Action: None required.

4xxxx0409Equate Symbol: IwmRsnCodeNoConn

Meaning: Connect token does not reflect a successful Connect. The system did not receive the information (applies to both goal mode and compatibility mode). No SYSEVENT TRAXFRPT was issued.

Action: None required.

8Equate Symbol: IwmRetCodeInvocError

Meaning: Invalid invocation environment or parameters.

8xxxx080CEquate Symbol: IwmRsnCodeMonEnvLacksData

Meaning: Input monitoring environment does not contain the necessary information.

Action: Ensure that the monitoring environment was established with the necessary information.

8xxxx080EEquate Symbol: IwmRsnCodeArrTimeGTEndTime

Meaning: Input arrival time later than end time.

Action: Check for possible storage overlay of the parameter list or variable.

8xxxx0820Equate Symbol: IwmRsnCodeBadMonEnv

Meaning: Input monitoring environment does not pass short form validity checking.

Action: Check for possible storage overlay.

8xxxx0821Equate Symbol: IwmRsnCodeBadConn

Meaning: Input connect token does not pass validity checking.

Action: Check for possible storage overlay.

8xxxx082DEquate Symbol: IwmRsnCodeExStTimeGTEndTime

Meaning: Execution start time greater than execution end time

Action: Check for possible storage overlay of the parameter list or variable.

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

Meaning: Caller's space connection is not enabled for this service.

Action: Avoid requesting this function under the input connection. IWM4CON options must be specified previously to enable this service.

8xxxx087EEquate Symbol: IwmRsnCodeRoMonEnv

Meaning: Input monitoring environment is report-only.

Action: Avoid calling this function for report-only monitoring environments.

8xxxx0894Equate Symbol: IwmRsnCodeInvalidEWLMCorr

Meaning: Passed correlator information (EWLM_CHCORR, EWLM_PACORR, or EWLM_CHCTKN) did not pass validity checking, that means: the architected ARM correlator length field in the first two Bytes of the correlator (token) is either less than 4 ('0004'x) or greater than 512 ('0200'x).

Action: Check the specification of the correlator information.

8xxxx0895Equate Symbol: IwmRsnCodeEWLMServNotEnabled

Meaning: The service is not enabled because the caller invoked the IWMCONN service with EWLM=NO.

Action: Specify the parameter EWLM_CHCORR, EWLM_PACORR, EWLM_CHCTKN, or WORKREQ_STA only when connected with EWLM=YES.

8xxxx0897Equate Symbol: IwmRsnCodeTranStatusInvalid

Meaning: Passed work request completion status is not valid.

Action: Check the EWLM ARM interface specification for valid completion status values.

CEquate Symbol: IwmRetCodeEnvError

Meaning: Environmental error.

Cxxxx0C02Equate Symbol: IwmRsnCodeReportingSusp

Meaning: SYSEVENT TRAXFRPT invoked, but reporting is temporarily suspended for one of the following reasons:

  • RMF™ workload activity reporting is not active
  • There is no installation control specification (IEAICSxx parmlib member with RPGN specified for some subsystem other than TSO) in effect. No data reported but a later reissue could be successful.

Action: Invoke the function when the conditions are alleviated.

Cxxxx0C03Equate Symbol: IwmRsnCodeSyseventNoWorkElt

Meaning: SYSEVENT TRAXFRPT invoked, but no work element was available to save the input information.

Action: Invoke the function when the conditions are alleviated. This condition may be due to a common storage shortage condition.

Cxxxx0C05Equate Symbol: IwmRsnCodeRptNoWorkElt

Meaning: Report routine invoked, but no work element was available to save the input information.

Action: Invoke the function when the conditions are alleviated. This condition may be due to a common storage shortage condition.

Cxxxx0C06Equate Symbol: IwmRsnCodeNoEndTime

Meaning: No end time was supplied to the service and STCK gave a non-zero condition code.

Action: No action required.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014