EDGXCI return and reason codes

When the EDGXCI macro returns control to your application program:

GPR 15 (and retcode, when you code RETCODE) contains a return code.
GPR 0 (and rsncode, when you code RSNCODE) contains a reason code.

The EDGXCI macro returns these types of return codes and reason codes:

Return and reason codes that are associated with the processing of your subcommand. These return and reason codes are the same ones that DFSMSrmm returns when you issue a subcommand request. Refer to z/OS DFSMSrmm Managing and Using Removable Media for more information about these return and reason codes.
Return codes and reason codes that are issued by the API. The API returns:
- Return code 0 and reason code 0 when processing has completed successfully.
- Return code 0 and reason code 4 when the output buffer is full and more information is available.
- Any return code higher than 100 when an error has occurred.
When you use the API with high-level programming languages, DFSMSrmm returns a return code and reason code and a message described in the related messages column in Table 1. When you use the standard API, DFSMSrmm does not return a message but you can look to the related message for guidance.

Table 1identifies the decimal return and reason codes.

Table 1. Return and reason codes for the EDGXCI macro
Return Code	Reason Code	Meaning and Action	Related Message
0	—	Meaning: Success. Action: Refer to the action provided with the specific reason code.
0	0	Meaning: EDGXCI command is successfully completed. Action: None required.
0	4	Meaning: There is more output waiting to be given to you. Action: After you have processed the output in your output buffer, use OPERATION=CONTINUE to get more output.	EDG3900I
104	—	Meaning: Program error. An exception condition has been encountered, but the operation you requested was completed. The output results might not be acceptable to you. Action: Refer to the action provided with the specific reason code.
104	02	Meaning: There is nothing to CONTINUE. Action: None required.	EDG3901I
108	—	Meaning: Program error. An error condition has been encountered, and the operation you requested was not successfully completed. Action: Refer to the action provided with the specific reason code.
108	02	Meaning: Required token is missing. Action: You need to use TOKEN=token	EDG3902E
108	04	Meaning: Required address of the input subcommand is missing. Action: You need to use SUBCMDADDR=subcmdaddr	EDG3903E
108	06	Meaning: Required address of your output buffer is missing. Action: Use OUTBUFADDR=outbufaddr to specify the parameter.	EDG3904E
108	08	Meaning: Your output buffer is less than 4096 bytes in size. Action: Obtain storage and set its length.	EDG3905E
108	10	Meaning: Your output buffer is too small. The second word in your buffer contains the size you need. Action: Obtain the correct amount of storage and set its length.	EDG3906E
108	12	Meaning: OPERATION parameter is invalid. Action: Use OPERATION= to specify the parameter; check your program for incorrect modifying of the parameter list.	EDG3907E
108	14	Meaning: OUTPUT parameter is invalid. Action: Use OUTPUT= to specify the parameter; check your program for incorrect modifying of the parameter list.	EDG3908E
108	16	Meaning: EXPAND parameter is invalid. Action: Use EXPAND= to specify the parameter; check your program for incorrect modifying of the parameter list.	EDG3909E
108	18	Meaning: MULTI parameter is invalid. Action: Use MULTI= to specify the parameter; check your program for incorrect modifying of the parameter list.	EDG3909E
108	56	Meaning: The token is already in use. Action: Use TOKEN=token to specify a token that is not in use.	EDG3910E
108	58	Meaning: OUTPUT=FIELDS is not supported for the subcommand specified by SUBCMDADDR=subcmdaddr. Action: Use OUTPUT=LINES or specify a different subcommand.	EDG3911E
108	60	Meaning: The length of the subcommand specified by SUBCMDADDR=subcmdaddr is too large. Action: Use a smaller subcommand.	EDG3912E
112	—	Meaning: Environmental error. A limit, such as a storage limit, was exceeded. The operation you requested was not successfully completed. Action: Refer to the action provided with the specific reason code.
112	02	Meaning: Unable to obtain sufficient work area storage. Action: Remove the cause of the short-on-storage condition or request a larger region size. Rerun your program.	EDG3913E
116	—	Meaning: System error. An error caused by the system, rather than your program, has been encountered. The operation you requested was not successfully completed. Action: Refer to the action provided with the specific reason code.
116	02	Meaning: DFSMSrmm is not installed. Action: Ensure DFSMSrmm is installed and active before running your program.	EDG3914E
116	04	Meaning: A call to a system service has resulted in a non-zero return code. DFSMSrmm has placed the return code and the associated reason code as structured fields in your output buffer. Action: Retry the subcommand after the cause of the error has been corrected or removed.	EDG3915E
116	06	Meaning: An abnormal end has occurred. Action: Remove the cause of the abnormal end. Rerun your program.	EDG3916E
120	02	Meaning: Program error has occurred while you were using the high-level API. Action: Refer to the action provided with the specific reason code.	EDG3918E
120	04	Meaning: The LOAD for program EDGXAPI failed. Action: Correct the cause of the error and retry the command.	EDG3919E