TACL Reference Manual

UTILS:TACL Commands and Functions
HP NonStop TACL Reference Manual—429513-018
8-86
IPUCOM Program
IPUCOM Program
Use the IPUCOM program for a command line interface which can be used to set,
reset, or display an IPU number associated with a process. It can also be used to set
or display CPU-wide controls.
Syntax to set an IPU association:
Either a process name or a CPU pin can be used to associate a process with an IPU. If
the -cpu option is omitted, then the CPU where the IPUCOM program is running is
used. To ensure that the intended process is set, it is recommended to use the -cpu
option with -pin. This also helps a $CMON process to change the CPU assignment
when IPUCOM is running.
-pin <pin>
specifies the PIN of the process whose association is to be set.
-pname <name>
specifies the primary process named <name> for a process pair.
-bname <name>
specifies the backup process named <name> for a process pair.
Remember that the primary and backup processes are on different CPUs. To set an
association betweem them requires two invocations of IPUCOM. For processes that
are not a part of a process pair, use either the -pname or -bname option to specify the
process name. When -pname or -bname is used with the -cpu option, the process
specified is the process named <name> in the specified CPU regardless of its primary
or backup status.
The specified <name> or <pin> and <cpu-number> are all relative to the system where
IPUCOM is running.
Specifying a system name in <name> (for example: \MYSYS.$XYZ) is not allowed and
results in an error from IPUCOM. IPUCOM expects only a local process name in
<name>.
Note.
•
The keywords in each of the command line syntaxes such as -pname, -bname, -pin
and so on are case-insensitive.
•
The numeric values (pin, cpu number, ipu number) must be in decimal format.
•
The maximum command line length supported by IPUCOM is 529 characters.
IPUCOM {-pname <name> | -bname <name> | -pin <pin> } [-cpu
<cpu-number>] <ipu-number>