Add ASP Copy Description (ADDASPCPYD)

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.

When an ASP is configured for HyperSwap, both sets of storage hosts, logical unit ranges, and recovery domains must be specified in the ASP copy description

Restrictions:

Parameters

Keyword Description Choices Notes
ASPCPY ASP copy Name Required, Positional 1
ASPDEV ASP device Name Required, Positional 2
DEVDMN Device domain Name, * Optional
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: IBM System Storage 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
STGHOST2 Second 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
LUN2 Second logical unit name Single values: *NONE
Other values: Element list		 Optional
Element 1: IBM System Storage 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
RCYDMN2 Second 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

ASP copy (ASPCPY)

Specifies the name of the ASP copy description to be added.

This is a required parameter.

name
Specify the name of the ASP copy description.

ASP device (ASPDEV)

Specifies the name of the ASP device description associated with the ASP copy description.

This is a required parameter.

name
Specify the name of the ASP device description.

Device domain (DEVDMN)

Specifies the name of the device domain.

*
The device domain that the current node is in.
name
Specify the name of the device domain.

Cluster resource group (CRG)

Specifies the name of the cluster resource group (CRG) that identifies the nodes among which the copy can switch.

*NONE
No cluster resource group is associated with the copy.
name
Specify the name of the cluster resource group.

Cluster resource group site (SITE)

Specifies the name of the cluster resource group (CRG) site that identifies the nodes among which the copy can switch.

*NONE
No cluster resource group site is associated with the copy.
name
Specify the site name within the cluster resource group.

Storage host (STGHOST)

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

*NONE
There is no storage host for this ASP copy description.

Other values (up to 1 repetition)

Element 1: User name

character-value
Specifies the user name that IBM PowerHA for i passes to the storage host when opening a connection. The user name can be changed. It is up to the user to keep this information current. The user name can contain as many as 16 characters. The actual length used and the character values must conform to the storage host's signon rules.

Element 2: Password

character-value
Specify the password. The password can contain as many as 16 characters.

Element 3: Internet address

You can specify 2 values for this parameter element.

character-value
Specifies an internet address that the local system can use to connect to the storage host. The internet address may be an IPv4 or IPv6 address.

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 embedded 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, embedded, or trailing zeros in the address.

If the internet address is entered from the command line, the address must be enclosed in apostrophes.

Location (LOCATION)

The cluster node that will own this IASP. Possible values shown are:

*DEFAULT
The CRG site identifies the node locations of the I/O adapter. This value should be used for Geographic Mirror, Metro Mirror, and Global Mirror ASP sessions.
*NONE
The copy of the ASP will never be brought online on any system. This is only valid if the copy description will be used for a FlashCopy target.
name
Identifies the single node that uses the I/O adapter. This value is only valid if the description will be used for a FlashCopy target.

Logical unit name (LUN)

Specifies the logical units (LUNs) that are associated with the copy description.

Element 1: IBM System Storage device

character-value
Specify the name of the IBM System Storage device that contains the LUNs.
*NONE
There is no logical unit that needs to be specified.

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.

Recovery domain (RCYDMN)

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:

Single values

*NONE
There is no recovery domain. The ASP copy is not used for switchable LUNs.

Other values

Element 1: Cluster node

character-value
Specify the cluster node name in the recovery domain.

Element 2: Host identifier

character-value
Specify the name of the IBM System Storage host identifier for the recovery domain node.

Element 3: Volume group

character-value
Specify the name of the volume group associated with each host identifier.

Second storage host (STGHOST2)

Specifies the second storage host for the ASP copy. The second storage host information is only required if the ASP copy will be used for HyperSwap.

Single values

*NONE
There is no second storage host for this ASP copy description. The ASP is not HyperSwap.

Other values (up to 1 repetitions)

Element 1: User name

character-value
Specifies the user name that IBM PowerHA for i passes to the storage host when opening a connection. The user name can be changed. It is up to the user to keep this information current. The user name can contain as many as 16 characters. The actual length used and the character values must conform to the storage host's signon rules.

Element 2: Password

