CREATE-SNAPSET

Create a Snapset

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

Function

The CREATE-SNAPSET command creates a Snapset for an imported pubset. This also includes entering the Snapset in the Snapset catalog and placing it in service. The DELETE-EARLIEST operand controls whether a new Snapset is created and under which conditions the oldest existing Snapset is to be deleted and reused before the Snapset is created (the default is deletion when the Snapset limit is reached).

The command is rejected when a new Snapset is to be created and no free Snapset is available (the setting DELETE-EARLIEST=*NO prevents the oldest Snapset from being deleted when the Snapset limit is reached).

Format

CREATE-SNAPSET                                                                                                                                      

PUBSET = <cat-id 1..4>

,DELETE-EARLIEST = *AT-LIMIT / *YES / *NO

Operands

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

DELETE-EARLIEST = *AT-LIMIT / *YES / *NO 
Specifies whether and under which conditions the oldest Snapset is to be deleted.

DELETE-EARLIEST = *AT-LIMIT
The oldest Snapset is deleted only if the maximum number of Snapsets permissible for the pubset (Snapset limit) has already been reached.

The Snapset limit is entered in the SVL of the pubres/volres of the Control Volume Set using the SET-PUBSET-ATTRIBUTES command.

DELETE-EARLIEST = *YES
The oldest Snapset is always deleted.

DELETE-EARLIEST = *NO
A new Snapset is created. If the Snapset limit has already been reached, the command is rejected.

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	DMS13D6	Snapset limit exceeded
	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/dismount
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
5	64	DMS13D7	Internal error in Snapset management: Return code of DPSVLST (create the volume list)
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	SHC-OSD subsystem not available