Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The QHASM.HYPERSWAP_STATUS_LIST view contains HyperSwap information about the list of nodes and devices in a cluster.

...

  • *OBJOPR and *READ authority on QHASM/HYS_LIST.

  • Input/output system configuration (*IOSYSCFG) special authority.

...

...

Note: At least one node in a device domain must be active for sessions in the device domain to be returned.

Results Table

The table describes the columns in the view. The system name used here is HYS_LIST. The schema is QHASM.

Column Name

System Column Name

Data Type

Description

NODE

NODE

VARCHAR(8)

A valid simple name that uniquely identifies a node.

ASP_DEVICE

ASPDEV

VARCHAR(10)

Nullable

The name of the Auxiliary Storage Pool (ASP) group the HyperSwap status is for. Possible values are:

*SYSBAS
HyperSwap status is returned for disk unit pairs in the System ASP (ASP 1) and the User ASPs (ASP numbers 2 through 32).

name
The name of an Independent ASP device description for a primary Independent ASP.

Contains the null value if HyperSwap status is not known for the device on this node. This could be due to a failure communicating with the node, or because the node is not active in the cluster.

FIRST_STORAGE_IDENTIFIER

STGID1

VARCHAR(20)

Nullable

The unique identifier for the storage device that a logical unit (volume) resides in. Possible values are:NOT CONFIGURED
The disk unit is not configured for HyperSwap.

name
The name of the source storage identifier.

Contains the null value if HyperSwap status is not known for the device on this node. This could be due to a failure communicating with the node, or because the node is not active in the cluster, or HyperSwap is not configured.

FIRST_STORAGE_ACCESSIBLE

STGID1ACS

VARCHAR(3)

Nullable

Whether the storage device is accessible or not. Possible values are:

YES

The storage device is accessible.

NO

The storage device is not accessible.

Contains the null value if HyperSwap is not configured or the HyperSwap status is not known for the device on this node. This could be due to a failure communicating with the node, or because the node is not active in the cluster, or HyperSwap is not configured.

SECOND_STORAGE_IDENTIFIER

STGID2

VARCHAR(20)

Nullable

The unique identifier for the storage device that a logical unit (volume) resides in. Possible values are:NOT CONFIGURED
The disk unit is not configured for HyperSwap.

name
The name of the source storage identifier.

Contains the null value if HyperSwap status is not known for the device on this node. This could be due to a failure communicating with the node, or because the node is not active in the cluster, or HyperSwap is not configured.

SECOND_STORAGE_ACCESSIBLE

STGID2ACS

VARCHAR(3)

Nullable

Whether the storage device is accessible or not. Possible values are:

YES

The storage device is accessible.

NO

The storage device is not accessible.

Contains the null value if HyperSwap is not configured or the HyperSwap status is not known for the device on this node. This could be due to a failure communicating with the node, or because the node is not active in the cluster, or HyperSwap is not configured.

STORAGE_AFFINITY

STGAFNTY

VARCHAR(3)

Nullable

Whether the affinity of the storage device is used or not. Possible values are:

YES

The affinity of the storage device is used.

NO

The affinity of the storage device is not used.

NOT DEFINED

The affinity of the storage device is not defined.

Contains the null value if HyperSwap is not configured or the HyperSwap status is not known for the device on this node, or HyperSwap is not configured.

PRIMARY_STORAGE_IDENTIFIER

PRISTGID

VARCHAR(20)

Nullable

The unique identifier for the storage device that is the primary storage device in the HyperSwap relationship. Possible values are:

name
The name of the source storage identifier.

Contains the null value if the HyperSwap status is ‘TWO PRIMARY’ or if the HyperSwap status is not known for the device on this node. This could be due to a failure communicating with the node, or because the node is not active in the cluster, or HyperSwap is not configured.

COPY_STATUS

CPYSTS

VARCHAR(20)

Nullable

A summary of the status of the HyperSwap
relationships for the device on the node. Possible
values are:

ACTIVE-SYNCHRONIZED

All of the HyperSwap relationships for the device are active and all of the copies of the volumes are synchronized.

SUSPENDED

One or more of the HyperSwap relationships for the device are currently suspended.

RESUMING

HyperSwap is currently resuming.

TWO PRIMARY

One or more of the HyperSwap relationships for the device consists of two primary volumes.

STORAGE FAILURE

There are problems when communicating with the storage devices.

NOT CONFIGURED

The HyperSwap relationships are not configured on this node for the device.

INVALID

The configuration of HyperSwap relationships on this node for the device is not valid.

Contains the null value if HyperSwap status is not known for the device on this node.

...