HP TACL Programming Manual page 211

Communicating With
Programmatic
Interfaces
You can access the process name as follows:
PUSH proc^offset proc^len proc^lwa procname
SET VARIABLE proc^len &
[:_completion^procdeath:z^procname:zlen]
[#IF proc^len > 0 |THEN|
SET VARIABLE proc^offset &
[:_completion^procdeath:z^procname:zoffset]
SET VARIABLE proc^lwa [#compute proc^offset+proc^len-1]
SET VARIABLE procname &
[:_completion^procdeath:z^procname^:byte([proc^offset]:&
[proc^lwa])]
]
You can access the termination text as follows:
PUSH termtext^len termtext^lwa termtext
SET VARIABLE termtext^len &
[:_completion^procdeath:z^termtext^len]
[#IF termtext^len > 0 |THEN|
SET VARIABLE termtext^lwa [#compute termtext^len-1]
SET VARIABLE termtext &
[:_completion^procdeath:z^termtext:byte(0:[termtext^lwa])]
]
Section 7, "Using Programmatic Interfaces," describes how to access the SPI and EMS
interfaces. To describe a high-PIN process to one of these interfaces, you must use a
process handle in place of a process identifier (CRTPID). The D-series TACL product
recognizes a new data type called PHANDLE (process handle) for STRUCT variables.
TACL uses ten unsigned integers, separated by periods, to represent a process handle
in external form (as returned by #SSGET or #OUTVAR). Each integer can range from
0 to 65535. Use this external form whenever you send a process handle to TACL (as
used by #SSPUT and #SET). The following example shows a process handle in TACL
external form:
1.3.5.7.9.11.13.15.17.19
To display a process handle, you can use the OUTVAR command or #OUTPUTV
built-in function. The #VARIABLEINFO built-in function with option TYPE returns
type PHANDLE for a process handle field in a STRUCT.
#SSGET and #SSPUT convert a process handle to and from the external form. Neither
function checks the validity of the handle, but #SSPUT checks to make sure the handle
contains ten unsigned integers, each with a value between zero and 65535.
D-series TACL supports the new token data type ZSPI^TDT^PHANDLE, which has
the value type of a process handle. The format of ZSPI^TDT^PHANDLE consists of
107365 Tandem Computers Incorporated
Supplemental Information for D-Series Systems
Communicating With Programmatic Interfaces
A–5