OSI/FTAM Programming Guide

ManualsBrandsHP ManualsServerHP NonStop G-Series

151

152

153

154

155

156

157

158

159

160

Using FTM Procedure Calls

HP NonStop OSI/FTAM Programming Guide—528612-001

4-35

Deselecting Files

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

to deselect an FTAM file. Sometimes you can omit a procedure call associated with a

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

table. The sequence of procedures is explained after the table.

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

1. To end access to the file that was previously selected, call

FTM_DESELECT_REQ_.

a. If the procedure succeeds, it returns a status code of ZAPS-VAL-STATUS-OK.

If the procedure fails, it 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.

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

completion of the FTM_DESELECT_REQ_ call. MFM_AWAITIOX_ gives you

the status code for the completed procedure call. For more information on the

MFM_AWAITIOX_ procedure, refer to the OSI/FTAM Programming Reference

Manual.

c. If you call MFM_AWAITIOX_ and the status code returned is not ZAPS-VAL-

STATUS-OK, call APS_STATUS_, specifying as input the CEPI returned by the

FTM_INITIALIZE_REQ_ procedure for this association.

2. Next, to receive a deselect confirm event, call APS_EVENT_RECEIVE_. 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

Table 4-14. Calls for Deselecting an FTAM File

Step Action to Take Procedure(s) to Call

1 Deselect the previously selected file. FTM_DESELECT_REQ_

a. If error returned by FTM_DESELECT_REQ_, check

status.

APS_STATUS_

b. If nowait mode, await completion of

FTM_DESELECT_REQ_.

MFM_AWAITIOX_

c. If error returned by MFM_AWAITIOX_, check status. APS_STATUS_

2 Get the next event. APS_EVENT_RECEIVE_

a. If nowait mode, await completion of

APS_EVENT_RECEIVE_.

MFM_AWAITIOX_

3 Check status: Is the event a deselect confirm? Or, if

APS_EVENT_RECEIVE_ returns a status other than

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

APS_STATUS_

4 Retrieve service confirm information. FTM_DESELECT_CNF_