QUERY DUMPDEV
Authorization
Privilege Class: G
Purpose
Use the QUERY DUMPDEV command to display DUMPDEV parameters for a guest IPL. The parameters are for a list-directed IPL with dump from a SCSI or ECKD device. The parameters can identify the system dumper program and information to pass to the program. The parameters can also identify the virtual device number and specify whether the IPL is a secure IPL. The device that is IPLed is also used to store the dump data.
The DUMPDEV parameters can be set by using the SET DUMPDEV command.
For more information, see SET DUMPDEV.
Responses
The following lines are displayed if DUMPDEV parameters are set for a SCSI device:
SCSI DEVICE {TBD } {NOSECURE}
{dddd} {SECURE }
PORTNAME hhhhhhhh hhhhhhhh LUN hhhhhhhh hhhhhhhh BOOTPROG {n }
{AUTO}
BR_LBA hhhhhhhh hhhhhhhh
The following lines are displayed if DUMPDEV parameters are set for an ECKD device:
ECKD DEVICE {TBD } {NOSECURE}
{dddd} {SECURE }
BOOTPROG {n } BOOTREC {cylinder head record}
{AUTO} {LABEL }
ALTERNATE dddd PORTNAME hhhhhhhh hhhhhhhh
SCPDATA
00----03 04----07 08----11 12----15 16----19
0000 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
0020 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
0040 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
.
.
.
SCPDATA
0----+----1----+----2----+----3----+----4----+----
0000 tttttttttttttttttttttttttttttttttttttttttttttttttt
0050 tttttttttttttttttttttttttttttttttttttttttttttttttt
0100 tttttttttttttttttttttttttttttttttttttttttttttttttt
.
.
.
- SCSI
- The SCSI response indicates that DUMPDEV parameters are set for the IPL of a SCSI device. SCSI is the default device type.
- ECKD
- The ECKD response indicates that DUMPDEV parameters are set for the IPL of an ECKD device.
- DEVICE TBD
- DEVICE dddd
- The DEVICE TBD response indicates that the DUMPDEV parameters do not include the device number.
The device number is to be specified later.
If the SECURE parameter is not set, then the device number can be specified later as an operand of the IPL command. If the SECURE parameter is set, then the device number must be set by using the SET DUMPDEV command.
The DEVICE dddd response indicates the 4-digit hexadecimal virtual device number (dddd) of the device to be IPLed.
There is no default value for the DEVICE parameter.
- PORTNAME hhhhhhhh hhhhhhhh
- The PORTNAME response indicates the hexadecimal 8-byte fibre channel port name of the SCSI device. The default value is 0.
- LUN hhhhhhhh hhhhhhhh
- The LUN response indicates the hexadecimal 8-byte logical unit number of the SCSI device. The default value is 0.
- BOOTPROG n
- BOOTPROG AUTO
- The BOOTPROG response indicates the boot program that is loaded from the IPL device. The n value indicates the program number. The program number must be a decimal value in the range 0 - 30. The BOOTPROG AUTO response indicates that the first dump program (not operating system) on the IPL device is loaded. The default value is BOOTPROG 0.
- BR_LBA hhhhhhhh hhhhhhhh
- The BR_LBA response indicates the hexadecimal logical-block address of the boot record of the SCSI device. The default value is 0.
- BOOTREC cylinder head record
- BOOTREC LABEL
- The BOOTREC response indicates the location of the boot record. The location can be a
specification of cylinder, head, and record on the IPL device. The values are delimited by blanks
and contain no leading zeros. The values must be in hexadecimal format.
A BOOTREC LABEL response indicates that the location of the boot record is determined from the volume label. BOOTREC LABEL is the default setting.
- ALTERNATE
- The ALTERNATE response line can be produced up to three times. Each line identifies an alternate device number and fibre-channel port name that can be used to access the LUN.
- SECURE
- NOSECURE
- The SECURE response indicates that the SECURE parameter is set. The NOSECURE response indicates that the SECURE parameter is not set. The SECURE parameter must be set before you can initiate a secure IPL. NOSECURE is the default setting.
- SCPDATA
- The SCPDATA response indicates the information that is passed to the IPL program. The information is displayed in the same format (text or hex) as it was entered.
Usage Notes
- Parameters for a list-directed IPL without
dump (also called LOADDEV parameters) are set by using any of the following methods:
- SET LOADDEV command.
- LOADDEV user directory statement. The LOADDEV user directory statement can be modified by a directory management tool such as IBM® Directory Maintenance (DirMaint). To set load parameters by using DirMaint, use the DIRM LOADDEV command. The LOADDEV user directory statement can be modified also by the Image_IPL_Characteristics_Define_DM API function.
Parameters for a list-directed IPL with dump (also called DUMPDEV parameters) are set by using the CP SET DUMPDEV command.
For more information, see SET LOADDEV and SET DUMPDEV, LOADDEV Directory Statement in z/VM®: CP Planning and Administration, DIRM LOADDEV in z/VM: Directory Maintenance Facility Commands Reference, and Image_IPL_Characteristics_Define_DM API function in z/VM: Systems Management Application Programming.
- If a DUMPDEV parameter is not set and has a default value, then the QUERY DUMPDEV response displays the default parameter value.
- The default LOADDEV and DUMPDEV values for the PORTNAME and LUN parameters is 0, which is not a valid device port name and not a valid device LUN. An IPL attempt that uses the default value for the PORTNAME or LUN parameter will fail.
Messages
- HCP003E Invalid option - command contains extra option(s) starting with option
- HCP2824I No DUMPDEV parameters are currently defined