HP OpenVMS Systems Documentation

HP OpenVMS DCL Dictionary

Changes the user capabilities associated with the specified CPUs.

Requires ALTPRI and WORLD privileges.

Format

SET CPU cpu-id[,...]

Parameter

cpu-id

Specifies a decimal value representing the identity of a processor in an OpenVMS multiprocessing system. On a VAX 6000 system or an Alpha 7000 system, the CPU is the backplane slot number of the processor.

Qualifiers

/ALL

Applies the specified operation to all CPUs in the active set.

/ASSIGN [=option] (Alpha/I64 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_PARTITION	The hard partition of the OpenVMS instance.

Supported only on AlphaServer systems that support partitioning.

/AUTO_START (Alpha/I64 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.

/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.

/CLEAR=(n[,...])

Clears all user capabilities defined by the position values n specified by the /CAPABILITY qualifier.

/FAILOVER=option (Alpha/I64 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_PARTITION	Assigns a resource to the hard partition node 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

/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.

/MIGRATE=option (Alpha/I64 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.

/POWER=option (Alpha/I64 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.

/OVERRIDE_CHECKS (Alpha/I64 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.

/REFRESH (Alpha/I64 only)

Examines and updates the OpenVMS context for the specified CPU or CPUs, using the hardware configuration tree.

/SET=(n[,...])

Sets all user capabilities defined by the position values n specified by the /CAPABILITY qualifier.

/START (Alpha/I64 only)

Initiates a request for the specified CPU to join the OpenVMS active set if it is not already there.

Examples

$ SET CPU/CAPABILITY/GLOBAL/SET=(2,4)
      

This command sets user capabilities 2 and 4 in the global cell SCH$GL_DEFAULT_CPU_CAP.

$ 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.

$ SET CPU/CAPABILITY/SET=(1,2) 0

$ SHOW CPU/FULL

PIPERI, a DEC 3000 Model 500
Multiprocessing is ENABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 1

System Page Size = 8192
System Revision Code =
System Serial Number =
Default CPU Capabilities:
        System:         QUORUM RUN
Default Process Capabilities:
        System:         QUORUM RUN

PRIMARY CPU = 00

CPU 00 is in RUN state
Current Process: VMSADU          PID = 00000094
Serial Number:
Revision:       F001
VAX floating point operations supported.
IEEE floating point operations and data types supported.
PALCODE: Revision Code = 5.48-01
         PALcode Compatibility = 0
         Maximum Shared Processors = 0
         Memory Space:  Physical address = 00000000 00054000
                        Length = 81920
         Scratch Space: Physical address = 00000000 00104000
                        Length = 8192
Capabilities of this CPU:
        System:         PRIMARY QUORUM RUN
        User bitmask:   00000003
Processes which can only execute on this CPU:
        NETACP           PID = 0000008F  Reason: PRIMARY Capability

$ SET CPU/CAPABILITY/CLEAR=1 0

$ SHOW CPU/FULL

PIPERI, a DEC 3000 Model 500
Multiprocessing is ENABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 1

System Page Size = 8192
System Revision Code =
System Serial Number =
Default CPU Capabilities:
        System:         QUORUM RUN
Default Process Capabilities:
        System:         QUORUM RUN

PRIMARY CPU = 00

CPU 00 is in RUN state
Current Process: VMSADU          PID = 00000094
Serial Number:
Revision:       F001
VAX floating point operations supported.
IEEE floating point operations and data types supported.
PALCODE: Revision Code = 5.48-01
         PALcode Compatibility = 0
         Maximum Shared Processors = 0
         Memory Space:  Physical address = 00000000 00054000
                        Length = 81920
         Scratch Space: Physical address = 00000000 00104000
                        Length = 8192
Capabilities of this CPU:
        System:         PRIMARY QUORUM RUN
        User bitmask:   00000002
Processes which can only execute on this CPU:
        NETACP           PID = 0000008F  Reason: PRIMARY Capability

      

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.

$ SET CPU/REFRESH/ALL
      

This command updates the OpenVMS context in this instance for all CPUs physically residing in the current hard partition.

$ SET CPU/FAILOVER=WFGLXA 12
      

This command sets CPU 12 to failover to another instance (WFGLXA), if the current instance crashes.

$ 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.

$ 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.

$ 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.