Changes the user capabilities associated with the specified CPUs.
Requires ALTPRI and WORLD privileges.
Format
SET CPU cpu-id[, . . . ]
1 – Parameter
cpu-id
Specifies a decimal value representing the identity of a
processor in an OpenVMS multiprocessing system. On an Alpha 7000
system, the CPU is the backplane slot number of the processor.
2 – Qualifiers
2.1 /ALL
Applies the specified operation to all CPUs in the active set.
2.2 /ASSIGN
/ASSIGN [=option] (Alpha/Integrity servers only)
Assigns the CPU to the current instance if no option is
specified.
If an option is specified, the CPU is assigned to that resource.
Option Description
$$PARTITION The current soft partition of the OpenVMS
instance.
$$HARD_ The hard partition of the OpenVMS instance.
PARTITION
Supported only on AlphaServer systems that support partitioning.
2.3 /AUTO_START
/AUTO_START (Alpha/Integrity servers only)
/NOAUTO_START
Sets or clears the instance-specific autostart flag for the
specified CPUs.
When autostart is enabled, that CPU will join the OpenVMS active
set when it is assigned or migrated into the partition. The CPU
will also autostart if a power-up transition is completed while
the CPU is owned by the issuing instance.
Supported only on AlphaServer systems that support partitioning.
2.4 /CAPABILITY
/CAPABILITY
/NOCAPABILITY
Allows bits in the process user capability mask to be set or
cleared individually, in groups, or all at once.
NOTE
The SET CPU/[NO]CAPABILITY command will fail if there is
an active process that requires a capability that is not
available on any remaining active CPU.
Specifying the /CAPABILITY qualifier has no direct effect, but
merely indicates the target of the operations specified by the
following secondary qualifiers:
/SET=(n[,..Sets all user capabilities defined by the position
values n, where n has the range of 1 to 16.
/CLEAR=(n[,Clears all user capabilities defined by the position
values n, where n has the range of 1 to 16.
The secondary qualifiers can all be used at once as long as the
user capability bits defined in the /SET and /CLEAR parameters do
not overlap.
The /NOCAPABILITY qualifier clears all user capability bits.
2.5 /CLEAR
/CLEAR=(n[,...])
Clears all user capabilities defined by the position values n
specified by the /CAPABILITY qualifier.
2.6 /FAILOVER
/FAILOVER=option (Alpha/Integrity servers only)
/NOFAILOVER
Establishes instance-specific failover relationships for each CPU
in the instance's potential set.
When the instance crashes, CPUs with a failover target other than
the current instance will be assigned or migrated to that target.
Specifying the /FAILOVER qualifier has no direct effect; however,
it indicates the target of the operations specified by the
following options:
Option Description
instance_name The name of any valid running instance in the
current hard partition.
partitionID The numeric ID of any partition (reflected in
the configuration tree) in the current hard
partition. An operating system instance is not
required to be running with this identifier.
$$PARTITION Assigns a resource to the current partition of
the current instance.
$$HARD_ Assigns a resource to the hard partition node
PARTITION of the configuration tree. This makes the CPU
available to multiple soft partitions below it.
The /FAILOVER qualifier generates a resource assignment only when
the current instance crashes.
Supported only on AlphaServer systems that support partitioning.
99
2.7 /GLOBAL
Modifies the global cell SCH$GL_DEFAULT_CPU_CAP. This global cell
is used to initialize the user capability mask of CPUs that are
brought into the active set for the first time.
2.8 /MIGRATE
/MIGRATE=option (Alpha/Integrity servers only)
Transfers ownership of the CPU from the current instance to
another soft partition.
Option Description
instance_name The name of any valid running instance in the
current hard partition.
partitionID The numeric ID of any partition (reflected in
the configuration tree) in the current hard
partition. An operating system instance is not
required to be running with this identifier.
Supported only on AlphaServer systems that support partitioning.
2.9 /POWER
/POWER=option (Alpha/Integrity servers only)
Turns the power on or off in one or more CPU slots. Valid options
are ON and OFF.
Supported only on AlphaServer GS series systems.
2.10 /OVERRIDE_CHECKS
/OVERRIDE_CHECKS (Alpha/Integrity servers only)
Directs the SET/CPU command to bypass a series of checks that
determine whether the specified processor is eligible for removal
from the active set.
2.11 /REFRESH
/REFRESH (Alpha/Integrity servers only)
Examines and updates the OpenVMS context for the specified CPU or
CPUs, using the hardware configuration tree.
2.12 /SET
/SET=(n[,...])
Sets all user capabilities defined by the position values n
specified by the /CAPABILITY qualifier.
2.13 /START
/START (Alpha/Integrity servers only)
Initiates a request for the specified CPU to join the OpenVMS
active set if it is not already there.
3 – Examples
1.$ SET CPU/CAPABILITY/GLOBAL/SET=(2,4)
This command sets user capabilities 2 and 4 in the global cell
SCH$GL_DEFAULT_CPU_CAP.
2.$ SET CPU/CAPABILITY/GLOBAL/SET=(2,4) 0
This command sets user capabilities 2 and 4 in the global cell
SCH$GL_DEFAULT_CPU_CAP, as well in the active CPU 0.
3.$ SET CPU/CAPABILITY/SET=(1,2) 0
$ SHOW CPU/FULL
SYSTEM: EUROS, HP RX2600 (900MHZ/1.5MB)
SMP EXECLET = 3 : ENABLED : STREAMLINED.
CONFIG TREE = VERSION 6
PRIMARY CPU = 0
HWRPB CPUS = 2
PAGE SIZE = 8192
REVISION CODE =
SERIAL NUMBER = US30464615
DEFAULT CPU CAPABILITIES:
SYSTEM: QUORUM RUN
DEFAULT PROCESS CAPABILITIES:
SYSTEM: QUORUM RUN
CPU 0 STATE: RUN CPUDB: 8901C000 HANDLE: 00005D70
OWNER: 000004C8 CURRENT: 000004C8 PARTITION 0 (EUROS)
CHGCNT: 1 STATE: PRESENT, PRIMARY, REASSIGNABLE
PROCESS: TEST11 PID: 20201185
CAPABILITIES:
SYSTEM: PRIMARY QUORUM RUN RAD0
USER: USR1 USR2
SLOT CONTEXT: 901EB000
CPU - STATE..........: RC, PA, PP, CV, PV, PMV, PL
TYPE...........: ITANIUM MAJOR = 31, MINOR = 0
SPEED..........: 900 MHZ
LID............: 00000000
VARIATION......: IEEE FP, PRIMARY ELIGIBLE
SERIAL NUMBER..: 0001A968930A1A25
REVISION.......:
HALT REQUEST...: 0
SOFTWARE COMP..: 7.0
PALCODE - REVISION CODE..: 1.1
COMPATIBILITY..: 0
MAX SHARED CPUS: 0
BINDINGS: * NONE *
FASTPATH:
FGB0
PKA0
PEA0
EIA0
FEATURES:
AUTOSTART - ENABLED.
FASTPATH - SELECTION ENABLED AS PREFERRED CPU.
CPU 1 STATE: RUN CPUDB: 89163480 HANDLE: 00005E80
OWNER: 000004C8 CURRENT: 000004C8 PARTITION 0 (EUROS)
CHGCNT: 1 STATE: PRESENT, REASSIGNABLE
PROCESS: * NONE *
CAPABILITIES:
SYSTEM: QUORUM RUN RAD0
SLOT CONTEXT: 901EC000
CPU - STATE..........: RC, PA, PP, CV, PV, PMV, PL
TYPE...........: ITANIUM MAJOR = 31, MINOR = 0
SPEED..........: 900 MHZ
LID............: 01000000
VARIATION......: IEEE FP
SERIAL NUMBER..: 000363B4B0C5C862
REVISION.......:
HALT REQUEST...: 0
SOFTWARE COMP..: 7.0
PALCODE - REVISION CODE..: 1.1
COMPATIBILITY..: 0
MAX SHARED CPUS: 0
BINDINGS: * NONE *
FASTPATH:
FGA0
EWA0
PKB0
BG0
FEATURES:
AUTOSTART - ENABLED.
FASTPATH - SELECTION ENABLED AS PREFERRED CPU.
$ SET CPU/CAPABILITY/CLEAR=1 0
$ SHOW CPU/FULL
SYSTEM: EUROS, HP RX2600 (900MHZ/1.5MB)
SMP EXECLET = 3 : ENABLED : STREAMLINED.
CONFIG TREE = VERSION 6
PRIMARY CPU = 0
HWRPB CPUS = 2
PAGE SIZE = 8192
REVISION CODE =
SERIAL NUMBER = US30464615
DEFAULT CPU CAPABILITIES:
SYSTEM: QUORUM RUN
DEFAULT PROCESS CAPABILITIES:
SYSTEM: QUORUM RUN
CPU 0 STATE: RUN CPUDB: 8901C000 HANDLE: 00005D70
OWNER: 000004C8 CURRENT: 000004C8 PARTITION 0 (EUROS)
CHGCNT: 1 STATE: PRESENT, PRIMARY, REASSIGNABLE
PROCESS: TEST11 PID: 20201185
CAPABILITIES:
SYSTEM: PRIMARY QUORUM RUN RAD0
USER: USR2
SLOT CONTEXT: 901EB000
CPU - STATE..........: RC, PA, PP, CV, PV, PMV, PL
TYPE...........: ITANIUM MAJOR = 31, MINOR = 0
SPEED..........: 900 MHZ
LID............: 00000000
VARIATION......: IEEE FP, PRIMARY ELIGIBLE
SERIAL NUMBER..: 0001A968930A1A25
REVISION.......:
HALT REQUEST...: 0
SOFTWARE COMP..: 7.0
PALCODE - REVISION CODE..: 1.1
COMPATIBILITY..: 0
MAX SHARED CPUS: 0
BINDINGS: * NONE *
FASTPATH:
FGB0
PKA0
PEA0
EIA0
FEATURES:
AUTOSTART - ENABLED.
FASTPATH - SELECTION ENABLED AS PREFERRED CPU.
CPU 1 STATE: RUN CPUDB: 89163480 HANDLE: 00005E80
OWNER: 000004C8 CURRENT: 000004C8 PARTITION 0 (EUROS)
CHGCNT: 1 STATE: PRESENT, REASSIGNABLE
PROCESS: * NONE *
CAPABILITIES:
SYSTEM: QUORUM RUN RAD0
SLOT CONTEXT: 901EC000
CPU - STATE..........: RC, PA, PP, CV, PV, PMV, PL
TYPE...........: ITANIUM MAJOR = 31, MINOR = 0
SPEED..........: 900 MHZ
LID............: 01000000
VARIATION......: IEEE FP
SERIAL NUMBER..: 000363B4B0C5C862
REVISION.......:
HALT REQUEST...: 0
SOFTWARE COMP..: 7.0
PALCODE - REVISION CODE..: 1.1
COMPATIBILITY..: 0
MAX SHARED CPUS: 0
BINDINGS: * NONE *
FASTPATH:
FGA0
EWA0
PKB0
BG0
FEATURES:
AUTOSTART - ENABLED.
FASTPATH - SELECTION ENABLED AS PREFERRED CPU.
$
In this example, the first SET CPU command sets user
capabilities 1 and 2 for CPU 0. The second SET CPU command
clears capability 1.
4.$ SET CPU/REFRESH/ALL
This command updates the OpenVMS context in this instance for
all CPUs physically residing in the current hard partition.
5.$ SET CPU/FAILOVER=WFGLXA 12
This command sets CPU 12 to failover to another instance
(WFGLXA), if the current instance crashes.
6.$ SET CPU/FAILOVER=$$HARD 13
This command assigns CPU 13 to hard partition ownership if
the current instance crashes. Assignment to the hard partition
makes the CPU visible and available to other instances for
assignment.
7.$ SET CPU/ASSIGN=$$HARD 14
This command assigns CPU 14, currently owned by the instance,
to hard partition ownership. Assignment to the hard partition
makes the CPU visible and available to other instances for
assignment.
8.$ SET CPU/ASSIGN 15
This command assigns CPU 15, currently owned by the hard
partition, to this instance. If the CPU is powered, in
the potential set, and autostart enabled, then it will
automatically join the active set.