Return codes for APPC mapped conversations
The return codes for APPC mapped conversation verbs are indicated by equivalent CICS return codes.
| APPC RETURN_CODE | CICS return codes |
|---|---|
| OK | EIBERR zero + INVREQ not raised |
| ALLOCATION_ERROR | |
| Local allocation failures: | CICS is unable to allocate a session for an ALLOCATE command. |
| ALLOCATION_FAILURE_NO_RETRY | SYSIDERR raised The second and subsequent bytes of EIBRCODE give further information |
| ALLOCATION_FAILURE_RETRY | SYSBUSY raised if there is
a HANDLE for it. Otherwise, CICS queues the request until a session
is available See also the UNSUCCESSFUL return code, which relates to the NOQUEUE option on the CICS ALLOCATE command. |
| Remote allocation failures: | These will be returned to the program after the CONNECT PROCESS command has been issued, and the partner system has been unable to start the requested task. They may be returned on any subsequent command that relates to the session in use |
| CONVERSATION_TYPE_MISMATCH | TERMERR (EIBERRCD = 10086034) |
| PIP_NOT_ALLOWED | TERMERR (EIBERRCD = 10086031) |
| PIP_NOT_SPECIFIED_CORRECTLY | TERMERR (EIBERRCD = 10086032) |
| SECURITY_NOT_VALID | TERMERR (EIBERRCD = 080F6051) |
| SYNC_LEVEL_NOT_SUPPORTED_BY_PGM | TERMERR (EIBERRCD = 10086041) |
| SYNC_LEVEL_NOT_SUPPORTED_BY_LU | INVREQ (EIBRCODE = E000000C) Note: CICS remembers SYNC_LEVEL negotiated at bind time and does not permit a request to be sent for a sync level not supported by the remote LU. |
| TPN_NOT_RECOGNIZED | TERMERR (EIBERRCD = 10086021) |
| TRANS_PGM_NOT_AVAIL_NO_RETRY | TERMERR (EIBERRCD = 084C0000) |
| TRANS_PGM_NOT_AVAIL_RETRY | TERMERR (EIBERRCD = 084B6031) |
| BACKED_OUT | EIBSYNRB (EIBERRCD = 08240000) |
| DEALLOCATE_ABEND | The transaction is abended with code AZCH (EIBERRCD = 08640000) |
| DEALLOCATE_NORMAL | EIBFREE + ¬EIBERR |
| FMH_DATA_NOT_SUPPORTED | TERMERR (EIBERRCD = 08890100) |
MAP_EXECUTION_FAILURE |
Not applicable. Map requests are not sent because the option is not supported. |
| PARAMETER_ERROR | This return code relates ONLY to the CICS ALLOCATE command. It is given when an invalid LU name or MODE name has been specified. |
| PARAMETER_ERROR (Invalid LU name) | SYSIDERR (EIBRCODE = D0 04 .. |
| PARAMETER_ERROR (Invalid mode name) | CBIDERR raised for invalid PROFILE on ALLOCATE command. |
| PROG_ERROR_NO_TRUNC | EIBERRCD = 08890000 (RECEIVE Only) |
| PROG_ERROR_PURGING | CDBERRCD = 08890000 |
| RESOURCE_FAILURE_RETRY | EIBERRCD = A000 |
| RESOURCE_FAILURE_NO_RETRY | EIBERRCD = A000 |
| UNSUCCESSFUL | RETCODE = 01 04 04 |
| This return code relates ONLY to the APPC ALLOCATE verb with RETURN_CONTROL(IMMEDIATE) specified. This is implemented in CICS with the NOQUEUE option on the ALLOCATE command. | Control returned to the program because a session was not immediately available. |
Note: In all cases, where a value
for EIBERRCD is given, EIBERR will be set to X'FF'. It is
intended that the program should first test EIBERR and then examine
EIBERRCD if additional information is required.
|
|