IBM Support

How to FTP binary z/VSE dumps

How To


Summary

Transfer binary z/VSE dumps to IBM z/VSE support either via the IBM Support portal or by Secure FTP to the Enhanced Customer Data Repository (ECuRep).

Environment

z/VSE with TCP/IP

Steps

z/VSE creates dumps in binary format either
  • As stand-alone dumps on a stand-alone dump disk
  • Or as stand-alone dumps on a stand-alone dump tape
  • Or as system dump in the system dump library
  • Or by DUMP command on a tape if a tape address is specified as cuu
The binary format is preferred for problem analysis by IBM z/VSE support. The following recipe shall help to send the binary dump(s) via your workstation to IBM either via the IBM Support portal or by using Secure FTP to the Enhanced Customer Data Repository (ECuRep).
Each file should be uploaded with a unique file name starting with the complete case number. For example material for case TS012345678 should be uploaded as  TS012345678.yyyyyyyy.zzz with:
  • yyyyyyyy identifying the data, for example HWFFF-IJSYSDU for the stand-alone dump file from a hard wait  with code FFF or DF200012 for the dump of the F2 partition with serial number 12, and
  • zzz identifying the format of the data, for example BIN (or DUMP) for binary dump data, ZIP for a compressed .zip file, and AWS for a virtual tape images created by the VSE Virtual Tape Server on a remote workstation.
Correctly named files inform the IBM z/VSE support team how to handle the material. Note that unique names are required to avoid FTP error 553 "Permission Denied" when uploading directly to ECuRep.
  1. Binary download from z/VSE system to a workstation:
    • Download VSE.DUMP.FILE (IJSYSDU) from a stand-alone dump disk: Connect to the z/VSE system from a workstation via FTP. Issue the FTP command BIN for binary transfer and then GET IJSYSDU as e.g. TS012345678.HWFFF-IJSYSDU.BIN (for details see Appendix A). To extract single files from the VSE.DUMP.FILE, use the ADD DUMP function in Interactive User Interface (IUI) dialogue "Storage Dump Management".
      For systems without IUI use the sample JCL supplied in Appendix C and continue with the below step "Download dumps from system dump library SYSDUMP".
    • Or Download dumps from the system dump library SYSDUMP: Connect to the z/VSE system from a workstationC via FTP. Change to the library SYSDUMP.Fn|BG|DYN Issue the FTP commands BIN for binary transfer and GET dumpname.DUMP as e.g. TS012345678.filename.BIN (for details see Appendix B).
      If FTP is not possible, use 3270 IND$FILE transfer as described in Appendix E.
    • Or Download files from a stand-alone dump tape: First copy the dump file(s) from the stand-alone dump tape to the z/VSE system dump library using the ADD DUMP function in Interactive User Interface (IUI) dialogue "Storage Dump Management".
      For systems without IUI use the sample JCL supplied in Appendix D and continue with the above step "Download dumps from system dump library SYSDUMP".
    • Or Copy the dump from tape to the system dump library  and continue with Download dumps from SYSDUMP:  Start DITTO and use Copy function as shown in Appendix F. When you have copied the dump, continue with "Download dumps from the system dump library SYSDUMP".  If the tape is a remote VTAPE, you may send the AWS file as binary data directly.
  2. Optionally compress file(s) on your workstation, for example compress TS012345678.HWFFF-IJSYSDU.BIN into TS012345678.HWFFF-IJSYSDU.ZIP.
  3. Use Secure FTP or HTTPS to transfer your file(s) onto the IBM server. See Enhanced Customer Data Repository (ECuRep) - Send data for a detailed description how upload your data in a secure way.
  4. The case matching the file name(s) will be updated automatically with the names of the received files. In addition you may inform IBM z/VSE support that data has been sent.
Note: Appendixes A to E describe the download of data from z/VSE to a workstation. Please consider encrypted download if z/VSE and the workstation are not in the same network.
Appendix A: FTP the VSE.DUMP.FILE (IJSYSDU) from z/VSE to your workstation
Step 1: In your TCP/IP startup job specify the VSE.DUMP.FILE (IJSYSDU)by DLBL, EXTENT, and ASSGN.  Insert the statements as used in your z/VSE system.
Sample JCL for a ECKD disk:
// DLBL IJSYSDU,'VSE.DUMP.FILE'
// EXTENT SYS020,,1,,start,length
// ASSGN SYS020,cuu
Sample JCL for a FBA or FBA-SCSI disk: 
// DLBL IJSYSDU,'VSE.DUMP.FILE',,SD,CISIZE=4608
// EXTENT SYS020,,1,,start,length
// ASSGN SYS020,cuu

