Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Display information about existing Snapsets

Component:	BS2000
Functional area:	File processing Job variables
Domain:	MULTI-CATALOG-AND-PUBSET-MGMT SNAPSET
Privileges:	STD-PROCESSING TSOS HSMS-ADMINISTRATION OPERATING

Function

The SHOW-SNAPSET-CONFIGURATION command outputs information concerning the Snapset concerned for a pubset. The output is directed to SYSOUT; it can optionally also be directed to SYSLST. The following information is output:

Pubset-global information
- Pubset catalog ID
- Name of a save pool which is assigned to the pubset
- Displays whether additional snap copies are to be created for the pubset on a remote disk storage system.
Snapset-specific information
- Snapset identification consisting of the Snapset ID (letter identifier) and relative age (historical sequence number)
- Creation time (date and time) of the Snapset
- Snapset status: either the CCOPY session ID concerned (created for Snapset access) or another status display

If no Snapset exists for the pubset, the command is rejected with the message DMS13D8 or DMS13E5.

The command supports structured output in S variables (see "Output in S variable").

Privileged functions

If the privileged user (privilege TSOS, OPERATING, HSMS administrator) requests information on a particular Snapset, the VSNs of the pubset volumes and the MNs of the assigned snap units of the local disk storage system are also output (in the case of remote mirroring, possibly also for the remote disk storage system).

Format

SHOW-SNAPSET-CONFIGURATION

PUBSET = *DEFAULT-PUBSET / <cat-id 1..4>

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

,OUTPUT = *SYSOUT / *SYSLST

Operands

PUBSET = *DEFAULT-PUBSET / <cat-id 1..4>
Catalog ID of the pubset about whose Snapsets information is to be provided. The default value is the catalog ID of the calling user’s default pubset.

SNAPSET =
Specifies the Snapsets about which information is to be provided.

SNAPSET = *ALL
Information about all Snapsets is output.

SNAPSET = <name 1..1 with-low> / <integer -52..-1>
Information about the specified Snapset is output, the Snapset being specified by means of the Snapset ID or its relative age (-1 corresponds to the latest Snapset). The maximum of 52 pubsets is 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.

OUTPUT =
Specifies where the information is to be output.

OUTPUT = *SYSOUT
The output is directed to SYSOUT.

OUTPUT = *SYSLST
Output is written to SYSLST.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
1	0	DMS13D8	No Snapset exists on the pubset
	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	Pubset does not exist (no MRSCAT entry)
	64	DMS138C	Pubset not accessible
	64	DMS13D5	The Snapset specified does not exist
	64	DMS13DF	Subsystem SHC-OSD not available
	64	DMS13E5	No Snapset catalog exists on the pubset
	64	DMS13EC	Error in structured output in S variable
	64	DMS148F	GCF subsystem not available
1	64	DMS13D7	Internal error in Snapset management: Return code of GCF
7	64	DMS13D7	Internal error in Snapset management: Return code of CCOPY

Output in S variable

The SNAPSET operand identifies the S variables which are to be created. The following specifications are possible for SNAPSET:

Notation used in command	Abbreviated form used in table
SNAPSET = *ALL	1
SNAPSET = <name 1..1 with-low> / <integer -52..-1> (Nonprivileged user)	2
SNAPSET = <name 1..1 with-low> / <integer -52..-1> (Privileged user)	3

Output information	Name of the S variable	T	Contents	Condition
Number of Snapsets: When SNAPSET=*ALL is specified, the number of Snapsets currently created, otherwise the value is 1	var(*LIST).NUM-OF-SNAPSETS	S	<integer 1..52>	1, 2, 3
Pubset catalog ID	var(*LIST).PUBSET	S	<cat-id>	1, 2, 3
Current setting for keeping additional snap copies on a remote disk storage system	var(*LIST).REMOTE-COPY	S	NO YES	1
Name of the save pool which is assigned to the pubset	var(*LIST).SAVE-POOL-NAME	S	*DEFAULT-POOL	1
Date when the Snapset was created	var(LIST).SNAPSET(LIST).CRE-DATE	S	<yyyy-mm-dd>	1, 2, 3
Time when the Snapset was created	var(LIST).SNAPSET(LIST).CRE-TIME	S	<hh:mm:ss>	1, 2, 3
Number of pubset volumes	var(LIST).SNAPSET(LIST).NUM-OF-VOL	S	<integer 1..255>	3
Displays whether an additional snap copy has been created on a remote disk storage system	var(LIST).SNAPSET(LIST).REMOTE-COPY	S	NO YES	3
Name of the save pool which is assigned to the Snapset With ETERNUS DX/AF systems in S#-volume mode there is no save pool, hence NONE is displayed. With ETERNUS DX/AF systems in SDV mode a distinction must be made between - the Snapset does not use storage space on the save pool: DEFAULT-POOL is then displayed - the Snapset is already using storage space on the save pool: the name of the save pool as configured in the system is displayed	var(LIST).SNAPSET(LIST).SAVE-POOL- NAME	S	DEFAULT-POOL <name> NONE	2, 3
Snapset status: When access is possible, the CCOPY session ID (<x-text 8..8>) is displayed, otherwise the corresponding status display	var(LIST).SNAPSET(LIST).SESSION-ID	S	<x-text 8..8> CREATING ACTIVATE DELETING NOT_ACC.	1, 2, 3
Snapset ID	var(LIST).SNAPSET(LIST).SNAPSET-ID	S	a..z A..Z	1, 2, 3
Relative age of the Snapset	var(LIST).SNAPSET(LIST).SNAPSET-NR	S	<integer -52..-1>	1, 2, 3
MN of the assigned snap unit of the local disk storage system	var(LIST).SNAPSET(LIST).VOL(*LIST).SOURCE-SNAP-UNIT	S	<mnemo-name>	3
In the case of remote mirroring, MN of the assigned snap unit of the remote disk storage system. Otherwise *NO	var(LIST).SNAPSET(LIST).VOL(*LIST).TARGET-SNAP-UNIT	S	*NO <mnemo-name>	3
VSN of a pubset volume	var(LIST).SNAPSET(LIST).VOL(*LIST).VOL	S	<vsn>	3

