CHANGE_DISK_PATHS procedure

The CHANGE_DISK_PATHS procedure enables or disables all paths matching the parameters provided. The last path to a disk will not be disabled unless explicitly requested. This procedure is only supported for some external SCSI devices.

Any combination of resource-name, host-wwpn, remote-wwpn, and adapter-name can be specified. The specified operation will be applied to all the paths that match the provided parameters. A disable operation must leave at least one remaining active path to all resources unless the force parameter with a value of YES is specified. If no paths match the provided parameters, no action is taken.

The world-wide port name (WWPN) values that can be changed by this procedure apply to an IO Adapter (IOA).

Authorization: The caller must have *IOSYSCFG special authority.

The schema is QSYS2.

operation

A character string that contains the operation to perform.

DISABLE: Disable all paths matching the parameters.
ENABLE: Enable all paths matching the parameters.

resource-name

A character string that contains the resource name of the path to be changed. If resource-name is omitted or the null value, the operation will be applied to all the paths that match the world wide port name or adapter parameters that are provided.

host-wwpn

A 16 character hexadecimal string representing the world wide port name for the host side of the paths to be enabled or disabled. If resource-name, remote-wwpn, or adapter-name is specified, this parameter can be omitted or have the null value.

If this parameter is not specified, the default is the null value, meaning that host-wwpn is not part of the request.

remote-wwpn

A 16 character hexadecimal string representing the world wide port name for the remote side of the paths to be enabled or disabled. If resource-name, host-wwpn, or adapter-name is specified, this parameter can be omitted or have the null value.

If this parameter is not specified, the default is the null value, meaning that remote-wwpn is not part of the request.

force

A character string that indicates whether the last path to a disk can be disabled by this procedure.

NO: The last path to a disk will never be disabled. This is the default.
YES: The last path to a disk can be disabled, overriding normal safely checks.

adapter-name

A character string that specifies an adapter on which all paths should be disabled. If resource-name, host-wwpn, or remote-wwpn is specified, this parameter can be omitted or have the null value. End of change

If this parameter is not specified, the default is the null value, meaning that adapter-name is not part of the request.

Examples

Enable a path.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'ENABLE',
                             RESOURCE_NAME => 'DMP001');

Enable all paths on a host port.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION   => 'ENABLE',
                             HOST_WWPN   => 'c050760a3038001e');

Disable a path.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'DISABLE',
                             RESOURCE_NAME => 'DMP001');

Disable a path, forcing the disk to be disabled if it is the last path to the disk.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'DISABLE',
                             RESOURCE_NAME => 'DMP001',
                             FORCE         => 'YES');

Disable all paths on a host target pair.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION    => 'DISABLE',
                             HOST_WWPN    => 'c050760a3038001e',
                             REMOTE_WWPN  => '5005076306181347');

Disable all paths on a remote port.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'DISABLE',
                             REMOTE_WWPN   => '5005076306181347');

Enable all paths on an adapter.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'ENABLE',
                             ADAPTER_NAME  => 'DC06');

Enable all paths on an adapter to a specific remote port.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'ENABLE',
                             REMOTE_WWPN   => '5005076306181347',
                             ADAPTER_NAME  => 'DC06');

Disable all paths on an adapter.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'DISABLE',
                             ADAPTER_NAME  => 'DC06');

Disable all paths on an adapter to a specific remote port.


CALL QSYS2.CHANGE_DISK_PATHS(OPERATION     => 'DISABLE',
                             REMOTE_WWPN   => '5005076306181347',
                             ADAPTER_NAME  => 'DC06');