Copyright IBM Corporation 2001, 2008. All Rights Reserved .---------------------------------------------------------------. * * * SYSTCPDA is an IBM internally developed tool to select and * * format TCP/IP packet trace records. These records are * * created by z/OS TCPIP PKTTRACE commands. * * * .---------------------------------------------------------------. * * * Copyright IBM Corporation 2001, 2009. All Rights Reserved * * * * * .---------------------------------------------------------------. This zip file contains a version of SYSTCPDA formatter load module in MVS transmit file format. You should now have the following files: README.TXT - This file LICENSE.TXT - License reguarding the use of this program SYSTCPDA.XMI - An XMIT format file of the unloaded module SYSTCPDA.HLP - A TSO HELP file The latest available version can be found on the web at: ftp://ftp.software.ibm.com/software/network/commserver/downloads/systcpda.zip To install this software: 1) Copy SYSTCPDA.XMI to your MVS system as SYSTCPDA.XMIT and SYSTCPDA.HLP to your MVS system as SYSTCPDA.HELP. These MUST be RECFM=FB LRECL=80 data sets. If you use the SEND command, it will look something like this: SEND SYSTCPDA.XMI a:SYSTCPDA.XMIT LRECL(80) RECFM(F) If you use FTP, preallocate the temporary data set SYSTCPDA.XMIT of at least 15 3390 tracks and then use these FTP commands: BINARY quote site RECFM=FB LRECL=80 PUT SYSTCPDA.XMI SYSTCPDA.XMIT 2) On MVS, type RECEIVE INDA(SYSTCPDA.XMIT) This will create a hlq.MIGLIB load module library. NOTE: Do not use your SYS1.MIGLIB library. If you do, you will no longer be able to invoke the original formatter and apply PTFs to the original formatter. 3) To invoke the program, a) Concatenate the hlq.MIGLIB to ddname ISPLLIB, STEPLIB or place it in LINKLIST or LPA. -- OR -- b) Use the TSOLIB command: TSOLIB ACT DA('hlq.MIGLIB') -- OR -- c) Enter IPCS TASKLIB('hlq.MIGLIB') and type CTRACE COMP(SYSTCPDA) SUB((...)) OPTIONS((...)) 4) To install the help file, do: a) SEND SYSTCPDA.HLP a:SYSTCPDA.HELP LRECL(80) RECFM(F) ASCII -- OR -- b) Use these FTP commands: ASCII quote site RECFM=FB LRECL=80 PUT SYSTCPDA.HLP SYSTCPDA.HELP c) Copy SYSTCPDA.HELP to one of the data sets in the SYSHELP concatenation. d) Issue HELP SYSTCPDA to display the help information Changes from V1R9 to V1R10 1) This version corresponds to the V1R10 version of the SYSTCPDA packet trace formatter. 2) Updates for the packet trace formatter: o Formatting V1R10 data trace socket domain, type and protocol o Formatting Packet trace discard packets o Selection by SNA header fields, TCID, TH5ADDR, SUBAREA and element. o Formatting of SNA headers, request units, vectors and variables o FIN APARs: PK38890, PK46193, PK47409, PK48674, PK50074 and PK55682 o PTFs: UK38196 3) See the documentation at: ://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/F1A1C580/2.1.4.5 http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/F1A1C580/2.1.15.3 http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/F1A1C580/2.1.24 Changes from V1R8 to V1R9+ 1) This version corresponds to the V1R9 version of the SYSTCPDA packet trace formatter. 2) Updates for the packet trace formatter: o Correct check sum processing for offload IP packets. o FIN APARS PK21638, PK38890, PK46193, PK47409 and PK48674 o OSAENTA - Formatting of NTA packets - Select packets with the DEVICEID, MACADDR, ETHTYPE, VLANID option keywords. - Select packets with the DISCARD option keyword o IGMP Version 3 3) See the documentation at: http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/F1A1C570/2.1.15.3 http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/F1A1C570/2.1.24 Changes from V1R6 to V1R8+ 1) This version corresponds to the V1R8 version of the SYSTCPDA packet trace formatter. 2) Updates for the packet trace formatter: o FIN APAR PK21638 for checksum calculations o Large send or segmentation offload O EE - Enterprise Extended packets o Support for selecting the FIRST or LAST encapsulated packet o Support for formatting the FIRST, LAST, or ALL encapsulated packets. o Confidential text of DATTRACE data. o IPSEC and NAPT support o Correct reassembly for iPv4 and IPv6 packets o FIN APARS PQ99395 and PK02718 o FIN APARS PQ99335, PQ99328, PK19814 o APAR PK36947 for OSAENTA 3) See the documentation at: http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/F1A1C560/2.1.3.5 Changes from V1R4 to V1R6 1) This version corresponds to the V1R6 version of the SYSTCPDA packet trace formatter. 2) Updates for the following packet formatters: o RipNg - RIP for IPv6 packets o EE - Enterprise Extended packets o OSPF - OSPF version 3 packets o TELNET - Format 3270 data streams o LPR - Line printer request o SYSLOG - syslog data o POP3 - POP3 data o SMTP - Simple Mail Transfer Protocol 3) Add the SESSION(PIPE) report This alternative session report show the amount of data waiting for acknowledgement. 4) CHECKSUM(DETAIL|SUMMARY) | NOCHECKSUM Check sum all selected packet and report any errors 5) Format up to eight bytes data for the SUMMARY report 6) Add FLAG(DATA) and DATASIZE(nnnnn) to select packets that have more that DATASIZE bytes of data. 7) Add SNIFFER(TCPDUMP) to write packet trace records in TCPDUMP format. 8) Corrected miscellaneous problems PQ85300 - Correct an ABEND0C4 formating SNMP packets PQ88299 - Abend0C4 in EZBPTTNL Changes from V1R2 to V1R4 1) Support for IPv6 This resulting in many the reports being revamped for the longer IPv6 address. 2) Updates for the following packet formatters: o DNS - Type A6 and AAAA records o NTP - Format Network Time Protocol packets o SNMP - Additional checking 3) Report changes o Count packets by IPv4 and IPv6 for statistics o SUMMARY report is now two lines o Add ICMP and ICMPv6 Ping fields to summary line o Add the SESSION(STATE) report o Correct calculations for SESSION values (prevent negative values) Changes from V1R4 (version 2002.140) 1) Problems fixed o Abend0C9 when doing SESSION report. Application data byte counter was negative. Problems with the install or questions on the program? Mike Stayton mws@us.ibm.com