Change HyperSwap Status (CHGHYSSTS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change HyperSwap Status command is used to change the current status of the HyperSwap configuration.
Restrictions:
- You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| OPTION | Option | *STOP, *START, *SWAP | Required, Positional 1 |
| ASPDEV | ASP device | Name, *ALL, *SYSBAS | Optional, Positional 2 |
| NODE | Cluster node | Name, * | Optional |
| Top |
Option (OPTION)
Specifies the function of the change request.
This is a required parameter.
- *START
- Specifies that HyperSwap replication should be started. This parameter has no affect if HyperSwap replication is currently running.
- *STOP
- Specifies that HyperSwap replication should be stopped (suspended). This parameter has no affect if HyperSwap replication is currently stopped.
- *SWAP
- Specifies that the direction of HyperSwap should be changed.
| Top |
ASP device (ASPDEV)
The name of the Auxiliary Storage Pool (ASP) group for which HyperSwap status is to be changed.
- *ALL
- Specifies HyperSwap status is changed for all disk units currently owned by the node. This option only works if all HyperSwap relationships for all ASP groups on the node are going in the same direction.
- *SYSBAS
- Specifies HyperSwap status is changed for disk unit pairs in the System ASP (ASP 1) and User ASPs (ASP numbers 2 through 32).
- name
- Specify the name of the ASP device description of a primary ASP for which HyperSwap is changed.
| Top |
Cluster node (NODE)
The cluster node name for which HyperSwap status is changed.
- *
- Specifies HyperSwap status is changed for the local node.
- *CRGPRI
- Specifies HyperSwap status is changed for the current cluster resource group (CRG) primary node if the ASPDEV parameter specifies an ASP device that is in a CRG.
- name
- Specify the cluster node name for which HyperSwap status is changed.
| Top |
Examples
Example 1: Starting the HyperSwap replication
CHGHYSSTS OPTION(*START)
This command starts HyperSwap replication for all ASP devices owned by the local node.
Example 2: Changing the direction of HyperSwap
CHGHYSSTS OPTION(*SWAP)
This command changes the current direction of HyperSwap replication for all ASP devices owned by the local node.
Example 3: Changing the direction of HyperSwap for SYSBAS on a node named NODE01
CHGHYSSTS OPTION(*SWAP) ASPDEV(*SYSBAS) NODE(NODE01)
This command changes the current direction of HyperSwap replication for SYSBAS on cluster node NODE01.
| Top |
Error messages
*ESCAPE Messages
- CPF9801
- Object &2 in library &3 not found.
- CPF9802
- Not authorized to object &2 in &3.
- HAE002B
- &1 command failed.
| Top |