OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-132
FTM_SELECT_REQ_
FTM_SELECT_REQ_
This procedure allows you to make a file available for access. You must have
previously established an association with a remote responder. This procedure initiates
the file-selection regime. For a description of the file-selection 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.
filename input
INT .EXT:ref:(ZAPS-DDL-CHAR128)
is the name of the file to be selected. The name should uniquely identify the file,
according to the requirements of the remote system. You can specify a maximum
of 128 characters for the file name.
filename is a required parameter.
requested-access input
INT .EXT:ref:(ZFTM-DDL-REQUESTED-ACCESS)
specifies the level of access to the file you are requesting. The requested access
does not have to reflect full file-action capabilities as specified in the
permitted-actions field of the initial-attributes parameter of the create
request, but it must be a subset of these capabilities. The default access requested
will be ZREAD and ZREADATTR.
requested-access is an optional parameter.
status := FTM_SELECT_REQ_ ( cepi ! I
, filename ! I
, [ requested-access ] ! I
, [ access-passwords ] ! I
, [ account ] ! I
, [ tag ] ) ; ! I