Created:  | Updated: 

We have summarized the most common support questions here with an appropriate solution to each issue.

FAQ: z/IRIS IronTap

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: Ensure that one of the supported SMF records are enabled on the designated LPAR(s)

Click to expand instructions ...

Verify that supported SMF records are being streamed for processing by referring to our Latest Administration and User Guide.

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: Verify that the APM agent is up and running

Click to expand instructions ...

The agent has to be installed and started (Full APM mode) on the same machine the Java application is running on. On Linux use the following command to view the current state of the agent:

sudo service instana-agent status

expected result:


If the agent is not running, use the following command:

sudo service instana-agent start

Step 4: Check that application has the required environment variables set

Step 5: Is z/IRIS IronTap configured to process the correct JDBC client info properties?

Click to expand instructions ...

Step 6: 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 7: Ensure that your application is correctly instrumented by the agent

Click to expand instructions ...
  1. Set the agent log level to debug either via the UI or the agent config

  2. Restart your application

  3. Entries like 'Successfully instrumented class' should appear in the agent logs

Step 8: Activate ‘Logging Metrics’ or ‘Traces’ to monitor the Instana agent

Click to expand instructions ...
  • Enable "Logging Metrics or Traces to File" as described in the Instana Agent documentation

  • Ensure that the agent is creating traces for your application

How do I share my IronTap logs with support?

Click to expand instructions ...
  • Enable IronTap's 'SMF dumps' capability as described in our 'Configure IronTap'

  • Run your application to create SMF records

  • Open a support ticket and attach the following files:

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

    • IronTap logs

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:


Instana APM related FAQ

How do I deactivate the Instana JVM Instrumentation using JDBC 4.0 for Db2 on z/OS?

Click to expand instructions ...

Answer: Disabling the feature requires a restart of the JVM and the removal of the z/IRIS related system properties. Refer to “Enable z/IRIS integration with Instana” for more information.

How do I filter mainframe traces in Instana APM by numeric values?

Click to expand instructions ...

Answer: Currently this function is not available for call.tag tags in Instana APM. All values within a mainframe trace are String-based.