IBM Support




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.

image 12108

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.

FTP to IBM command screen

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.

FTP to IBM *IFS screen

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. The following URL provides some guidance on creating an IBM transfer ID. QMGTOOLS: Create a transfer ID to upload data to IBM

*IBMSDDUU Encrypted standard FTP over port 21 in passive mode
*SFTP Encrypted secure FTP over port 22
*STDFTP Nonencrypted standard FTP over port 21 in passive mode
*BDFTP Encrypted SSL FTP over port 990 in passive mode
*HTTPS Encrypted SSL HTTP transfer over port 443

The hosts used by QMGTOOLS can be found in the following URL.

Enhanced Customer Data Repository (ECuRep) - Send data

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

GDPR-related Changes to ECuRep and Testcase FTP File Uploads

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.

Enhanced Customer Data Repository (ECuRep) - Send data

*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.

FTP to IBM statuses screen

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

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

Historical Number


Document Information

Modified date:
16 November 2021