解决启动资源时出现的问题

使用此处提供的建议可以帮助您解决启动集成节点以外的资源时可能发生的常见问题。

关于此任务

要了解如何解决启动集成节点时的常见问题，请参阅解决启动集成节点时的问题。

要获取有关启动资源时可能发生的特定问题的建议，请参阅下列各节。

启动期间资源终止

过程

场景: 在 Windows上启动集成节点时显示以下错误消息:

ServiceName - DLL initialization failure Initialization of the
dynamic link library c:\windows\system32\user32.dll failed.
The process is terminating abnormally.

说明: 当 Windows 由于存储空间不足而无法启动服务时，会发出此错误。
解决方案: 此错误是操作系统问题。 Microsoft Developer Network (MSDN) 中提供了有关如何从此问题恢复的信息。您可以在 Web 上访问 MSDN ，网址为 http://msdn.microsoft.com。

在 Windows 上启动时资源挂起

过程

场景: 您尝试在 Windows上启动集成节点，但事件日志中没有任何事件显示已启动连接。
说明: 此问题通常是由仅具有一个线程的进程引起的。要查看这是否是原因，请检查 Windows 任务管理器。如果已启动进程 bipconfigmgr.exe 或 dataflowengine.exe，请检查相应进程拥有的线程数。如果此进程只有一个线程，则您极有可能遇到此问题。
解决方案:
1. 使用 mqsistop 命令关闭集成节点，并从任务管理器中结束该过程。
2. 从 Windows 启动按钮，单击设置 > 控制面板
3. 双击管理工具
4. 双击服务可打开 " 服务 " 窗口。从可用服务列表中，找到并右键单击要启动的集成节点资源 (服务名称以 IBM® Integration Bus 组件开头)。单击菜单中的属性。
5. 记录 This Account 设置。请与系统管理员联系以获取与 This Account关联的密码，因为更改值时会丢失这些设置。
6. 选择系统帐户作为登录身份选项，然后选择允许服务与桌面交互。这些选择允许您查看任何隐藏的对话框消息。单击确定接受更改。
7. 重新启动失败的资源，并向 IBM 服务代表报告任何后续错误消息和对话框消息。
8. 当 IBM 服务代表为您解决此问题时，请确保将此帐户，密码和确认密码条目复原为创建集成节点时使用的值。

启动组件时发出错误消息 BIP8048

过程

场景: 启动组件时发出错误消息 BIP8048 。
说明: 此消息指示 IBM MQ 在尝试启动队列管理器时未按预期进行响应。导致此问题的原因可能为：
- strmqm 可执行文件在 Linux® 系统上不存在。
- amqmdain 可执行文件在 Windows 上不存在
解决方案: 检查 IBM MQ 安装是否完全正常运行:
- 在 Windows上，启动 "IBM MQSeries ®" 服务。
- 在 Linux上，发出 strmqm 命令以启动与此组件关联的队列管理器。
如果检查失败，那么您的 IBM MQ 安装不完整。发生此错误通常是因为您先前已安装 WebSphere® Application Server，这将安装不支持 IBM Integration Bus的嵌入式 IBM MQ 组件。

卸载 WebSphere Application Server，然后安装随 IBM Integration Bus提供的完整 IBM MQ 产品。

单击指向特定样本的链接时，报告“未找到”错误

过程

情景： 当您单击指向特定样本的链接时，出现 "未找到 "错误，表明 URL 无效。
说明: 仅当您使用与 IBM Integration Toolkit集成的产品文档时，才能查看样本应用程序。如果查看的是独立或在线产品文档，那么无法访问这些资源。
解决方案: 如果要访问样本，请确保您正在 IBM Integration Toolkit中查看产品文档。

启动时发出错误消息 BIP0832

过程

场景: 启动时显示以下错误消息:
BIP0832E: A class java.io.FileNotFoundException exception occurred which reported the following message: [filepath] (The process cannot access the file because it is being used by another process). Resolve the reason of error and try again.
说明: 在 "入队首选项" 屏幕上指定了无效的 IBM MQ Java™ 客户机跟踪输出文件。
解决方案:
1. 通过单击 Windows > 首选项，然后单击左侧的入队，打开 "入队" 首选项屏幕。
2. 在目标文件字段中，指定有效的输出文件 (非只读或已在使用的输出文件)。

集成服务器反复重新启动

过程

场景: 集成服务器重复重新启动。系统日志可能显示错误（例如 BIP2060）。
说明: 问题可能由以下原因引起:
- 集成节点环境变量定义错误
- 错误可承载的实施库目录许可权
- 错误数据库许可权
- 无效的用户编写的 LIL
解决方案: 检查:
- 环境变量，如设置命令环境中所述
- 文件和目录许可权，如检查安装目录的许可权中所述
- 组成员资格，如集成服务器中所述

