Change ASP Copy Description (CHGASPCPYD)

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

Parameters

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

ASP copy (ASPCPY)

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

This is a required parameter.

name
Specify the name of the ASP copy description.
Top

ASP device (ASPDEV)

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

*SAME
The name of the ASP device description does not change..
name
Specify the name of the ASP device description.
Top

Cluster resource group (CRG)

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

*SAME
The name of the cluster resource group does not change.
*NONE
There is no cluster resource group for this copy description.
name
Specify the name of the cluster resource group.
Top

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.

*SAME
The name of the cluster resource group site does not change.
*NONE
No cluster resource group site is associated with the copy.
name
Specify the site name within the cluster resource group.
Top

Storage host (STGHOST)

Specifies the storage host (there can be more than one for redundancy purposes) for the ASP copy.

Single values

*SAME
The storage host information is not changed.

Other values (up to 2 repetitions)

Element 1: User name

name
Specifies the name of the user that IBM PowerHA for i passes to the connection agent when opening a connection. The user name can be changed. It is up to the user to keep this information current.

Element 2: Password

*SAME
The user signon password does not change.
character-value
Specify the password.

Element 3: Internet address

You can specify 2 values for this element.

*SAME
The internet address does not change.
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 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

Location (LOCATION)

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

Single values

*SAME
The location does not change.
*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.
Top

Logical unit name (LUN)

Specifes the logical units (LUNs) that are accessible through an individual IOA and are associated with the copy description.

Single values

*SAME
The logical unit information does not change.

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

character-value
Specify the name of the TotalStorage device that contains the LUNs.

Element 2: Logical unit range

You can specify 32 values for this element.

*SAME
The logical unit ranges does not change.
character-value
Specify a LUN range in the form 'mmmm-nnnn'. 'mmmm' is the first LUN number within a range and 'nnnn' is the last LUN number in that range.
Top

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:

Element 1: Cluster node

*SAME
The cluster node name does not change.
character-value.
Specify the cluster node name in the recovery domain.

Element 2: Host identifier

character-value.
Specify the name of the TotalStorage 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.
Top

Examples

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

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.
Top