OSI/FTAM Programming Guide

ManualsBrandsHP ManualsServerHP NonStop G-Series

161

162

163

164

165

166

167

168

169

170

Using FTM Procedure Calls

HP NonStop OSI/FTAM Programming Guide—528612-001

4-51

Handling P-Aborts and U-Aborts

If the action-result value is ZFTM-VAL-ACTION-SUCCESS, the data transfer

has been cancelled.

Handling P-Aborts and U-Aborts

Two types of aborts can be generated: the provider abort (P-abort), and the user abort

(U-abort). A P-abort is generated by any service provider in the OSI stack on the

NonStop system or on the responding system. A U-abort is generated by

application-level peers, such as the program using the NonStop FTAM initiator or the

remote responder.

Table 4-20 shows the sequence of procedures to call and describes the steps to

handle a P-abort or a U-abort. Sometimes you can omit a procedure call associated

with a substep, depending on the context. The sequence of procedures is explained

after the table.

These steps explain the sequence of procedure calls given in Table 4-20.

1. Call APS_EVENT_RECEIVE_ to determine whether an event has been received.

a. If the association is in nowait mode, call MFM_AWAITIOX_ to wait for

completion of the APS_EVENT_RECEIVE_ call and to obtain the status code.

A status code of ZAPS-VAL-STATUS-EVENT means you received an event.

In wait mode, this procedure returns a status code of

ZAPS-VAL-STATUS-EVENT when you receive an event. If

APS_EVENT_RECEIVE_ returns a different status code, to obtain the details

of an error at this stage, call APS_STATUS_, specifying as input the CEPI

returned by the FTM_INITIALIZE_REQ_ procedure for this association.

2. If you receive an event, call APS_STATUS_ to determine which event. If the event

code is ZFTM-VAL-EVT-PABORT-IND, you received a P-abort indication. If the

event code is ZFTM-VAL-EVT-UABORT-IND, you received a U-abort indication.

Table 4-20. Calls for Handling P-Aborts and U-Aborts

Step Action to Take Procedure(s) to Call

1 Get the next event. APS_EVENT_RECEIVE_

a. If nowait mode, await completion of

APS_EVENT_RECEIVE_.

MFM_AWAITIOX_

2 Check status: Is the event ZFTM-VAL-EVT-

PABORT-IND or ZFTM-VAL-EVT-UABORT-IND? Or,

if APS_EVENT_RECEIVE_ returns a status other

than ZAPS-VAL-STATUS-EVENT, is there an error?

APS_STATUS_

3 Get the indication data. FTM_P_ABORT_IND_

FTM_U_ABORT_IND_

4 Discard the association context. APS_DISCARD_