Reconfiguring the system directly

Use the CONFIG command to change the online or offline status of any of the following, directly, that is, without invoking a configuration display or a CONFIGxx parmlib member: available processors, Integrated Cryptographic Facilities (ICRFs), attached to online processors, storage amounts, storage ranges, central storage elements, logical partitions, PCIE function identifiers (PFIDs), or channel paths.

See System Reconfiguration for more information about how to reconfigure the resources associated with a processor or a processor complex. See PR/SM Planning Guide for more information about logical partitions.

 
CF {{CPUAD|CPU}(x[,x]...)[,{ONLINE|ON}   [,{STANDARD |  ZAAP | ZIIP | ANY}] ] }
                         [,{OFFLINE|OFF} [,{STANDARD |  ZAAP | ZIIP | ANY}] ]  
 
   {CORE  (x[,x]...)[,{ONLINE|ON}   [,{STANDARD |  ZAAP | ZIIP | ANY}] ] }
                    [,{OFFLINE|OFF} [,{STANDARD |  ZAAP | ZIIP | ANY}] ]  
 
   {CHP{(xx)    }[,{ONLINE|ON}[,NOVARY][,FORCE]   ] }
       {(aa-bb) }[,{OFFLINE|OFF}[,UNCOND][,FORCE] ]                              
       {(list)  } 
       {(ALL,id)} 
 
   {PFID{(xxxx)     }[,ONLINE|ON            ] }
        {(aaaa-bbbb)}[,{OFFLINE|OFF}[,FORCE]]  
        {(list)     }
 
   {SCM{(dddddddd{M|G|T})[,ONLINE|ON|OFFLINE|OFF]} }
       {(scm_ranges),{OFFLINE|OFF}               }
 
   {{STORAGE|STOR}{(ddddddddM)          }[,{ONLINE|ON}|,{OFFLINE|OFF}] }
                  {(ddddddddM-ddddddddM)}                                     
                  {(E=id)               }                                                    

The parameters are:

CPUAD or CPU

The system is to reconfigure one or more CPUs. The system is also to reconfigure one or more ICRFs attached to specified online CPUs. CONFIG CPU[AD] is allowed when LOADxx option PROCVIEW is set to CPU or CORE,CPU_OK but not CORE.

(x[,x]...)

One or more CPU identifiers. The CPU identifier is a one-to-two-digit hexadecimal value.

ONLINE or ON

The system is to bring the specified processor(s) online. If necessary, the system synchronizes the processor’s TOD clocks. If Integrated Cryptographic Service Facility/MVS (ICSF/MVS) is active, the system brings online any ICRF attached to each processor.

STANDARD or ZAAP or ZIIP or ANY

The system validates that the processor requested to be brought online is the expected processor type. If the processor being configured is not of the specified type, the command is rejected and the system issues message IEE241I with 'PROCESSOR TYPE MISMATCH'.

STANDARD

Standard (general purpose) processor.

ZAAP

IBM® zEnterprise® Application Assist Processor (zAAP).

ZIIP

IBM z Integrated Information Processor (zIIP).

ANY

Any type of processor. ANY is the default if no processor type is specified.

Note: CONFIG ONLINE command variants that do not specify CPU(nn) will not accept this processor type specification. For example, CONFIG ONLINE,ZAAP is not accepted.

OFFLINE or OFF

The system is to take offline the specified processor(s) and any ICRF attached to the processor(s).

STANDARD or ZAAP or ZIIP or ANY

The system validates that the processor requested to be brought offline is the expected processor type. If the processor being configured is not of the specified type, the command is rejected and the system issues message IEE241I with 'PROCESSOR TYPE MISMATCH'.

STANDARD

Standard (general purpose) processor.

ZAAP

IBM zEnterprise Application Assist Processor (zAAP).

ZIIP

IBM z Integrated Information Processor (zIIP).

ANY

Any type of processor. ANY is the default if no processor type is specified.

