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 IWMMNTFY 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 115. Return and Reason Codes for the IWMMNTFY 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.

4xxxx0404Equate Symbol: IwmRsnCodeCompatNoSyseventRqd

Meaning: Reserved.

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.

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.

8xxxx080FEquate Symbol: IwmRsnCodeNoUserKeyNtfy

Meaning: User key routine not allowed to issue Notify.

Action: Avoid requesting this function in user key.

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: Input execution start time later than end time.

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

8xxxx0840Equate Symbol: IwmRsnCodeServiceNotEnabled

Meaning: The 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 requesting this function for Report-Only PBs.

8xxxx0895Equate Symbol: IwmRsnCodeEWLMServNotEnabled

Meaning: The service is not enabled because monitoring environment cannot be associated with EWLM work requests.

Action: Specify the parameter WORKREQ_STA only when the monitoring environment is created with IWMMCREA EWLM=YES or the address space is connected with IWMCONN EWLM=YES and the connect token is passed to IWMMCREA when creating the monitoring environment.

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: Reserved 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.

Cxxxx0C04Equate Symbol: IwmRsnCodeNtfyNoWorkElt

Meaning: Notify 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