管理连接器

管理连接器可能包括诸如启动、暂停、停止和关闭连接器等任务。有关配置连接器(包括设置属性、受支持的业务对象和相关联的映射)的信息,请参阅 System Implementation Guide

可从系统监视器或系统管理器中启动、暂停、停止和关闭连接器,并且可在 Windows、OS/400 和 Linux 中使用脚本手工启动连接器。

一般连接器管理器脚本调用适当的 start_connector.batstart_connector.sh 脚本,该脚本处理连接器的实际连接器管理(包括关闭)。InterChange Server Express 产品为它交付的每个连接器提供了 start_connector.batstart_connector.sh 脚本。

本节包括下列主题:

查看连接器状态

启动、停止和暂停连接器

为连接器配置流量控制的步骤

在 OS/400 上更改适配器代理程序的用户概要文件的步骤

查看连接器状态

通过登录至系统监视器并打开包含连接器状态的视图,或通过使用系统管理器中的“InterChange Server 组件管理”视图,可以查看连接器的状态。要使用系统管理器,遵循连接至 InterChange Server Express 实例的步骤中的指示信息。

连接器的状态将以不同方式显示,取决于您正在使用的工具。

使用系统监视器来查看连接器状态的步骤

在系统监视器中执行下列步骤来查看连接器的状态:

  1. 登录至系统监视器(请参阅登录至系统监视器的步骤)。
  2. 如果未显示“系统概述”视图,则单击视图下的系统概述链接。出现“系统概述监视器”(请参阅图 11)。

    当安装产品时,缺省视图设置为“系统概述”,且包含在该视图中的缺省监视器设置为“系统概述”。可以更改这些缺省值以适合您的监视需要。有关指示信息,请参阅设置视图以监视系统

  3. 单击服务器名称旁边的三角形以显示系统中组件的列表。
  4. 单击正在运行的协作旁边的三角形以显示与其关联的连接器(请参阅图 25)。

    图 25. 系统监视器,显示连接器状态的“系统概述”


使用系统管理器来查看连接器状态的步骤

执行下列步骤以在系统管理器中查看连接器的状态:

  1. 连接至包含要查看的连接器的 InterChange Server Express 实例。有关连接至 InterChange Server Express 实例的指示信息,请参阅连接至 InterChange Server Express 实例的步骤
  2. 展开 InterChange Server Express 实例,然后展开“连接器”文件夹。

    连接器出现在展开的“连接器”文件夹下,具有不同颜色的灯以指示其不同状态。

    图 26. “InterChange Server 组件管理”视图中的“连接器”文件夹


表 5 列示了由每个连接器的显示颜色表示的连接器状态,并显示了在该状态期间正在执行的操作。

表 5. 连接器状态
连接器状态(颜色) 已处理预订请求 已处理服务调用请求 已处理预订传递
活动的(绿色)
暂停(黄色)
在恢复中或未知(灰色)


不活动的(红色)

启动、停止和暂停连接器

本节描述如何启动、停止和暂停连接器。

本节包括以下主题:

"连接器初始化"

启动、停止和暂停连接器的步骤

用于更改连接器状态的系统管理器命令

"在 Windows 上手工启动连接器的步骤"

在 OS/400 上手工启动连接器的步骤

在 Linux 上手工启动连接器的步骤

"关闭连接器"

"重新启动连接器"

"设置连接器的自动和远程重新启动"

将 OAD 用作 Windows 服务的步骤

连接器初始化

首次启动连接器时,必须初始化它。初始化连接器将要求您手工启动它。有关手工启动连接器的指示信息,请参阅在 Windows 上手工启动连接器的步骤

如果连接器未启动,检查以确保启动它的命令行包括当前 InterChange Server Express 名称。有关更多信息,请参阅《WebSphere Business Integration Server Express 安装指南 Windows 版》、《WebSphere Business Integration Server Express 安装指南 Linux 版》或《WebSphere Business Integration Server Express 安装指南 OS/400 版》。

启动、停止和暂停连接器的步骤

在初始化连接器之后,可以用系统监视器或系统管理器来启动、停止和暂停它。

在系统监视器中执行下列步骤来启动、停止和暂停连接器:

  1. 当查看“系统概述”视图时(请参阅图 25),通过选择连接器左边的复选框来指定连接器。
  2. 从视图的左上角中的图标组中选择“启动”、“暂停”或“停止”图标(请参阅图 27)。

图 27. 系统监视器,用于启动、暂停、重新启动或关闭组件的图标


