HP-UX SNAplus2 R7 APPC Programmer's Guide

TP Server Verbs
ABORT_ATTACH
5.8 ABORT_ATTACH
The ABORT_ATTACH verb is used to end the processing of the attach by this TP server after the attach has been
accepted using an ACCEPT_ATTACH verb because the TP server or TP has encountered an error during further
processing. For example, the TP server was unable to fork to the TP. The ABORT_ATTACH verb can be issued
by both the TP server and the TP processes.
5.8.1 VCB Structure: ABORT_ATTACH
The definition of the VCB structure for the ABORT_ATTACH verb is as follows:
typedef struct abort_attach
{
AP_UINT16 opcode;
unsigned char rsrvd1; /* Reserved */
unsigned char rsrvd2; /* Reserved */
AP_UINT16 primary_rc;
AP_UINT32 secondary_rc;
AP_UINT32 tps_id;
unsigned char attach_id[8];
AP_UINT32 reason;
} ABORT_ATTACH;
5.8.2 Supplied Parameters
The TP supplies the following parameters to APPC:
opcode
AP_ABORT_ATTACH
tps_id
The ID of the TP server, as returned on a previous REGISTER_TP_SERVER verb.
attach_id
The ID of the attach to be aborted, as returned by the attach notification callback.
reason
The reason the automatic start is being aborted. The value is an SNA sense code as shown in Section 5.7.3,
Returned Parameters.
5.8.3 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
Successful Execution
If the verb executes successfully, APPC returns the following parameter:
primary_rc
AP_OK
Unsuccessful Execution
If the verb does not execute successfully, APPC returns a primary return code parameter to indicate the type of
error and a secondary return code parameter to provide specific details about the reason for unsuccessful execution.
265