This document explains how to send and upload data to IBM i Support that uses the MustGather tool.
IBM i OS v7.2 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 the method in this document fails, refer to the following link for more methods:
MustGather: Instructions for Sending Data to IBM i Support
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.
MustGather: How to obtain and Install QMGTOOLS and keep it current
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, *HTTPS uses HTTPS (port 443) to transfer data to IBM
Note: For *HTTPS, you would need a transfer ID and password. Use the following URL to create a transfer ID. https://www.secure.ecurep.ibm.com/transferids/. The following URL provides some guidance on creating an IBM transfer ID. QMGTOOLS: Create a transfer ID to upload data to IBM
|*HTTPS||Encrypted SSL HTTP transfer over port 443|
The hosts used by QMGTOOLS can be found in the following URL.
IBM/BD/Transfer 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:
Register for an IBM ID
QMGTOOLS: Create a transfer ID to upload data to IBM
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:
16 November 2021