在系统管理器中执行下列步骤来启动、停止和暂停连接器:

  1. 在系统管理器中,转至“InterChange Server 组件管理”视图中的“连接器”文件夹(请参阅图 26)。
  2. 右键单击连接器的名称,然后选择启动 ConnectorName暂停 ConnectorName停止 ConnectorName

用于更改连接器状态的系统管理器命令

以下列表描述了可以用来更改连接器状态的命令并描述了其处理操作:

启动 ConnectorName
启动已暂停或停止的所选连接器。连接器轮询应用程序,而连接器控制器则读取持久队列。将处理流。

暂停 ConnectorName
暂停正在运行或已停止的所选连接器。连接器停止轮询应用程序,而连接器控制器则停止读取新的请求,但将继续处理事件。

停止 ConnectorName
停止正在运行或已暂停的所选连接器。连接器停止轮询应用程序且未能用异常消息来发出请求。连接器控制器停止读取持久队列。将不处理流和请求。

关闭 ConnectorName
关闭选择的连接器。将停止连接器的进程。

引导 ConnectorName
重新启动选择的连接器。仅当已将连接器的 OADAutoRestartAgent 属性设置为 True 时,此操作才可用。请参阅"设置连接器的自动和远程重新启动"

在 Windows 上手工启动连接器的步骤

当安装 IBM WebSphere Business Integration Adapters 时,将在 IBM WebSphere 程序菜单上为每个安装的连接器创建快捷方式。连接器在 InterChange Server Express 资源库中定义,且在装入资源库时装入。

启动 InterChange Server Express 会自动初始化在资源库中定义的每个连接器。只要 InterChange Server Express 在运行,连接器就可供使用。

注:
要在第一次使用连接器时使它工作,必须在启动连接器之前配置它。有关配置指示信息,请参阅您正在使用的连接器的适配器指南。

执行下列其中一个步骤来启动连接器:

通过修改连接器快捷方式或 start_connector.bat 文件,可以定制每个连接器的启动。使用表 6 中列示的连接器启动参数来定制连接器的启动。-

表 6. 连接器启动参数
参数 功能
-b 导致适配器代理程序作为后台进程运行。此参数阻止代理程序尝试读取来自系统输入的“q”(退出)字符。从系统输入读取的代理程序对在 iSeries 子系统内运行的代理程序造成了性能瓶颈。
-c configFile 启动期间要使用的配置文件的名称。如果文件名指定相对路径,则启动脚本在产品的安装目录中查找该文件。仅当使用本地连接器配置文件时才需要此参数。如果不使用本地配置文件,输入 IBM WebSphere InterChange Server Express 使用的配置文件的名称(缺省情况下为 InterchangeSystem.cfg)
-c 导致当用户指定的配置文件不存在时使用缺省配置文件。
-d 指定 C++ 连接器的库文件的名称,该库文件是动态链接库(DLL)。此 DLL 名不包括 .dll 文件扩展名。启动脚本为所有 C++ 连接器指定此选项。
-f pollFrequency 轮询频率是轮询操作之间的毫秒数。
  • 要指定毫秒数,为 pollFrequency 提供一个值。
  • 要使连接器仅当您在连接器的“命令提示符”窗口中输入值 p 时才轮询,指定 -fkey 选项。
  • 如果将连接器配置为仅处理业务对象请求而不处理应用程序事件,则轮询不是必要的;您可以通过指定 -fno 来禁用轮询。

此参数的值覆盖任何资源库定义。可以指定 -fkey-fno,但不能同时指定两者。

-j 指定用 Java 编写连接器。如果指定 -l className,则此参数是可选的。
-l className 指定 Java 连接器的全局类的名称,全局类是连接器基本类的扩展。启动脚本为所有 Java 连接器指定此选项。
-n connectorName 指定要启动的连接器的名称。
-p password 指定连接器用来访问 InterChange Server Express 的密码。
-s serverName 指定服务器的名称。此参数是必需的。该名称区分大小写。
-t 打开连接器属性 SingleThreadAppCalls。此属性保证连接器框架对专用连接器代码进行的所有调用都是通过一个事件触发的流进行的。缺省值是 false。重要提示:不要更改此属性的交付值。每个连接器都具有适合其线程模型的设置。仅当启动您创建的连接器时才指定此选项。
-x connectorProps 将专用连接器属性传递至连接器。为您输入的每个值使用格式 prop_name=value

在 OS/400 上手工启动连接器的步骤

在 OS/400 上运行的连接器代理程序将以三种方法中的其中一种方法正常启动和停止。

执行下列其中一个步骤来在 OS/400 上手工启动连接器:

