OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-113
FTM_OPEN_REQ_
FTM_OPEN_REQ_
This procedure allows you to make the contents of the previously selected file available
for access. This procedure initiates the file-open regime. For a description of the
file-open 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.
process-mode input
INT .EXT:ref:(ZFTM-DDL-PROC-MODE)
specifies the actions permitted on the file during the file-open regime. If not
specified by your application, process-mode will be the single action ZREAD.
process-mode is an optional parameter.
contents-type input
INT.EXT:ref:(ZFTM-DDL-CNTNTS-TYPE)
allows you to specify the abstract data type of the contents of the file, including the
structuring information. contents-type must either match the contents type of
the file being opened or be an allowed simplification of the document type.
contents-type is an optional parameter. If you do not specify contents-type,
the default value is ZFTM-VAL-CNTNTSTYPE-UNKNOWN, and the remote
responder returns the valid contents-type information for the file, which you retrieve
via the FTM_OPEN_CNF_ procedure call.
If you do specify contents-type, the information includes a document type with
associated parameters (universal-class, string-significance, and
status := FTM_OPEN_REQ_ ( cepi ! I
, [ process-mode ] ! I
, [ contents-type ] ! I
, [ tag ] ) ; ! I