Step 2: Define the IJSYSDU file to TCP/IP.
For TCP/IP for VSE (CSI):
DEFINE FILE,PUBLIC='IJSYSDU',DLBL=IJSYSDU,TYPE=SAM,RECFM=F,LRECL=4112
For IPv6/VSE (BSI): 
INPUT SAM IJSYSDU BLKSZ 4112 RECSZ 4112 RECFM F
Following is an example how to use an FTP client on your workstation to download the IJSYSDU file:
Appendix B:  FTP dump files from z/VSE dump library to workstation

TCP/IP must be running and accept FTP requests. SYSDUMP must be defined in TCP/IP, e.g.   
    For CSI in IPINIT: 
DEFINE FILE,PUBLIC='SYSDUMP',DLBL=SYSDUMP,TYPE=LIBRARY

    For BSI start FTP server partition with: 
SNMT LIBRARY SYSDUMP
On your workstation connect to your VSE system (console log for access to CSI): 
D:\dumps>ftp powerct3
Connected to powerct3.boeblingen.de.ibm.com.
220-TCP/IP for VSE Internal FTPDAEMN 01.05 F 20080229 09.58
    Copyright (c) 1995,2006 Connectivity Systems Incorporated
220 Ready for new user
User (powerct3.boeblingen.de.ibm.com:(none)): sysa   <== a user id on your system with access authority  
331 User name okay, need password
Password:
230 User logged in, proceed
ftp> cd sysdump                             
250 Requested file action okay, completed
ftp> cd f2
250 Requested file action okay, completed
ftp> dir
200 Command okay
150 File status okay; about to open data connection
DF200011.DUMP          279616        284  09/18/08  15:07                  
DF200012.DUMP          275504        279  09/18/08  15:10                  
HSKMEM.DUMP               100          1  09/18/08  15:07                 
226 Closing data connection
ftp: 240 bytes received in 0,41Seconds 0,59Kbytes/sec.
ftp> quote site unix off                           <== switch to VSE mode to have BIN take affect
200 Command processed
ftp> bin                                           <== binary transfer, no record length
200 Command okay
ftp> get DF200012.DUMP TS012345678.DF200012.BIN    <== rename file  
200 Command okay
150-About to open data connection
    File:SYSDUMP.F2.DF200012.DUMP
    Type:Binary Recfm:S Lrecl:  4096
    CC=ON UNIX=OFF RECLF=OFF TRCC=OFF CRLF=ON NAT=NO CONT=OFF
    MODE=Stream  STRU=File
150 File status okay; about to open data connection
226-Bytes sent: 275,504
    Records sent: 9
    Transfer Seconds:          .04 (  6726K per second)
    File I/O Seconds:          .02 ( 13452K per second)
226 Closing data connection
ftp: 275504 bytes received in 1,00Seconds 275,50Kbytes/sec.
ftp> quit
221 FTPDaemn closing control connection
Appendix C:  Copy dump files from SADUMP disk to z/VSE dump library

 Sample job to scan the stand-alone dump disk: 
