Skip to end of metadata
Go to start of metadata

Summary

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

FAQ: z/IRIS IronTap

Why are all SMF records being discarded?

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

  1.  Ensure that one of the supported SMF records are enabled on the designated LPAR(s)

    See our Latest Administration and User Guide for supported SMF records

  2.  Your application accesses the designated LPAR(s)
    Note that several load-balancing mechanisms on the mainframe may distribute the work among different LPARs, CICS regions, etc.
  3.  The Instana agent is up and running

    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:

    Running.
    

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

    sudo service instana-agent start
  4.  Your application ist started with the required runtime parameters
  5.  Your application and IronTap are configured to use the same trace field
  6.  The correct EBCDIC code page is set in the IronTap config file
    • See our 'Latest Administration and User Guide' for the EBCDIC code page configuration in IronTap
    • Note that some z/OS applications might use other code pages than the system default code page
  7.  Ensure that your application is correctly instrumented by the agent
    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 com.ibm.db2.jcc' should appear in the agent logs
  8.  Use Logging Metrics or Traces to File for the Instana agent
    • Enable "Logging Metrics or Traces to File" as described in the Instana Agent documentation
    • Ensure that the agent is creating traces for your application

What logs should be collected when I open a support ticket for z/IRIS IronTap?

 Enable SMF dumps and gather: APM agent logs, Irontap logs and smf dumps
  • Enable IronTap's 'SMF dumps' capability as described in our 'Latest Administration and User Guide'
  • 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 accumulated CPU Time and Db2 elapsed time zero?

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

-START TRACE(ACCTG) CLASS(1,2,3) IFCID(3) DEST(SMF) TDATA(CORRELATION)

Instana APM related FAQ

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

Answer: Disabling the feature requires a restart of the JVM and the removal of the z/IRIS related system properties.



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

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