| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add Auxiliary Storage Pool Copy Description (ADDASPCPYD) command is used to describe a single physical copy of an auxiliary storage pool (ASP) and to assign a name to the description. ASP copy descriptions are used by IBM PowerHA for i to manage geographic mirroring, Metro Mirror, Global Mirror and FlashCopy copies.
When geographic mirroring is configured, the disk units are assigned to the mirror copy. An ASP copy description for the mirror copy can be added either before or after the configuration. Similarly, when configuring a Metro Mirror, Global Mirror or FlashCopy target, the ASP copy description for it can be added at any time.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ASPCPY | ASP copy | Name | Required, Positional 1 |
| ASPDEV | ASP device | Name | Required, Positional 2 |
| CRG | Cluster resource group | Name, *NONE | Optional |
| SITE | Cluster resource group site | Name, *NONE | Optional |
| STGHOST | Storage host | Single values: *NONE Other values: Element list |
Optional |
| Element 1: User name | Character value | ||
| Element 2: Password | Character value | ||
| Element 3: Internet address | Values (up to 2 repetitions): Character value | ||
| LOCATION | Location | Name, *DEFAULT, *NONE | Optional |
| LUN | Logical unit name | Single values: *NONE Other values: Element list |
Optional |
| Element 1: TotalStorage device | Character value | ||
| Element 2: Logical unit range | Values (up to 128 repetitions): Character value | ||
| Element 3: Consistency group range | Values (up to 128 repetitions): Character value | ||
| RCYDMN | Recovery domain | Single values: *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 added.
This is a required parameter.
| Top |
Specifies the name of the ASP device description associated with the ASP copy description.
This is a required parameter.
| 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. Storage host information is required if the ASP copy will be used in a Metro Mirror, Global Mirror or FlashCopy session. Absence of this information when starting an ASP session causes the session to fail to start.
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 parameter 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 associated with the copy description.
Element 1: TotalStorage device
Element 2: Logical unit range
A range of logical unit (LUN) numbers in the form of 'mmmm-nnnn'. 'mmmm' is the LUN number that begins a range and 'nnnn' is the LUN number that ends a range. For example, '1008-100C' specifies the five LUN numbers 1008, 1009, 100A, 100B, and 100C.
Element 3: Consistency group range
A range of logical unit (LUN) numbers in the form of 'mmmm-nnn' to be used as the Flashcopy target by Global Mirror to maintain consistency groups. 'mmmm' is the LUN number that begins a range and 'nnnn' is the LUN number that ends a range. For example, '1008-100C' specifies the five LUN numbers 1008, 1009, 100A, 100B, and 100C.
| 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: Adding a Copy Description for Geographic Mirroring
ADDASPCPYD ASPCPY(ORDER) ASPDEV(ORDERDEV) CRG(ORDERCRG) SITE(SITE1)
This command adds an ASP copy description named ORDER for the independent auxiliary storage pool (ASP) associated with ASP device description ORDERDEV. The CRG name and SITE name are provided because the copy is intended for use with geographic mirroring.
Example 2: Adding a Copy Description for Global Mirror
ADDASPCPYD ASPCPY(ORDER) ASPDEV(ORDERDEV) CRG(ORDERCRG) SITE(SITE1)
STGHOST((JOEUSER JOE1PWD4U (3.3.333.33)))
RSRCNAME((IOA001 NODEA))
LUN((IBM.2107-AZ12341 (1000-1004)))
This command adds an ASP copy description named ORDER for an independent ASP. To enable the copy description to be used in a Global Mirror session, storage host information is provided. It identifies the storage host by internet address and provides the user name and password that can be used to access the storage host. The resource name is the name of the input/output adapter (IOA) that is used to access the disk units in the external storage unit. The LUN parameters identifies a storage unit and the five logical units within it. The logical units have numbers 1000 through 1004.
Example 3: Adding a Copy Description for FlashCopy
ADDASPCPYD ASPCPY(ORDER) ASPDEV(ORDERDEV)
STGHOST((JOEUSER JOE1PWD4U (3.3.333.33)))
RSRCNAME((IOA001 NODEA))
LUN((IBM.2107-AZ12341 (1000-1004)))
This command adds an ASP copy description named ORDER for an independent ASP. The copy will be a FlashCopy target. Therefore, CRG information is not used.
Example 4: Adding a Copy Description for switchable LUNs
ADDASPCPYD ASPCPY(ACOPYD) ASPDEV(IASP001)
CRG(MYCRG) SITE(SITE1)
STGHOST((JOEUSER JOE1PWD4U (3.3.333.33)))
LOCATION(*DEFAULT)
LUN(IBM.2107-AZ12341 (1000-1004))
RCYDMN((NODEA (0000 0001) (V1 V2))
(NODEB (0002 0003) (V1 V2)))
This command adds an ASP copy description named ACOPYD for an independent ASP. To enable the copy description to be used for swithable LUNs, site recovery domain and storage host information is provided. It identifies the storage host by internet address and provides the user name and password that can be used to access the storage host. The LUN parameters identifies a storage unit and the five logical units within it. The logical units have numbers 1000 through 1004. The CRG has a recovery domain consisting of NODEA and NODEB. NODEA has two host connections (0000 and 0001) and NODEB has two host connections (0002 and 0003). Volume group V1 is to be switched between 0000 and 0002 while volume group V2 is to be switched between 0001 and 0003.
| Top |
*ESCAPE Messages
| Top |