IBM Support

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

Troubleshooting


Problem

You are looking for instructions to set a SLIP trap for an IBM MQ for z/OS error message and include TCP/IP CTRACE or TCP/IP packet trace in the dump.

Resolving The Problem

Following are instructions to start TCP/IP CTRACE or packet trace and to set a SLIP trap for a message from IBM MQ. The SLIP has keywords to dump the packet trace at the same time. In case a packet trace is needed and there is no error message to set a SLIP trap for, instructions are also provided to capture an SVC Dump.

 

Tab navigation

 

See technote MustGather: Directions to start, end, and format trace for instructions to start IBM 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 cannot 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 springs).
  • 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 enter END. You only need to pass an external writer name on the reply if you are writing to the external writer as described at How to Collect PKTTRACE and CTRACE on z/OS.

When the slip trap shown later in this document springs, it dumps IBM MQ's CHIN and trace dataspace as well as TCP/IP and its trace dataspace. This dump captures the needed doc at the time of the failure. You need to manually stop the trace after the SLIP trap springs.

 



SLIP trap instructions

 Since this trap is not a PER SLIP, it can run along with other SLIP traps. Replace CSQX207E with the message that you are receiving.

*****************************************************************
* MSTR 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. *
*****************************************************************

As of z/OS 1.13, the SYSTCPIP trace buffers are in 64-bit storage.
 


SVC Dump instructions

From the z/OS console:
/DUMP COMM=(dump title)
/R xxx,SDATA=(CSA,RGN,PSA,SQA,LSQA,TRT,SUM,GRSQ),CONT
/R xxx,JOBNAME=(ssidMSTR,ssidCHIN,tcpipproc),CONT
/R xxx,DSPNAME=('ssidCHIN'.CSQXTRDS),END

where "dump title" is the comment you want to provide for the title of the dump
      "xxx" is replaced with the related reply-to number found at the end of the console syslog
      "ssid" is the subsystem id of the queue manager
      "tcpipproc" is replaced with the name of the TCP/IP procedure 
 

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"ARM Category":[{"code":"a8m0z0000001iitAAA","label":"Retired-\u003ETroubleshooting"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Versions"},{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"ARM Category":[{"code":"a8m0z0000001iitAAA","label":"Retired-\u003ETroubleshooting"}],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Versions"}]

Product Synonym

WMQ IBM MQ

Document Information

Modified date:
09 September 2023

UID

swg21040434