OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-123
FTM_READ_REQ_
For more information on the use of the above values, see the OSI/FTAM
Programming Guide or ISO 8571, Part 2.
fadu-id is a required parameter.
access-context input
INT .EXT:ref:(ZFTM-DDL-ACCESS-CNTXT)
specifies the file access structure for transfers in the data-transfer regime. Valid
values are the following:
ZFTM-VAL-ACCESSCNTXT-FA for flat all data units. Both data and node
descriptors are transferred. This value applies to FTAM-2 files only.
ZFTM-VAL-ACCESSCNTXT-UA for unstructured all data units. Only data is
transferred. This value applies to FTAM-1, FTAM-2, FTAM-3, and NBS-9 files.
For a full explanation of this parameter and its usage, see the OSI/FTAM
Programming Guide.
The access-context parameter is required.
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 complete this procedure call successfully, these conditions must be met:
°
The association must be in the file-open regime.
°
You must have negotiated the read 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 remote responder to respond affirmatively to this read primitive, the read
field of the permitted-actions attribute of this file must be set to ON.
ZFTM-VAL-FADUID-CURRENT
ZFTM-VAL-FADUID-NEXT
ZFADUNUMBER (specifies number of FADUs separating desired FADU
from root FADU)
Data Structure Field Possible Values