Instructions for setting a SLIP on a WebSphere MQ error message and including TCP/IP CTRACE and TCP/IP PACKET trace

Technote (troubleshooting)


Problem(Abstract)

You are looking for instructions to set a slip on a WebSphere MQ for z/OS error message and includeTCP/IP CTRACE or TCP/IP packet trace in the dump.

Resolving the problem

Following are instructions to start TCP/IP CTRACE and/or packet trace and to SLIP on a message from WebSphere MQ. The SLIP has keywords to dump the packet trace at the same time.

Tab navigation



See technote MustGather: Directions to start, end, and format trace for instructions to start MQ trace.

TCP/IP packet trace and CTRACE instructions


See How to Collect PKTTRACE and CTRACE on z/OS for the latest TCP/IP trace instructions.

The following example includes limiting the trace to a specific IP address.

  • Insure BUFSIZE in CTIEZB00 in PARMLIB is set to 16M.
  • Start packet trace comp(SYSTCPDA):

    TRACE CT,ON,COMP=SYSTCPDA,SUB=(tcpipprocname)
    R xx,END
  • Start the packet trace processing in TCPIP. Without this step packets can not be captured by the CTRACE component:

    V TCPIP,tcpipprocname,PKT,ON,IP=xx.xx.xx.xx
  • Along with the packet trace, run a CTRACE to capture the following
    options:

    TRACE CT,ON,COMP=SYSTCPIP,SUB=(tcpipprocname)
    R xx,OPTIONS=(PFS,SOCKET,ENGINE,TCP,INTERNET),
    JOBNAME=(ssidCHIN),END

  • Set the slip according to instructions later in this document.
  • Recreate the problem (during which the slip trap will spring).......
  • Stop Packet trace comp(SYSTCPDA):

    V TCPIP,tcpipprocname,PKT,OFF,IP=xx.xx.xx.xx

    TRACE CT,OFF,COMP=SYSTCPDA,SUB=(tcpipprocname)

  • Stop CTRACE comp(SYSTCPIP)

    TRACE CT,OFF,COMP=SYSTCPIP,SUB=(tcpipprocname)

When you enter the trace command TRACE CT,ON,COMP=SYTCPDA,SUB=(tcpipprocname) the system prompts you to Specify Operands. You can just enter END. You would only pass an external writer name on the reply if you were writing to the external writer.

When the slip trap (below) springs, it will dump WebSphere MQ's CHIN and trace dataspace as well as TCP/IP and its trace dataspace to capture the needed doc at the time of the failure. You will have to manually stop the trace after the slip.




Slip instructions for z/OS 1.13 or later


Since this is not a PER slip, it can run in conjunction with other slips.
*****************************************************************
* MASTER and CHIN SVC DUMP ON Message CSQX207E *
*****************************************************************
SLIP SET,MSGID=CSQX207E,
JOBNAME=ssidCHIN,A=SVCD,
JOBLIST=(ssidMSTR,ssidCHIN,tcpipprocname),
DSPNAME=('ssidCHIN'.CSQXTRDS),
SDATA=(ALLNUC,CSA,LPA,RGN,PSA,SWA,SQA,LSQA,TRT,SUM),
MATCHLIM=1,END

*****************************************************************
* End of SLIP trap command. *
*****************************************************************

*****************************************************************
* Example of same slip to collect the VTAM dataspace(csm) also
*****************************************************************
SLIP SET,MSGID=CSQX207E,
JOBNAME=ssidCHIN,A=SVCD,
JOBLIST=(ssidMSTR,ssidCHIN,tcpipprocname),
DSPNAME=('ssidCHIN'.CSQXTRDS,1.00000CSM),
SDATA=(ALLNUC,CSA,LPA,RGN,PSA,SWA,SQA,LSQA,TRT,SUM),
MATCHLIM=1,END

*****************************************************************


As of z/OS 1.13, you are no longer required to specify DSPNAME=('tcpipprocname'.*) to request the TCPIPDS1 data space on the DUMP and SLIP commands. The TCPIPDS1 data space has been removed and the SYSTCPIP trace buffers have been moved to 64-bit storage.



Slip instructions for z/OS 1.2 through z/OS 1.12


The MSGID parameter was added to the SLIP command in z/OS 1.2.

Since it is not a PER slip, it can run in conjunction with other slips.
*****************************************************************
* MASTER and CHIN SVC DUMP ON Message CSQX207E *
*****************************************************************
SLIP SET,MSGID=CSQX207E,
JOBNAME=ssidCHIN,A=SVCD,
JOBLIST=(ssidMSTR,ssidCHIN,tcpipprocname),
DSPNAME=('ssidCHIN'.CSQXTRDS,'tcpipprocname'.*),
SDATA=(ALLNUC,CSA,LPA,RGN,PSA,SWA,SQA,LSQA,TRT,SUM),
MATCHLIM=1,END

*****************************************************************
* End of SLIP trap command. *
*****************************************************************

*****************************************************************
* Example of same slip to collect the VTAM dataspace(csm) also
*****************************************************************
SLIP SET,MSGID=CSQX207E,
JOBNAME=ssidCHIN,A=SVCD,
JOBLIST=(ssidMSTR,ssidCHIN,tcpipprocname),
DSPNAME=('ssidCHIN'.CSQXTRDS,'tcpipprocname'.*,1.00000CSM),
SDATA=(ALLNUC,CSA,LPA,RGN,PSA,SWA,SQA,LSQA,TRT,SUM),
MATCHLIM=1,END

*****************************************************************



Slip instructions for z/OS releases prior to 1.2



*****************************************************************
* MASTER and CHIN SVC DUMP ON Message CSQX207E *
*****************************************************************
SLIP SET,IF,LPAMOD=(IGC0003E,0),
DATA=(1R?+4,EQ,C3E2D8E7,1R?+8,EQ,F2F0F7C5),
JOBNAME=ssidCHIN,A=SVCD,
JOBLIST=(ssidMSTR,ssidCHIN,tcpipprocname),
DSPNAME=('ssidCHIN'.CSQXTRDS,'tcpipprocname'.*),
SDATA=(ALLNUC,CSA,LPA,RGN,PSA,SWA,SQA,LSQA,TRT,SUM),
MATCHLIM=1,END

*****************************************************************
* End of SLIP trap command. *
*****************************************************************

*****************************************************************
* Example of same slip to collect the VTAM dataspace(csm) also
*****************************************************************
SLIP SET,IF,LPAMOD=(IGC0003E,0),
DATA=(1R?+4,EQ,C3E2D8E7,1R?+8,EQ,F2F0F7C5),
JOBNAME=ssidCHIN,A=SVCD,
JOBLIST=(ssidMSTR,ssidCHIN,tcpipprocname),
DSPNAME=('ssidCHIN'.CSQXTRDS,'tcpipprocname'.*,1.00000CSM),
SDATA=(ALLNUC,CSA,LPA,RGN,PSA,SWA,SQA,LSQA,TRT,SUM),
MATCHLIM=1,END

*****************************************************************

The EBCDIC in the DATA parameter can be modified to slip on other WebSphere MQ message numbers if necessary. This method will work for z/OS 1.2 and later, but the method described below is preferred.


Product Alias/Synonym

WMQ MQ

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
Documentation

Software version:

5.3.1, 6.0, 7.0, 7.0.1, 7.1

Operating system(s):

OS/390, z/OS

Reference #:

1040434

Modified date:

2013-09-16

Translate my page

Machine Translation

Content navigation