Note: CONFIG OFFLINE command variants that do not specify CPU(nn) will not accept this processor type specification. For example, CONFIG OFFLINE,ZAAP is not accepted.

CORE

The system is to configure a core online or offline. CONFIG CORE is allowed when in LOADxx option PROCVIEW is set to CORE or CORE,CPU_OK  but not CPU.

(x[,x]...)

One or more core identifiers. The core identifier is a one-to-two-digit hexadecimal value.

ONLINE or ON

The system is to bring the specified core online according to the MultiThreading Mode of the core type. For example, if zIIPs are exploiting a MultiThreading Mode of 2, two threads on the zIIP core are brought online. For more information, see IEAOPTxx MT_CP_MODE and MT_ZIIP_MODE in z/OS MVS Initialization and Tuning Reference.

STANDARD or ZAAP or ZIIP or ANY

The system validates that the core requested to be brought online is the expected core type. If the core being configured is not of the specified type, the command is rejected and the system issues message IEE241I with 'PROCESSOR TYPE MISMATCH'.

STANDARD

Standard (general purpose) core.

ZAAP

IBM zEnterprise Application Assist Processor (zAAP).

ZIIP

IBM z Integrated Information Processor (zIIP).

ANY

Any type of core. ANY is the default if no core type is specified.

Note: CONFIG ONLINE command variants that do not specify CPU(nn) will not accept this core type specification. For example, CONFIG ONLINE,ZAAP is not accepted.

OFFLINE or OFF

The system is to take offline all threads on the specified core.

STANDARD or ZAAP or ZIIP or ANY

The system validates that the core requested to be brought offline is the expected core type. If the core being configured is not of the specified type, the command is rejected and the system issues message IEE241I with 'PROCESSOR TYPE MISMATCH'.

STANDARD

Standard (general purpose) core.

ZAAP

IBM zEnterprise Application Assist Processor (zAAP).

ZIIP

IBM z Integrated Information Processor (zIIP).

ANY

Any type of core. ANY is the default if no core type is specified.

Note: CONFIG OFFLINE command variants that do not specify CPU(nn) will not accept this core type specification. For example, CONFIG OFFLINE,ZAAP is not accepted.

Note: When running a machine that supports multiple threads per core, configuring a core means multiple threads will be configured.

STORAGE or STOR

The system is to reconfigure central storage, both logically and physically. Note that storage reconfiguration is not supported on all processors and that central storage reconfiguration in a PR/SM environment without enhanced dynamic storage reconfiguration must be specified by storage element ID. The starting and ending addresses of the central storage for which you want the status display.

ddddddddX

The amount of central storage to be reconfigured. Specify up to eight decimal digits followed by a multiplier (M-megabytes, G-gigabytes, T-terabytes, P-petabytes) for this amount. Check the configuration of your processor to see which size storage increments are supported. The value for dddddddd must be a multiple of the storage increment size (usually 2, 4, or 8), and cannot exceed 16383P.

Instead of specifying a decimal amount, you may specify a hexadecimal amount, with or without a multiplier, in the format X'xxxxxx'. For example:

• X'123456789A00000'
• X'123'M

You may use underscores in any hexadecimal specification for better clarity. Underscores in the specification are ignored during processing.

ddddddddX-ddddddddX

The starting and ending addresses of the central storage section to be reconfigured. Specify up to eight decimal digits followed by a multiplier (M-megabytes, G-gigabytes, T-terabytes, P-petabytes) for each address. The value for each dddddddd must be a multiple of the storage increment size (usually 2, 4, or 8), and cannot exceed 16383P. The starting and ending addresses must not be the same.

Instead of specifying the range using decimal numbers, you may specify it in hexadecimal, with or without a multiplier, in the format X'xxxxxx'-X'xxxxxx'. For example:

• X'123456789A00000'-X'123456789B00000'
• X'123'M-X'124'M

