[z/OS]

在 z/OS 上收集 Java 和 JMS 应用程序问题的信息

如果需要 IBM® 支持人员的帮助来解决 IBM MQ for z/OS®上的 JMS 或 Java 问题，那么首先需要收集故障诊断信息以发送给 IBM 支持人员以帮助查找解决方案。

开始之前

在开始此任务之前，请回答有关此问题的以下问题:
  • 您在系统上观察到什么 JMS 或 Java 问题?
  • 问题什么时候开始，什么时候停止?
  • 是否报告了任何 Java 异常，以及它们是否包含 Java 调用堆栈?
  • JMS 或 Java 应用程序使用哪些队列管理器，队列和主题?

搜索 IBM MQ 支持站点 以获取已知问题，例如使用任何错误消息或返回码。

大多数 IBM MQ for z/OS Java 故障是由设置或配置问题导致的。 必须正确配置路径，类路径和环境变量。 请参阅：

关于本任务

如果您可以重现问题或者问题正在发生，那么可以生成数据以提供有关问题的更多信息。

收集故障诊断信息后，可以将其发送到 IBM。

过程

  1. 收集以下必需信息:
    1. 作业日志
      您需要 Syslog ， MSTR 作业日志和 CHIN 作业日志。

      作业日志名为 xxxxMSTR 和 xxxxCHIN，其中 xxxx 是 IBM MQ 子系统标识 (SSID)。请参阅 为 IBM MQ for z/OS 作业创建包含 JES2 作业日志的打印数据集。

    2. 在发生故障时生成的转储。
      请参阅 IBM MQ for z/OS 转储
    3. 在发生故障时进行的转储。
      请参阅 使用 z/OS DUMP 命令
    4. LOGREC 报告
      请参阅 LOGREC 报告
      注: 您还需要产品的版本和发行版号。 有关如何查找此信息的信息，请参阅步骤 4 。
  2. (可选) 在发生问题时生成以下内容:
    1. 生成 GTF 跟踪
    2. 生成 MSTR 内部跟踪
    3. 生成 CHIN 跟踪
    4. 跟踪 IBM MQ classes for JMS 应用程序
    5. 跟踪 IBM MQ Classes for Java 应用程序
    6. 为 WebSphere Application Server启用 JMS 跟踪
  3. 收集 IBM MQ 数据。
  4. 记录 IBM MQ for z/OS 和任何其他产品的产品级别。
    请参阅 IBM MQ for z/OS 的 MSTR 作业日志中的消息 CSQY000I
    记录系统的 操作系统版本和维护级别 。
  5. 对于独立应用程序，记录正在使用的 IBM MQ classes for Java 或 IBM MQ classes for JMS 版本。
    在当前类路径上查找类的构建级别
    发出以下命令：
    java com.ibm.mq.MQJavaLevel
    或
    java com.ibm.mq.jms.MQJMSLevel
    查找特定目录中 JAR 文件的构建级别:
    切换到包含 jar 的目录，然后发出以下命令:
    java -cp com.ibm.mq.jar com.ibm.mq.MQJavaLevel
    或
    java -cp com.ibm.mqjms.jar:com.ibm.mq.jar com.ibm.mq.jms.MQJMSLevel
    如果接收到 MQJavaLevel 或 MQJMSLevel的 java.lang.NoClassDefFoundError ，那么需要提供类的路径。 可以使用以下方法之一：
    1. 在命令中指定 CLASSPATH:
      java -cp path/com.ibm.mq.jar com.ibm.mq.MQJavaLevel
      其中 path 是包含相关 JAR 文件的目录路径。
      例如：
      java -cp ./com.ibm.mq.jar com.ibm.mq.MQJavaLevel
      提供当前目录中 com.ibm.mq.jar 文件的版本信息，或者
      java -cp /usr/lpp/mqm/V9R3M0/java/lib/com.ibm.mq.jar com.ibm.mq.MQJavaLevel
      提供文件 /usr/lpp/mqm/V9R3M0/java/lib/com.ibm.mq.jar的版本信息。
      注: java -cp /usr/lpp/mqm/V9R3M0/java/lib/com.ibm.mq.jar com.ibm.mq.MQJavaLevel 必须在一行上。
    2. 设置 CLASSPATH 和 LIBPATH 环境变量。

      请参阅 为 IBM MQ classes for JMS/Jakarta Messaging设置环境变量 和 配置 Java 本机接口 (JNI) 库 以匹配应用程序或 WebSphere Application Server使用的设置。

      OMVS 中的 "env" 命令将向您显示当前设置。

      如果需要为 OMVS 会话设置变量，那么以下导出命令是要从 OMVS 命令行发出或添加到 .profile的示例:
      export LIBPATH=/usr/lpp/mqm/V9R3M0/java/lib:$LIBPATH
export CLASSPATH=/usr/lpp/mqm/V9R3M0/java/lib/com.ibm.mq.jar:$CLASSPATH
export CLASSPATH=/usr/lpp/mqm/V9R3M0/java/lib/com.ibm.mqjms.jar:$CLASSPATH
      注：
      • /usr/lpp 是针对您的环境可能不同的安装目录
      • 这些变量是显示级别所需的最小值
      • 运行时 CLASSPATH 包含其他库。
  6. 在上载到 ECUREP 之前，请使用 AMATERSE 实用程序，并确保指定与数据关联的观测值编号。
  7. 将收集的信息发送到 IBM。

    问题和数据的良好描述是您可以向 IBM提供的最重要信息。 请勿在未提供描述的情况下发送数据!

    有关 FTP 和电子邮件指示信息，请参阅 与 IBM 软件支持人员交换信息。

    要打开或更新案例，请转至 IBM My Support 站点。
    注: 始终更新案例以指示已发送数据。

    如果需要与 IBM 软件支持人员交谈，请联系您的 国家或地区代表。 如果需要在美国与 IBM 软件支持人员交谈，可以致电 1-800-IBM-SERV。