mqsichangeflowuserexits 命令

支持的操作系统

用途

使用 mqsichangeflowuserexits 命令设置活动或非活动的用户出口列表。每个执行组和消息流都具有活动用户出口列表和非活动用户出口列表。消息流启动时将决定其用户出口的有效状态。这是由该消息流及其执行组的活动和非活动用户出口列表决定的。

优先顺序为消息流、执行组和缺省代理。在消息流和执行组设置中,活动列表优先于非活动列表。

如果没有对消息流设置给定的用户出口状态,则依据执行组的设置决定其状态。如果既没有对消息流也没有对执行组设置用户出口状态,则为缺省状态,即非活动状态,或通过 mqsichangebroker 命令的代理属性 activeUserExits 将其明确定义为活动状态。

如果消息流或执行组的活动和非活动列表中同时出现特殊的用户出口名称,则活动列表具有优先级别,即该用户出口为活动状态。因此,如果希望将用户出口从活动状态更改为非活动状态,必须使用 -i 标志将其指定为非活动列表的部分,并使用 -a 标志重新指定新的活动列表来将其从活动列表中除去。

如果给定消息流的多个出口都是活动的,则以定义的顺序调用它们。首先以 -a 标志指定的顺序来调用消息流活动列表中的出口。

当它们被调用后,再调用执行组活动列表(既不在消息流的活动列表中也不在非活动列表中)中的出口。 调用它们的顺序为 -a 标志指定的顺序。

在执行组或消息流的活动或非活动列表中没有提及,却存在于代理的活动列表中的所有用户出口都以设置 activeUserExits 代理属性时指定的顺序调用。

如果活动或非活动列表中指定的任何用户出口未向目标执行组注册,则该命令失败,带有 BIP8858 错误。

命令成功完成后,如果指定的任何用户出口无效,则根据用户出口所在的列表来执行以下操作:
  • 如果用户出口在消息流的活动或非活动列表中指定,则消息流无法启动并且 BIP2315 消息会被写入系统日志。
  • 如果用户出口在执行组的活动或非活动列表中指定,则执行组无法启动并且 BIP2314 消息会被写入系统日志。
上述问题的可能原因为:
  • 除去包含用户出口库的目录从而更改了 MQSI_USER_EXIT_PATH 变量后,代理或执行组重新启动。
  • 除去包含用户出口库的目录从而更改了 userExitPath 代理属性后,代理或执行组重新启动。
  • 用户出口库(或它的某个依赖性)被除去或代理无法将其装入。

语法

参数

brokername
(必填)。代理名。
-e egName
(必填)。执行组的名称。
-f messageflow
(可选)。消息流的名称。如果已提供,则为该消息流更改用户出口。如果没有提供,则在执行组级别设置用户出口。
-a activeUserExitNames
(可选)。活动用户出口的名称列表(用冒号隔开)。这些名称是用户出口在装入时注册的名称。如果任何一个列出的用户出口未向目标执行组注册,则该命令失败,带有 BIP8858 错误。
-i inactiveUserExitNames
(可选)。

非活动用户出口的名称列表(用冒号隔开)。这些名称是用户出口在装入时注册的名称。如果任何一个列出的用户出口未向目标执行组注册,则该命令失败,带有 BIP8858 错误。

权限

调用此命令的用户标识必须具有 mqbrkrs 组权限。

响应

该命令返回下列响应:
  • BIP8852 用法语句
  • BIP80711 成功完成命令。
  • BIP8858 用户出口名称 &1 无效(其中,&1 为该命令指定的用户出口名称,但这些用户出口未在目标执行组中注册,因此无效)。

示例

在消息流级别设置活动出口
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -a exit2
BIP8071I: 命令成功完成。
在消息流级别设置非活动出口
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -i exit1
BIP8071I: 命令成功完成。
在执行组级别设置活动出口
mqsichangeflowuserexits WBRK_BROKER -e default -a exit3,exit1
BIP8071I: 命令成功完成。
在执行组级别设置非活动出口
mqsichangeflowuserexits WBRK_BROKER -e default -1 exit2
BIP8071I: 命令成功完成。
在消息流级别将 exit1 更改为非活动状态,并将 exit2 保留为活动状态(先前已发出带参数“-a exit1:exit2”的命令将两个出口都设置为活动状态)
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -i exit1 -a exit2
BIP8071I: 命令成功完成。
相关概念
建立用户出口
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an35900_