You may use underscores in any hexadecimal specification for better clarity. Underscores in the specification are ignored during processing.

E=id

The storage element to be reconfigured, identified by the storage element id. Use this parameter only under the direction of a system programmer to take a storage element offline or online.

ONLINE or ON

The system is to bring the specified storage range or storage element online. The system rejects the command if you specify:

• An address higher than the storage limit set at system initialization
• An address or an element id for storage that is not available to the system

OFFLINE or OFF

The system is to take the specified storage range or storage element offline.

Note:

1. There can be a delay between the time you enter CONFIG STOR ... OFFLINE and the time the system issues a message indicating the storage is offline. This delay occurs when there is activity in the specified storage; all activity in the storage must stop before the command can take effect. If the storage does not go offline within a short time, a message appears that lets you cancel the command.
2. When you issue CONFIG STOR ... OFFLINE without E=id, the system rejects the command if you specify storage that is either part of the hardware system area (HSA) or assigned permanently to the system. Generally, you can take non-preferred (reconfigurable) storage offline, but, you cannot take preferred (non-reconfigurable) storage offline.
3. When you issue CONFIG STOR ... OFFLINE with E=id, the system moves any storage associated with the HSA or permanently assigned to the system to another storage element. The system saves the addresses of the former storage and displays their address ranges.
4. In order to configure a range of storage online through the CONFIG STOR(xx-xx),ONLINE command, the subject storage must be in a storage element that is online. If a storage element is offline, the only way to bring online any storage within that element is to configure the entire element online, through CONFIG STOR(E=id),ONLINE.

SCM(dddddddd{M|G|T}),ONLINE|ON

SCM(dddddddd{M|G|T}),OFFLINE|OFF

SCM(scm_ranges),OFFLINE|OFF

The system reconfigures storage-class memory (SCM), both logically and physically. To bring SCM online, an amount must be specified. To take SCM offline, a range of starting and ending addresses of the SCM blocks must be specified.

dddddddd{M|G|T}

The amount of storage-class memory (SCM) to be reconfigured. Specify up to eight decimal digits followed by a multiplier (M-megabytes, G-gigabytes, T-terabytes) for this amount. Check your processor configuration for the supported SCM increment sizes. The value for dddddddd must be a multiple of the SCM increment size (usually 2, 4, or 8), and cannot exceed 16T.

Instead of specifying a decimal amount, you can alternatively specify a hexadecimal amount, with or without a multiplier, in the format X'xxxxxx'. For example:

• X'123456789A00000'
• X'123'M

You can use underscore characters in any hexadecimal specification for additional clarity. Underscore characters in the specification are ignored during processing.

Attention: If you are taking SCM offline and you do not specify one or more scm_ranges, the system will select which SCM increments to take offline.

ONLINE or ON

The system brings the specified amount of SCM online. ONLINE is the default value if only CONFIG SCM is specified. The system rejects the command under any of the following conditions:

• You specify a value that is not a multiple of the SCM increment size.
• You specify a value that exceeds the total amount of SCM that is defined to this partition.
• You specify a value that is not a valid amount of SCM (0, for example).
• SCM is not supported or not defined on the system.

OFFLINE or OFF

The system takes the specified amount or specified ranges of SCM offline.

Attention: Taking SCM offline can impact data reliability and performance. Consider the following implications before taking SCM offline:

• Your system must have enough auxiliary storage, which can include SCM and must include page data sets, to back critical system data. The CONFIG SCM OFFLINE command will fail if taking the specified amount of SCM offline would leave auxiliary storage more than 50% full.
• SCM is used for paging critical address spaces and common address spaces. An insufficient amount of SCM causes those address spaces to page to page data sets, which could lead to a loss of critical data during a DASD HDD HyperSwap® scenario.
• SCM is used for paging large pages. If there is an insufficient amount of SCM, 1M large pages are demoted to 256 4K pages and paged to page data sets, which could have a negative impact on system performance.

scm_ranges

