z/OS Communications Server
Obtaining a TELNET CTRACE and PKTTRACE in an External Writer             


Obtaining a TELNET CTRACE and PKTTRACE in an External Writer     

Example of Writer                                                              
 //CTWTR PROC                                                                  
 //IEFPROC  EXEC PGM=ITTTRCWR,0M                                               
 //TRCOUT01 DD DSNAME=ibmuser.ctrace1,VOL=SER=xxxxxx,UNIT=xxxx,                
 //         SPACE=(CYL,(xxx),,CONTIG),DISP=NEW,CATLG)                          
 //SYSPRINT DD SYSOUT=*                                                        
Remember to define only contiguous primary space, no secondary and make the dataset as large as
possible. The writer address space should be at least in the same WLM Service Class as TCPIP.                                  
                                                                               
1. TCPIP CTRACE & PACKET TRACE to external writer                              
                                                                               
  A. Start the writer for TCPIP CTRACE                                          
     TRACE CT,WTRSTART=ctwrt,WRAP                                               
                                                                               
  Please note:  For the ctrace external writer,  the trace.membername identifies the name of the member
  that identifies the name of the member that contains the source JCL that invokes the external writer.
  The member can be a SYS1.PROCLIB cataloged procedure or a  job.  The membername in the WTR
  parameter must match the membername in a previous TRACE CT,WTRSTART command.                                          
                                                                               
  B. Start CTRACE                                                               
     TRACE CT,ON,COMP=SYSTCPIP,SUB=(tcpproc)                                   
     R xx,OPTIONS=(TELNET),WTR=ctwrt,END                                       
                                                                               
2.  Enable TCPIP PACKET TRACE to external writer                                 
  A. Start the writer for packet tracing                                       
     TRACE CT,WTRSTART=pktwrt                                                  
  B. Start Packet trace/Connect the writer                                     
     TRACE CT,ON,COMP=SYSTCPDA,SUB=(tcpproc)                                   
     R xx,WTR=pktwrt,END                                                       
  C. Clear any previous packet trace setting:                                  
     V TCPIP,tcpproc,PKTTRACE,CLEAR                                            
  D. Start TCPIP Packet Trace                                                  
     V TCPIP,tcpproc,PKTTRACE,FULL,IPADDR=nnn.nnn.nnn.nnn                      
                                                                               
3. Recreate problem screnario                                                  
                                                                               
4. Disconnect CTRACE writer                                                    
                                                                               
   TRACE CT,OFF,COMP=SYSTCPIP,SUB=(tcpipprocname)                              
   R xx,WTR=DISCONNECT,END                                                     
                                                                               
5. Disconnect PKTTRACE writer                                                  
                                                                               
   TRACE CT,OFF,COMP=SYSTCPDA,SUB=(tcpipprocname)                               
   R xx,WTR=DISCONNECT,END                                                      
                                                                               
6. Stop CTRACE external writer:                                                
                                                                               
   TRACE CT,WTRSTOP=ctwrt1,FLUSH                                                
                                                                               
7. Stop PKTTRACE writer                                                        
                                                                               
   TRACE CT,WTRSTOP=pktwtr,FLUSH                                               
                                                                               
**************************************************************************************************************************         
                                                                               
The TRSMAIN program should be used to terse all dumps and traces sent to us.  IBM support is trying to
convert to this process since it will make dataset processing by you, the customer,  compatible with all
IBM Support Centers.                                                               
                                                                               
Procedure to obtain a copy of TRSMAIN (MVS terse program)                      
     FTP service.software.ibm.com                                              
     USER: anonymous                                                           
     PASSWORD: *****                                                        Where ***** = any E-mail address               
     CD s390/mvs/tools/packlib/                                                
     There are two files:  README.TXT and TRSMAIN                              
     See README.TXT file for detailed instructions                             
                                                                               
Procedure to SEND/RECEIVE doc to/from TCPIP Level 2 support via FTP.           
     ftp testcase.software.ibm.com (timeout 720                                
     USER: anonymous
     PASSWORD: *****                                                      Where: ***** = any E-mail address          
     cd s390/toibm/tcpip                                                       
     mkdir nnnnn                                                                Where nnnnn = Your 5 digit PMR number             
     cd nnnnn                                                                    Enter newly created sub-directory                 
     bin                                                                             Set transfer mode to binary                       
     put @@@@@                                                            Where:@@@@@ = the dump/trace file name