There are three basic steps that need to be followed in order to prepare your z/OS data.

  1. Gather diagnostic data.
  2. 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.
    • File naming convention: xxxxx.bbb.ccc.yyy.yyy.[TRS]
    • Example: 34143.055.724.dump.TRS (PMR_#.branch_office_#.country_code_#.dump.TRS)
    Field Description Sample
    xxxxx PMR number 43123
    bbbb Branch office number 055
    ccc 724
    yyy.yyy Short description of the file dump
    TRS Mandatory Identifier for a tersed file TRS
  3. Send data

Close [x]

Skip to main content

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

Close [x]

Skip to main content

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

Close [x]

Skip to main content

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.

  1. From the TSO READY: prompt enter: ftp ftp.ecurep.ibm.com
  2. At the USER: prompt, enter: anonymous
  3. At the password prompt, enter: your_email_address (e.g., your_user_id@company.com)
  4. At the Command: prompt, enter: cd toibm/mvs
  5. At the Command: prompt, enter: bin
  6. At the Command: prompt, enter: put YOUR.LOCAL.DSN 12345.123.724.dump
  7. At the Command: prompt, enter: quit

Close [x]

Skip to main content

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.

  1. From the C:> prompt, enter: receive your_data_at_MVS your_data_at_the_workstation (binary)
  2. From the C:>: prompt, enter: ftp ftp.ecurep.ibm.com
  3. At the USER: prompt, enter: anonymous
  4. At the password prompt, enter your_email_address (e.g., your_user_id@company.com)
  5. At the Command: prompt, enter: cd toibm/mvs/
  6. At the Command: prompt, enter: bin
  7. At the Command: prompt, enter: put your_data_at_the_workstation 12345.123.724.DUMP
  8. At the Command: prompt, enter: quit

Close [x]

Skip to main content

IBM country codes

Close [x]

Skip to main content

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.

Related links

%%sidebarspace%%