TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-76
#CONVERTPHANDLE Built-In Function
#CONVERTPHANDLE Built-In Function
Use #CONVERTPHANDLE to convert a process file identifier to a process handle or a
process handle to a process file identifier.
integer-string
is a process handle represented by ten integers, each separated by a period.
process-identifier
is a process name or CPU,PIN.
Results
If you specify PROCESSID, #CONVERTPHANDLE returns a process name for the
specified integer sequence. If the process is not named, TACL returns the CPU and
PIN. The node name is always included. If the specified process handle is not valid,
TACL returns an error.
If you specify INTEGERS, #CONVERTPHANDLE returns a process handle,
represented as ten integers. If the process does not exist, a null process handle,
consisting of the value 65535 in each of the ten integers, is returned.
Considerations
Process handles are the D-series successor to process identifiers (CRTPIDs) for
process-control purposes. Process handles can occur in SPI buffers and in operating
system messages. TACL provides a process handle in the TACL structure
:_COMPLETION^PROCDEATH for completion handling on D-series systems.
Use the external format of a process handle (ten integers separated by periods) if you
need to present a process handle to TACL in external form, as in calls to #SSPUT and
#SET.
Examples
1. This function call converts a ten-integer process handle to its corresponding
process identifier:
10> #CONVERTPHANDLE/PROCESSID/ 512.31.2.18.0.0.11.57728.0.243
\SYS2.$S
#CONVERTPHANDLE
{ / PROCESSID / integer-string } |
{ / INTEGERS / process-identifier }
Note. The format for a process handle is defined by as part of the TACL software product and
is subject to change in future RVUs.