Symptom Records for APPC Service Failures

If your program encounters return code 32 (atbcts_service_failure), and reason code 16 (atbcts_appc_service_failure), an APPC service failure has been detected. The system writes symptom records that describe the error to the logrec data set. See z/OS MVS Diagnosis: Tools and Service Aids for more information on retrieving and reading the logrec data set software record reports.

Section 3 of the symptom record contains the primary symptom string for APPC service failures:

Table 1. Symptom String for Service Failure Errors. (Section 3 of the Symptom Record in the Logrec Data Set.)
Symptom	Description
PIDS/5752SCACB	Product identifier
RIDS/ATBxxxxx	CSECT name
RIDS/ATBxxxxx#L	Load module name
LVLS/ddd	Product level
PCSS/ATBxxxx	The allocate queue service that caused the error. This field is omitted if the error was not caused by an allocate queue service.
PRCS/dddddddd	The return code returned to the caller of the service. This field is omitted if the error was not caused by an allocate queue service.
FLDS/REASON VALU/Hdddddddd	The unique reason code that identifies the APPC service failure.

Section 5 of the symptom record contains the following information for the APPC service failure:

The job or user name, in EBCDIC, for the home address space of the caller
An EBCDIC description of the error (up to 80 characters).

Look for symptom FLDS/REASON VALU/Hdddddddd in section 3 of the symptom record for the reason code identifying the error, which is one of the following:

Table 2. Reason Codes for Service-Failure Errors
Reason Code	Message Text	Explanation
00000006	ERROR IN TRYING TO VERIFY APPCSERV AUTHORITY.	An error occurred when APPC/MVS tried to verify the APPCSERV authority of the caller. This error occurred while APPC was processing a call to the Register_For_Allocates service.
00000007	ERROR RETRIEVING SECURITY INFORMATION.	An error occurred when APPC/MVS tried to obtain information about the caller's security environment. This error occurred while APPC was processing a call to the Register_For_Allocates service. The RACF return code and reason code appear in section 5 of the symptom record. System Programmer Response: Ensure that the correct level of the security product is installed and is active. Also check security-related parameters specified on the Register_For_Allocates call (such as user_ID and profile) for proper authorization.
00000008	ERROR RETRIEVING SIDE INFORMATION.	An error occurred when APPC/MVS tried to obtain side information from the side information file. This error occurred while APPC was processing a call to the Register_For_Allocates service.
00000009	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal failure occurred during APPC processing of a call to the Register_For_Allocates service.
0000000A	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal failure occurred during APPC processing of a call to the Register_For_Allocates service.
0000000B	FAILURE IN SERIALIZING SERVER FACILITIES RESOURCES.	Serialization of APPC/MVS server facilities resources failed during APPC processing of the Register_For_Allocates service.
0000000C	FAILURE IN SERIALIZING SERVER FACILITIES RESOURCES.	Serialization of APPC/MVS server facilities resources failed during APPC processing of the Register_For_Allocates service.
0000000D	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal failure occurred during APPC processing of a call to the Register_For_Allocates service.
0000000E	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal failure occurred during APPC processing of a call to either the Receive_Allocate or Unregister_For_Allocates service.
0000000F	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal failure occurred during APPC processing of a call to either the Receive_Allocate or Unregister_For_Allocates service.
00000010	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal failure occurred during APPC processing of a call to the Receive_Allocate service.
00000011	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal error occurred in APPC/MVS processing.
00000012	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal error occurred in APPC/MVS processing.
00000013	AN INTERNAL FAILURE OCCURRED IN APPC PROCESSING.	An internal error occurred in APPC/MVS processing.