Guardian Application Conversion Guide

Creating and Managing a High-PIN Process
Converting TACL Programs
7–6 096047 Tandem Computers Incorporated
Setting High PIN for a New Process
You might create a new process (for example, your requester) using the TACL RUN
command or #NEWPROCESS built-in function:
9> SET HIGHPIN ON
10> RUN requestr / CPU 3, NAME $REQ, NOWAIT /
In the above example, TACL creates the $REC process at a high PIN because the
#HIGHPIN built-in variable is set ON. If #HIGHPIN is OFF, you need to specify
#HIGHPIN ON in the RUN command line:
9> SET HIGHPIN OFF
10> RUN requestr / HIGHPIN ON, CPU 3, NAME $REQ, NOWAIT /
When you issue a D-series RUN command, TACL calls the PROCESS_CREATE_
procedure to create the new process. If the RUN command is unsuccessful, TACL sets
the 4-word built-in variable #ERRORNUMBERS to these values:
word [0] 1149
word [1] PROCESS_CREATE_ error returned value
word [2] PROCESS_CREATE_ error-detail parameter
word [3] 0 (zero)
Note that these values are different from the values returned by TACL running under
the C-series operating system. C-series TACL returns 1101 in word 0 and
NEWPROCESS error information in words 1 and 2. You might need to alter your
program if your program controls flow based on these values.
To run a converted process at a low PIN, set the HIGHPIN run option to OFF when
you issue the RUN command. For example, the following RUN command causes
TACL to create the process at a low PIN in CPU 3 (if a low PIN is available):
10> RUN requestr / HIGHPIN OFF, CPU 3, NAME $REQ, NOWAIT /
Receiving Completion
Codes
Batch processes return completion information indicating whether the process stopped
normally or abnormally. D-series TACL uses a new :_COMPLETION^PROCDEATH
structure for completion information while providing C-series compatibility by
continuing to support the use of :_COMPLETION.
In previous releases, TACL saves Stop (-5) and Abend (-6) messages in the variable
:_COMPLETION, if it exists. TACL defines :_COMPLETION as a STRUCT when you
log on and the STRUCT remains unless you remove it with a POP command.
D-series TACL receives process deletion messages (-101) instead of Stop and Abend
messages. TACL saves each Process deletion message in the variable
:_COMPLETION^PROCDEATH, if it exists. TACL defines
:_COMPLETION^PROCDEATH as a STRUCT when you log on. The STRUCT
remains unless you remove it using the POP command.