character-value
Specify the password. The password can contain as many as 16 characters.

Element 3: Internet address

You can specify 2 values for this parameter element.

character-value
Specifies an internet address that the local system can use to connect to the storage host. The internet address may be an IPv4 or IPv6 address.

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 embedded 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, embedded, or trailing zeros in the address.

If the internet address is entered from the command line, the address must be enclosed in apostrophes.

Second logical unit name (LUN2)

Specifies the logical units (LUNs) that are associated with the second IBM System Storage device (STGHOST2). This is used for HyperSwap ASPs only.

Element 1: IBM System Storage device

character-value
Specify the name of the second IBM System Storage device that is specified in STGHOST2 that contains the LUNs.
*NONE
There is no logical unit that needs to be specified. This is only valid if STGHOST2 is also *NONE.

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.

Second recovery domain (RCYDMN2)

Specifies the connection information for each node in the CRG site recovery domain. This field is required only for HyperSwap switchable LUNs.

Single values

*NONE
There is no recovery domain. The ASP copy is not used for HyperSwap switchable LUNs.

Other values

Element 1: Cluster node

character-value
Specify the cluster node name in the recovery domain.

Element 2: Host identifier

character-value
Specify the name of the IBM System Storage host identifier from STGHOST2 for the recovery domain node.

Element 3: Volume group

character-value
Specify the name of the volume group from STGHOST2 associated with each host identifier.

Examples

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 to the Current Device Domain 

ADDASPCPYD   ASPCPY(ACOPYD) ASPDEV(IASP001)
             CRG(MYCRG) SITE(SITE1)
             DEVDMN(*)

This has the same result as Example 1. The copy description is added to the current device domain.

Example 3: Adding a Copy Description to a Named Device Domain 

ADDASPCPYD   ASPCPY(ACOPYD) ASPDEV(IASP001)
             CRG(MYCRG) SITE(SITE1)
             DEVDMN(MYDOMAIN)

This is similar to Example 1, but the copy description is added to the device domain named MYDOMAIN.

Example 4: Adding a Copy Description for Global Mirror 

ADDASPCPYD   ASPCPY(ORDER) ASPDEV(ORDERDEV)
             CRG(ORDERCRG) SITE(SITE1)
             STGHOST((JOEUSER JOE1PWD4U (192.168.1.10)))
             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 5: Adding a Copy Description for FlashCopy 

ADDASPCPYD   ASPCPY(ORDER) ASPDEV(ORDERDEV)
             STGHOST((JOEUSER JOE1PWD4U (192.168.1.10)))
             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 6: Adding a Copy Description for switchable LUNs 

ADDASPCPYD   ASPCPY(ACOPYD) ASPDEV(IASP001)
             CRG(MYCRG) SITE(SITE1)
             STGHOST((JOEUSER JOE1PWD4U (192.168.1.10)))
             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.

Example 7: Adding a Copy Description for switchable LUNs for a HyperSwap IASP 

ADDASPCPYD   ASPCPY(ACOPYD) ASPDEV(IASP001)
             CRG(MYCRG) SITE(SITE1)
             STGHOST((JOEUSER JOE1PWD4U (192.168.1.10)))
             LOCATION(*DEFAULT)
             LUN(IBM.2107-AZ12341 (1000-1004))
             RCYDMN((NODEA (0000 0001) (V1 V2))
                    (NODEB (0002 0003) (V1 V2)))
             STGHOST2((JOEUSER JOE1PWD4U (192.168.1.20)))
             LUN2(IBM.2107-BZ54321 (2000-2004))
             RCYDMN2((NODEA (000A 000B) (V5 V6))
                    (NODEB (000C 000D) (V5 V6)))

This command adds an ASP copy description named ACOPYD for an independent ASP that is configured for HyperSwap. This example is similar to Example 6, however, the copy description needs the storage host information, LUN ranges , and recovery domain information for the second IBM System Storage device. These are entered using STGHOST2, LUN2, and RCYDMN2 keywords respectively.

Error messages

*ESCAPE Messages

CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9899
Error occurred during processing of command.
HAE002B
&1 command failed.