IBM Support

MustGather: How to obtain and Install QMGTOOLS and keep it current



This document demonstrates how to obtain and install QMGTOOLS properly.

Resolving The Problem

This document demonstrates how to obtain and install QMGTOOLS properly.

Important Note: The MustGather Data Capture tool is provided as-is.

The MustGather Data Capture tool was created by IBM Support to help automatically collect the many pieces of debug data that is critical to fixing complex problems more quickly.

Important Note:  Currently, there are no requirements to use this tool.

The current release date of QMGTOOLS is 03/30/2021. QMGTOOLS is only updated for IBM i supported releases - Currently 7.2 and above. QMGTOOLS is no longer updated for 7.1 and below, regardless of an extended contract.
To check the version run command:  CALL QMGTOOLS/QGETVER or GO QMGTOOLS/MG then option 12.  If the build date is before September 28, 2020 update QMGTOOLS before use.

Note:  Since parts of QMGTOOLS collects system information, it will be shipped with public *EXLCUDE.
The command QMGTOOLS/CHGPUBAUT (change public authority) is included to allow the ability 
to change the public authority for the contents of the QMGTOOLS library.  
For example, to change public to *CHANGE for objects in QMGTOOLS library, run command:  

There are three suggested methods to get the QMGTOOLS library if the library does not exist on the IBM i system.

Method 1 - Installation of QMGTOOLS via PTF order

QMGTOOLS can be obtained via PTF. Refer to the PTF Cover letter for the latest information.

Note: If your release is not listed here, then refer to the other methods to get QMGTOOLS in this document.  The QMGTOOLS library shipped via the following PTFs have a build date of 10/11/2019.

The current QMGTOOLS build provided by the PTFs is from 2019. Internet connectivity is required to update the utility by using GO MG Option 13 after the QMGTOOLS utility is restored from the PTF save file. 

NOTE: When PTF is applied, if library QMGTOOLS is on the system, a check for the build date is performed. If the build date is less than the build date of the one that is included in the PTF, library QMGTOOLS is cleared and an attempt is made to restore that library from the PTF.

SI71232 - R740 APAR SE72229
SI71231 - R730 APAR SE72229
SI71203 - R720 APAR SE72229

Method 2 - Other methods to obtain QMGTOOLS

Follow the URL:

A video of the QMGTOOLS install process is available:

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Historical Number


Document Information

Modified date:
07 April 2021