CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-12
CRE_File_Open_
file_ordinal
identifies the standard file to open. You can use the following symbolic names for
file_ordinal:
flags
if present, specifies CRE options. flags.<0:13> must be 0. flags.<14:15>
specifies the buffering attribute for a spooler collector. If
flags is not passed,
CRE_File_Open_ assumes its value to be 0.
access
if present, specifies read-only, write-only, or read-write access to the file. If the file
is not open and you either do not specify
access or specify its value as -1,
CRE_File_Open_ uses:
•
Read-only access if you are opening standard input
•
Write-only access if you are opening standard output or standard log
If the file is already open and you do not specify
access or specify its value as -1,
CRE_File_Open_ sets the access for the current open to the same value used
when the file was first opened.
CRE_File_Open_ converts extend access to write-only access.
access corresponds to the access parameter to the FILE_OPEN_ system
procedure.
Refer to the FILE_OPEN_ procedure in the
Guardian Procedure Calls Reference
Manual for valid access parameter values.
exclusion
if present, specifies shared, exclusive, or protected access to the file. If the file is
not open and you either do not specify
exclusion or specify its value as -1,
CRE_File_Open_ uses:
•
Shared if the device is a terminal
•
Protected if the device is a process or a disk and the access mode is read-only
•
Exclusive in all other cases
If the file is already open and you do not specify
exclusion or you specify its
value as -1, CRE_File_Open_ sets
exclusion for the current open to the value
used when the file was first opened.
CRE File Ordinal Symbolic Names
CRE^Standard^Input
CRE^Standard^Output
CRE^Standard^Log