Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-113
FILE_OPEN_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation. Some
values are warnings (that is, they indicate conditions that do not prevent the file
from being opened); see the
filenum parameter, below, for determining whether
the file was opened successfully.
filename:length input:input
STRING .EXT:ref:*, INT:value
specifies the name of the Guardian file to be opened. The value of
filename
must be exactly
length bytes long and must be a valid file name or DEFINE
name. If the name is partially qualified, it is resolved using the contents of the
=_DEFAULTS DEFINE.
pathname input
specifies the OSS file to be opened.
length is ignored; the pathname parameter
is terminated by a null character.
options.<10> must be set to 1 to open an OSS
file by its pathname. See Appendix D, File Names and Process Identifiers
, for a
description of OSS pathname syntax.
error := FILE_OPEN_ ( {filename|pathname}:length } ! i:i
,filenum ! i,o
,[ access ] ! i
,[ exclusion ] ! i
,[ nowait-depth ] ! i
,[ sync-or-receive-depth ] ! i
,[ options ] ! i
,[ seq-block-buffer-id ] ! i
,[ seq-block-buffer-len ] ! i
,[ primary-processhandle ] ! i
,[ elections ] ); ! i