| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Auxiliary Storage Pool Copy Description (CHGASPCPYD) command changes an existing auxiliary storage pool (ASP) copy description.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ASPCPY | ASP copy | Name | Required, Key, Positional 1 |
| ASPDEV | ASP device | Name, *SAME | Optional |
| CRG | Cluster resource group | Name, *SAME, *NONE | Optional |
| SITE | Cluster resource group site | Name, *SAME, *NONE | Optional |
| STGHOST | Storage host | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: User name | Character value | ||
| Element 2: Password | Character value, *SAME | ||
| Element 3: Internet address | Values (up to 2 repetitions): Character value, *SAME | ||
| LOCATION | Location | Name, *SAME, *DEFAULT, *NONE | Optional |
| LUN | Logical unit name | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: TotalStorage device | Character value | ||
| Element 2: Logical unit range | Values (up to 128 repetitions): Character value, *SAME | ||
| Element 3: Consistency group range | Values (up to 128 repetitions): Character value, *SAME | ||
| RCYDMN | Recovery domain | Single values: *SAME, *NONE Other values (up to 128 repetitions): Element list |
Optional |
| Element 1: Cluster node | Character value | ||
| Element 2: Host identifier | Values (up to 30 repetitions): Character value | ||
| Element 3: Volume group | Values (up to 30 repetitions): Character value |
| Top |
Specifies the name of the ASP copy description to be changed.
This is a required parameter.
| Top |
Specifies the name of the ASP device description associated with the ASP copy description.
| Top |
Specifies the name of the cluster resource group (CRG) that identifies the nodes among which the copy can switch.
| Top |
Specifies the name of the cluster resource group (CRG) site that identifies the nodes among which the copy can switch.
| Top |
Specifies the storage host (there can be more than one for redundancy purposes) for the ASP copy.
Single values
Other values (up to 2 repetitions)
Element 1: User name
Element 2: Password
Element 3: Internet address
You can specify 2 values for this element.
An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address.
An IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped). An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.
If the internet address is entered from the command line, the address must be enclosed in apostrophes.
| Top |
The cluster node that will own this IASP. Possible values shown are:
Single values
| Top |
Specifes the logical units (LUNs) that are accessible through an individual IOA and are associated with the copy description.
Single values
Other values (up to 64 repetitions) The logical units are positionally related to the IOA resources specified on the resource name (RSRCNAME) parameter. That is, the LUNs of the first value are accessed through the first IOA resource, the LUNs of the second value are acccessed through the second IOA resource, and so forth.
Element 1: TotalStorage device
Element 2: Logical unit range
You can specify 32 values for this element.
| Top |
Specifies the connection information for each node in the CRG site recovery domain. This field is required only for switchable LUNs. Possible values shown are:
Element 1: Cluster node
Element 2: Host identifier
Element 3: Volume group
| Top |
Example 1: Changing the Resource Name
CHGASPCPYD ASPCOPY(ORDER) RSRCNAME((IOA002 NODEA))
This command changes the name of the input/output adapter (IOA) and node that is used to access the ASP copy's disk units.
Example 2: Changing the Storage Host Internet Address
CHGASPCPYD ASPCOPY(ORDER) STGHOST(*SAME *SAME (4.4.444.44))
This command changes the internet address that is used to a storage host.
| Top |
*ESCAPE Messages
| Top |