Add SVC ASP Copy Description (ADDSVCCPYD)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Add Storage Area Network (SAN) Volume Controller Auxiliary Storage Pool Copy Description (ADDSVCCPYD) command is used to describe a single physical copy of an auxiliary storage pool (ASP) that exists within a SAN Volume Controller (SVC) and to assign a name to the description. SVC ASP copy descriptions are used by PowerHA for Metro Mirror, Global Mirror and FlashCopy copies. End of change

Restrictions:

You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
You must have use (*USE) authority to the ASP device description for which an entry is being added.
You must have read authority to the secure shell key file specified in the SVCHOST parameter.

Top

Parameters

Keyword	Description	Choices	Notes
ASPCPY	ASP copy	Name	Required, Positional 1
ASPDEV	ASP device	Name	Required, Positional 2
CRG	Cluster resource group	Name, *NONE	Required, Positional 3
SITE	Cluster resource group site	Name, *NONE	Required, Positional 4
NODE	Node identifier	Name, CRG, NONE	Required, Positional 5
SVCHOST	Storage host	Element list	Required, Positional 6
	Element 1: User name	Character value
	Element 2: Secure shell key file	Path name
	Element 3: Internet address	Character value
VRTDSKRNG	Virtual disk range	Values (up to 128 repetitions): Element list	Required, Positional 7
	Element 1: Range start	0-8191
	Element 2: Range end	0-8191
	Element 3: Host identifier	Single values: *ALL Other values (up to 300 repetitions): 0-512
DEVDMN	Device domain	Name, *	Optional
RCYDMN	Recovery domain	Single values: *NONE Other values (up to 128 repetitions): Element list	Optional
	Element 1: Cluster node	Name
	Element 2: Host identifier	Values (up to 300 repetitions): 0-512

Top

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.

Top

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.

Top

Cluster resource group (CRG)

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

This is a required parameter.

*NONE: No cluster resource group is associated with the copy.
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.

This is a required parameter.

*NONE: No cluster resource group site is associated with the copy. This value is only valid if CRG is *NONE.
name: Specify the site name within the cluster resource group.

Top

Node identifier (NODE)

Specifies the cluster node that will own the copy.

This is a required parameter.

*NONE: The copy of the ASP is not owned by any cluster node and will never be brought online on any system. This is value is only valid if the copy description will be used for a FlashCopy target.
*CRG: The cluster resource group (CRG) site identifies the owning cluster node. This value is required to be used for Metro Mirror and Global Mirror ASP sessions.
name: Identifies the single cluster node that owns the copy.

Top

Storage host (SVCHOST)

Specifies the SAN Volume Controller cluster for the ASP copy.

This is a required parameter.

Element 1: User name

character-value: Specifies the user name that PowerHA passes to the SAN Volume Controller cluster 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 SAN Volume Controller cluster signon rules.

Element 2: Secure shell key file

path-name: Specifies the path to the file containing secure shell key used to authenticate the user to the SAN Volume Controller cluster. The path name must be qualified with the name of the directory in which the file is located.

Element 3: Internet address

character-value

Specifies the internet address that the local system can use to connect to the SAN Volume Controller cluster. 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.

Top

Virtual disk range (VRTDSKRNG)

Specifies the virtual disks (VDisks) that are associated with the copy description. Up to 128 ranges can be specified.

This is a required parameter.

You can specify 128 values for this parameter.

Element 1: Range start

0-8191: The virtual disk identifier that starts the virtual disk range.

Element 2: Range end

0-8191: The virtual disk identifier that ends the virtual disk range.

Element 3: Host identifier

Single values

*ALL: The virtual disk range is to be assigned to all host identifiers for the corresponding cluster node when the cluster node becomes the cluster resource group primary.

Other values (up to 300 repetitions)

0-512: The host identifier that this virtual disk range is to be assigned to when the corresponding cluster node becomes the cluster resource group primary.

