部署用户出口

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

要部署用户出口:

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

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

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

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

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

    1. 停止代理
    2. 使用 mqsichangebroker 命令设置代理的 activeUserExits 属性。
    3. 更新开始启动代理并查看系统日志以确保所有执行组启动,且没有错误。 如果指定了任何无效的用户出口名称(即,用户出口不是由任何执行组装入的库提供),则会有一条 BIP2314 消息写入系统日志,并且执行组中的所有流都无法启动,除非您执行以下某个操作:
      • 在实现出口的用户出口路径中提供库;然后发出 mqsireload 命令或重新启动代理以从库中装入出口
      • 发出 mqsichangeflowuserexits 命令以从活动或不活动的列表中除去出口
      更新结束

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

相关概念
建立用户出口
相关任务
建立用户出口
相关参考
mqsicreatebroker 命令
mqsichangebroker 命令
mqsireportflowuserexits 命令
mqsichangeflowuserexits 命令
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ac02160_