OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-142
FTM_TRANSFER_END_REQ_
FTM_TRANSFER_END_REQ_
This procedure allows you to signify that no more data transfer is required. Before
calling this procedure, you must call the FTM_DATA_END_REQ_ or
FTM_DATA_END_IND_ procedure. This procedure terminates the data-transfer regime
and moves the association to the file-open 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
•
For this procedure call to complete successfully, two conditions must be met:
°
The application must have previously called the FTM_DATA_END_IND_ or
FTM_DATA_END_REQ_ procedure.
°
The association must be in the data-transfer regime.
•
If you set the nowait operating mode in the FTM_INITIALIZE_REQ_ call, you must
issue an MFM_AWAITIOX_ call to complete the nowait I/O operation.
status := FTM_TRANSFER_END_REQ_ ( cepi ! I
, [ tag ] ) ; ! I