Processing Completion Information
Supplemental Information for D-Series Systems
107365 Tandem Computers Incorporated
A–3
The ALTERPRIORITY message is defined as follows:
STRUCT altpri^msg;
BEGIN
INT msgcode; == -56
INT userid; == user altering the priority
INT cipri; == command interpreter
== initial priority
INT ciinfile [0:11]; == command interpreter IN file
INT cioutfile [0:11]; == command interpreter OUT file
INT crtpid [0:3]; == process identifier of target
== process
INT progname [0:11]; == program file of target process
INT priority; == new priority for target process
INT phandle [0:9]; == phandle of target process
END;
TACL sends the new message to a C-series $CMON if a user on a D-series operating
system attempts to alter the priority of a process running on a C-series system. The
C-series $CMON process can extract a valid process identifier and ignore the extra
words in the message. The process handle for a process running on a C-series system
can always be converted to a process identifier.
Processing
Completion
Information
Section 5, “Initiating and Communicating With Processes,” describes how to use the
variable:_COMPLETION to access completion information.
Because a D-series PIN does not fit into a CRTPID field, D-series TACL uses a new
structure for completion information. The TACL product provides C-series
compatibility by continuing to support the use of :_COMPLETION.
In previous releases, TACL saved STOP (-5) and ABEND (-6) messages in the variable
:_COMPLETION, if it existed. (TACL defines :_COMPLETION as a STRUCT when
you log on, and the STRUCT remains unless you pop it.)
D-series TACL receives PROCDEATH (-101) messages instead of STOP and ABEND
messages. TACL saves a PROCDEATH message in the variable
:_COMPLETION^PROCDEATH, if it exists. (TACL defines
:_COMPLETION^PROCDEATH as a STRUCT when you log on, and the STRUCT
remains unless you pop it.)
If the variable :_COMPLETION exists, TACL converts the PROCDEATH system
message to a C-series STOP or ABEND system message and stores the message in
:_COMPLETION. Note, however, that if the message represents an unnamed high
PIN process, the message will not fit in :_COMPLETION. In such a case, TACL fills
:_COMPLETION with zeroes.
New D-series TACL applications should use :_COMPLETION^PROCDEATH.
Existing TACL applications may continue to use :_COMPLETION; however, the PIN
in the process identifier field is set to 255 for any high PIN value.