Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-32
OPEN^FILE Procedure
corresponding to the flags parameter. A 0 indicates the default setting is used. If
this parameter is omitted, all positions are treated as zeros.
max-recordlen input
INT:value
specifies the maximum record length for records within this file. If this parameter is
omitted, the maximum record length is 132.
The open is aborted with an SIOERR^INVALIDRECLENGTH, error 520, if the file’s
record length exceeds the maximum record length and
max-recordlen is not 0.
If
max-recordlen is 0, then any record length is permitted.
prompt-char input
INT:value
specifies the interactive prompt character for reading from terminals or processes.
“?” is the default prompt. The prompt character is limited to seven bits, <9:15>.
error-file-fcb input
INT:ref:*
if present, specifies a file where error messages are displayed for all files. Only
one error-reporting file is allowed per process. The file specified in the latest
OPEN^FILE call is the one used. Omitting this parameter does not alter the setting
of the current error-reporting file.
The default error-reporting file is the home terminal.
If the error-reporting file is not open when needed, it is opened only for the duration
of the message printing, then closed. Remember that the error-reporting file FCB
must be initialized.
Refer to the
Guardian Programmer’s Guide for information about the file FCB.
General Considerations
•
Specifics of AUTO^TOF
If AUTO^TOF is ON, a top-of-form control operation is performed to the file when
both (1) the file being opened is a process or a line printer, and (2) write access is
specified.
•
When read/write access is not permitted
If the file is an EDIT file or if blocking is specified, either read or write access must
be specified for the open to succeed. Read/write access is not permitted.
•
Accessing a temporary disk file