APPC, CPI-C, and SNA Sense Codes
The following return codes apply only to CPI-C programs that use CPI
Resource Recovery (CPI-RR) calls.
For programs using conversations with sync_level set to
CM_SYNC_POINT, all return codes indicating that backout processing is required
have numeric values equal to or greater than CM_TAKE_BACKOUT. This
allows you to test for a range of return code values to determine if backout
processing is required. An example is:
- return_code >= CM_TAKE_BACKOUT
A Backout() request has been made; the local program needs to handle
it.
- Explanation
- The remote program, the local system, or the remote system issued a CPI-RR
Backout() call, and the local application must issue a Backout() call to
restore all protected resources for a context to their status as of the last
synchronization point. The conversation's context is in the
Backout-Required condition upon receipt of this return code.
Once the local program issues a Backout() call, the conversation is placed in
the state it was in at the time of the last sync point operation.
This return code is returned only for conversations with
sync_level set to CM_SYNC_POINT.
- Likely Causes
- The partner program issued a Backout() call.
- Programmer Action
- Your program should return to the point where its last synchronization
point with its partners. The conversation state is now what it was
then. To handle what has occurred since that time, all intervening
logic and code must be executed again.
- Operator Action
- None.
The partner has abruptly ended the conversation.
- Explanation
- The remote program issued a Deallocate() call (CMDEAL) with
deallocate_type set to CM_DEALLOCATE_ABEND, or the remote system
has done so because of a remote program abnormal-ending condition. If
the conversation for the remote program was in Receive state when
the call was issued, information sent by the local program and not yet
received by the remote program is purged.
This conversation with the partner is over.
This return code is returned only for conversations with
sync_level set to CM_SYNC_POINT.
- Likely Causes
- The partner program encountered a condition that caused it to terminate
unexpectedly, or it was stopped unexpectedly by a user. For
example:
- The partner program was processing an error, and encountered another
error. Rather than loop in its error-handling code, the partner program
issued a Deallocate() call with deallocate_type set to
CM_DEALLOCATE_ABEND.
- Programmer Action
- The local conversation's context is in the
Backout-Required condition and the program must issue a CPI-RR
Backout() call to restore all of the context's protected resources to
their status as of the last synchronization point.
The conversation is now in Reset state; the
conversation_ID that was supplied in this CPI-C call is no longer
valid.
- Operator Action
- Correct the problem encountered by the partner program.
The partner program was abnormally terminated, or it ended the
conversation abnormally by issuing a Deallocate() call.
- Explanation
- This return code is returned under one of the following conditions:
- The partner program, using a native APPC (LU 6.2) application
programming interface and not using CPI-C, issued a DEALLOCATE verb specifying
a TYPE parameter of ABEND_SVC. If the conversation for the partner
program was in Receive state when the verb was issued, information
sent by the local program and not yet received by the partner program is
purged.
- The partner program either terminated abnormally or terminated normally
but did not deallocate the conversation before terminating. The CPI-C
or APPC software used by the partner deallocated the conversation on behalf of
the partner program.
This return code is returned for basic conversations only. In
addition, it is returned only for conversations with sync_level set
to CM_SYNC_POINT.
This conversation with the partner is over. This return code is
reported to the local program on a call the program issues for a conversation
in Send or Receive state.
You may see this return code associated with SNA sense data
08640000.
- Likely Causes
- Here are some examples of how this return code is caused.
- This return code is seen locally if the partner program ended unexpectedly
because of a protection fault or other operating system exception.
- If the partner program is running on the AS/400, this return code reports
the absence of a valid routing entry in a subsystem. If no specific
subsystem device or remote location name has been entered, check to see if the
subsystem QCMN is active. If QCMN is active, be sure the routing entry
for APPC programs (PGMEVOKE) is present in the subsystem. If a
subsystem other than QCMN is being used and a specific communications entry or
remote location name entry is being used, be sure a routing entry with
PGMEVOKE is specified in the same subsystem. In both cases, the fix is
to add a routing entry in a subsystem.
- Programmer Action
- The local conversation's context is in the
Backout-Required condition and the program must issue a CPI-RR
Backout() call to restore all of the context's protected resources to
their status as of the last synchronization point.
The conversation is now in Reset state; the
conversation_ID that was supplied in this CPI-C call is no longer
valid.
- Operator Action
- None.
The partner program ended the conversation abnormally by issuing a
Deallocate() call.
- Explanation
-
The remote APPC (LU 6.2) transaction program issued a DEALLOCATE
verb specifying a TYPE parameter of ABEND_TIMER. If the conversation
for the remote program was in Receive state when the verb was
issued, information sent by the local program and not yet received by the
remote program is purged. This return code is reported to the local
program on a call the program issues for a conversation in Send or
Receive state.
This conversation with the partner is over.
This return code is returned for basic conversations only. In
addition, it is returned only for conversations with sync_level set
to CM_SYNC_POINT, and only when the remote transaction program is using a
native APPC (LU 6.2) application programming interface and is not
using CPI-C.
- Likely Causes
- The partner program encountered a condition that caused it to choose to
terminate abnormally.
- Programmer Action
- The local conversation's context is in the
Backout-Required condition and the program must issue a CPI-RR
Backout() call to restore all of the context's protected resources to
their status as of the last synchronization point.
The conversation is now in Reset state; the
conversation_ID that was supplied in this CPI-C call is no longer
valid.
- Operator Action
- None.
The active conversation has been unexpectedly ended, and starting it
again probably will fail.
- Explanation
- A failure occurred that caused the conversation to be prematurely
terminated. For example, the session being used for the conversation
was deactivated because of a session protocol error, or the conversation was
deallocated because of a protocol error between the mapped conversation
components of the systems. The condition is not temporary, and the
program should not retry the transaction until the condition is
corrected. This return code can be reported to the local program on a
call it issues for a conversation in any state other than Reset or
Initialize.
This conversation with the partner is over.
This return code is returned only for conversations with
sync_level set to CM_SYNC_POINT.
- Likely Causes
- The session or link used to get to the partner has been broken, or the
partner program was abruptly stopped. For example:
- The local and partner LUs have been disconnected from each other.
The link or session has been abruptly terminated.
- The partner program was deactivated while it was running.
- The partner computer may have violated internal SNA protocols.
- Programmer Action
- The local conversation's context is in the
Backout-Required condition and the program must issue a CPI-RR
Backout() call to restore all of the context's protected resources to
their status as of the last synchronization point.
The conversation is now in Reset state; the
conversation_ID that was supplied in this CPI-C call is no longer
valid.
- Operator Action
- Examine any platform-related message logs and error logs at both locations
to find more information about this problem. Look for equipment
failures or setup problems related to the network components and the computers
using them. Fix the problem, as indicated by any SNA sense data
associated with this call. You may need to run the applications again
with SNA tracing activated to get the sense data.
After correcting the problem, try running the pair of programs again, if
appropriate.
The active conversation has been unexpectedly ended, and starting it
again may be successful.
- Explanation
- A failure occurred that caused the conversation to be prematurely
terminated. For example, the session being used for the conversation
was deactivated because of a session outage such as a line failure, a modem
failure, or a cryptography failure. The condition may be temporary, and
the program can retry the transaction. This return code can be reported
to the local program on a call it issues for a conversation in any state other
than Reset or Initialize.
This conversation with the partner is over.
This return code is returned only for conversations with
sync_level set to CM_SYNC_POINT.
- Likely Causes
- Some aspect of the partner computer, needed for CPI-C communication, has
been deactivated. Here are some examples of how this return code is
caused.
- The partner computer was powered off or re-booted during the
conversation.
- The partner computer stopped or unloaded its APPC software during the
conversation.
- The partner computer deactivated its data link control (DLC) during the
conversation.
- The local or partner LU deactivated the session in the middle of a
conversation.
- The local LU was notified of a session outage occurring in the
network.
- Programmer Action
- The local program should attempt to allocate a session again. It is
possible for some permanent failures to be initially reported as temporary,
but the allocation of subsequent conversations would also fail.
The local conversation's context is in the Backout-Required
condition and the program must issue a CPI-RR Backout() call to restore all of
the context's protected resources to their status as of the last
synchronization point.
The conversation is now in Reset state; the
conversation_ID that was supplied in this CPI-C call is no longer
valid.
- Operator Action
- Examine any platform-related message logs and error logs at both locations
to find more information about this problem. Look for equipment
failures or setup problems related to the network components and the computers
using them. Fix the problem, as indicated by any SNA sense data
associated with this call. You may need to run the applications again
with SNA tracing activated to get the sense data.
After correcting the problem, try running the pair of programs again, if
appropriate.
The local program issued a Send_Error() call, but the conversation with
the partner had already been deallocated.
- Explanation
- When a Send_Error() call (CMSERR) is issued in Receive state,
incoming information is purged by the system. This purged information
may include a notification of Deallocate-Abend from the remote program or
system. When such a notification is purged, CPI-C returns
CM_DEALLOCATED_NORMAL_BO instead of one of the following return codes:
- CM_DEALLOCATED_ABEND_BO,
- CM_DEALLOCATED_ABEND_SVC_BO, or
- CM_DEALLOCATED_ABEND_TIMER_BO.
This conversation with the partner is over.
This return code is returned only for conversations with
sync_level set to CM_SYNC_POINT.
- Likely Causes
- The partner program deallocated the conversation unexpectedly.
- Programmer Action
- The local conversation's context is in the
Backout-Required condition and the program must issue a CPI-RR
Backout() call to restore all of the context's protected resources to
their status as of the last synchronization point.
The conversation is now in Reset state; the
conversation_ID that was supplied in this CPI-C call is no longer
valid.
- Operator Action
- None.
[ Top of Page | Previous Page | Next Page ]