OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-23
FTM_CANCEL_RSP_
FTM_CANCEL_RSP_
This procedure allows you to communicate the results of actions taken in response
to the responder’s request to cancel the data-transfer regime. For a description of
the data-transfer regime, 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.
action-result input
INT(32):value
allows you to provide information on the success of the remote responder’s cancel
request. The action-result value is never less severe than the most severe
diagnostic value. These are the valid values:
ZFTM-VAL-ACTION-SUCCESS
ZFTM-VAL-ACTION-FAILURE
action-result is an optional parameter. If you do not supply this parameter, it
defaults to ZFTM-VAL-ACTION-SUCCESS.
diagnostic input
INT .EXT:ref:(ZFTM-DDL-DIAGNOSTIC)
allows you to provide further information on the results of actions taken to cancel
the data-transfer regime. For a complete list of possible diagnostic values, see
Appendix C, ISO FTAM Diagnostic Messages. For more information on
application-generated diagnostic messages, see the OSI/FTAM Programming
Guide.
status := FTM_CANCEL_RSP_ ( cepi ! I
, [ action-result ] ! I
, [ diagnostic ] ! I
, [ tag ] ); ! I