您无法确定在 z/OS 上是否已完成启动

过程

场景: 您无法判断是否已在 z/OS 系统上完成启动。

解决方案: 要确定启动是否完成:

检查系统日志中的消息。以下示例显示了一个系统日志条目，说明包含一个集成服务器的集成节点的启动：

S STU3053
$HASP100 STU3053  ON STCINRDR
IEF695I START STU3053  WITH JOBNAME STU3053  IS ASSIGNED TO USER STU3 
 , GROUP STCGROUP
$HASP373 STU3053  STARTED
+(broker53) 0 BIP9141W: The component was started.
+(broker53) 0 BIP2001I: The IBM Integration Bus 
service has started
 process ID 33554919.
+(broker53.default) 0 BIP2201I: Integration Server started: process '67109
442
 196'; thread '0'; additional information 'broker53', '76eb7f2d-e800-00
 00-0080-974c271866d2', 'default', 'true', 'Q4A3', 'false', 'ARG5D651',
  'ARGO53', '********', 'false', 'f9c27f2d-e800-0000-0080-974c271866d2'
 , '/local/argo/driver/drv3', '/local/argo/tgrp53/broker53'.
+(broker53.default) 0 BIP9137I: A work manager has been registered by R
443
 RMS registration services, work manager name is BIP.STU30532.006710919
 6.IBM.UA  .

显示地址空间。以下示例说明包含一个集成服务器的集成节点的显示：

D OMVS,U=STU3
BPXO040I 18.49.59 DISPLAY OMVS 446 
OMVS     000E ACTIVE          OMVS=(68,05) 
USER     JOBNAME  ASID        PID       PPID STATE   START     CT_SECS 
STU3     STU30531 0069   33554696   33554919 HR    18.49.15      2.217 
  LATCHWAITPID=         0 CMD=bipbroker broker53 
STU3     STU30532 03FD   67109196   67109222 HR    18.49.23     19.816 
  LATCHWAITPID=         0 CMD=DataFlowEngine broker53 76eb7f2d-e800-00 
STU3     STU3053  0036   33554768   83886483 HRI   18.49.08       .653 
  LATCHWAITPID=         0 CMD=bipservice Q4A3BRK AUTO 
STU3     STU30532 03FD   67109222   33554696 1W    18.49.23     19.816 
  LATCHWAITPID=         0 CMD=bipimain DataFlowEngine broker53 76eb7f2 
STU3     STU3053  0036   83886483          1 1WI   18.49.08       .653 
  LATCHWAITPID=         0 CMD=/local/argo/driver/drv3/bin/bipimain bip 
STU3     STU30531 0069   33554919   33554768 1W    18.49.15      2.217 
  LATCHWAITPID=         0 CMD=bipimain bipbroker broker53

结果

基础结构主程序 bipimain 是每个地址空间的首个进程。它在同一地址空间中启动 bipservice、bipbroker 或 DataFlowEngine 作为第二个进程。对于每个集成服务器，将启动附加的地址空间。在此示例中，只有一个集成服务器。

异常终止代码0C1当您尝试启动时发出DataFlowEngine在z/OS

过程

设想：前两个IBMIntegration Bus地址空间成功启动，但第三个地址空间（DataFlowEngine) 无法启动。结果是 0C1 异常结束。
解释：这DataFlowEngine地址空间由管理代理生成。如果区域大小太小，要么是因为在过程中指定的区域大小不够，要么是因为区域大小被z/OSIEFUSI 退出，DataFlowEngine地址空间可能无法启动，并失败并出现0C1异常结束。
解决方案:
1. 对转储使用 IPCS 命令（如有需要，将转储从文件系统移至传统的 MVS 数据集）：
```
verbx vsmdata,'noglobal,jobname(vcp0brk2)'   
```
  其中 vcp0brk2 是失败作业的名称。
2. 查找字符串 'VSM LOCAL DATA AREA AT ADDRESS '。
  字段 ELIM 提供可用的区域大小，并且必须大于 0C800000。如果字段 SMFEL 不是 ffffffff，那么 IEFUSI 出口更改了允许的区域大小。这个值还必须大于 0C80000。
3. 如果您有 IEFUSI 出口，请检查此出口没有限制集成节点地址空间。
  例如，常用的字段是 OUCBSUBN。此字段可以是用于集成节点的 STC 或 OMVS，并表明地址空间的启动方式。

在 z/OS 上启动消息流期间发出错误消息 BIP2604 ，返回码为 `MQRC_CONNTAG_IN_USE`

