Guardian Procedure Calls Reference Manual

validmask
output
INT:ref:1
returns a value indicating which of the information parameters had valid information returned.
Each parameter has a corresponding bit in this value set to true if the parameter is valid for
the device, as follows:
pricrtpid<0>
backcrtpid<1>
accessmode<2>
exclusion<3>
syncdepth<4>
file-name<5>
accessid<6>
Returned Value
INT
A file-system error code that indicates the outcome of the call. Error 1 (EOF) indicates there are no
further opens. Error 2 (invalid operation) is returned for nondisk devices that cannot return any
valid information.
Considerations
• Order of returned information
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 are not grouped together in the sequence
of calls.
• High-PIN considerations
If a caller uses OPENINFO to obtain the process ID of a primary or backup process that has
a high PIN, the returned validmask bit for that process ID is 0 and the returned process ID
value is all zeros. Thus, if the primary process has a high PIN, validmask.<0> = 0 and
pricrtpid is zero-filled; if the backup process has a high PIN, validmask.<1> = 0 and
backcrtpid is zero-filled.
• Support for HP NonStop Storage Management Foundation (SMF) objects
The OPENINFO procedure supports single SMF logical files but does not support entire SMF
virtual volumes. If the name of a 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 a SMF virtual volume is supplied, but not a full logical file name, an
error is returned.
If you call the OPENINFO procedure and supply the name of a physical volume that has an
open that was made on a 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.
OSS Considerations
It is often necessary to run OSS processes at high PINs. See "High-PIN considerations" above, for
more information.
OPENINFO Procedure (Superseded by FILE_GETOPENINFO_ Procedure) 927