OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-130
FTM_READ_ATTRIB_CNF_
contains values of the attributes associated with the file, returned by the remote
responder. For a description of these attributes, see the OSI/FTAM Programming
Guide.
The initiator limits the length of several of the file attributes and shortens any
attribute value that exceeds these limits. Therefore, if the responder returns a
value for an access-control password that is greater than 32 characters, the
initiator passes only the first 32 characters to the application, or in the case of a
filename attribute, if the value is greater than 128, the initiator passes only the first
128 characters to the application.
file-attrib is an optional parameter.
diagnostic output
INT .EXT:ref:(ZFTM-DDL-DIAGNOSTIC)
provides information that qualifies the success or explains the failure of a
requested action. For a complete list of possible diagnostic values, see
Appendix C, ISO FTAM Diagnostic Messages.
diagnostic is an optional parameter.
Considerations
•
To complete this procedure call successfully, you must have previously called
FTM_SELECT_REQ_, and the association must be in the file-selection regime.
•
Before calling FTM_READ_ATTRIB_CNF_, you must call the following procedures:
FTM_READ_ATTRIB_REQ_
APS_EVENT_RECEIVE_
APS_STATUS_
You call APS_EVENT_RECEIVE_ to receive the confirm event and
APS_STATUS_ to determine, via the APS_STATUS_ event-code parameter, the
proper confirm procedure to use to retrieve the data. You must receive the
ZFTM-VAL-EVT-READATTR- CNF event before calling
FTM_READ_ATTRIB_CNF_.
•
The attributes returned are dependent on responder support of the requested
attributes. The responder might not support all the attributes requested. In such a
case, the responder will give a legal value for those attributes supported and will
respond that no value is available for those attributes not supported.