Skip to main content
Skip table of contents


Created:  | Updated: 


Why is IronTap dropping SMF records?

Answer: The following steps provide you with an overview of the most common pitfalls and how to solve them:

Step 1: Verify that SMF records enabled

Click to expand instructions ...

Verify that z/OS clients stream supported SMF records streamed to the Kafka cluster.

Step 2: Verify that the instrumented applications call mainframe LPARs that are monitored by z/IRIS

Click to expand instructions ...

Note that several load-balancing mechanisms on the mainframe may distribute the work among different LPARs, CICS regions, etc.

Step 3: For Distributed Db2 observability, check that JDBC application has the required environment variables set

Click to expand OpenTelemetry instructions ...

Step 4: Is IronTap integration configured correctly?

Click to expand OpenTelemetry instructions ...

Step 5: Is the correct EBCDIC code page set in the IronTap config file?

Click to expand instructions ...
  • Refer to Configure IronTap to find out more about EBCDIC code page configuration in IronTap is correct

z/OS applications might use code pages that differ from the system default code page.

Step 6: Ensure that your application is correctly instrumented by the agent

Click to expand OpenTelemetry instructions ...

How do I share my IronTap logs with support?

Click to expand instructions ...
  • Ensure agent logs are active

  • Ensure IronTap logs are active

  • Run the relevant business applications for which tracing or metrics are needed

  • Attach the following files to your support ticket:

    • APM agent logs (regular log file as well as the metrics/traces log)

    • IronTap logs

How do I extract or collect SMF records for my z/IRIS support issue?

Click to expand instructions ...
  • If IronTap receives SMF records via TCP, enable IronTap's 'SMF dumps' capability as described in Configure IronTap

  • If IronTap streams SMF records via Kafka, use the Kafka Record Extractor tool to collect and archive SMF records

Why is the zos.db2.cpu.time and zos.db2.elapsed.time zero?

Click to expand instructions ...

Answer: The mainframe administrator has to activate class 2 & 3 like in the following Db2 transaction trace-set:


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.