IBM Support

IBM Secure Diagnostic Data Upload Utility in the IBM i Environment

Troubleshooting


Problem

IBM Secure Diagnostic Data Upload Utility (IBMSDDUU) is a secure mechanism to quickly upload data to IBM for Support purposes.

Environment

IBM i OS

Resolving The Problem

Requirements
An IBM Java Development Kit version must be installed to take advantage of this utility.
Refer to the URLs below for more information on how to download and install 57xxJV1 Options 14, 15, 16, and 17.
How To Download JDK 7.0/7.1 for the IBM i OS (57xxJV1 Options 14 & 15)
Support of Java Development Kit (JDK) 8.0 on the IBM i OS
An IBM Support Case must be open already, to which the uploaded data will be associated.

Download information for the IBMSDDUU tool can be found in the document:
Enhanced Customer Data Repository (ECuRep) - Send data (Java utility)

Instructions for use on the IBM i OS
Download the ibmsdduu_http.jar file from IBM.

image-20220729112222-1
Place the ibmsdduu_http.jar file in any IFS directory (for example, /home/mydir).
Issue the STRQSH command from the IBM i command line to get into the P0SIX environment.
Change to the directory containing the ibmsdduu_http.jar file (for example, cd /home/mydir/).
For sending standard IFS files:
 
java -cp ibmsdduu_http.jar ibmsdduu/httpupload -email=<email> -id=<TSnnnnnnnnn> -userid=<transfer_id> -password=<password> <file_name>
 
Where <email>, <transfer_id>, <password>, and <file_name> (/home/myfile.txt) are replaced with appropriate information and <TSnnnnnnnnn> is replaced with the case number.
For sending data that resides in an IBM i OS library environment:

Example - Sending a Save File, SAMPLDTA, in library SAMPLLIB:
  • In QSH, create a directory in the IFS to hold data temporarily:
    mkdir /sampledir
  • Move or copy the Save File to the newly created directory:
    mv /QSYS.LIB/SAMPLLIB.LIB/SAMPLDTA.FILE /sampledir
    or

    cp /QSYS.LIB/SAMPLLIB.LIB/SAMPLDTA.FILE /sampledir
  • Send the file using ibmsdduu.jar:
    java -cp ibmsdduu_http.jar ibmsdduu/httpupload -email=<email> -id=TSnnnnnnnnn -userid=<transfer_id> -password=<password> /sampledir/SAMPLDTA.FILE

Where <email>, <transfer_id>, <password>, and <file_name> are replaced with appropriate information and <TSnnnnnnnnn> is replaced with the case number.

The -threads parameter allows for specifying between 1 and 15 threads. The maximum of 15 threads may not be allowed in some customer environments; however, it is allowed by IBM's Enhanced Customer Data Repository (ECuRep).

Specifying a server close to your geographic location may yield improved upload performance and reliability. Use the -server parameter to select a closer data repository.
  • In the Americas use: -server=testcase.boulder.ibm.com
    In Europe, the Middle East, and Africa, use: -server=www.secure.ecurep.ibm.com (default)
    In Asia Pacific use: -server=www.ap.ecurep.ibm.com

The -logfile <filePath> parameter can be specified to log error messages when debugging.

Full help text can be obtained by issuing the following command:

java -cp ibmsdduu_http.jar ibmsdduu/httpupload -help

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000C4BAAU","label":"IBM i"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Historical Number

575895956

Document Information

Modified date:
29 July 2022

UID

nas8N1011955