Guardian Procedure Calls Reference Manual

• If another process has become the mom of the specified process by a call to
PROCESS_SETINFO_ or STEPMOM, then the process handle of that other process is returned
in mom's-processhandle.
• By default, an OSS process does not have a mom process; therefore, a null process handle
is returned in mom's-processhandle. An OSS process can have a mom process if it was
created by the OSS tdm_fork() or one of the tdm_exec set of functions; see the online
reference pages or the Open System Services System Calls Reference Manual for details. An
OSS process does have a mom process if a mom process has been explicitly assigned by
either the PROCESS_SETINFO_ or STEPMOM procedure.
Home Terminal Considerations
• The home-terminal file name returned by PROCESS_GETINFO_ is in a form suitable for passing
directly to file-system procedures such as FILE_OPEN_.
• The home terminal is always the same as the home terminal of the original creator (not stepmom)
of the process unless the home terminal is altered by a call to PROCESS_SETSTRINGINFO_,
SETMYTERM, PROCESS_DEBUG_ or DEBUGPROCESS, or the home terminal option is supplied
to PROCESS_CREATE_, PROCESS_SPAWN_, NEWPROCESS, NEWPROCESSNOWAIT,
OSS tdm_fork(), OSS tdm_spawn(), or one of the OSS tdm_exec set of functions.
I/O Processes That Control Multiple Devices
• If processhandle is an I/O process that controls multiple devices, the returned proc-fname
is the name of the first device controlled by that I/O process.
OSS Considerations
• Use this procedure to find out if a process is an OSS process and to retrieve the OSS process
ID associated with the process handle.
• An OSS process can change its processor,pin value during its lifetime. Zombie processes are
not returned, because processor,pin pairs are not defined for zombie processes.The OSS
process ID is a unique identifier representing an OSS process. It is a positive integer. It is not
reused by the system until the process lifetime ends. A zombie process is an inactive process
that will be deleted by its parent process.
Examples
error := PROCESS_GETINFO_ ( proc^handle ,
proc^descriptor:maxlen ,
proc^desc^length , ,
moms^proc^handle , , , , , ,
gmoms^proc^handle , jobid );;
error := PROCESS_GETINFO_ ( proc^handle ,
proc^descriptor:maxlen ,
proc^desc^length , ,
moms^proc^handle , , , , , ,
gmoms^proc^handle ,
jobid, , , , , , , , , , ,
timeout);
Related Programming Manual
For programming information about the PROCESS_GETINFO_ procedure, see the Guardian
Programmer's Guide.
PROCESS_GETINFO_ Procedure 1011