* $$ JOB JNM=SCANDMPD,DISP=D,PRI=9,CLASS=0
* $$ LST DISP=H,RBS=1000
// JOB SCANDMPD  SCAN DUMP FILE ON DISK
* *****************************************************************
* DLBL and EXTENT statements for dump file IJSYSDU
* Please adapt cuu, start and length to your system values
* *****************************************************************
// DLBL IJSYSDU,'VSE.DUMP.FILE'                            <== for ECKD
* or // DLBL IJSYSDU,'VSE.DUMP.FILE',,SD,CISIZE=4608       <== for FBA or FBA-SCSI
// EXTENT ,,,,start,length
// EXEC DOSVSDMP,PARM='SCAN DEVICE=cuu'
/*
/&
* $$ EOJ

Sample job to load dump files from stand-alone dump disk to the VSE dump library: 
* $$ JOB JNM=DMPOND1,DISP=D,PRI=8,CLASS=0
* $$ LST DISP=H,RBS=1000
// JOB DMPOND1  ONLOAD DUMP FROM DISK
* NOTE THAT DUMP FILES ON DISK START WITH NUMBER 1. THIS JOB EXAMPLE
* LOADS DUMP FILES 1 TO 7 INTO SYSDUMP.BG AS DUMPS SADMP001 TO SADMP007
* *****************************************************************
* DLBL and EXTENT statements for dump file IJSYSDU
* Please adapt cuu, start and length to your system values
* *****************************************************************
// DLBL IJSYSDU,'VSE.DUMP.FILE'                            <== for ECKD
* or // DLBL IJSYSDU,'VSE.DUMP.FILE',,SD,CISIZE=4608       <== for FBA & SCSI
// EXTENT SYS009,,,,start,length
// ASSGN SYS009,cuu
// EXEC PROC=DTRINFOA
// EXEC INFOANA,SIZE=300K
   SELECT DUMP MANAGEMENT
     DUMP NAME SYSDUMP.BG.SADMP001
          RETURN
   SELECT DUMP ONLOAD
          VOLID DISK SYS009
          FILE 1
          RETURN
   SELECT DUMP MANAGEMENT
     DUMP NAME SYSDUMP.BG.SADMP002
          RETURN
   SELECT DUMP ONLOAD
          VOLID DISK SYS009
          FILE 2
          RETURN
...
   SELECT DUMP MANAGEMENT
     DUMP NAME SYSDUMP.BG.SADMP007
          RETURN
   SELECT DUMP ONLOAD
          VOLID DISK SYS009
          FILE 7 LAST                                      <== last file
          RETURN
   SELECT END
/*
/&
* $$ EOJ
Appendix D:  Copy dump files from SADUMP tape to z/VSE dump library

Sample job to load dump files from stand-alone dump tape to the VSE dump library: 
* $$ JOB JNM=DMPONL2,DISP=D,PRI=8,CLASS=0
* $$ LST DISP=H,RBS=1000
// JOB DMPONL2  ONLOAD DUMP FROM TAPE
* PLEASE MOUNT TAPE VOL111 ON UNIT 280 TO ONLOAD
* DUMP SYSDUMP.BG.SAD00003 - SAD00009
// PAUSE
// ASSGN SYS018,280
// MTC REW,280
// EXEC PROC=DTRINFOA
// EXEC INFOANA,SIZE=300K
   SELECT DUMP MANAGEMENT
     DUMP NAME SYSDUMP.BG.SAD00003
          RETURN
   SELECT DUMP ONLOAD
          VOLID VOL111 SYS018
          FILE 3
          RETURN
   SELECT DUMP MANAGEMENT
     DUMP NAME SYSDUMP.BG.SAD00004
          RETURN
   SELECT DUMP ONLOAD
          VOLID VOL111 SYS018
          FILE 4
          RETURN
   SELECT DUMP MANAGEMENT
     DUMP NAME SYSDUMP.BG.SAD00005
          RETURN
   SELECT DUMP ONLOAD
          VOLID VOL111 SYS018
          FILE 5
          RETURN
...
   SELECT DUMP MANAGEMENT
     DUMP NAME SYSDUMP.BG.SAD00009
          RETURN
   SELECT DUMP ONLOAD
          VOLID VOL111 SYS018
          FILE 9 LAST                                      <== last file
          RETURN
   SELECT END
/*
// MTC REW,SYS018
/&
* $$ EOJ
Appendix E:  RECEIVE dump files from z/VSE dump library to workstation
The RECEIVE function is described in the VSE/ESA Programming and Workstation Guide (PDF).

The following example shows how to receive the file DF200012.DUMP from sublibrary SYSDUMP.F2 to your workstationC as TS012345678.DF200012.BIN
  1. Logon session "A" to z/VSE and enter native CICS or, for administrators, fast path 386 "PC File Transfer".
  2. Verify that terminal session is capable of file transfer (transaction INWQ returns terminal-id=DFT).
  3. Open a workstationC command window, change to the directory to receive the dump, and issue command:
    receive TS012345678.DF200012.BIN A:DF200012 DUMP (file=lib l=sysdump s=f2 binary
Job PWSLTS is started in dynamic class P and in your workstation command window you will see:
The file transfer request is being processed.
 Number of bytes transferred :   nnnnnnnn
 File transfer complete.
Appendix F:  Copy dump from tape into SYSDUMP using DITTO
The DUMP command to a tape device creates a dump in binary format. To copy the dump into the z/VSE dump library, configure and run the following job.
​* $$ JOB JNM=DITTOT2L,CLASS=0,DISP=D,PRI=3                          
* $$ LST DISP=H,CLASS=D                                             
// JOB DITTOT2L   TAPE 2 LIBRARY COPY                               
*  update userid, password, numbr and cu1 accordingly               
// ID USER=user,PWD=password                                        
// PAUSE                                                            
// ASSGN SYS011,cu1    * INPUT  Dump TAPE                           
// UPSI 1                                                           
* COPY DUMP TAPE FILE #1 INTO DUMP LIBRARY                          
// EXEC DITTO                                                       
$$DITTO REW INPUT=SYS011                                            
$$DITTO TL INPUT=SYS011,RECFMIN=F,                                  
$$DITTO    LIBOUT=SYSDUMP.DYN,MEMBEROUT=DYNnumbr.DUMP,RECFMOUT=S    
$$DITTO EOJ                                                         
/*                                                                  
/*                                                                  
/&                                                                  
* $$ EOJ

Document Location

Worldwide

Operating System

z/VSE:All operating systems listed

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSB27H","label":"z\/VSE"},"Component":"Interactive Interface","Platform":[{"code":"PF038","label":"z\/VSE"}],"Version":"z\/VSE","Edition":"5.1;5.2;6.1;6.2","Line of Business":{"code":"LOB56","label":"Z HW"}}]

Document Information

Modified date:
01 February 2022

UID

ibm16394896

Page Feedback