DELETE-SNAPSET

Delete Snapset

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

Function

The DELETE-SNAPSET command deletes one or all existing Snapsets for an imported pubset. When a Snapset is deleted, the individual volumes of the Snapset are cleared and removed from the Snapset catalog. When all existing Snapsets are deleted, the context required for Snapset operation is also removed: the Snapset catalog is deleted and the Snapset limit is set to zero.

Format

DELETE-SNAPSET                                                                                                                       

PUBSET = <cat-id 1..4>

,SNAPSET = *EARLIEST / <name 1..1 with-low> / <integer -52..-1> / *ALL

Operands

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

SNAPSET = *EARLIEST / <name 1..1 with-low> / <integer -52..-1> / *ALL
Specifies which Snapsets are to be deleted.

, When operating with ETERNUS DX/AF, only the oldest Snapset can be deleted. This must be borne in mind when a Snapset which is to be deleted is specified explicitly using the Snapset ID or the relative age.

SNAPSET = *EARLIEST
The oldest Snapset is deleted.

SNAPSET = <name 1..1 with-low>
Specifies the Snapset explicitly by means of the Snapset ID. The maximum of 52 pubsets are distinguished by means of Snapset IDs specified which comprise letters from the 26 lowercase letters a to z and the 26 uppercase letters A to Z.

SNAPSET = <integer -52..-1>
The Snapset to be deleted is specified by means of its relative age. The value -1 specifies the latest Snapset here.

SNAPSET = *ALL
All Snapsets are deleted and the context for Snapset operation of this pubset is removed.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without errors
	32	CMD0216	No authorization
	64	DMS1351	Internal error
	64	DMS1386	Error in the memory request
	64	DMS1389	Error in MSCF communication
	64	DMS138B	No MRSCAT entry
	64	DMS138C	Pubset not accessible
	64	DMS13D5	The Snapset specified does not exist on the pubset
	64	DMS148F	GCF not loaded
1	64	DMS13D7	Internal error in Snapset management: Return code of GCF
2	64	DMS13D7	Internal error in Snapset management: Return code in the case of mount/demount
3	64	DMS13D7	Internal error in Snapset management: Return code when reading or writing the SVL
4	64	DMS13D7	Internal error in Snapset management: Return code when setting/resetting the reconfiguration lock
6	64	DMS13D7	Internal error in Snapset management: Return code of SHC-OSD
7	64	DMS13D7	Internal error in Snapset management: Return code of CCOPY
	64	DMS13DF	Subsystem SHC-OSD not available