在 Linux 上手工启动连接器的步骤

执行下列其中一个步骤来在 Linux 上手工启动连接器:

关闭连接器

本节包括以下主题:

在系统监视器中关闭连接器的步骤

在系统管理器中关闭连接器的步骤

关闭连接器会停止连接器的进程。在关闭连接器之前,暂停或停止使用连接器的每个协作对象(必须将协作配置为暂停;请参阅协作文档以了解关于如何执行此操作的详细信息)。如果在“协作一般属性”窗口中选择了当发生关键错误时暂停复选框,则当发生关键错误时协作自动暂停。然后将这种协作的最新未处理的事件移至事件提交队列。

可以执行连接器的“永久”或“临时”关闭。通过启用或禁用(缺省值)自动重新启动,来控制关闭类型:

有关启用或禁用自动重新启动的指示信息,请参阅"设置连接器的自动和远程重新启动"

关闭连接器的指示信息取决于您要使用哪个工具来监视系统:

在系统监视器中关闭连接器的步骤

在系统监视器中执行下列步骤来关闭连接器:

  1. 从“系统概述”视图中,通过选择要关闭的连接器的协作对象左边的复选框来选择该对象,然后单击该视图的左上角中的“暂停”按钮(请参阅图 27)。对与连接器相关联的每个协作执行此操作。
  2. 选择要关闭的连接器的复选框,然后单击该视图的左上角中的“关闭”按钮(请参阅图 27)。

在系统管理器中关闭连接器的步骤

在系统管理器中执行下列步骤来关闭连接器:

  1. 展开“InterChange Server 组件管理”视图中的“协作对象”文件夹(请参阅图 30)。
  2. 右键单击与连接器相关联的协作对象并单击暂停 CollaborationName。对与连接器相关联的每个协作执行此操作。

    协作对象图标更改为带有两条垂直线的图标。

  3. 从“InterChange Server 组件管理”视图中展开的“连接器”文件夹中,右键单击连接器,然后单击关闭 ConnectorName
注意:
不要使用 Ctrl+C 或 ENDJOB CL 命令来关闭连接器。这样做会阻止连接器按顺序关闭。另外,如果您使用 Ctrl+C、ENDJOB CL 命令或者使用“q”或其它手工方法来执行关闭,且 Object Activation Daemon(OAD)处于启用状态,则 OAD 立即重新启动连接器。

重新启动连接器

在您已在系统监视器或系统管理器的“InterChange Server 组件管理”视图中使用“关闭连接器”操作之后,本节中所描述的过程重新启动连接器。仅当已对连接器启用自动和远程重新启动时,此操作才可用(请参阅设置连接器的自动和远程重新启动)。

本节包括以下主题:

使用系统监视器重新启动连接器的步骤

使用系统管理器重新启动连接器的步骤

使用系统监视器重新启动连接器的步骤

在系统监视器中执行下列步骤来重新启动连接器:

  1. 在“系统概述”视图(请参阅图 25)中,选择要重新启动的连接器左边的复选框。
  2. 单击该视图左上角中的“重新启动代理程序”按钮(请参阅图 27)。

使用系统管理器重新启动连接器的步骤

在系统管理器中执行下列步骤来重新启动连接器:

  1. 展开系统管理器的“InterChange 系统组件管理”视图中的“连接器”文件夹(请参阅图 26)。
  2. 右键单击您要重新启动的连接器,然后单击引导 ConnectorName

设置连接器的自动和远程重新启动

使用 IBM WebSphere MQ 触发的 Object Activation Daemon(OAD),您可以使连接器能够支持自动和远程重新启动功能。该功能允许连接器处理以下情况:

本节包括以下主题:

在 Windows 上设置连接器的自动和远程重新启动的步骤

在 Linux 上设置连接器的自动和远程重新启动的步骤

在 OS/400 上设置连接器的自动和远程重新启动的步骤

为 MQ 触发的 OAD 启用连接器的步骤

在 Windows 上设置连接器的自动和远程重新启动的步骤