Specifies a range of SCM or a list of ranges separated by commas identified by ddd{M|G|T}-ddd{M|G|T} (for example: 0G-16G,32G-64G). The starting and ending addresses for each range of SCM must be multiples of the increment size.

CHP

The system is to reconfigure one or more channel paths.

Note that if you have systems running on a processor at the z990 level or higher, you can automatically reconfigure channel paths on and offline using the hardware management console (HMC) instead of issuing the CONFIG command. On a z990, you may have multiple logical channel subsystems, which means that if an ESCON card fails, you need to reconfigure 15 channels being used across 30 different partitions in each logical channel subsystem. Automatic CHPID reconfiguration lets you issue a reconfiguration request centrally from HMC, which in turn triggers the z/OS® systems in each partition to issue the CONFIG command. Then only those partitions that cannot process the request or are not running on a z990 level processor or higher need to be individually reconfigured with the CONFIG command.

(xx)

A single channel path identified by xx. The channel path identifier may have a value from 0 to FF.

(aa-bb)

A range of channel paths. The starting and ending channel path identifiers may have values from 0 to FF.

(list)

One or more single channel paths, ranges of channel paths, or a combination of single channel paths and ranges of channel paths. ALL,id cannot be included in the list.

(ALL,id)

All of the channel paths associated with one side of a partitioned processor complex are to be placed online or offline, where id is the identifier (0 or 1) of the side. Use ALL,id only when your processor complex is one that can be partitioned (such as a 3090 Model 400 Processor Complex). Message IEE172I indicates that all channel paths on a side have been brought online or taken offline.

Note: If you configure a partitionable processor from single image to partitioned mode, and a tape mount is pending, the tape drive(s) might not start after you mount them. You can avoid the problem by mounting the tape before you issue the CONFIG CHP(ALL,id),OFFLINE command to perform the partitioning or, after partitioning, you can issue the VARY device,ONLINE command to start the tape drive(s).

ONLINE or ON

The system is to bring the specified channel path(s) online.

ONLINE,NOVARY

The system is to bring the specified channel paths online without bringing online the paths to the associated devices. Use this command when you want to configure online a channel path that does not currently have a device connected. Example 10 shows the operator commands and system responses.

ONLINE,FORCE

Indicates that if the resource being configured online is a channel path, the system attempts to bring the channel path online even if it is offline due to switch port decommissioning or HMC repair and verify reasons. The attempt will fail if the switch port is offline for other reasons (for example, blocked, in maintenance mode, or service required).

OFFLINE or OFF

The system is to take the specified channel path(s) offline. The system rejects this command if it would remove the last path to a device that is:

• In use by a system function
• Online
• Allocated
• A TP device
• The only active console in the system
• A coupling facility.

To remove the last path to all other devices, use the CONFIG command without the UNCOND or FORCE parameters.

OFFLINE,UNCOND

The system is to take the specified channel path(s) offline, even if it is the last path to a device. The system rejects this command if it would remove the last path to a device that is:

• In use by a system function
• Allocated
• A TP device
• The only active console in the system
• A coupling facility in use by an active XES connection on the system from which the CONFIG command is issued. (Structures in the coupling facility can be in use, persistent, or have failed-persistent connectors.)

Use OFFLINE,UNCOND to remove the last path to an unallocated online device. You cannot do this by specifying OFFLINE alone.

OFFLINE,FORCE

Attention: FORCE is a very powerful option. Never specify FORCE unless you understand all its consequences for your system.

The system is to take the specified channel path or paths offline, even if a prior CONFIG CHP or VARY PATH command or a dynamic I/O process has not completed.

The system is to take the specified channel path or paths offline, even if it is the last path to a device. The system rejects this command if it would remove the last path to a device that is:

• The only active console in the system

The last path to all other devices listed in the OFFLINE,UNCOND option can be removed by the OFFLINE,FORCE option

