8.37 CPU (Define target CPU f
or console displays and commands)

8.37.1 Function

The CPU command sets the target CPU for console displays and commands in a Hercules multi-CPU
environment. If the Hercules configuration file sets a single CPU environment, then no CPU command is
necessary. If the NUMCPU system parameter in the Hercules configuration file is set greater than one
and no CPU command is given, then always the first CPU (CPU 0) is the target for console displays and
commands.

If a CPU address is given through the CPU command then this specifies the CPU to which all subsequent
panel commands will apply to. If an optional command follows the CPU address, the command will exe-
cute on this CPU and the target CPU will not be permanently changed.

For example entering command “CPU 0F” followed by command “GPR” will change the target CPU for
panel displays and commands and then display the general purpose registers for CPU #15 whereas the
command “CPU 0F GPR” will execute the GPR command on CPU #15, but will not change the target
CPU for subsequent panel displays and commands.

Please note that the command “CPU 1
CPU 2
” does no change the target to CPU 2 as the last command
(CPU 2) is issued under the temporary CPU 1 environment.

8.37.2 Syntax

Descriptive

CPU hh [cmd]

Diagram

Êʬ¬¬ CPU ¬¬¬ hh ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

cmd

8.37.3 Parameter

hh

The hexadecimal CPU address of the CPU in the multiprocessor configuration
which you wish all console commands to apply to. For example, entering “CPU 0F”
followed by a subsequent command “GPR” in a multi- CPU configuration will dis-
play the general purpose registers for CPU #15 in the configuration, as opposed to
CPU #0. The CPU address is then permanently set to CPU #15, as long as no
other CPU command is given.

cmd

This is the Hercules command that will execute on CPU hh. In this case the CPU
address applies only for this command and is not permanently set to CPU hh.

8.37.4 Examples

Example 1:

Set the target address for subsequent Hercules commands to CPU #4 in a multiprocessor configuration
and display the general purpose registers for this CPU.

HHC00013I Herc command: 'cpu 4'

HHC00013I Herc command: 'gpr'

HHC02269I General purpose registers

HHC02269I CP04: GR00=00000000 GR01=062B7000 GR02=0178F500 GR03=040C1E18

HHC02269I CP04: GR04=00000000 GR05=00000021 GR06=00000000 GR07=0146B847

HHC02269I CP04: GR08=00000000 GR09=03EB0980 GR10=00F67400 GR11=04755D78

HHC02269I CP04: GR12=0146A848 GR13=040C0390 GR14=00000000 GR15=00000336

Figure 80: CPU command (set target CPU address permanently)

Example 2:

Set the target address temporarily to CPU #2 in a multiprocessor configuration and display the general
purpose registers for this CPU.

HHC00013I Herc command: 'cpu 2 gpr'

HHC02269I General purpose registers

HHC02269I CP02: GR00=762DDDF8 GR01=00010016 GR02=00F52D28 GR03=0428E294

HHC02269I CP02: GR04=00FACD80 GR05=01175397 GR06=0428EF58 GR07=00F3C4B8

HHC02269I CP02: GR08=0428E268 GR09=81174398 GR10=0175F060 GR11=00FD12C0

HHC02269I CP02: GR12=03FCD790 GR13=0428E390 GR14=8101250C GR15=811744F4

Figure 81: CPU command (set target CPU address permanently)