Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-106
PROCESS_GETINFOLIST_ Procedure
•
125: processes that have loaded the specified Guardian loadfile
This is a search-only attribute used to find processes that have loaded a particular
loadfile. The Guardian file name must be specified in
srch-values-list. If the
file name is not fully qualified, the current
=_DEFAULTS DEFINE is used to specify
the omitted system, volume, and subvolume. To search for a file on another
system, the resulting qualified file name and the
nodename parameter must
specify the same system.
This attribute cannot be used in the same
srch-attr-list as 116 or 126.
•
126: processes that have loaded the specified OSS loadfile
This is a search-only attribute used to find processes that have loaded a particular
loadfile. The OSS path name must be specified in
srch-values-list. If the
path name is not absolute, it is applied to the current directory (CWD). To search
for a file on another system, either the specified path name or the CWD must
contain the system name (for example,
/E/sierra), and the nodename
parameter must specify the same system.
This attribute cannot be used in the same
srch-attr-list as 116 or 125.
OSS Considerations
•
The PROCESS_GETINFOLIST_ procedure returns as many complete sets of
values as will fit in the
ret-values-list buffer; it returns no partial sets. In
particular, the OSS attributes OSS controlling terminal (27) and OSS program
pathname (93) can return large amounts of information. The
ret-values-list
buffer must be large enough to accommodate all the information requested.
•
To retrieve the corresponding process handle of an OSS process ID, specify the
desired OSS process ID in the
oss-pid parameter, specify the process handle
attribute code (48) in the
ret-attr-list parameter, and search for only the
specified OSS process ID by setting the
srch-option parameter to 3. Note that
an OSS process can use a number of process handles during its lifetime.
•
The OSS CONT process state is equivalent to the Guardian runnable process
state. The OSS STOP process state is equivalent to the Guardian suspend
process state. The OSS zombie process state has no Guardian equivalent.
•
The OSS attributes OSS controlling terminal (27) and OSS program pathname (93)
can be used only on the local node. For these attributes, either specify the local
node in the
nodename:length parameter, set length to 0, or omit the
parameter.