SHOW-SNAPSHOT-STATUS

Display information about the dump generator

Component:	BS2000
Functional area:	System control and optimization
Domain:	SYSTEM-MANAGEMENT
Privileges:	TSOS OPERATING
Routing code:	R

Function

The SHOW-SNAPSHOT-STATUS command displays the following information about the dump generator SNAP:

• Status of the SNAP dump function (enabled or disabled)

• Maximum SNAP runtime (value of the system parameter SNAPTIME)

• Information about the system files of SNAP

Format

SHOW-SNAPSHOT-STATUS                                                                                                                      

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without errors
	1	CMD2201	Error in function call: Function errored
	3	CMD2203	Error in function call: Version errored
	32	CMD0221	System error
	64	CMD0216	Command privilege missing

Output format

The information is output on a line-by-line basis. 

Sample output

SNAPSHOT-STATUS: READY
SNAPTIME       : 24             SECONDS
SNAPFILE.DAT   : :4V08:$TSOS.SNAPFILE.DAT
SNAPFILE       : :4V08:$TSOS.SNAPFILE
    SIZE       : 153744         PAM PAGES
    EXTENTS    : 2
    EXTENT#  VSN     EXTENT_SIZE
    1        4V08.0  153600
    2        4V08.1  144 

Explanation of the output lines

Output line	Meaning and possible values
SNAPSHOT-STATUS	Shows whether the SNAP dump function is initialized for the active session. Possible values: OFF SNAP dump function is disabled (after system startup with SNAP-ACTIVE-SWITCH=OFF parameter or after /DEACTIVATE-SNAPSHOT) READY SNAP dump function is enabled (after system startup with SNAP-ACTIVE-SWITCH=ON parameter or after /ACTIVATE-SNAPSHOT) PREVIOUS Data of a SNAP dump was not copied to the $SYSSNAP.xxx file NOT_INIT Not all resources are ready IN_INIT Resources provided IN_PROCESS A SNAP dump will be created IN_COPY Data of a SNAP dump will be copied to the $SYSSNAP.xxx file LOCKED The Snapshot process was suspended as the result of an internal error (see messages or SERSLOG entries). Systems support must initiate measures to correct this error.
SNAPTIME	Currently set maximum SNAP runtime in seconds which is set using the system parameter SNAPTIME. Possible values: <integer 8..24>, where a value <  8 is shown with 8 and a value > 24 with 24.
SNAPFILE.DAT	Complete path name of the system file: :$TSOS.SNAPFILE.DAT. If the file does not exist “-” is output.
SNAPFILE	Complete path name of the system file: :$TSOS.SNAPFILE. If the file does not exist “-” is output.
If the system file $TSOS.SNAPFILE exists further information is output.
SIZE	Size of the system file $TSOS.SNAPFILE in PAM pages
EXTENTS	Number of extents of the system file $TSOS.SNAPFILE
Detailed information on the extents is provided in a table with the following columns:
EXTENT#	Sequence number of the extent, beginning with 1
VSN	VSN of the pubset disk on which the file is located
EXTENT_SIZE	Size of the extent in PAM pages

Table 151: Output lines of the SHOW-SNAPSHOT-STATUS command