Guardian Procedure Calls Reference Manual

filename:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the fully qualified file name of the file about which information is being returned. maxlen
is the length in bytes of the string variable filename.
filenamelen
output
INT .EXT:ref:1
is the length in bytes of the name returned in filename.
accessid
output
INT .EXT:ref:1
is the process access ID (user ID) of the opener at the time the open was done.
validmask
output
INT .EXT:ref:1
returns a value indicating which of the output parameters has returned valid information. Each
parameter has a corresponding bit that is set to 1 if the parameter is valid for the device, as
follows:
primary-opener<0>
backup-opener<1>
accessmode<2>
exclusion<3>
syncdepth<4>
filename<5>
accessid<6>
Returned Value
INT
A file-system error code that indicates the outcome of the call. 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.
Considerations
• Opens are not returned in any defined order. In particular, when retrieving information about
all opens on a disk volume, the opens for any one file might not be grouped together in the
sequence of calls.
• The FILE_GETOPENINFO_ procedure supports single SMF logical files but does not support
entire SMF virtual volumes. If the name of an SMF logical file is supplied to this procedure,
the system queries the disk process of the appropriate physical volume to obtain information
about current openers. If the name of an SMF virtual volume is supplied, but not a full logical
file name, an error is returned.
If you call the FILE_GETOPENINFO_ procedure and supply the name of a physical volume
that has an open that was made on an SMF logical file name, information about the open is
returned, but the returned file name is that of the physical file supporting the logical file.
FILE_GETOPENINFO_ Procedure 441