OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-87
FTM_FILE_OPEN_REQ_
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
•
Before calling FTM_FILE_OPEN_REQ_, you must have negotiated a service class
other than the file-management service class, via the FTM_INITIALIZE_REQ_ call.
You must also have negotiated the grouping functional unit and the read or write
functional unit.
•
To successfully complete this procedure call, the association must be in the FTAM
regime.
•
You must issue an MFM_AWAITIOX_ call to complete the nowait I/O operation
when you set the nowait operating mode in the FTM_INITIALIZE_REQ_ call.
•
If the value of the file-status parameter is ZFTM-VAL-FOPEN-OLD, this
procedure does not issue the F-CREATE primitive, and the call results in the
following grouped request:
F-BEGIN-GROUP
F-SELECT
F-OPEN
F-END-GROUP
If file-status is any value other than ZFTM-VAL-FOPEN-OLD, the
FTM_FILE_OPEN_REQ_ call results in the following grouped request:
F-BEGIN-GROUP
F-CREATE
F-OPEN
F-END-GROUP
•
The grouping threshold parameter is set to 2 for this grouped procedure call.
This means that the entire call must either succeed or fail. For instance, if the
file-selection succeeds but the file-open fails, the association remains in the FTAM
regime and the file is not selected.
•
The contents-type parameter does not support the specification of abstract
syntax and constraint set as described in ISO 8571-3, clause 17.1.2.4. This is
consistent with National Institute of Standards and Technology, Stable
Implementation Agreements for Open Systems Interconnection Protocols, section
9.10.2.3.
•
The remote responder supplies values of unassigned initial attributes, depending
on the requirements of the responding system’s FTAM implementation.