VARY PROCESSOR

Read syntax diagramSkip visual syntax diagram VARY ONlineOFFline PROCessor nnnn

Authorization

Privilege Class: B

Purpose

When multithreading is not installed or not enabled, use VARY PROCESSOR to add a processor to the configuration for use by CP or to remove a processor from the configuration. When multithreading is enabled, the VARY PROCESSOR command is not valid and the VARY CORE command must be used.

Operands

ONline
adds a processor to the configuration and makes it available for use by CP.
OFFline
stops the use of a processor and removes it from the configuration.
PROCessor nnnn
specifies the processor to be made available or unavailable. The value nnnn is a hexadecimal number (0000 - 004F) that identifies the address of the processor.

Usage Notes

  1. The last active primary processor cannot be varied offline. A primary processor is a processor whose CPU type matches the type of the system's IPL processor.
  2. If the last unparked processor of a secondary processor type is varied offline while all other online processors of that type are parked, CPU affinity will be temporarily suppressed until one of those processors can be unparked.

    A secondary processor is a processor whose CPU type does not match the CPU type of the system's IPL processor.

  3. If the last processor of a secondary processor type is varied offline, CPU affinity will be suppressed for all user IDs and resource pools defined on the system that have CPU affinity on for that secondary processor type. As soon as a secondary processor of that type is varied online, CPU affinity will be unsuppressed. A resource pool that limits a secondary processor type (like IFL) and that has CPU affinity suppressed will apply the resource pool limit against the number of CP CPUs on the system. For example, if the resource pool limit is set to CAPACITY 1.5, then the resource pool is limited to 1.5 CP CPUs when CPU affinity is suppressed. If the resource pool limit is set to LIMITHARD 20%, then the resource pool is limited to 20% of the CP CPU resource when CPU affinity is suppressed and 20% of the IFL CPU resource when CPU affinity is unsuppressed.

Responses

Response 1: 

PROCESSOR nnnn ONLINE
indicates that the specified processor is now online and operational.
Response 2: 

PROCESSOR nnnn OFFLINE
indicates that the specified processor is now offline and not operational.

Messages

  • HCP003E Invalid option - {option|command contains extra option(s) starting with option}
  • HCP026E Operand missing or invalid
  • HCP039E Processor address missing or invalid
  • HCP880E The command processing cannot complete because processor nnnn is already online.
  • HCP881E The command processing cannot complete because processor nnnn is already offline.
  • HCP882E The VARY command processing cannot complete due to an initialization failure.
  • HCP883E The command processing cannot complete because processor nnnn is not responsive.
  • HCP884E The command processing cannot complete because processor nnnn is the only active primary processor.
  • HCP885E The VARY processing cannot complete because the physical vary failed; processor nnnn is logically offline.
  • HCP886E The VARY command processing cannot complete because processor nnnn is not available.
  • HCP1321E VARY PROCESSOR is not valid because multithreading is enabled.
  • HCP1463I CPU affinity is suppressed for the specified CPU type type
  • HCP1465I CPU affinity is no longer suppressed for the specified CPU type type