IBM Support

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

Troubleshooting


Problem

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 080819.
**************************************************************
To check the version run command:  CALL QMGTOOLS/QGETVER or GO QMGTOOLS/MG then option 12.  If the build date is before 2019 update QMGTOOLS before use.


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

Method 1 - Install 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 11/02/2018.

***IMPORTANT***
The current QMGTOOLS build provided by the PTFs is from 2014. Use this option if your IBM i server is able to connect to the Internet. 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.

R740 PTF is under construction.  The manual download and install method below needs to be followed.
SI68645 - R720 APAR SE70173 https://www-01.ibm.com/support/docview.wss?uid=nas2SE70173
SI68663 - R730 APAR SE70173 https://www-01.ibm.com/support/docview.wss?uid=nas2SE70173

The cover letter of the PTFs provides the following process to restore QMGTOOLS:
1) After applying the PTF, a save file, QESMGTSAVF, is created in
library QSYS

2) This save file contains the QMGTOOLS library

3) Record the QALWOBJRST (allow object restore option) system value with
command: DSPSYSVAL SYSVAL(QALWOBJRST)

4) Change the QALWOBJRST (allow object restore option) system value to
*ALL with command: CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(*ALL)

5) If QMGTOOLS library exists, clear the library and restore with
command: RSTOBJ OBJ(*ALL) SAVLIB(QMGTOOLS) DEV(*SAVF)
SAVF(QSYS/QESMGTSAVF) MBROPT(*ALL) ALWOBJDIF(*ALL)

6) If QMGTOOLS library does not exist, restore with command:
RSTLIB SAVLIB(QMGTOOLS) DEV(*SAVF) SAVF(QSYS/QESMGTSAVF)
MBROPT(*ALL) ALWOBJDIF(*ALL)

7) Change back the QALWOBJRST system value to the original value with
command: CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(xxxx) where xxxx was
the original value

8) Once QMGTOOLS is installed, try to update QMGTOOLS to get the latest version:

a) GO QMGTOOLS/MG

b) choose option 13 (Check IBM for updated QMGTOOLS)

Method 2 - Manually download and install QMGTOOLS from IBM FTP site


To obtain the tool go to the following URL: http://public.dhe.ibm.com/services/us/igsc/has/

Or from the main iDoctor page ( https://www-912.ibm.com/i_dir/idoctor.nsf ), do the following:
1. Select Downloads ( https://www-912.ibm.com/i_dir/idoctor.nsf/downloadoptions.html )
2. Click HA and QMGTOOLS ( http://public.dhe.ibm.com/services/us/igsc/has/ )

Download the version appropriate to the IBM i OS level being debugged (for example, if user is on R730 download the QMGTOOL730.savf):

image-20190718095100-1

A save file called QMGTOOLxxx.savf (where xxx = VRM of the IBM i OS level) will be downloaded to the user's PC, where it can be FTP'd to the IBM i system(s).

image-20190718095155-2

On the IBM i server, create the QMGTOOLS library and save file.
CRTLIB QMGTOOLS
CRTSAVF QMGTOOLS/QMGTOOLS

Use a DOS/Command prompt to FTP the save file from the PC to the IBM i server.
Example commands:
CD DESKTOP <<if the QMGTOOLxxx.savf resides on the desktop>>
FTP <IBM i server name>
BIN
PUT QMGTOOLxxx.savf QMGTOOLS/QMGTOOLS
or
PUT QMGTOOLxxx.SAVF /QSYS.LIB/QMGTOOLS.LIB/QMGTOOLS.SAVF

Restore the QMGTOOLS library on the IBM i system.
1. Issue the following IBM i command:
RSTLIB SAVLIB(QMGTOOLS) DEV(*SAVF) SAVF(QMGTOOLS/QMGTOOLS) MBROPT(*ALL) ALWOBJDIF(*ALL)

2. With the library successfully restored, proceed to the QMGTOOLS main menu by adding QMGTOOLS to the library list. ADDLIBLE QMGTOOLS
GO MG

Method 3 - Get the latest QMGTOOLS via iDoctor GUI interface


Refer to this link for instructions: http://www-01.ibm.com/support/docview.wss?uid=nas8N1020164

Historical Number

614354368

Document information

More support for: IBM i

Software version: All Versions

Operating system(s): IBM i

Reference #: N1011297

Modified date: 08 August 2019