更新开始

部署用户出口

当您已编写及编译用户出口时,需要给予库扩展名“.lel”、导出函数 bipInitializeUserExits 和 bipTerminateUserExits,并将该库安装在代理的系统上。 此外,还可基于每个消息流将用户出口状态设置为活动或不活动。

要部署用户出口:

  1. 在代理上安装用户出口
    包含用户出口代码的库必须安装在可由代理访问的文件系统上。例如,文件必须拥有对代理运行所使用用户标识的读取和执行权限。代理在以下位置查看包含用户出口的库:
    • 代理属性 UserExitPath(对于 64 位执行组为 UserExitPath64)。这是以冒号(在 Windows 中是分号)分隔的多个目录的列表。可在 mqsicreatebroker 或 mqsichangebroker 上使用 –x 标志对其进行设置。 设置它以将用户出口装入特定代理。
    • 环境变量 MQSI_USER_EXIT_PATH(对于 64 位执行组为 MQSI_USER_EXIT_PATH64)。这是以冒号(在 Windows 中是分号)分隔的多个目录的列表。通常对其进行设置以将用户出口装入特定环境的每个代理。

    如果两者都进行了设置,则环境变量具有优先权。环境变量中的所有目录都以目录在变量中出现的顺序进行搜索。于是,代理属性中的所有目录都以目录在属性中出现的顺序进行搜索。

  2. 将用户出口库装入代理的进程
    如果用户出口库已安装在代理上,则它必须装入。 可以用以下某个方法来执行该操作:
    • 停止并重新启动代理
    • 发出 mqsireload 命令。这会使执行组进程重新启动。
  3. 激活用户出口

    用户出口状态可为活动或不活动的,且在缺省情况下为不活动的。一组用户出口的缺省状态可基于每个代理更改为活动的。

    要设置代理的缺省用户出口状态:

    1. 停止代理
    2. 使用 mqsichangebroker 命令设置代理的 activeUserExits 属性。
    3. 启动代理并查看系统日志以确保所有执行组启动,且没有错误。 如果指定了任何无效的用户出口名称(即,用户出口不是由任何执行组所装入的库提供的),则会有一条 BIP2314 消息写入系统日志,并且执行组中的所有流都无法启动。

    您也可覆盖代理的缺省用户出口状态。可基于每个执行组或消息流使用 mqsichangeflowuserexit 命令激活或取消激活用户出口,其优先顺序为先消息流后执行组。如果某个给定流有多个活动的出口,则能够按所定义的顺序调用这些出口(如 mqsichangeflowuserexit 中所述)。

相关概念
建立用户出口
相关任务
建立用户出口
相关参考
mqsicreatebroker 命令
mqsichangebroker 命令
mqsireportflowuserexit 命令
mqsichangeflowuserexit 命令
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
ac02160_


更新结束