This document explains how to send and upload data to IBM i Support that uses the MustGather tool.
IBM i OS v7.1 and later
Diagnosing The Problem
The IBM MustGather tool provides an automated option for sending and uploading MustGather data files to IBM i Support from the IBM i Server.
When executed, the tool automatically sends and uploads a save file or files in the IFS from your IBM i Server to IBM i Support.
Resolving The Problem
On the IBM i server, refer to the following instructions to send and upload the MustGather information needed by IBM Support to help diagnose the cause of and resolve your issue.
Note: If this method fails, refer to this link for more methods:
Step 1 Install QMGTOOLS
To install the MGTOOLS toolkit, refer to the following document for how to download and install the MGTOOLS toolkit on your IBM i server.
Step 2 The FTP option
A) Add the QMGTOOLS library to your library list by issuing the following command:
B) Go to the QMGTOOLS main menu.
C) In the following example, option 10 is the FTP data to IBM option.
Step 3 Parameters
To send a save file, choose *SAVF for the
File Type parameter. The FILE and LIBRARY parameter is where you put in the save file information.
To send an IFS file, such as an HMC pedbg file, choose *IFS for the
File Type parameter. The IFS FILE parameter is where you put the location of the file in the IFS.
Note: Choosing *SFTP uses secure FTP for non-Blue Diamond customers. For Blue Diamond customers, choose *BDFTP as that uses both SFTP and SSL FTP. Refer to the Blue Diamond link at the end of this document for further details.
FTP type - *IBMSDDUU is a multithread Java application that splits up the file and uploads to EcuRep/Testcase, *SFTP uses secure FTP (port 22) to IBM, *STDFTP uses a standard FTP connection to EcuRep/Testcase, *BDFTP is for Blue Diamond customers
| || |
| || |
| || |
| || |
The hosts used by QMGTOOLS is based on this URL:
IBM/BD ID and Pass - IBM ID, Transfer ID, Blue Diamond ID, or *STORED. Currently, set to 'anonymous'. At some point in time, IBM requires an IBM ID to upload data if you are not a Blue Diamond client. Refer to the following link to register for an IBM ID:
If the preceding URLs do not work, do a search for "IBM ID" using an Internet search engine.
For current information on what ID is required for transferring files to IBM, refer to the following URL. If the following URL does not work, do a search for "Ecurep" using an Internet search engine.
*STORED refers to if the user stored credentials using the option "Store FTP2IBMCMD credentials" from the QMGTOOLS main menu.
File type - is the file located in the IFS or is this a save file. Note: If file type is *IFS, you must refer to the full path of the file located in the IFS and not the IFS directory.
There are 3 options to enter an IBM problem number:
PMR#, Branch, Country - the PMR information
RCMS# - an RCMS number
Case Number# - case number
After you press Enter, more parameters are presented. IBM recommends these values remain default unless directed by IBM. If you would like to receive a confirmation of the upload, you are welcome to enter your email address in the "Email address" field. Leave all other fields as default.
An FTP2IBM job gets submitted to execute the FTP transfer. Details on the FTP transfer are logged in option 11 of the main QMGTOOLS menu, View FTP to IBM Statuses. Select V to view the FTP log.
Refer to the following documents for more information:
QMGTOOLS: Front end interface for IBM Secure Diagnostic Data Upload Utility
IBM Secure Diagnostic Data Upload Utility in the IBM i Environment
06 October 2020