Previous Page Contents Page Next Page

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 SNA Sense Codes.

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.

Parameter Check

If the verb does not execute because of a parameter error, APPC returns the following parameters:

primary_rc

AP_PARAMETER_CHECK

secondary_rc

Possible values are:

AP_BAD_ATTACH_ID

The value specified for the attach_id parameter was not recognized.

AP_BAD_TPS_ID

The value specified for the tps_id parameter was not recognized.

Other Conditions

If the verb does not execute because other conditions exist, APPC returns the following primary return code. For a list of return codes common to all verbs, see Common Return Codes.

primary_rc

AP_UNEXPECTED_SYSTEM_ERROR

Previous Page Contents Page Top of Page Next page