For coupling facility CHPIDs, the OFFLINE,FORCE option should only be used when configuring the last path to the coupling facility offline for the purpose of removing the coupling facility from the current configuration.

Responding to the FORCE option for non-coupling facility channel paths:

Note that some of the messages described here might not appear if a CONFIG CHP(xx),OFFLINE,FORCE command executes concurrently with another command or process that takes paths offline.

If last-path considerations do not apply to any devices, message IEE080D asks whether to continue with offline processing for the channel path.

Reply NO to leave the channel path online.

Reply YES to take the channel path offline.

If last-path considerations do apply, message IEE100E lists any devices that are affected by the OFFLINE,FORCE options. The following message then asks you to confirm the FORCE option:

IEE131D REPLY 'CANCEL' OR 'CONTINUE'

Reply CANCEL to leave the channel path and devices online. Reply CONTINUE if you want to remove the channel path. After you reply CONTINUE, the following message appears:

IEE507D SHOULD ACTIVE DEVICES HAVE I/O TERMINATED?
        REPLY NO OR YES

Reply NO to leave the affected devices online and allocated.

If you specify NO to message IEE507D, the channel path will NOT be configured offline.

Reply YES to have the system stop all I/O in progress on the affected devices, permanently reject all future I/O requests to the devices, and mark the affected devices pending-offline.

If you specify YES to message IEE507D, further system action depends on whether or not there are reserved devices on the channel path you want to take offline:

• If there are no reserved devices on the channel path, the system takes the channel path offline when it stops I/O on the devices.
• If there are reserved devices on the channel path for which there are no alternate paths, you get the following messages after you reply YES to message IEE507D:

  IEE508E NO ALTERNATE PATHS TO RESERVED
                             DEVICES ddd [,ddd]...
  IEE131D REPLY 'CANCEL' OR 'CONTINUE'

  If you do not want to lose I/O on reserved devices, reply CANCEL to terminate the CONFIG command and leave the channel path and devices online. Reply CONTINUE to have the system continue to remove the channel path. After you reply CONTINUE, message IOS062E is issued. All the processors for this image enter a restartable disabled wait (WAIT062) state.

  The IOS062E message asks you to stop all systems sharing the reserved devices so the system can reserve the devices again, if possible, through alternate paths. If the system cannot find alternate paths, it stops I/O in progress on the devices, rejects any future I/O requests to the devices as permanent I/O errors, and marks the devices pending-offline.

  Once the system has been restarted from the wait state, recovery for the channel path will be started and completed. Then, message IOS201E will inform you to start the processors stopped when message IOS062E was issued.

Generally, when CONFIG CHP OFFLINE,FORCE causes the system to take a device offline, you can bring the device back online by bringing online a channel path that provides a path to the device. Once it is back online, the device is again available for allocation. However, if the device was reserved when the system took it offline with the channel path, to bring the device back online and make it again available for allocation, you must provide a path to the device with a CONFIG CHP command and issue a VARY device ONLINE command.

Responding to the FORCE option for a coupling facility:

Note that messages IXL126I and IXL127I might not appear if a CONFIG CHP OFFLINE,FORCE is issued for a coupling facility CHPID while another CONFIG CHP or dynamic activate is still processing coupling facility CHPIDs and has not completed.

Message IXL126I identifies the coupling facility that is affected by the OFFLINE,FORCE option. The following message then asks you to confirm the FORCE option:

  IXL127A  REPLY CANCEL OR
CONTINUE

Reply CANCEL to leave the coupling facility online. Reply CONTINUE if you want to remove the coupling facility.

PFID

The system is to configure the specified list of PCIE function identifiers (PFID) online or offline.

(xxxx)

A single PFID identified by xxxx. The PFID may have a hexadecimal value from 0 to X'FFFF'.

(aaaa-bbbb)

A range of PFIDs. The starting and ending PFIDs may have values from 0 to X'FFFF'.

(list)

One or more single PFIDs, ranges of PFIDs, or a combination of single PFIDs and ranges of PFIDs.

