Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-103
FILE_GETOPENINFO_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation. Error 1
(EOF) indicates that there are no more opens. Error 2 (invalid operation) is
returned for nondisk devices that cannot return any valid information.
searchname:length input:input
STRING .EXT:ref:*, INT:value
specifies the name of the disk file, volume, device, or subdevice about which open
information is to be returned. The value of
searchname cannot be a DEFINE
name. If the name is partially qualified, it is resolved using the =_DEFAULTS
DEFINE.
prevtag input, output
FIXED .EXT:ref:1
is a value identifying the open that was last returned. Before the first call, initialize
prevtag to 0; on subsequent calls, pass the parameter unchanged.
primary-opener output
INT .EXT:ref:10
is the process handle of the (primary) process that has the file open.
error := FILE_GETOPENINFO_ ( searchname:length ! i:i
,prevtag ! i,o
,[ primary-opener ] ! o
,[ backup-opener ] ! o
,[ accessmode ] ! o
,[ exclusion ] ! o
,[ syncdepth ] ! o
,[ filename:maxlen ] ! o:i
,[ filenamelen ] ! o
,[ accessid ] ! o
,[ validmask ] ); ! o