SET-SNAPSET-PARAMETER

Define the Snapset environment

Component:	BS2000 OSD/BC
Functional area:	Pubset and MRSCAT management
Domain:	MULTI-CATALOG-AND-PUBSET-MGMT SNAPSET
Privileges:	TSOS HSMS-ADMINISTRATION

Function

The SET-SNAPSET-PARAMETER command sets the processing environment for the Snapsets of an (imported) pubset. The settings are stored in the pubset’s Snapset catalog.
The following settings are possible (see the manual “Introduction to System Administration” [14]):

• In the case of ETERNUS systems in SDV operating mode, only a single (Default) save pool is supported.
• In the case of ETERNUS systems in S# volume operation, no save pools are supported.
• In the case of EMC systems with TimeFinder/Snap, a special save pool can be assigned to the pubset. 
• In the case of EMC systems with TimeFinder/SnapVX, no save pools are supported.
• In the case of remote mirroring, snap copies can also be generated on the remote disk storage system. When Concurrent SRDF on EMC system is used, which of the remote disk storage systems the snap copies are to be generated on must be specified.

The SHOW-SNAPSET-CONFIGURATION command displays the current settings.

Format

SET-SNAPSET-PARAMETER                                                                                                                      

PUBSET = <cat-id 1..4>
,SAVE-POOL-NAME = *UNCHAN GED / <name 1..32 with-under-low> / *DEFAULT-POOL
,REMOTE-COPY = *UNCHAN GED / *NO / *YES(...)
	*YES(...)
		|	RA-GROUP = *UNIQUE / <integer 1..250>

Operands

PUBSET = <cat-id 1..4>
Catalog ID of the pubset for which the Snapset processing environment is to be set.

SAVE-POOL-NAME =
This value is relevant for Symmetrix systems only.
Name of the save pool in the disk storage system which is to be used for snap copies from the specified pubset.

SAVE-POOL-NAME = *UNCHANGED
The current setting is retained.

SAVE-POOL-NAME = <name 1..32 with-under-low>
Name of a dedicated save pool which is used for snap copies of the pubset. The specified save pool must have been set up in the disk storage system by an engineer.

SAVE-POOL-NAME = *DEFAULT-POOL
The default save pool in the disk storage system is used.

REMOTE-COPY = *UNCHANGED / *NO / *YES(...)
This setting is evaluated only in the case of mirroring in a remote disk storage system.
Specifies whether snap copies are also to be created on the remote disk storage system.

REMOTE-COPY = *UNCHANGED
The current setting is retained.

REMOTE-COPY = *NO
No snap copies are created on the remote disk storage system.

REMOTE-COPY = *YES(...)
Snap copies are also created on the remote disk storage system.

RA-GROUP = *UNIQUE
Only one remote disk storage system is operated, and additional snap copies (target units) are also kept on this.

RA-GROUP = <integer 1..250>
Only for Symmetrix or VMAX3 systems.
The specified RA group determines the remote disk storage system on which the snap copies are kept. This specification is required if the pubset is mirrored on multiple remote disk storage systems using Concurrent SRDF. 

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
	32	CMD0216	Required authorization not available
	64	DMS1351	Internal error
	64	DMS1386	Error in the memory request
	64	DMS1389	Error in MSCF communication
	64	DMS138B	Not an MRSCAT entry
	64	DMS138C	Pubset not accessible
	64	DMS13D6	Snapset limit exceeded
1	64	DMS13D7	Internal error in Snapset management: Return code of GCF
	64	DMS148F	GCF not loaded