Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-33
OPEN^FILE Procedure
When using OPEN^FILE to access a temporary disk file, AUTO^CREATE must be
OFF; otherwise, the OPEN^FILE call results in a file-system error 13.
•
Sync depth of open files
All files opened with the OPEN^FILE procedure are opened with a sync depth of 1.
This is the only possible sync depth; no other can be set.
•
Opening $RECEIVE
If you attempt to use a C-series format common FCB with a D-series format FCB
for $RECEIVE, OPEN^FILE fails with an error 536.
•
Error-reporting file
The error-reporting file is used, when possible, for reporting errors. If this file
cannot be used or if the error is with the error-reporting file, the default error-
reporting file is used.
•
Appending data to the file
SIO procedures append data to the file if access is write only and PURGE^DATA is
OFF (the default value).
•
Opening $RECEIVE with the OLD^RECEIVE flag ON
If $RECEIVE is open with the OLD^RECEIVE flag ON (receive C-series format
messages), a subsequent open of the caller by another process on a remote node
that has a name consisting of more than five characters fails with an error 20.
Notification of this failure is not sent to the caller reading $RECEIVE.
•
List of literals used with flags and flags-mask
ABORT^OPENERR (%1D) Abort on open error; defaults to ON (1). If ON and a
fatal error occurs during the OPEN^FILE call, all files are
closed and the process ends abnormally. If OFF (0), the
file-system or SIO-procedure error number is returned to
the caller.
ABORT^XFERERR (%2D) Abort on data transfer error; defaults to ON. If ON
and a fatal error occurs during a data transfer operation
(such as a call to any SIO procedure except OPEN^FILE),
all files are closed and the process ends abnormally. If
OFF, the file-system or SIO-procedure error number is
returned to the caller.
AUTO^CREATE (%10D) Auto create; defaults to ON. If ON, and if open
access is write, a file is created if one does not already
exist. If write access is not given and the file does not exist,
error 11 is returned. If no file code has been assigned or if
the file code is 101, and if a block buffer of at least 1024
bytes is provided, an EDIT file is created. If there is not a
buffer of sufficient size and no new file code is specified,