Your IBM SSR will provide you with a Problem Management Record number (PMR). Write this down.
Compress data
All diagnostic data delivered electronically to IBM must be in a compressed or packed format following the IBM file naming convention. Use the IBM file naming convention as shown below. This will be provided to you by your IBM SSR.
z/OS clients should use the AMATERSE service aid to compress their data sets [PACK parameter] which is part of z/OS. By compressing the data, you improve data transfer time and convert your files into a familiar record length and format. For more information about AMATERSE, please refer to the most current z/OS MVS Diagnosis: Tools and Service Aids documentation.
To meet additional security requirements, it is possible to compress and encrypt the diagnostic data using the z/OS Utility z/OS Problem Documentation Upload Utility (PDUU) instead of using AMATERSE.
File naming convention for My Support cases: TS<xxxxxxxxx>.yyy.yyy.[TRS]
Examples for My Support Case number: TS012345678.datasetname.TRS (TS<Case ID>.<datasetname>.TRS)
Field
Description
Sample
TSxxxxxxxxx
My Support Case ID (TS+9 digits)
TS012345678
yyy.yyy
Short description of the file
dump01
TRS
Mandatory Identifier for a tersed file
TRS
Send data
Send data to IBM using the most appropriate method.
Your IBM SSR will inform you what directory to use.
You can use either MVS batch, MVS command line or transfer the data using your workstation.
What is z/OSMF?
The z/OSMF Incident Log provides a consolidated list of incidents based on SVC dumps taken on any system in the Sysplex. Each incident provides details and diagnostic data captured with each incident - snapshots of Syslog/Operlog, Logrec detail and a Logrec Summary. In addition, z/OSMF V1R12 can send user-specified attachments, which are sequential data sets or Unix(tm) files. z/OSMF facilitates sending the data to any FTP destination using FTP (supporting FTP profiles for firewall parameters, when provided) or using the Problem Documentation Upload Utility. The Incident Log aggregates and sends data to the specified URL (IBM or ISV). The Problem Documentation Upload Utility is only supported for sending data to IBM.
Encrypt the diagnostic data
Protecting sensitive data is a growing concern for companies worldwide. As a result of customer requirements, concerns and recent events in which security has been compromised, businesses are proactively focusing on securing customer and business data.
IBM offers a new z/OS FTP utility available for IBM clients to send documentation (large data sets) in a more efficient manner to IBM FTP sites.
This z/OS mtftps module has been developed and is supported by IBM z/OS lab.
It is a single tool to provide all the functions required to send PMR related documentation to IBM. In-line hardware compression minimizes processor and I/O time compared to software compression.
Optional encryption
z/OS Problem Documentation Upload Utility optionally uses 192 bit 3DES hardware encryption (z890/z990 systems or higher). We strongly recommend the usage of this feature instead of the former available e-Garda modules.
Note: As a result of security requirements and concerns IBM will discontinue the use of the old IBM MVS encryption programs (e-Garda module).
Delivery via a batch
Batch job transfering the data via FTP
Note: Please be sure to TURN OFF the LINE NUMBERING.
//* EXEC Statement for NON-Secure-FTP
//FTP EXEC PGM=FTP,PARM='-v (EXIT '
//* Uncomment next line for Secure-FTP
//*FTP EXEC PGM=FTP,PARM='-a TLS -v (EXIT '
//SYSTCPD DD DSN=YOUR.TCPPARMS(TCPDATA),DISP=SHR
//SYSFTPD DD DSN=YOUR.TCPPARMS(FTPDATA),DISP=SHR
//SYSPRINT DD SYSOUT=*
//* Please use 192.109.81.7 instead of ftp.ecurep.ibm.com
//* if you have problems with IP name resolution
//INPUT DD *
ftp.ecurep.ibm.com
anonymous
your@email.address
bin
cd /toibm/mvs
put 'YOUR.CRYPTED.DATASET' 12345.123.724.DUMP.TRS
Batch job transfering the data via FTP, including terse, cypher and FTP
The following JCL can be tailored and used to process the data sets to be transmitted to the FTP server.
Note: Please be sure to TURN OFF the LINE NUMBERING.
/XXXXX JOB CLASS=A,MSGCLASS=X,REGION=64M
//*----------------------------------------------------
//* Be sure that line numbering is set to off (unnum)
//*----------------------------------------------------
//* Delete the temporary file
//*----------------------------------------------------
//DELETE EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DELETE YOUR.TERSED.DATASET
DELETE YOUR.CRYPTED.DATASET
SET MAXCC=0
//*----------------------------------------------------
//* Terse the file
//* THIS STEP IS MANDATORY
//*----------------------------------------------------
//TERSE EXEC PGM=TRSMAIN,PARM=PACK
//SYSPRINT DD SYSOUT=*
//INFILE DD DISP=SHR,DSN=YOUR.INPUT.DATASET
//OUTFILE DD DISP=(NEW,CATLG),UNIT=SYSDA,
// SPACE=(CYL,(10,5),RLSE),
// DSN=YOUR.TERSED.DATASET
//*----------------------------------------------------
//* Encrypt the file
//* Optional step if you can not use secure FTP
//*----------------------------------------------------
//DFSMSENC EXEC PGM=CSDFILEN
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//SYSUT1 DD DISP=SHR,
// DSN=YOUR.TERSED.DATASET
//SYSUT2 DD DISP=(NEW,CATLG),UNIT=SYSDA,
// SPACE=(CYL,(10,5),RLSE),
// DSN=YOUR.CRYPTED.DATASET
//SYSIN DD *
DESC='Optional information'
CLRTDES
PASSWORD=sample password please change
//*----------------------------------------------
//* SEND THE FILE TO THE IBM FTP SERVER
//* WHEN CRYPTED, SEND THE CRYPTED DATASET
//* WHEN TERSED ONLY, SEND THE TERSED DATASET
//* USE NON-SECURE OR SECURE FTP
//*----------------------------------------------
//* EXEC Statement for NON-Secure-FTP
//FTP EXEC PGM=FTP,PARM='-v (EXIT '
//* Uncomment next line for Secure-FTP
//*FTP EXEC PGM=FTP,PARM='-a TLS -v (EXIT '
//SYSTCPD DD DSN=YOUR.TCPPARMS(TCPDATA),DISP=SHR
//SYSFTPD DD DSN=YOUR.TCPPARMS(FTPDATA),DISP=SHR
//SYSPRINT DD SYSOUT=*
//INPUT DD *
ftp.ecurep.ibm.com
anonymous
your@email.address
bin
cd /toibm/mvs
put 'YOUR.CRYPTED.DATASET' 12345.123.724.DUMP.TRS[.EFZ]
quit
/*
Where
TRS - Mandatory identifier for tersed files
EFZ - Identifier only for encrypted files
Delivery via MVS command line
Use the following instructions to transfer your data to our FTP server from the TSO command line.
Note: The instructions below do not include steps which may be necessary to pass through a firewall or proxy server.
From the TSO READY: prompt enter: ftp ftp.ecurep.ibm.com
At the USER: prompt, enter: anonymous
At the password prompt, enter: your_email_address (e.g., your_user_id@company.com)
At the Command: prompt, enter: cd toibm/mvs
At the Command: prompt, enter: bin
At the Command: prompt, enter: put YOUR.LOCAL.DSN 12345.123.724.dump
At the Command: prompt, enter: quit
Delivery via a workstation
Use the following instructions to download your prepared data to your workstation using File Transfer Protocol (FTP) from a command line.
Note: The instructions below do not include steps which may be necessary to pass through a firewall or proxy server.
From the C:> prompt, enter: receive your_data_at_MVS your_data_at_the_workstation (binary)
From the C:>: prompt, enter: ftp ftp.ecurep.ibm.com
At the USER: prompt, enter: anonymous
At the password prompt, enter your_email_address (e.g., your_user_id@company.com)
At the Command: prompt, enter: cd toibm/mvs/
At the Command: prompt, enter: bin
At the Command: prompt, enter: put your_data_at_the_workstation 12345.123.724.DUMP