过程

场景: 在 z/OS上启动消息流期间，发出了错误消息 BIP2604 ，返回码为 MQRC_CONNTAG_IN_USE :
```
BIP2604E: 节点无法打开 WebSphere MQ 队列 [队列名称] 
由队列管理器 [队列管理器名称] 拥有
```
此消息每隔 30 分钟输出一次。
说明: 在 z/OS上， IBM MQ 支持通过在应用程序连接到参与队列共享组的队列管理器时使用连接标记 (序列化令牌) 对共享资源 (例如共享队列) 进行序列化访问。
在这种情况下，消息流节点无法连接到与输入队列关联的所指示 IBM Integration Bus 队列管理器，因为它传递的序列化令牌已在队列共享组中使用。

这条消息仅用于信息参考。这条消息说明，两个或多个消息流输入节点尝试连接队列管理器以从共享队列获取消息时，使用的是序列化标记。
解决方案: 检查消息流的另一个实例或使用相同序列化令牌的流是否已在运行。如果情况如此，那么无需执行进一步的操作。否则，请与 IBM 支持中心联系。

创建或更改可配置服务后，请重新启动集成节点，但消息流未启动，并在系统日志或 Windows 事件查看器中发出消息 BIP2275

过程

场景: 创建或更改可配置服务后，重新启动集成节点，但消息流未启动，并且在系统日志或 Windows 事件查看器中发出消息 BIP2275 ，指示从持久存储装入消息流时发生错误。
说明: 更改或创建可配置服务时，此时不会完全验证连接属性; 集成节点不会尝试使用这些属性来建立连接。对于入站适配器，只有在集成节点重新启动时才建立连接。因此，在该可配置服务中设置的属性可能无效。

解决方案: 查看 BIP2275 消息后的消息，以确定消息流是否由于连接属性无效而未能启动。

例如，在 SAP 中，您将看到带有原因的消息 BIP3414，例如：

Connect to SAP gateway failed 
Connect_PM GWHOST= invalidhost.test.co, GWSERV=sapgw00, ASHOST= invalidhost.test.co, 
  SYSNR=00 
LOCATION CPIC (TCP/IP) on local host 
ERROR partner not reached (host invalidhost.test.co, service 3300) 
TIME Fri Nov 28 15:27:32 2008 
RELEASE 640 
COMPONENT NI (network interface) 
VERSION 37 
RC -10 
MODULE nixxi_r.cpp 
LINE 8728 
DETAIL NiPConnect2 
SYSTEM CALL SiPeekPendConn 
ERRNO 10061 
ERRNO TE'

后跟 BIP3450 消息和一条适配器错误消息，例如：

Connect to SAP gateway failed 
Connect_PM GWHOST= invalidhost.test.co, GWSERV=sapgw00, ASHOST= invalidhost.test.co,
  SYSNR=00 
LOCATION CPIC (TCP/IP) on local host 
ERROR partner not reached (host invalidhost.test.co, service 3300) 
TIME Fri Nov 28 15:27:32 2008 
RELEASE 640 
COMPONENT NI (network interface) 
VERSION 37 
RC -10 
MODULE nixxi_r.cpp 
LINE 8728 
DETAIL NiPConnect2 
SYSTEM CALL SiPeekPendConn 
ERRNO 10061 
ERRNO TE

此错误已被适配器检测到。以下消息描述适配器所提供的诊断信息：

Connect to SAP gateway failed 
Connect_PM GWHOST= invalidhost.test.co, GWSERV=sapgw00, ASHOST= invalidhost.test.co,
  SYSNR=00 
LOCATION CPIC (TCP/IP) on local host 
ERROR partner not reached (host invalidhost.test.co, service 3300) 
TIME Fri Nov 28 15:27:32 2008 
RELEASE 640 
COMPONENT NI (network interface) 
VERSION 37 
RC -10 
MODULE nixxi_r.cpp 
LINE 8728 
DETAIL NiPConnect2 
SYSTEM CALL SiPeekPendConn 
ERRNO 10061 
ERRNO TE

此消息表明 applicationServerHost 和 gatewayHost 属性不正确。当您确定哪些属性不正确时，请使用 mqsichangeproperties 命令来更正属性，或者使用 mqsideleteconfigurableservice 命令来还原到适配器中已部署的属性。重新启动集成节点。

报告设备分配错误

过程