在 Windows 平台上执行下列步骤来设置连接器的自动和远程重新启动:

  1. 安装 IBM WebSphere MQ。

    使用 MQ 触发的 OAD 要求安装 MQ 触发器监视器并配置某些队列。此监视器将作为 WebSphere MQ 软件的一部分安装。这些队列由特别的 mqtriggersetup.bat 脚本创建和配置。

    重要提示:
    WebSphere MQ 触发器监视器必须存在于连接器代理程序所驻留的机器上。如果单个机器上存在多个连接器代理程序,则仅需要存在一个 MQ 触发器监视器。
  2. 启动 MQ 触发器监视器。
    要启动 MQ 触发的 OAD,您必须启动 MQ 触发器监视器,可通过下列任一方法来执行此操作:
  3. 配置连接器的自动和远程重新启动。参阅下面的为 MQ 触发的 OAD 启用连接器的步骤
  4. 对需要重新启动的每个连接器运行 mqtriggersetup.bat 脚本(位于 bin 目录中),例如:
    mqtriggersetup.bat WebSphereICS.queue.manager JDBC WebSphereICS D:/IBM/WebSphereServer/connectors/JDBC/start_JDBC.bat

在 Linux 上设置连接器的自动和远程重新启动的步骤

在 Linux 平台上执行下列步骤来设置连接器的自动和远程重新启动:

该文件的自变量为:

例如:

mqtriggersetup 
 WebSphereICS.queue.manager 
 JDBC 
 /home/smbadmin/IBM/WebSphereItemSync/connectors/JDBC/start_JDBC.sh 
 JDBC WebSphereICS
 

在 OS/400 上设置连接器的自动和远程重新启动的步骤

在 OS/400 平台上执行下列步骤来设置连接器的自动和远程重新启动:

  1. 使用必需的自变量运行 mqtriggersetup.sh 以添加和配置队列来传送触发事件。此文件位于产品安装的目录中,例如,/QIBM/ProdData/WBIServer43/bin。该文件的自变量为:

    例如:

    mqtriggersetup.sh 
     InstanceName.QUEUE.MANAGER 
     JDBC 
     /QIBM/UserData/WBIServer43/QWBIDFT/connectors/JDBC/start_JDBC.sh 
     InstanceName 
     QWBIJDBCC 
     

    其中 InstanceName 是 InterChange Server Express 实例的名称,以大写字母输入。

  2. 启用 WebSphere MQ 触发器监视器。例如:
    STRMQMTRM INITQNAME(INITIATION.QUEUE)
     MQMNAME(InstanceName.QUEUE.MANAGER)
     

    其中 InstanceName 是 InterChange Server Express 实例的名称,以大写字母输入。

  3. 对 QMQM 用户概要文件授予对以下对象的 *USE 权限:
    适配器的作业描述(*JOBD)(例如,对于 JDBC 为 QWBISVR43/QWBIJDBCC)

为 MQ 触发的 OAD 启用连接器的步骤

在设置 OAD 属性之前,执行下列步骤来为连接器启动连接器配置器易捷版:

  1. 启动 InterChange Server Express。
  2. 打开系统管理器。
  3. 在“集成组件库”下双击连接器。这将打开连接器配置器易捷版。
  4. 在“标准属性”选项卡中,设置表 7 中所显示的标准属性。


    表 7. 在连接器配置器易捷版中配置标准属性
    名称 可能的值 描述 缺省值
    OADAutoRestartAgent truefalse 如果此属性设置为 true,则 MQ 触发的 OAD 将在异常关闭之后自动尝试重新启动连接器。它还可以用于以远程方式启动连接器代理程序。此值是动态的。 false
    OADMaxNumRetry 数目 最大尝试次数。 10,000
    OADRetryTimeInterval 分钟数 每次重试之间的分钟数。如果连接器代理程序未在此时间间隔内启动,则将再次尝试重新启动代理程序。 10

从连接器配置器易捷版中,可执行以下任何操作:

将 OAD 用作 Windows 服务的步骤

注:
此主题仅适用于 Windows 平台。

如果您正在配置连接器以便使用 OAD 自动重新启动或远程启动,则不要将连接器配置为作为自动 Windows 服务运行。相反,应安装 WebSphere MQ 触发器监视器来作为 Windows 服务运行。当系统启动时,OAD 自动作为 Windows 服务启动;当 InterChange Server Express 重新启动时,它通过 OAD 启动连接器。

重要提示:
缺省情况下,将安装连接器作为需要手工启动的 Windows 服务。如果连接器的 Windows 服务从手工更改为自动,则远程重新启动功能无效。

执行下列步骤来作为 Windows 服务安装 WebSphere MQ 触发器监视器:

  1. 选择开始 > 程序 > IBM WebSphere MQ > WebSphere MQ Services
  2. 右键单击 WebSphere Business Integration Server Express 正在使用的队列管理器,并单击新建 > 触发器监视器。出现“创建触发器监视器服务”对话框。
  3. 单击参数选项卡。在队列名称字段中,输入字符串“INITIATION.QUEUE”。在描述列中,触发器监视器显示为队列管理器的一个服务。
  4. 运行“Windows 服务设置”工具。在服务组件列表中选择 InterChange Server Express
  5. 服务相关性字段中,输入 OAD Windows 服务的名称。

