Guardian Procedure Calls Reference Manual
(%40000D) Carriage return/line feed (CR/LF) on BREAK; defaults to ON. If ON
and BREAK is enabled, a CR/LF is written to the terminal when BREAK is entered.
CRLF^BREAK
(%400000D) Keep last open time; defaults to OFF. If ON and open access to a
disk file is read only, the “time of last open” file attribute is not updated by this
KEEP^LASTOPENTIME
open. If OFF, the “time of last open” file attribute is updated. This flag is ignored if
the file is not a disk file or if open access is not read only.
(%200000D) Enable level-3 spooling when writing to a spooler collector; defaults
to OFF. If ON, writing to the spooler collector is buffered and a block buffer with
LEVEL3^SPOOL^ENABLE
a length of at least 1024 bytes must be provided. If OFF or if the other requirements
for level-3 spooling are not met, one record at a time is written to the spooler
collector. See Level-3 Spooling Considerations (page 913).
(%20D) File must be new; defaults to OFF. This flag applies only if AUTO^CREATE
is ON. If the file already exists, error 10 is returned.
MUSTBENEW
(%200D) Nowait I/O; defaults to OFF (wait I/O). If ON, nowait I/O is in effect. If
NOWAIT is specified in the open flags of OPEN^FILE, then the nowait depth is 1.
It is not possible to use a nowait depth greater than 1 using SIO procedures.
NOWAIT
(%100000D) Receive C-series format system messages; defaults to OFF. If ON,
system messages read by the caller from $RECEIVE are in C-series format. If OFF,
OLD^RECEIVE
system messages read from $RECEIVE are in D-series format. This flag is ignored
for all files other than $RECEIVE. It is also ignored if you are using a C-series format
FCB; all messages are then in C-series format.
(%4D) Print error message; defaults to ON. If ON, and a fatal error occurs, an error
message is displayed on the error file. This file is the home terminal unless otherwise
specified.
PRINT^ERR^MSG
(%40D) Purge data; defaults to OFF. If ON, and open access is write, the data is
purged from the file after the open. If OFF, the new data is appended to the existing
data.
PURGE^DATA
(%2000D) Read trailing blank trim; defaults to ON. If ON, the count-returned
parameter on a READ^FILE call does not account for trailing blanks.
READ^TRIM
(%1000D) Variable-length records; defaults to OFF for fixed-length records. If ON,
the maximum record length for variable-length records is 254 bytes.
VAR^FORMAT
(%10000D) Write fold; defaults to ON. If ON, writes that exceed the record length
cause multiple logical records to be written. If OFF, writes that exceed the record
length are truncated to record-length bytes; no error message or warning is given.
WRITE^FOLD
(%20000D) Write blank pad; defaults to ON for disk fixedlength records and OFF
for all other files. If ON, writes of less than record-length bytes, including the last
WRITE^PAD
record if WRITE^FOLD is in effect, are padded with trailing blanks to fill out the
logical record.
(%4000D) Write trailing blank trim; defaults to ON. If ON, trailing blanks are
trimmed from the output record before being written to the file.
WRITE^TRIM
EDIT File Considerations
• When creating a file, if you do not assign a file code for the new file or if you assign it a file
code of 101, and if you provide a block buffer of at least 1024 bytes, an EDIT file is created.
If you do not provide a block buffer of sufficient size and if you assign no file code, a file
code of 0 is used. If you assign a file code of 101 but do not provide a block buffer of sufficient
size, an error is returned.
• EDIT files are created with the ODDUNSTR attribute set. EDIT files created before the D20
RVU might not have this attribute set. When opening an EDIT file created before D20 that
does not have the ODDUNSTR attribute set, SIO alters the file so that it has this attribute set.
• Starting in the D20 RVU, the EDIT file directory is written to the end of a new disk extent
whenever a new extent is used (although in the case of a new EDIT file, the directory is not
moved to the end of the primary extent until the first page is filled). The result is that, starting
in D20, an EDIT file might appear to be larger (that is, the value of EOF is greater) when
912 Guardian Procedure Calls (O)