OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-151
FTM_WRITE_REQ_
FTM_WRITE_REQ_
This procedure allows you to request transfer of data to the previously opened file. This
procedure initiates 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.
fadu-operation input
INT (32):value
specifies what action the responder should take with data it receives. Valid values
are the following:
ZFTM-VAL-FADU-OP-INSERT
ZFTM-VAL-FADU-OP-REPLACE
ZFTM-VAL-FADU-OP-EXTEND
where the value ZFTM-VAL-FADU-OP-INSERT is valid only for FTAM-2 files, and
the values ZFTM-VAL-FADU-OP-REPLACE and ZFTM-VAL-FADU-OP-EXTEND
are valid for FTAM-1 and FTAM-3 files.
fadu-operation is a required parameter.
fadu-id input
INT .EXT:ref:(ZFTM-DDL-FADU-ID)
specifies the target FADU. This value depends on the document type of the file.
Valid values are the following:
status := FTM_WRITE_REQ_ ( cepi ! I
, fadu-operation ! I
, fadu-id ! I
, [ tag ] ) ; ! I