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
MAP_NOT_FOUND
MAPPING_NOT_SUPPORTED

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 ..
                  or D0 0C ..)

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.


dfhp639.html | Timestamp icon Last updated: Monday, 5 June 2017