chzhyperlink

The chzhyperlink command modifies the zHyperLink control switch for the specified storage image.

Note: zHyperLink connections are not available on DS8882F systems.

Parameters

-read enable | disable: (Optional) The setting of the read control switch.
-write enable | disable: (Optional) The setting of the write control switch.
storage_image_ID: (Required) The storage image ID, which consists of the values for manufacturer, machine type, and serial number.
Note: If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Note: By default, the zHyperLink facility is disabled in z/OS®. To enable z/OS for zHyperLink read or write processing, use the SETIOS MVS™ system command after an IPL, or use the IECIOSxx PARMLIB to enable zHyperLink processing during IPL.

SETIOS MVS Command

To enable zHyperLink read and write processing on the IBM z host system after an IPL, enter the following MVS commands:

SETIOS ZHPF=YES
SETIOS ZHYPERLINK,OPER={READ|WRITE|ALL}

For more information about the SETIOS MVS command, refer to the z/OS MVS System Commands.

IECIOSxx parmlib

To enable zHyperLink read and write processing during an IPL, include the following statements in the IECIOSxx PARMLIB member on the IBM z host system:

ZHPF=YES
ZHYPERLINK,OPER={READ|WRITE|ALL}

For more information about the IECIOSxx PARMLIB member, refer to the z/OS MVS Initialization and Tuning Reference.

Example: Modifying the zHyperLink control switch for the storage image

dscli> chzhyperlink -read enable IBM.2107-75FA120

Output

CMUC00519I chzhyperlink: zHyperLink read is successfully modified.