Commands Reference, Volume 5

snap Command

Purpose

Gathers system configuration information.

Syntax

snap [ -a ] [ -A ] [ -b ] [ -c ] [ -D ] [ -f ] [ -g ] [ -G ] [ -i ] [ -k ] [ -l ] [ -L ][ -n ] [ -N ] [ -p ] [ -r ] [ -s ] [ -S ] [ -t ] [ -T ] [ -w ] [ -o OutputDevice ] [ -d Dir ] [ -v Component ]

snap [ -a ] [ -A ] [ -b ] [ -c ] [ -D ] [ -f ] [ -g ] [ -G ] [ -i ] [ -k ] [ -l ] [ -L ][ -n ] [ -N ] [ -p ] [ -r ] [ -s ] [ -S ] [ -t ] [ -T ] [ -o OutputDevice ] [ -d Dir ] [ -v Component ]

Description

The snap command gathers system configuration information and compresses the information into a pax file. The file can then be down-loaded to disk or tape, or transmitted to a remote system. The information gathered with the snap command may be required to identify and resolve system problems.

Note: Root user authority is required to execute the snap command.

Use the snap -o /dev/rfd0 command to copy the compressed image to diskette. Use the snap -o /dev/rmt0 command to copy the image to tape.

Approximately 8MB of temporary disk space is required to collect all system information, including contents of the error log. If you do not gather all system information with the snap -a command, less disk space may be required (depending on the options selected).

Note: If you intend to use a tape to send a snap image to IBM for software support, the tape must be one of the following formats:

8mm, 2.3 Gb capacity

8mm, 5.0 Gb capacity

4mm, 4.0 Gb capacity

Using other formats prevents or delays IBM software support from being able to examine the contents.

The snap -g command gathers general system information, including the following:

Error report
Copy of the customized Object Data Manager (ODM) database
Trace file
User environment
Amount of physical memory and paging space
Device and attribute information
Security user information

The output of the snap -g command is written to the /tmp/ibmsupt/general/general.snap file.

The snap command checks for available space in the /tmp/ibmsupt directory, the default directory for snap command output. You can write the output to another directory by using the -d flag. If there is not enough space to hold the snap command output, you must expand the file system.

Each execution of the snap command appends information to previously created files. Use the -r flag to remove previously gathered and saved information.

Flags

-a	Gathers all system configuration information. This option requires approximately 8MB of temporary disk space.
-A	Gathers asynchronous (TTY) information.
-b	Gathers SSA information.
-c	Creates a compressed pax image (snap.pax.Z file) of all files in the /tmp/ibmsupt directory tree or other named output directory. Note: Information not gathered with this option should be copied to the snap directory tree before using the -c flag. If a test case is needed to demonstrate the system problem, copy the test case to the /tmp/ibmsupt/testcase directory before compressing the pax file.
-D	Gathers dump and /unix information. The primary dump device is used. Notes: If bosboot -k was used to specify the running kernel to be other than /unix, the incorrect kernel is gathered. Make sure that /unix is , or is linked to, the kernel in use when the dump was taken. If the dump file is copied to the host machine, the snap command does not collect the dump image in the /tmp/ibmsupt/dump directory. Instead, it creates a link in the dump directory to the actual dump image. Gathers dump and /unix information. The primary dump device is used.
-d Dir	Identifies the optional snap command output directory (/tmp/ibmsupt is the default).
-f	Gathers file system information.
-g	Gathers the output of the lslpp -hBc command, which is required to recreate exact operating system environments. Writes output to the /tmp/ibmsupt/general/lslpp.hBc file. Also collects general system information and writes the output to the /tmp/ibmsupt/general/general.snap file.
-G	Includes predefined Object Data Manager (ODM) files in general information collected with the -g flag.
-i	Gathers installation debug vital product data (VPD) information.
-k	Gathers kernel information
-l	Gathers programming language information.
-L	Gathers LVM information.
-n	Gathers Network File System (NFS) information.
-N	Suppresses the check for free space.
-o OutputDevice	Copies the compressed image onto diskette or tape.
-p	Gathers printer information.
-r	Removes snap command output from the /tmp/ibmsupt directory.
-s	Gathers Systems Network Architecture (SNA) information.
-S	Includes security files in general information collected with the -g flag.
-t	Gathers Transmission Control Protocol/Internet Protocol (TCP/IP) information.
-T	Gathers all the log files for a multicpu trace. Only the base file, trcfile, is captured with the -g flag.
-v Component	Displays the output of the commands executed by the snap command. Use this flag to view the specified name or group of files. Note: Press the Ctrl-C key sequence to interrupt the snap command. A prompt will return with the following options: press the Enter key to return to current operation; press the S key to stop the current operation; press the Q key to quit the snap command completely.
-w	Gathers WLM information

Examples

Enter the following command to gather all system configuration information:
```
snap -a
```
The output of this command is written to the /tmp/ibmsupt directory.
Enter the following command to create a pax image of all files contained in the /tmp/ibmsupt directory:
```
snap -c
```
Enter the following command to gather general system configuration information, including the output of the lslpp -hBc command:
```
snap -g -o /dev/rfd0
```
Output is written to the /tmp/ibmsupt/general/lslpp.hBc and /tmp/ibmsupt/general/general.snap files. This command also writes the system information to a removable diskette.

Files

/usr/sbin/snap	Contains the snap command.
/tmp/ibmsupt	Contains snap command output.
/tmp/ibmsupt/general/lslpp.hBc	Contains the output of the lslpp -hBc command, which is required to recreate exact operating system environments.
/tmp/ibmsupt/general/general.snap	Contains general system information that is collected with the snap -g command.
/tmp/ibmsupt/testcase	Contains the test case that demonstrates your system problem.

Related Information

The errpt command, lslpp command, sysdumpdev command, sysdumpstart command.