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.
|
|