Guardian Procedure Calls Reference Manual

user. For logged-on processes, the effective user ID is equivalent to the process access ID
(PAID). For other processes, the effective user ID is invalid and there is no PAID equivalent.
The effective user ID determines access to OSS disk files, and the PAID determines access to
Guardian disk files.
• 26: OSS process ID of the OSS session leader (OSS processes only)
as a search attribute, specifies the session leader.
When used as a return attribute, this attribute returns the session leader. The session leader
returned might identify a process that is no longer valid.
The session leader is an OSS process that has created a session. A session is a collection of
process groups established for job-control purposes. Each process group is a member of a
session. A process is considered to be a member of the session of which its process group is
a member. A newly created process joins the session of its creator. A process can alter its
session membership. There can be multiple process groups in the same session.
• 27: OSS controlling terminal (OSS processes only)
as a search attribute, specifies the controlling terminal of an OSS process as an OSS pathname.
The controlling terminal is identified by a byte length followed by a string. Unlike other
attributes, the string must be null-terminated and the byte length must not include the last null
byte of the string. PROCESS_GETINFOLIST_ returns matching processes if the caller has the
appropriate security. If the pathname is not fully qualified, it is resolved in the current working
directory (cwd) of the calling process. If it cannot be resolved, error 10 is returned.
When used as a return attribute, this attribute returns the controlling terminal of an OSS process
if the controlling terminal exists. The controlling terminal is returned as a byte length followed
by a string. Unlike the controlling terminal search attribute, the return attribute string is not
null-terminated. A byte length of 0 is returned if either the controlling terminal does not exist,
the calling process does not have the appropriate security, or OSS is not running.
Each session can have at most one controlling terminal associated with it, and a controlling
terminal is associated with exactly one session.
This attribute applies only to OSS processes on the same node as the calling process.
• 28: process type
as a search attribute, if 0, specifies a search for all matching processes. If 1, this attribute
specifies a search for matching OSS processes only. Note that attributes 26 and 27 search
only for OSS processes regardless of the setting of this attribute.
When used as a return attribute, this attribute returns 0 if the process is a Guardian process
and 1 if the process is an OSS process. In this capacity, this attribute is equivalent to the
proc-type parameter of the PROCESS_GETINFO_ procedure.
• 30: process time
See the process-time parameter returned by the PROCESS_GETINFO_ procedure.
• 31: wait state
returns the wait field of the process indicating what, if anything, the process is waiting on.
The bits are defined as follows:
Wait on LSIG staus<0>
Wait on LPIPE status<1>
(Reserved)<2:7>
Wait on PON (processor power on)<8>
Wait on IOPON (I/O power on)<9>
Wait on INTR (interrupt)<10>
PROCESS_GETINFOLIST_ Procedure 1027