DB2: APPC Primary Return Codes

This table lists potential APPC Primary Return Codes returned by the CONNX DB2 Module when connected via supported SNA APPC/LU 6.2 vendor software.

 

APPC Primary Return Code

Message Text

Recommended Action

OK

OK

None Required

Allocation Error

The attempt to allocate an APPC conversation failed.

Refer to secondary return code; retry; notify CONNX Tech Support.

Canceled

The CONNX DB2 local server issued one of the following verbs: DEALLOCATE, SEND_ERROR or TP_ENDED.

None Required; restart connection as needed.

Communications Subsystem Abended

The APPC communications software running on the local client machine ended abnormally, or the connection from the client to the server ended due to a LAN error.

Restart the vendor SNA engine; retry connection.

Communications Subsystem Not Loaded

The APPC communications software on the local client machine could not be loaded (executed) or has ended. Notify the system administrator.

Usually a registry or PATH problem; check vendor SNA engine PATH/registry entries and retry.

Conversation Busy

Only one APPC verb can be processed at a time by each conversation.

Retry; notify CONNX Tech Support.

Conversation Ended

---

None Required

Conversation Style Mixed

---

Notify CONNX Tech Support.

Conversation Type Mixed

The CONNX DB2 local server has issued both basic and mapped conversation verbs. Only one type of verb is permitted per conversation.

Notify CONNX Tech Support.

CNOS Local Race Reject

The APPC engine is currently processing a Change Number of Sessions (CNOS) request from a local Logical Unit (LU).

Retry after a short wait.

CNOS Partner Logical Unit Reject

The partner Logical Unit rejected a Change Number of Sessions (CNOS) request from the local Logical Unit.

Refer to secondary return code.

Conversation Failure No Retry

The APPC conversation with the partner Transaction Program (the DRDA Application Server) ended due to a permanent error. Notify the system administrator. Do not retry the conversation.

Notify DBA and CONNX Tech Support.

Conversation Failure Retry

The APPC conversation with the partner Transaction Program (the DRDA Application Server) ended due to a temporary error. Restart the connection.

Retry; notify DBA and CONNX Tech Support.

Deallocate Abend

The conversation has been deallocated.

Issued by the host DRDA program; retry; notify DBA and CONNX Tech Support.

Deallocate Abend Program

The APPC conversation has been deallocated.

Issued by the host DRDA program; retry; notify DBA and CONNX Tech Support.

Deallocate Abend Service

The APPC basic conversation was deallocated by the partner Transaction Program (the DRDA Application Server) with dealloc_type set to AP_ABEND_SVC.

Issued by the host DRDA program; retry; notify DBA and CONNX Tech Support.

Deallocate Abend Timer

The APPC basic conversation was deallocated by the partner Transaction Program (the DRDA Application Server) with dealloc_type set to AP_ABEND_TIMER.

Issued by the host DRDA program; retry; notify DBA and CONNX Tech Support.

Deallocate Normal

The partner Transaction Program (the DRDA Application Server) has deallocated the conversation.

None Required

Invalid APPC verb

---

Notify CONNX Tech Support.

Invalid Verb Segment

The APPC Verb Control Block (VCB) extended beyond the data segment boundary.

Notify CONNX Tech Support.

Parameter Check

The APPC verb failed because of a parameter error.

Refer to secondary return code; correct the invalid parameter.

Program Error No Truncation

The partner Transaction Program (the DRDA Application Server) has issued a SEND_ERROR while the conversation was in SEND state. No data was lost.

Retry; notify CONNX Tech Support.

Program Error Purging

---

Retry; notify CONNX Tech Support.

Program Error Truncation

The partner Transaction Program (the DRDA Application Server) issued a SEND_ERROR after sending a partial logical record. Data was lost.

Retry; notify CONNX Tech Support.

State Check

The APPC verb failed because it was invoked from an invalid state.

Refer to secondary return code; retry; notify CONNX Tech Support.

Service Program Error No Truncation

The partner Transaction Program (the DRDA Application Server) or the partner LU issued SEND_ERROR. No data was lost.

Retry; notify CONNX Tech Support.

Service Program Error Purging

The partner Transaction Program (the DRDA Application Server) issued a SEND_ERROR. Data was lost.

Retry; notify CONNX Tech Support.

Service Program Error Truncation

The partner Transaction Program (the DRDA Application Server) issued a SEND_ERROR after sending a partial logical record. Data was lost.

Retry; notify CONNX Tech Support.

Thread Blocking

The calling thread is already blocked.

Retry; notify CONNX Tech Support.

Transaction Program Busy

The CONNX DB2 local server issued a call to the APPC engine while it was processing another call for the same transaction program.

None Required; retry.

Unsuccessful

No data was returned from a RECEIVE_IMMEDIATE request to the partner Transaction Program (the DRDA Application Server).

None Required; retry.