zdump/zgetdump.8

   1 .TH ZGETDUMP 8 "Apr 2006" "s390-tools"
   2 .SH NAME
   3 zgetdump \- tool for copying dumps.
   4 .SH SYNOPSIS
   5 \fBzgetdump\fR [-d] [-h] [-i] [-a] [-v] \fIdumpdevice\fR
   6 .SH DESCRIPTION
   7 \fBzgetdump\fR takes as input the dump device and writes its contents
   8 to standard output, which you can redirect to a specific file.
   9 .br
  10 \fBzgetdump\fR can also check, whether a DASD device contains a valid dumper.
  11 .SH OPTIONS
  12 .TP
  13 \fB-d\fR
  14 Check DASD device \fIdumpdevice\fR for valid dumper.
  15 .TP
  16 \fB-h\fR
  17 Print usage and exit.
  18 .TP
  19 \fB-i\fR
  20 Print the dump header information reading from the \fIdumpdevice\fR and
  21 check if the dump is valid.
  22 .TP
  23 \fB-i -a\fR
  24 Print the dump header information and check if the dump is valid when
  25 \fIdumpdevice\fR is a multi-volume tape.
  26 (Mount and check all cartridges in sequence.)
  27 .TP
  28 \fB-v\fR
  29 Output version information and exit.
  30 .TP
  31 \fBdumpdevice\fR
  32 This parameter specifies the device or partition where the dump is located.
  33 .SH EXAMPLE
  34 1. Scenario: DASD partition /dev/dasdx1 was prepared for dump by means of
  35 .br
  36   zipl -d /dev/dasdx1
  37 .br
  38 The corresponding single-volume dump tool was IPLed.
  39 .RB "The respective " "zgetdump " "call to copy the dump from the DASD
  40 partition to file dump_file is:
  41 .br
  42
  43   zgetdump /dev/dasdx1 > dump_file
  44
  45 2. Scenario: DASD partitions /dev/dasdx1 and /dev/dasdy1 contained in file
  46 dump_list_conf were prepared for dump by means of
  47 .br
  48   zipl -M dump_list_conf
  49 .br
  50 The corresponding multi-volume dump tool was IPLed.
  51 .RB "The respective " "zgetdump " "call to copy the dump from the DASD
  52 partitions to file dump_file is:
  53 .br
  54
  55   zgetdump /dev/dasdx > dump_file   or equivalent
  56 .br
  57   zgetdump /dev/dasdy > dump_file
  58
  59 3. Scenario: Tape device /dev/ntibm0 was prepared for dump by means of
  60 .br
  61   zipl -d /dev/ntibm0
  62 .br
  63 The corresponding tape dump tool was IPLed.
  64 .RB "The respective " "zgetdump " "call to copy the dump from the tape
  65 to file dump_file is:
  66 .br
  67
  68   zgetdump /dev/ntibm0 > dump_file
  69