Overview of Error_Extract Service

Error_Extract is a TP conversation service that returns detailed information about errors indicated by return codes. Your TP can display the detailed error information to end users, or use it as input to a debugging program.

All error return codes from APPC/MVS indicate that one of the following error situations occurred in APPC processing:

A TP called an APPC/MVS service with unknown values or incorrect parameters
A TP called a service while a conversation is in a state that does not support the service
APPC/MVS found an error that prevented the scheduling of a TP, such as:
- An LU was either not defined or incorrectly defined
- The address space in which a requestor TP is running did not have access to a scheduler
- An internal error occurred.

IBM recommends that your TP call Error_Extract immediately after APPC/MVS returns a return code that indicates one of the errors listed above. Also, call Error_Extract only when errors occur in calls to supported services, which are listed in Table 1.

The following sections explain how to call Error_Extract and interpret the information that Error_Extract returns.