Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-54
OPENINFO Procedure
(Superseded by FILE_GETOPENINFO_ Procedure )
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.