Guardian Application Conversion Guide

Creating and Managing a High-PIN Process
Converting TAL Applications
096047 Tandem Computers Incorporated 3–23
According to C-series rules, the process-deletion message is delivered to whatever
process has the same name as the process that created the terminating process.
For a description of these features, refer to the Guardian Procedure Calls Reference
Manual.
Creating a
Low-PIN Process
Your program might need to create a new process that must run at a low PIN. For
example, a process must run at a low PIN to access files on a remote C-series system.
To create a low-PIN process, call the PROCESS_CREATE_ procedure with the
create^options .<15> bit set to 1. If you use the ZSYSTAL file, set the
create^options parameter to ZSYS^VAL^PCREATOPT^LOWPIN. The system
creates the new process at a low PIN regardless of the HIGHPIN attribute setting for
the program object file:
create^options := ZSYS^VAL^PCREATOPT^LOWPIN;
error := PROCESS_CREATE_(program^file:pf^length,
! library^file:lf^length ! ,
! swap^file:sf^length ! ,
! ext^swapfile:esf^length ! ,
! priority ! ,
! cpu^number ! ,
process^handle,
error^detail,
! name^option:length ! ,
process^desc:max^length,
process^desc^length,
! nowait^tag ! ,
! home^term:home^term^len ! ,
! memory^pages ! ,
! jobid ! ,
create^options);
Managing a
High-PIN Process
This subsection describes how to convert a program to manage a high-PIN process.
Managing a process involves these operations:
Modifying the state of the process by activating or suspending the process,
invoking Inspect or Debug for the process, or stopping or abending the process
Getting information about the process
Setting process attributes
The following paragraphs describe these operations.
The security restrictions for modifying the state of a process and setting process
attributes are described in the Guardian Procedure Calls Reference Manual.