OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-58
FTM_DELETE_REQ_
FTM_DELETE_REQ_
This procedure allows you to request deletion of the currently selected file. The remote
responder’s successful response to this request primitive terminates the file-selection
regime and moves the association to the FTAM regime. For a description of these
regimes, see the OSI/FTAM Programming Guide.
status return 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) used to identify the specific
association. Use the CEPI value returned from the FTM_INITIALIZE_REQ_
procedure for this association. For additional information on using the cepi
parameter, see the OSI/FTAM Programming Guide.
cepi is a required parameter.
tag input
INT(32):value
is for use in nowait mode only. Specify a unique value to identify this instance of
the procedure call. When the operation is complete, the MFM_AWAITIOX_
procedure returns the tag value, allowing your application to match the completion
with the correct instance of the procedure call. For details on the use of the tag
parameter, see the OSI/FTAM Programming Guide.
tag is an optional parameter.
Considerations
•
To complete this procedure call successfully, the association must be in the
file-selection regime, and you must have set the ZDELETE field of the
requested-action parameter of the FTM_SELECT_REQ_ procedure call to
ON.
•
Before calling FTM_DELETE_REQ_, you must have negotiated the limited-file-
management functional unit via the FTM_INITIALIZE_REQ_ call.
•
For the remote responder to respond affirmatively to this delete primitive, the
delete-file field of the permitted-actions attribute of this file must be set to ON.
status := FTM_DELETE_REQ_ ( cepi ! I
, [ tag ] ) ; ! I