If the Snapset cannot be accessed, SESSION-ID (output field or S variable) displays the Snapset status. Meaning of the possible status displays:

ACTIVATE, CREATING and DELETING are transient statuses which can occur during ongoing Snapset processing.
In the case of NOT_ACC., the Snapset is currently not available or cannot be accessed. The /CHECK-SNAPSET-CONFIGURATION command enables the Snapset configuration to be checked, and under some circumstances the Snapset to be subsequently activated. Configuration problems may need to be rectified beforehand.

Examples

Output in S variables

/declare-var var-name=var1(type=*structure),multi-elem=*list /exec-cmd cmd=(show-snapset-conf pubset=abn7), text-output=*none,structure-out=var1 /show-var var1,inf=*par(val=*c-literal)

VAR1(*LIST).PUBSET = 'ABN7'
VAR1(*LIST).NUM-OF-SNAPSETS = 2
VAR1(*LIST).SNAPSET(*LIST).SNAPSET-NR = ' -1'
VAR1(*LIST).SNAPSET(*LIST).SNAPSET-ID = 'b'
VAR1(*LIST).SNAPSET(*LIST).CRE-DATE = '2015-05-08'
VAR1(*LIST).SNAPSET(*LIST).CRE-TIME = '13:38:51'
VAR1(*LIST).SNAPSET(*LIST).SESSION-ID = '88042577'
*END-OF-VAR
VAR1(*LIST).SNAPSET(*LIST).SNAPSET-NR = ' -2'
VAR1(*LIST).SNAPSET(*LIST).SNAPSET-ID = 'a'
VAR1(*LIST).SNAPSET(*LIST).CRE-DATE = '2015-03-30'
VAR1(*LIST).SNAPSET(*LIST).CRE-TIME = '13:46:21'
VAR1(*LIST).SNAPSET(*LIST).SESSION-ID = '87042577'
*END-OF-VAR
VAR1(*LIST).SAVE-POOL-NAME = '*DEFAULT-POOL'
VAR1(*LIST).REMOTE-COPY = '*YES'
*END-OF-VAR

/declare-var var-name=var2(type=*structure),multiple-elem=*list /exec-cmd cmd=(show-snapset-conf pubset=abn7,snapset=b), text-output=*none,structure-output=var2 /show-var var2,inf=*par(val=*c-literal)

VAR2(*LIST).PUBSET = 'ABN7'
VAR2(*LIST).NUM-OF-SNAPSETS = 1
VAR2(*LIST).SNAPSET(*LIST).SNAPSET-NR = ' -1'
VAR2(*LIST).SNAPSET(*LIST).SNAPSET-ID = 'b'
VAR2(*LIST).SNAPSET(*LIST).CRE-DATE = '2015-05-08'
VAR2(*LIST).SNAPSET(*LIST).CRE-TIME = '13:38:51'
VAR2(*LIST).SNAPSET(*LIST).SESSION-ID = '88042577'
VAR2(*LIST).SNAPSET(*LIST).SAVE-POOL-NAME = '*DEFAULT-POOL'
VAR2(*LIST).SNAPSET(*LIST).REMOTE-COPY = '*YES'
VAR2(*LIST).SNAPSET(*LIST).NUM-OF-VOL = 2
VAR2(*LIST).SNAPSET(*LIST).VOL(*LIST).VOL = 'ABN7.0'
VAR2(*LIST).SNAPSET(*LIST).VOL(*LIST).SOURCE-SNAP-UNIT = '9BED'
VAR2(*LIST).SNAPSET(*LIST).VOL(*LIST).TARGET-SNAP-UNIT = '9DEB'
*END-OF-VAR
VAR2(*LIST).SNAPSET(*LIST).VOL(*LIST).VOL = 'ABN7.1'
VAR2(*LIST).SNAPSET(*LIST).VOL(*LIST).SOURCE-SNAP-UNIT = '9BEE'
VAR2(*LIST).SNAPSET(*LIST).VOL(*LIST).TARGET-SNAP-UNIT = '9DEC'
*END-OF-VAR
*END-OF-VAR
*END-OF-VA

Output to SYSOUT

/show-snapset-conf pubset=abn7

% PUBSET = 2OS6 , SAVE-POOL-NAME = *DEFAULT-POOL, REMOTE-COPY = *NO
% SNAP-ID CREATION-DATE/TIME  SESSION-ID  SNAP-ID CREATION-DATE/TIME  SESSION-ID
%  -1  b  2015-05-08 13:38:51  88042577    -2  a  2015-03-30 13:46:21  87042577

/show-snapset-conf pubset=abn7,snapset=b

% PUBSET = ABN7 , SAVE-POOL-NAME = *DEFAULT-POOL
% SNAP-ID CREATION-DATE/TIME  SESSION-ID
%  -1  b  2015-05-08 13:38:51  88042577
% VOLUME  SOURCE-UNIT  TARGET-UNIT
% ABN7.0  9BED         9DEB
% ABN7.1  9BEE         9DEC

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-SNAPSET-CONFIGURATION