Open System Services Programmer's Guide

Guardian Process-Management Procedures
Table 14 displays information about each Guardian procedure that you can use to manage
processes. Procedures that have been superseded by other procedures are not shown. The columns
of the table contain the following:
Guardian Procedure
The name of the procedure and a brief description.
OSS Notes
Additional considerations or restrictions when the Guardian procedure is used on OSS
processes.
For details about a procedure, refer to the Guardian Procedure Calls Reference Manual.
Table 14 Guardian Process-Management Procedures
OSS NotesGuardian Procedure
An OSS parent process must read its $RECEIVE file for
system messages.
CHILD_LOST_
Examines a system message to determine whether a process
has stopped.
If an OSS process is reading Guardian system messages
to monitor an OSS process, it might appear that the
monitored process is alive when it has stopped. See
“Monitoring OSS Processes Reading Guardian System
Messages” (page 126).
FILENAME_TO_PROCESSHANDLE_
Converts a Guardian (process) filename to a process
handle.
OSS_PID_NULL_
Returns a null OSS process ID.
Has the same effect as calling the OSS kill() function
with SIGCONT as the value of the signal parameter.
PROCESS_ACTIVATE_
Returns a suspended process to a ready state.
There are several requirements an OSS process must meet
to use the debugging facility.
PROCESS_DEBUG_
Invokes the debugging facility on a process.
PROCESS_GETINFO_
Gets a limited set of information about a process.
Beginning with the H06.24 and J06.13 RVUs, additional
64-bit process attributes are available. See “New
PROCESS_GETINFOLIST_ Attributes” (page 287) for details.
PROCESS_GETINFOLIST_
Gets detailed information about a process or set of
processes.
Prior to the J06.14 and H06.25 RVUs, OSS processes
cannot belong to process pairs. For OSS process pairs
details, see “OSS Process Pairs” (page 158).
PROCESS_GETPAIRINFO_
Obtains information about a named process or process
pair.
Cannot create an OSS process.PROCESS_LAUNCH_
Creates a Guardian process.
If used to change the priority of an OSS process, the same
security rules apply as for the OSS kill() function.
PROCESS_SETINFO_
Modifies a single nonstring attribute of a process.
PROCESS_SETSTRINGINFO_
Modifies a single string-form attribute of a process.
Cannot create a Guardian process.PROCESS_SPAWN_
Can be used to create a backup process for an OSS
process pair. For OSS process pairs details, see “OSS
Process Pairs” (page 158).
Creates an OSS process.
156 Managing Processes