Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-88
PROCESS_GETINFOLIST_ Procedure
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.
This attribute is undefined if the target system is running an operating system
version earlier than D30.
•
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.
This attribute is undefined if the target system is running an operating system
version earlier than D30.
•
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.
This attribute is undefined if the target system is running an operating system
version earlier than D30.