ACTIVATE-SNAPSHOT

Start dump generator SNAP

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

Function

The ACTIVATE-SNAPSHOT enables the SNAP dump function. Any suspended SNAP dump will be processed (i.e. it will be assigned index structures for evaluation with the DAMP program and copied to the SYSSNAP ID). The command can be executed multiple times, e.g. in order to modify the size of the system file $TSOS.SNAPFILE.

ACTIVATE-SNAPSHOT is executed asynchronously. Message NSP4000 confirms that the command has been received correctly. The SHOW-SNAPSHOT-STATUS command enables you to check the modified settings.

Manual changes to the Snapshot files can lead to undefined statuses when the SNAP dump takes place. Modifications may only be made using the ACTIVATE-SNAPSHOT and DEACTIVATE-SNAPSHOT commands.

Format

ACTIVATE-SNAPSHOT                                                                                                                      

FILE-SIZE = *UNCHANGED-OR-STD / <integer 16..1024 Mbyte>

Operands

FILE-SIZE = *UNCHANGED-OR-STD / <integer 16..1024> Mbyte
Determines the size of the system file $TSOS.SNAPFILE on the home pubset.

FILE-SIZE = *UNCHANGED-OR-STD
The size of the system file $TSOS.SNAPFILE remains unchanged. If it does not yet exist, it is created with the standard size of 144 MB.

FILE-SIZE = <integer 16..1024 Mbyte>
Size of the system file $TSOS.SNAPFILE on the home pubset. The system file is expanded or reduced as required. If it does not yet exist, a new system file is created with this size.

A size of at least 144 MB is recommended.

 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error