OSI/FTAM Programming Reference Manual

APS Procedures

HP NonStop OSI/FTAM Programming Reference Manual—528611-001

F-3

APS_DISCARD_

This procedure allows you to delete the API context information for an association.

After APS_DISCARD_ has completed successfully, you can no longer use the CEPI. In

normal circumstances, call APS_DISCARD_ after the association has been released

or aborted by your application, by the remote responder, or by the service provider. In

exceptional circumstances, you can call APS_DISCARD_ without previously releasing

or aborting the association. Doing this provides the most abrupt disconnection

possible.

status returned value

INT

indicates the outcome of the call. For a list of possible ZAPS-VAL-STATUS-xxx

values, see Table B-1 on page B-2.

cepi input

INT:value

is the connection endpoint identifier (CEPI) for this association. Note that after this

procedure has completed successfully, no further FTM or APS procedures can be

called for this CEPI.

Considerations

•

In nowait mode, do not call MFM_AWAITIOX_ to complete this procedure.

•

You can call APS_DISCARD_ at any time, even when FTAM or APS procedures

are awaiting completion.

•

If a problem occurs and you call APS_DISCARD_, the source of the problem might

be hard to determine: APS_DISCARD_ deletes the subdevice, and it can no longer

be referenced through the SCF interactive interface.

status := APS_DISCARD_ ( cepi ); ! I