VMS Help SET, CPU  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    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 a VAX 6000
    system or 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 - /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.3 - /CLEAR

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

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

 2.4 - /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.5 - /SET

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

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

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

      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.