OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-152
FTM_WRITE_REQ_
ZFTM-VAL-FADUID-FIRST for the ZFIRSTLAST field. This value specifies the
beginning of the first FADU after the root FADU and applies only to FTAM-1
and FTAM-3 document types.
ZFTM-VAL-FADUID-END for the ZBEGINEND field. This value specifies the
end of the last FADU and applies only to FTAM-2 document types.
fadu-id 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 successfully complete this procedure call, these conditions must be met:
°
The association must be in the file-open regime.
°
You must have negotiated the write functional unit and a service class other
than the file-management service class when the association was established
via the FTM_INITIALIZE_REQ_ call.
•
For the responder to respond affirmatively to the write-request primitive, either the
replace, insert, or extend field of the permitted-actions field of the file must be set
to ON.
•
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.
•
Completion of the FTM_WRITE_REQ_ procedure call transfers the application to
the data-transfer regime.
•
This procedure applies only to the FTAM-1, FTAM-2, and FTAM-3 document types.
An application cannot write to NBS-9 files.