在完成这些步骤之后,您可以使用 Windows 中的“服务”工具来启动和停止该守护进程。

为连接器配置流量控制的步骤

流量控制是一个可配置的服务,它允许您管理连接器和协作对象队列的流。用于配置流量控制的参数可以是系统范围的和/或针对各个组件的。如果两者都配置了,则单个组件配置取代系统范围配置。有关在系统范围配置流量控制的指示信息,请参阅配置系统范围流量控制的步骤。本节描述如何配置连接器的流量控制。

注:
各个连接器或协作对象的配置更改是动态的,这意味着它们不需要重新引导 InterChange Server Express。流量控制的系统范围配置更改要求重新引导 InterChange Server Express。

要监视流量控制在系统中的工作方式,可查看作为系统监视器一部分提供的“流量控制”监视器和视图,也可在系统管理器的“InterChange Server 组件管理”视图中查看协作对象或连接器的“统计信息”。有关在系统监视器中使用“流量控制”监视器和视图的更多信息,请参阅查看缺省监视器的步骤使用缺省视图的步骤。有关从“InterChange Server 组件管理”视图中查看流量控制的更多信息,请参阅查看协作对象统计信息的步骤查看连接器统计信息的步骤

执行下列步骤来为连接器配置流量控制:

  1. 在系统管理器中,浏览至要为其配置流量控制的连接器,然后双击该连接器。连接器配置器易捷版打开(请参阅图 28)。

    图 28. 连接器配置器易捷版,“标准属性”选项卡


  2. 在“标准属性”选项卡中,单击 MaxEventCapacity 属性的单元。
  3. 将值更改为您想要对某一连接器进行排队的最大事件数。此属性的值的有效范围为 1 至 2147483647。
  4. 单击文件 > 保存 > 至项目。以下消息出现在连接器配置器易捷版的底部:已成功保存连接器“ConnectorName”。

在 OS/400 上更改适配器代理程序的用户概要文件的步骤

缺省情况下,OS/400 上的适配器代理程序在 QWBISVR43 用户概要文件下运行。因此,此用户概要文件必须具有读取和可能更新应用程序信息的权限。如果您不能对概要文件 QWBISVR43 授予此权限,则您可以更改用于适配器代理程序进程的用户概要文件。

执行下列步骤来更改适配器代理程序进程的用户概要文件:

  1. 使用如下的 CHGJOBD CL 命令更改适配器代理程序的作业描述:
    CHGJOBD JOBD(QWBISVR43/jobdname) USER(newid)
    其中 jobdname 是适配器代理程序的作业描述的名称,newid 是您想要在其下运行适配器代理程序的用户概要文件。newid 用户概要文件应该已具有对应用程序信息的权限。
  2. 使用以下 CL 命令为您的用户概要文件授予对适配器作业描述的权限:
    GRTOBJAUT OBJ(QWBISVR43/jobdname) OBJTYPE(*JOBD) USER(newid)
    其中 jobdname 是适配器代理程序的作业描述的名称,newid 是您想要在其下运行适配器代理程序的用户概要文件。
  3. 使用以下 CL 命令为您的用户概要文件授予对 QWBISVR43 库的权限:
    GRTOBJAUT OBJ(QWBISVR43) OBJTYPE(*LIB) USER(newid)
    其中 newid 是您想要在其下运行适配器代理程序的用户概要文件。
  4. 使用以下 CL 命令为您的用户概要文件授予对 QWBISVR43 子系统描述的权限:
    GRTOBJAUT OBJ(QWBISVR43/QWBISVR43) OBJTYPE(*JOBD) USER(newid)
    其中 newid 是您想要在其下运行适配器代理程序的用户概要文件。
  5. 使用以下 CL 命令为您的用户概要文件授予对 QWBISVR43 库中 QWBISVR43 类的权限:
    GRTOBJAUT OBJ(QWBISVR43/QWBISVR43) OBJTYPE(*CLS) USER(newid)
    其中 newid 是您想要在其下运行适配器代理程序的用户概要文件。
  6. 使用下列 CL 命令来为您的用户概要文件授予对适配器启动脚本所在的连接器目录的权限:
    CHGAUT OBJ('/pathToStartupScript') USER(newid) DTAAUT(*RWX)
    其中 pathToStartupScript 是适配器的启动脚本的路径,newid 是您想要在其下运行适配器代理程序的用户概要文件。

Copyright IBM Corp. 2004