ONLINE or ON

The system is to bring the specified PFID or PFIDs online.

OFFLINE or OFF

The system is to take the specified PFID or PFIDs offline. If a PFID is currently in-use, the CF PFID OFFLINE command for that device fails.

OFFLINE,FORCE

Attention: FORCE is a very powerful option. Never specify FORCE unless you understand all its consequences for your system.

The system is to take the specified PFID or PFIDs offline. If a PFID is currently in-use, the CF PFID OFFLINE command for that device fails. If OFFLINE,FORCE is specified, the PFID is reconfigured offline unconditionally.

cf cpu(2),offline

cf stor(4m-8m),on

cf stor(e=0),offline

cf chp(4-9,12),online

cf chp(00-06),offline,uncond

cf chp(all,1),online

d m=dev(223)

d m=dev(224)

IEE174I 09.05.00 DISPLAY M 197
DEVICE 0223   STATUS=OFFLINE
CHP                   01
PATH ONLINE           N
CHP PHYSICALLY ONLINE N
PATH OPERATIONAL      N

IEE174I 09.05.30 DISPLAY M 200
DEVICE 0224   STATUS=OFFLINE
CHP                   01
PATH ONLINE           N
CHP PHYSICALLY ONLINE N
PATH OPERATIONAL      N

cf chp(1),online,novary

IEE754I NOT ALL PATHS BROUGHT ONLINE WITH CHP(01)
IEE502I CHP(1),ONLINE
IEE712I CONFIG PROCESSING COMPLETE

d m=dev(223)

d m=dev(224)

IEE174I 09.05.40 DISPLAY M 200
DEVICE 0223    STATUS=OFFLINE
CHP                     01
PATH ONLINE             N
CHP PHYSICALLY ONLINE   Y
PATH OPERATIONAL        Y

IEE174I 09.05.50 DISPLAY M 200
DEVICE 0224    STATUS=OFFLINE
CHP                     01
PATH ONLINE             N
CHP PHYSICALLY ONLINE   Y
PATH OPERATIONAL        Y

vary path(223,01),online

d m=dev(223)

d m=dev(224)

IEE174I 09.05.55 DISPLAY M 200
DEVICE 0223    STATUS=ONLINE
CHP                     01
PATH ONLINE             Y
CHP PHYSICALLY ONLINE   Y
PATH OPERATIONAL        Y

IEE174I 09.05.59 DISPLAY M 200
DEVICE 0224    STATUS=OFFLINE
CHP                     01
PATH ONLINE             N
CHP PHYSICALLY ONLINE   Y
PATH OPERATIONAL        Y

cf pfid(99),online

IQP034I PCIE FUNCTION 00000099 ONLINE.
PCIE DEVICE TYPE NAME = (10GbE RoCE              ).
IEE504I PFID(99),ONLINE
IEE712I CONFIG   PROCESSING COMPLETE   

cf pfid(14-15,9A),offline

IQP034I PCIE FUNCTION 0000009A OFFLINE. 
 PCIE DEVICE TYPE NAME = (10GbE RoCE          ).
IEE148I PFID(14) NOT RECONFIGURED - PCI FUNCTION CURRENTLY IN-USE
IEE148I PFID(15) NOT RECONFIGURED - ITEM NOT AVAILABLE
IEE505I PFID(9A),OFFLINE 
IEE712I CONFIG   PROCESSING COMPLETE   

cf pfid(14),offline,force

IQP034I PCIE FUNCTION 00000014 NOT AVAILABLE FOR USE. 
 PCIE DEVICE TYPE NAME = (Hardware Accelerator).
IQP034I PCIE FUNCTION 00000014 AVAILABLE FOR CONFIGURATION.
 PCIE DEVICE TYPE NAME = (Hardware Accelerator). 
IEE505I PFID(14),OFFLINE
IEE712I CONFIG   PROCESSING COMPLETE