场景: 发出设备分配错误。
说明: 此问题的可能原因是您在组件文件系统上没有为启动式任务标识设置正确的许可权。
解决方案: 检查系统日志; 如果问题是由于为启动式任务标识设置了不正确的许可权而导致的，那么您通常会看到 RACF® 授权失败消息，如以下示例中所示。
```
ICH408I USER(TASKID1 ) GROUP(TSOUSER ) NAME(FRED (FRED) 959   
 /argo/MA11BRK/ENVFILE   
 CL(DIRSRCH ) FID(01D7C7E2E3F0F8000F16000000000003)   
 INSUFFICIENT AUTHORITY TO LOOKUP   
 ACCESS INTENT(--X)  ACCESS ALLOWED(OTHER ---) 
IEE132I START COMMAND DEVICE ALLOCATION ERROR 
IEA989I SLIP TRAP ID=X33E MATCHED.  JOBNAME=*UNAVAIL, ASID=00A8. 
D J,BPXAS 
IEE115I 11.13.04 2001.212 ACTIVITY 601
```
在此示例中，启动式任务标识无法访问文件系统组件。 ICH408I 消息显示：
- 任务正在尝试访问的文件
- 正在尝试访问文件的用户标识
- 标识要求具有的许可权（消息中的 INTENT）
- 标识实际具有的许可权（消息中的 ALLOWED）
您可以使用此信息更正许可权，然后像此示例一样重新发出启动集成节点请求。如果发出命令（可能是启动集成节点，或者提交 JCL 以启动某个实用程序作业）的用户没有文件系统组件的正确文件系统许可权，则会产生这种类型的消息。使用 ICH408I 信息来改正问题。

授权失败的另一个可能原因是 MVS 映像和 OMVS 段中的用户 ID 的 RACF 定义不一致。此外，请与系统管理员确认 MVS 上使用的 RACF ID 是否已创建相应的 OMVS 映像。

Windows 无法识别 IBM Integration Bus 数字签名: "未知发布者"

过程

场景: 用户 A 安装 IBM Integration Bus，并且可以运行所有程序 (mqsi*.exe， bip*.exe，包括命令控制台启动程序)。创建用户 B 并为其授予适当特权。当用户 B 运行命令控制台启动程序之类的可执行文件时，打开一个窗口并报告该可执行文件来自无法识别的发布者。
说明: 操作系统尚未为用户 B 安装相应的数字证书。
解决方案: 用户 B 必须手动安装证书:
1. 在 Windows 资源管理器中，浏览至 IBM Integration Bus 安装的 bin 目录; 例如，在 32 位系统上， C:\Program Files\IBM\MQSI\7.0\bin
2. 右键单击任意 .exe 文件以打开“属性”窗口。
3. 单击“数字签名”选项卡。
4. 从列表中选择适当的证书，然后单击详细信息。这将显示“数字签名详细信息”窗口。
5. 单击查看证书。这将显示“证书”窗口。
6. 单击安装证书并完成向导中的步骤。（依次单击下一步、下一步、完成和确定。）
7. 关闭“证书”窗口。您将返回到“数字签名详细信息”。
8. 从列表中选择副署签名，然后单击详细信息按钮。这将显示一个新的“数字签名详细信息”窗口。您可以重复前面的步骤以安装其他证书。

创建命令失败，并发出错误消息 BIP8022

过程

场景: 在 Windows上使用 mqsicreatebroker 命令时显示错误消息 BIP8022 ，即使提供的用户名和密码正确也是如此。
说明: 需要 Microsoft 组件 "共享文件和打印机服务"。
解决方案: 通过在 Windows 系统上安装 "针对 Microsoft 网络的共享文件和打印机" 服务来更正此错误。

集成服务器因 JVM 启动失败而反复重启

过程

设想：当你启动DataFlowEngine它不断地启动和停止，显示错误BIP2116E和BIP7409S在日志中：

BIP2116E: IBM Integration Bus internal error: diagnostic information 'Fatal Error; exception thrown before initialisation completed', 'JVM Startup'
BIP7409S: The integration node was unable to create a JVM. The return code indicates that an unrecognized option was passed in to it.

说明: 当您启动集成服务器时，它将创建用于执行 Java 用户定义节点的 Java 虚拟机 (JVM) ，并且由于不正确的 JVM 选项而导致其创建失败。
解决方案: 通过完成以下步骤来更正 JVM 选项:
1. 停止该集成节点。
  mqsistop integrationNodeName
2. 检查失败集成服务器的 jvmSystemProperty 值。
  mqsireportproperties brokerName -e egName -o ComIbmJVMManager -n jvmSystemProperty -f
3. 如果 jvmSystemProperty 具有无效选项，请更正或重置其值。
  mqsichangeproperties brokerName -e egName -o ComIbmJVMManager -n jvmSystemProperty -v "" -f
4. 启动集成节点。
  mqsistart integrationNodeName