Open System Services Programmer's Guide

Table 10 OSS and Guardian Process Attribute Comparison (continued)
Part of a Guardian Process?Part of an OSS Process?Process Attribute
AlwaysAlwaysGuardian user ID
AlwaysAlwaysOSS group ID
NeverAlwaysOSS parent process ID
NeverAlwaysOSS process ID
AlwaysAlwaysOSS user ID
Program type
AlwaysNeverGuardian
NeverAlwaysOSS
Terminals
SometimesSometimesGuardian home terminal
NeverSometimesOSS controlling terminal
SometimesAlwaysnice scheduling priority
Process-Management Interoperability
In general, you should manage OSS processes with OSS functions, because your applications are
more portable. However, there might be cases in which you want to use Guardian procedures to
manage OSS processes or OSS functions to manage Guardian processes. For example, if you
want to use a product or subsystem that runs only in the Guardian environment, you might need
to manage a process from the opposite environment.
The process handle of an OSS process allows most Guardian process-management procedures to
access it. On the other hand, a Guardian process does not have an OSS process ID, which is
required by many OSS process-management functions. This means that some OSS
process-management functions cannot access Guardian processes.
Table 11 lists and provides a short description of the Guardian process-management procedures
that can access OSS processes. Note that the only principal Guardian process-management
procedure missing from this list is PROCESS_LAUNCH_, because it can create only Guardian
processes. Table 14 (page 156) provides a summary of all Guardian process-management
procedures.
Procedures that are indicated as “superseded” in the Guardian Procedure Calls Reference Manual
are not included in this table, because you should not use them for new program development.
Table 11 Guardian Process-Management Procedures That Can Access OSS Processes
DescriptionGuardian Procedure
Examines a system message to determine whether a process has stoppedCHILD_LOST_
Converts a (process) filename to a process handleFILENAME_TO_PROCESSHANDLE_
Returns a null OSS process IDOSS_PID_NULL_
Returns a suspended process to a ready statePROCESS_ACTIVATE_
Invokes the debugging facility on a processPROCESS_DEBUG_
Gets a limited set of information about a processPROCESS_GETINFO_
Gets detailed information about a process or set of processesPROCESS_GETINFOLIST_
Obtains information about a named process or process pairPROCESS_GETPAIRINFO_
Modifies a single nonstring attribute of a processPROCESS_SETINFO_
Modifies a single string-form attribute of a processPROCESS_SETSTRINGINFO_
Process-Management Interoperability 115