z/OS MVS Programming: Callable Services for High-Level Languages
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


BCPii communication error reason codes

z/OS MVS Programming: Callable Services for High-Level Languages
SA23-1377-02

All BCPii API invocations can experience a communication failure when communicating between the BCPii address space and the support element of the targeted Central Processor Complex (CPC). The calling program receives the HWI_COMMUNICATION_ERROR (101 hexadecimal, 257 decimal) return code when this occurs. One of the output parameters from each service is a Diagnostic Area (referred to as the DiagArea). For the HWI_COMMUNICATION_ERROR return code, a field in this DiagArea that is called Diag_Commerr contains a more descriptive return code from the BCPii communications transport to help pinpoint the cause of the failure.

Below is a partial list of the descriptive communication transport error return codes, along with a suggested action to take.

Return Code in Hexadecimal (in decimal) Description / Suggested Action
0-63 (0-99) These return codes are documented in Appendix C (API Return Codes) in the System z Application Programming Interfaces publication (SB10-7030).
64-76 (100-118) An internal error has likely occurred inside the BCPii transport code. Contact the IBM Support Center.
77 (119) The BCPii transport rejected the particular request. Activate CTRACE with CTRACE option “ALL” and reissue the request. If the request failed again, turn off CTRACE, collect the SVCDUMP, and contact the IBM Support Center.
78-CF (120-207) An internal error has likely occurred inside the BCPii transport code. Contact the IBM Support Center.
D0 (208) The support element rejected the particular request. Activate CTRACE with CTRACE option “ALL” and reissue the request. If the request failed again, turn off CTRACE, collect the SVCDUMP, and contact the IBM Support Center.
D1-D3 (209-211) An internal error has likely occurred inside the BCPii transport code. Contact the IBM Support Center.
D4 (212) The support element rejected communication from BCPii, likely because the Cross partition authority was not granted on this support element.
E0 (224) No response was received from the support element, after waiting for a considerable amount of time. BCPii times out the request. Check if connectivity to the support element is still there.
Greater than E0 (>224) An internal error has likely occurred inside the BCPii transport code. Contact the IBM Support Center.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014