This statement serves to create a snapshot file. Only one snapshot file is permitted per pubset. It is cataloged under the file name $TSOS.SNAPFILE.
CREATE-SNAP-FILE |
DISK-NUMBER=n ,FILE-SIZE=<integer 16..1024> |
DISK-NUMBER
Specifies the disk of the pubset on which the snapshot file is to be created.
Depending on the format of the pubset ID (see the DECLARE-PUBSET statement), the number of the disk on the pubset must be specified.
DISK-NUMBER=n
One- to three-digit number of the IPL disk in the pubset (see "CREATE-VOLUME - Initialize disks").
FILE-SIZE=<integer 16..1024>
Specifies the minimum size of the snapshot file in Mbytes.
The value is rounded up to the size of the allocation unit.
It must be possible to create the entire file as one extent.
If the disk capacity is less than the value of the FILE-SIZE operand, the snapshot file is created with the size of the maximum disk value.
Information on the size of the snapshot file is provided in the “Diagnostics Handbook” [2 (Related publications)].
Notes
If a paging file is created on the same disk, the snapshot file is created from the end of the disk and the paging file is centered. If the areas overlap on the disk, the snapshot file is not created.
Creation of a snapshot file is recommended when the SNAP dump is already to be available after system initialization. See the SNAP-ACTIVE-SWITCH parameter in the startup parameter service, “Introduction to System Administration” [5]. When setting up a pubset with
DECLARE-PUBSET PUBSET-TYPE=*S-F(ACTION=*INSTALL)
, a warning is output if no CREATE-SNAP-FILE statement is specified.A snapshot file can also be created or modified retroactively using the ACTIVATE-SNAPSHOT command when the SNAP dump is activated.