Troubleshooting
Problem
Cause
Resolving The Problem
The new date of 5th of October 2020 is documented in Disablement of SHA-1 cipher suites and limiting anonymous log-in for ECuRep FTP server.
- Send files directly to ECuRep by using secure FTP
- Send files by using the secure upload HTTPS Form
- Email files directly to ECuRep
- Receive files from IBM Software Support
Notes:
- For help with ECuRep, see Enhanced Customer Data Repository (ECuRep) - ECuRep related Help.
- Your files are deleted seven days after your IBM Support case is closed.
- For Blue Diamond cases, use https://msciportal.im-ies.ibm.com
For more information about Blue Diamond upload, see https://www.ibm.com/support/pages/node/666503 - If you need to speak with an IBM Support representative, call your country representative. In the US, call 1-800-IBM-SERV.
Send files directly to ECuRep by using FTPS/SFTP
Diagnostic information such as log files, traces, and dumps can be sent to IBM Software Support by using the ECuRep Service site.Important Notes:
- To send files to this server, you must have an open case with the support center. The complete case number must be part of the file name.
- Refer to the transfer options in the ECuRep Send Data Introductions. There are options including:
- FTPS or SFTP
- HTTPS, which includes a secure browser interface at https://www.secure.ecurep.ibm.com/app/upload_sf
- the Java® utility ""IBM Secure Diagnostic Data Upload Utility"" (IBM SDDUU)
- the z/OS® Problem Documentation Upload Utility (IBM PDUU)
- email for 20 megabytes or less - For every transfer of compressed or non-text data, use binary mode. This statement includes intermediate transfers of z/OS or IBM i documentation to a workstation before upload to the IBM site.
- If the data set is encrypted, include the encryption key in an update in your IBM Support case or in an email sent to ibm_support@ecurep.ibm.com. The case number must be included in the subject line when the key is provided by email.
- You can create a file on the FTP site (for example, by using the
put
ormput
command), but you cannot update it. You need to create a new file with a unique name. - You cannot receive information from the directories where you put files (
get
ormget
command). The information you submit is only available to the IBM Support representatives.
Prepare data in a compressed or packed format
- Distributed platforms: Data collectors for your product, for example runmqras (IBM MQ), aceDataCollector (IBM App Connect), or mqsidc (IBM Integration Bus), do the compression for you. If manual compression of data is needed, see Manually packaging IBM MQ data to send to IBM for platform-specific examples.
- z/OS: Use the AMATERSE service aid (alias TRSMAIN) to terse all files. In addition to compressing the data, this step provides a consistent RECFM=FB LRECL=1024 binary format that ensures successful transmission of the data sets. For more information, see Prepare Data for z/OS.
For extra security via encryption or to split large files, instead use the z/OS Problem Documentation Upload Utility (PDUU, previously known as MTFTP). If PDUU is used, do not use AMATERSE before-hand.
If there is a core dump in z/OS UNIX Systems Services (USS) for IBM Integration Bus or IBM App Connect Enterprise, see the instructions to use the oget command to make the dump usable. - IBM i: create Save Files (SAVF). See the IBM i section of Manually packaging IBM MQ data to send to IBM.
Submit files to the FTP server
ftps
or sftp
), URLs, or JCL (z/OS)..tar, .zip, .trs, and .savf.
IBM i: cd toibm/os400
UNIX®: cd toibm/unix or toibm/aix or cd toibm/linux
Windows®: cd toibm/windows
z/OS: cd toibm/mvs
Other: toibm/other
The file naming convention is TS<xxxxxxxxx>.yyy.zzz
Where
TSxxxxxxxxx = IBM Support case ID, for example TS001234567
yyy = Short description of the file
zzz = File type or file extension, for example tar, TRS, or zip
Examples of FTP put commands:
Enter:
put your_file
(by default, the target file name is the same as the source file name) or put your_file target_file
(to provide a different name)For example:
put TS001234567.mqdata.tar
IBM i:
Save your files into a save file. See MustGather: Collect documentation for IBM MQ for IBM i troubleshooting. Include the TGTRLS(*PRV) option on SAV and SAVOBJ commands. Enter:
put your_file target_file.savf
For example:
put QGPL/P1234567A TS001234567.P1234567A.SAVF
z/OS:
Enter:
put 'your_file' target_file
(the source data set name is enclosed in single quotation marks)For example:
put 'DSNAME.TRS' TS001234567.dump.TRS
Find sample JCL for z/OS at:
- Enhanced Customer Data Repository (ECuRep) - Send data (z/OS utility)
- FAQs About GDPR-related Changes to ECuRep and Testcase FTP File Uploads
Send files by using the secure upload HTTPS Form
- Use the following link to upload files directly to an IBM Support case via the web:
https://www.secure.ecurep.ibm.com/app/upload_sf - Enter your case number, which is of the format TS001234567, on the first page.
- On the next page, select the files that you want to upload.
Notes:
- Some browsers have limitations that prevent files larger than 2GB from being uploaded.
- If JavaScript is enabled, you see progress information.
- Do not close the browser window until you see confirmation that the upload was successful.
Email files directly to ECuRep
For select IBM products, you can attach your diagnostic data to a note and email it to the IBM Enhanced Customer Data Repository (ECuRep) Mail Gateway. If the data you send (output, traces, compressed file, etc.) is less than 20 MB, you can email it to IBM Support by performing the following steps:
- Create an email message addressed to the following email address:
ibm_support@ecurep.ibm.com - In the subject line, include your complete IBM Support case number, which is of the format TS001234567.
- In the body of the message, put a brief description of the problem symptoms and describe the files you sent in.
- Attach the files (compressed if large) to the email.
- You will receive an automated reply once your email is processed. If your email cannot be associated to an existing case, it is tagged as lost and eventually deleted.
Note: Depending on your internet connection and email server, allowable attachment file might be significantly less than the 20 MB limit. When in doubt, you can simply use the FTP steps to ensure timely delivery of your files.
Receive files from IBM Software Support
Occasionally IBM Software Support needs to make files available for customer download. When the support center publishes a file for your case, the case is updated with download instructions.
For a ++APAR or ++USERMOD for z/OS, pre-allocate a data set with attributes of RECFM=FB and LRECL=80. Always transfer the file in binary mode.
Product Synonym
WebSphere MQ
Was this topic helpful?
Document Information
Modified date:
03 June 2022
UID
swg21392217