DB2 10.5 for Linux, UNIX, and Windows

db2snapcore - DB2® snapcore for Linux and Solaris command

On Linux and Solaris operating systems, this command mimics the functionality provided by the snapcore command on AIX® operating systems. The command extracts the shared objects list section from the EDU trap file, combines the section together with a core file and compresses the output into an archive which can be sent to IBM Support for analysis.

Authorization

One of the following authorities:
  • Instance owners
  • DBADM authority

Command syntax

Read syntax diagramSkip visual syntax diagram
>>-db2snapcore-- -c--corefile--+- -t--trapfile-+---------------->
                               '- -m--pmapfile-'   

>-- -e--executable_path--+-----------------------+-------------->
                         '- -o--output_directory-'   

>--+--------------+--+-----+-----------------------------------><
   |      .-pax-. |  '- -v-'   
   |      +-tar-+ |            
   '- -p--+-----+-'            

Command parameters

-c corefile | -corefile corefile
Specifies a relative or absolute path to the core file.
-t trapfile | -trapfile trapfile
Specifies a relative or absolute path to the trap file.
-m pmapfile | -mapfile pmapfile
Specifies a relative or absolute path to the pmap file.
-e executable_path | -executable executable_path
Specifies a relative or absolute path to the executable file. This file is either provided by IBM Support or obtained from the trap file under the guidance of IBM Support.
-o output_directory | -outdir output_directory
Specifies an output directory for the compressed output file. The specified output directory must exist.
-p | -packCommand
Compresses all files into an archive. On Linux operating systems, files are compressed into a pax archive by default. On the Solaris operating system, the pax option is not available and files are compressed into a tar archive by default.
pax
Specifies that the files are compressed using the pax (portable archive exchange) command. On the Solaris operating system, the pax option is not available.
tar
Specifies that the files are compressed using the tar (tape archive) command. Requires the tar command to be installed on the system.
-v | -verbose
Enables verbose mode.

Example

To archive the extracted shared objects list section from an EDU trap file or pmap file and a core file, issue a command like the following, replacing core and trap file names as required:
Linux
db2snapcore -corefile db2sysc.6270.98042.core -trapfile 28930.16.000.trap.txt -e ~/sqllib/adm/db2sysc
Solaris
db2snapcore -corefile 21870.000.core -mapfile OSSNAPS/pmap.txt -e ~/sqllib/adm/db2sysc

Depending on which archiving method is used (pax command or tar command), the file name for the resulting archive is either db2snapcore.pax.gz or db2snapcore.tar.gz.