TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-306
#PROCESSINFO Built-In Function
•
The process ID that follows the slashes determines where TACL searches for a
process:
°
TACL uses a starting CPU,PIN if specified; otherwise, TACL uses the CPU and
PIN of its own primary process. TACL starts searching at that CPU and PIN,
then searches higher PINs in the same CPU. If no matching process is found,
TACL searches higher-numbered CPUs for a matching process.
°
If you specify a $process-name, TACL uses the CPU,PIN of the primary
process of that process pair as the starting point.
°
If you specify a process pair, TACL returns information about whichever
process of the pair, primary or backup, it finds first. If, for example, the primary
process of a process pair is running in CPU 4 and the backup process is
running in CPU 2, TACL returns information about the backup process if you
specify the starting point of the search as CPU,PIN 0,0; it would return
information about the primary process if the search were to start at CPU,PIN
3,0.
°
If you specify nothing, TACL starts searching from the CPU,PIN of its own
primary process.
•
The starting CPU and PIN affect whether #PROCESSINFO returns information
about a primary or backup process. TACL returns information about the first
matching process that occurs at or beyond the starting point of the search.
•
If no process can be found that matches the specifications (RESULT returns a
value other than 0 or 1) no other results are returned. Therefore, you should use
the RESULT option first.
•
If you include one or more SEARCH options, TACL uses the CPU,PIN as the
beginning search point.
•
If you use SEARCH more than once, the process must meet all the specified
criteria.
•
To obtain information about a process on a node other than the current default
system, specify the remote node by using a SEARCH SYSTEM or SEARCH
PROCESSID command (see Examples
on page 9-308).
You can specify the search system redundantly, using both SEARCH and a
system specification following the option set, but if you give conflicting system
specifications, TACL returns RESULT = 99 (inconsistent parameters).
•
Because the home terminal and process-ancestor job ID of a process can reside
on different systems from the process itself, specifying a system by either of:
#PROCESSINFO /SEARCH HOMETERM \system.$terminal-name/
#PROCESSINFO /SEARCH GMOMJOBID \system.$process.job-id/
has no effect on the search system. Note that it is essential to specify a system in
SEARCH HOMETERM or SEARCH GMOMJOBID if the home terminal or process-
ancestor job ID is on a system other than the current default system.