Guardian Programming Reference Summary for C

Functions Summary (D-F)
Guardian Programming Reference Summary for C—522630-001
5-34
FILE_OPEN_
Establishes a communication path between an application process and a file and returns
a file number to the caller.
access
exclusion
options
#include <cextdecs(FILE_OPEN_)>
short FILE_OPEN_ ( { const char *filename | /* i */
const char *pathname } /* i */
,short length /* i */
,short *filenum /* i,o */
,[ short access ] /* i */
,[ short exclusion ] /* i */
,[ short nowait-depth ] /* i */
,[ short sync-or-receive-depth ] /* i */
,[ short options ] /* i */
,[ short seq-block-buffer-id ] /* i */
,[ short seq-block-buffer-len ] /* i */
,[ short *primary-processhandle ] );/* i */
0 = Read-write
1 = Read only
2 = Write only
3 = Extend (supported only for tape)
0 = Shared
1 = Exclusive
2 = Process exclusive (supported only for Optical Storage Facility)
3 = Protected
Bit 0 Unstructured access. For disk files, access is to occur as if the file were
unstructured, that is, without regard to record structures and partitioning. (For
unstructured files, setting this bit to 1 causes secondary partitions to be
inaccessible.) Must be 0 for other devices.
Bit 1 Nowait open processing. Specifies that the processing of the open proceed in
a nowait manner. This option cannot be specified for the TMF transaction
pseudofile (TFILE). The value of nowait-depth must be a nonzero value
when this option is used.
Bit 2 No open time update. For disk files, the “time of last open” file attribute is
not updated by this open. Must be 0 for other devices.