Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (O-Q)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
7-4
OPEN
(Superseded by FILE_OPEN_) Establishes a communication path between an
application process and a file. OPEN returns a file number to the application process.
This procedure operates only on Guardian objects.
CALL OPEN ( filename
,filenum
,[ flags ]
,[ sync-or-receive-depth ]
,[ primary-filenum ]
,[ primary-process-id ]
,[ seq-block-buffer-id ]
,[ buffer-length ]
,[ primary-define ] );
filename, INT:ref:12 input
filenum, INT:ref:1 output
flags, INT:value input
Flag
Flag in
Octal Meaning
<0> %100000 For disk files, if this bit is 1, the “last open time” attribute of the file
being opened is not updated by this open. For other files, this bit
should be zero.
<1> %40000 For the $RECEIVE file only, specifies whether or not the opener
wishes to receive open, close, CONTROL, SETMODE,
SETPARAM, RESETSYNC, and CONTROLBUF messages.
0 = no
1 = yes (must be 0 for all files other than $RECEIVE)
<2> %20000 Specifies that access to an Enscribe file is to occur as if the file were
unstructured, that is, without regard to record structures and
partitioning, (Note that for unstructured files, setting this bit to 1
makes secondary partitions inaccessible.) Setting this bit to 0
provides normal structured access to the file.
0 = normal access
1 = unstructured access
<3> %10000 (Reserved) must be 0 for nonprivileged users.
<4:5> %6000 Access mode
0 = Read/write
1 = Read-only
2 = Write-only
3 = reserved
<6> %1000 Must be 0 (reserved)