Return codes for APPC basic conversations

The return codes for APPC basic conversation verbs are indicated by equivalent CICS return codes.

APPC RETURN_CODE CICS return codes
OK CDBERR and RETCODE are zero
ALLOCATION_ERROR  
Local allocation failures: CICS is unable to allocate a session for an ALLOCATE command.
ALLOCATION_FAILURE_NO_RETRY RETCODE = 01....

The second and subsequent bytes give further information

ALLOCATION_FAILURE_RETRY For temporary problems, CICS waits in the ALLOCATE command until the problem has cleared and then continues.

See also the UNSUCCESSFUL return code, which relates to the NOQUEUE option on the CICS ALLOCATE command.

Remote allocation failures: These are 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 CDBERRCD = 10086034
PIP_NOT_ALLOWED CDBERRCD = 10086031
PIP_NOT_SPECIFIED_CORRECTLY CDBERRCD = 10086032
SECURITY_NOT_VALID CDBERRCD = 080F6051
SYNC_LEVEL_NOT_SUPPORTED_BY_PGM CDBERRCD = 10086041
SYNC_LEVEL_NOT_SUPPORTED_BY_LU RETCODE = 030C

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 CDBERRCD = 10086021
TRANS_PGM_NOT_AVAIL_NO_RETRY CDBERRCD = 084C0000
TRANS_PGM_NOT_AVAIL_RETRY CDBERRCD = 084B6031
BACKED_OUT CDBERRCD = 08240000
DEALLOCATE_ABEND_PROG CDBERRCD = 08640000
DEALLOCATE_ABEND_SVC CDBERRCD = 08640001
DEALLOCATE_ABEND_TIMER CDBERRCD = 08640002
DEALLOCATE_NORMAL CDBFREE + ¬CDBERR
PARAMETER_ERROR RETCODE = 01 0C ..

This return code relates ONLY to the ALLOCATE command (for CICS). It is given when an invalid LU name or MODE name has been specified. The third byte gives additional information.

PROG_ERROR_NO_TRUNC CDBERRCD = 08890000 (RECEIVE Only)
PROG_ERROR_TRUNC CDBERRCD = 08890001
PROG_ERROR_PURGING CDBERRCD = 08890000
RESOURCE_FAILURE_RETRY CDBERRCD = A000
RESOURCE_FAILURE_NO_RETRY CDBERRCD = A000
SVC_ERROR_NO_TRUNC CDBERRCD = 08890100 (RECEIVE Only)
SVC_ERROR_TRUNC CDBERRCD = 08890101
SVC_ERROR_PURGING CDBERRCD = 08890100
UNSUCCESSFUL

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.

RETCODE = 01 04 04

Control returned to the program because a session was not immediately available.

Note: In all cases, where a value for CDBERRCD is given, CDBERR will be set to X'FF'. It is intended that the program should first test CDBERR and then examine CDBERRCD if additional information is required.