Top

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.

Top

Recovery domain (RCYDMN)

Specifies the connection information for each node in the cluster resource group site recovery domain. This field is required only for switchable logical units.

Single values

*NONE: No recovery domain is used for this copy description. Switched logical units will not be used.

Other values (up to 128 repetitions)

Element 1: Cluster node

name: Specify the cluster node name in the recovery domain.

Element 2: Host identifier

You can specify 300 values for this element.

0-512: Specify the host identifier for the recovery domain node.

Top

Examples for ADDSVCCPYD

Example 1: Adding an SVC Copy Description for Global Mirror or Metro Mirror

ADDSVCCPYD   ASPCPY(ORDER) ASPDEV(ORDERDEV) CRG(ORDERCRG)
             SITE(SITE1) NODE(*CRG) SVCHOST(admin
             '/home/admin/.ssh/id_rsa' '1.1.1.1')
             VRTDSKRNG((100 104))

This command adds a SAN Volume Controller ASP copy description named ORDER for an independent ASP. To enable the copy description to be used in a Global Mirror or Metro Mirror session, cluster resource group information is provided. The VRTDSKRNG parameter identifies the five virtual disk volume identifiers within the ASP.

Example 2: Adding an SVC Copy Description to the Current Device Domain

ADDSVCCPYD   ASPCPY(ORDER) ASPDEV(ORDERDEV) CRG(ORDERCRG)
             SITE(SITE1) NODE(*CRG) SVCHOST(admin
             '/home/admin/.ssh/id_rsa' '1.1.1.1')
             VRTDSKRNG((100 104))
             DEVDMN(*)

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

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

ADDSVCCPYD   ASPCPY(ORDER) ASPDEV(ORDERDEV) CRG(ORDERCRG)
             SITE(SITE1) NODE(*CRG) SVCHOST(admin
             '/home/admin/.ssh/id_rsa' '1.1.1.1')
             VRTDSKRNG((100 104))
             DEVDMN(MYDOMAIN)

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

Example 4: Adding an SVC Copy Description for FlashCopy

ADDSVCCPYD   ASPCPY(ORDER) ASPDEV(ORDERDEV) CRG(*NONE)
             SITE(*NONE) NODE(ORDERNODE) SVCHOST(admin
             '/home/admin/.ssh/id_rsa' '1.1.1.1')
             VRTDSKRNG((100 104) (200 204))

This command adds a SAN Volume Controller ASP copy description named ORDER for an independent ASP. The copy will be a FlashCopy target. Therefore, cluster resource group information is not used. The VRTDSKRNG parameter identifies the 10 virtual disk volume identifiers within the ASP.

Example 5: Adding an SVC Copy Description for Switchable Logical Units

ADDSVCCPYD   ASPCPY(ORDER) ASPDEV(ORDERDEV) CRG(ORDERCRG)
             SITE(SITE1) NODE(*CRG) SVCHOST(admin
             '/home/admin/.ssh/id_rsa' '1.1.1.1')
             VRTDSKRNG((100 104 (10 40)) (200 204 *ALL))
             RCYDMN((NODE1 (10 20 30)) (NODE2 (40)))

This command adds a SAN Volume Controller ASP copy description named ORDER for an independent ASP. The copy will be used for switched logical units. The first VDISK range will be assigned to host identifier 10 when cluster node NODE1 is the cluster resource group primary and to host identifier 40 when NODE2 is the cluster resource group primary. The second VDISK range will be assigned to all host identifiers for NODE1 (host identifiers 10, 20, and 30) when it is the cluster resource group primary and to all host identifiers for NODE2 (only host identifier 40) when it is the cluster resource group primary.

Top

Error messages for ADDSVCCPYD

*ESCAPE Messages

CPF9801: Object &2 in library &3 not found.
CPF9802: Not authorized to object &2 in &3.
HAE002B: &1 command failed.

Top