Guardian Application Conversion Guide

Creating and Managing a High-PIN Process
Converting TAL Applications
3–28 096047 Tandem Computers Incorporated
PROCESS_GETINFO_ returns a limited set of information about a specific process
identified by its process handle. It also allows a process to retrieve its own process
handle.
PROCESS_GETINFOLIST_ returns detailed information about a specific process or
about all processes within a CPU that meet a list of search criteria. This procedure
also allows you to identify a process using the CPU and PIN if the process handle is
not available.
PROCESS_GETPAIRINFO_ returns information about a named process or process
pair, including the process handle for the current primary process, the backup process
(if one exists), and the ancestor process (if one exists).
Setting Process Attributes for a High-PIN Process
Your existing program might call one of the following C-series procedures to set
attributes for a process. To set attributes for a high-PIN process, convert your program
to call the appropriate D-series procedure.
C-Series Procedure D-Series Procedure
ALTERPRIORITY PROCESS_SETINFO_
PRIORITY PROCESS_SETINFO_
PROCESSFILESECURITY PROCESS_SETINFO_
SETMYTERM PROCESS_SETSTRINGINFO_
STEPMOM PROCESS_SETINFO_
PROCESS_SETINFO_ alters a single attribute of a process and optionally returns the
attribute’s previous value. PROCESS_SETINFO_ supersedes PRIORITY, except that it
does not return the initial priority. To return the initial priority, use the
PROCESS_GETINFOLIST_ procedure.
PROCESS_SETSTRINGINFO_ alters a single string attribute of a process and
optionally returns the attribute’s previous value.
Both procedures require a process handle as an input parameter to specify the process.
A process can specify itself by omitting the process handle input parameter or by
setting this parameter to a null value (-1 in each word).
In the following example, PROCESS_SETSTRINGINFO_ sets the home terminal name
of the calling process to the value of parameter new^home^term and returns the old
home terminal name and length in parameter old^home^term and
old^home^term^length . If you use the ZSYSTAL file, set the
home^term^attribute parameter to ZSYS^VAL^PINF^HOMETERM.