The zhmc tool

Edit online

You can use the HMC Web Services API to trigger dumps for Linux® in LPAR mode or in a DPM partition.

For information about the API, see Hardware Management Console Web Services API for your IBM Z® or LinuxONE hardware.

The zhmc command is the user interface for a client application that uses this API. For the command syntax and more information about this application, see https://github.com/zhmcclient/zhmccli.

Hint: The zhmc command is case sensitive. For hardware and partition specifications, use the capitalization as shown in the HMC interface and the corresponding HMC API queries.

Example for triggering a DPM partition dump

The following example makes these assumptions about the hardware system, LPAR, and boot device:
  • The name of the IBM Z or LinuxONE system is T46.
  • The name of the DPM partition is t46lp79.
  • The UUID of the dump volume is 0x6005076309FFD43500000000000078DA
For the example, follow these steps:
  1. Optional: Establish a console connection for viewing the progress and error information of the dump process.
    # zhmc partition console T46 t46lp79
  2. Start the dump process. If applicable, use a terminal session other than the session that displays the console messages.
    # zhmc partition dump --volume 6005076309FFD43500000000000078DA T46 t46lp79

Example for triggering an LPAR dump to a SCSI dump device

The following example makes these assumptions about the hardware system, LPAR, and boot device:
  • The name of the IBM Z or LinuxONE system is S35.
  • The name of the LPAR is S35LP54.
  • An FC-attached SCSI disk is prepared, with zipl, as a dump device.
  • The LUN of the disk is 0x4712000000000000.
  • The disk is accessed through WWPN 0x4712076300ce93a7.
  • The FCP device to access the disk has a bus ID 0.0.4711.
For the example, follow these steps:
  1. Optional: Establish a console connection for viewing the progress and error information of the dump process:
    # zhmc lpar console S35 S35LP54
  2. Start the dump process. If applicable, use a terminal session other than the session that displays the console messages.
    # zhmc lpar scsi-dump S35 S35LP54 4711 4712076300ce93a7 4712000000000000