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-36

Deleting Files

input the CEPI returned by the FTM_INITIALIZE_REQ_ procedure for this

association.

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.

3. If you received an event, call APS_STATUS_ to determine which event. If the event

code is ZFTM-VAL-EVT-DESELECT-CNF, you received a deselect confirm.

4. Next, call FTM_DESELECT_CNF_ to retrieve the data sent by the confirm. Check

the action-result output parameter.

If the action-result value is ZFTM-VAL-ACTION-SUCCESS, the file has been

deselected.

Deleting Files

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

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.

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

1. To delete the currently selected file, call FTM_DELETE_REQ_.

Before issuing the procedure call, check the values assigned to the

requested-access (ZFTM-DDL-REQUESTED-ACCESS) and

access-passwords (ZFTM-DDL-ACCESS-PASSWDS) parameters on the

FTM_SELECT_REQ_ procedure call. The ZDELETE field of the

Table 4-15. Calls for Deleting an FTAM File

Step Action to Take Procedure(s) to Call

1 Delete the currently selected file. FTM_DELETE_REQ_

a. If error returned by FTM_DELETE_REQ_, check

status.

APS_STATUS_

b. If nowait mode, await completion of

FTM_DELETE_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 delete 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_DELETE_CNF_