设置配置文件属性

当创建并命名新的连接器配置文件时,或当打开现有的连接器配置文件时,连接器配置器显示一个配置屏幕以及必需配置值类别的选项卡。

连接器配置器要求以下类别的属性具有值以便连接器在所有代理程序上运行:

注:
对于使用 JMS 消息传递的连接器,为了配置将数据转换为业务对象的数据处理程序,可能会显示额外的类别。

对于在 ICS 上运行的连接器,以下属性的值也是必需的:

重要提示:
连接器配置器接受使用英语或非英语字符集的属性值。但是,标准的和特定于连接器的属性的名称以及受支持的业务对象的名称都必须只使用英语字符集。

标准属性与特定于连接器的属性不同,如下所示:

标准属性特定于连接器的属性的字段是用颜色编码的,以显示哪些字段是可配置的:

设置标准连接器属性

要更改标准属性的值:

  1. 单击您要设置其值的字段。
  2. 输入一个值,或从下拉菜单(如果它出现的话)选择一个值。
  3. 在为标准属性输入所有值之后,您可以执行以下其中一项操作:

要获取有关特定标准属性的更多信息,将鼠标移至“标准属性”选项卡式页面中该属性的“描述”列中的条目上。如果您安装了“扩展帮助”,则会打开一个“帮助”窗口并显示标准属性的详细信息。

有关“扩展帮助”文件的位置,参阅『标准属性』附录中的 AdapterHelpName 属性。

设置特定于连接器的配置属性

对于特定于连接器的配置属性,您可以添加或更改属性名、配置值、删除属性和对属性进行加密。缺省属性长度为 255 个字符。

  1. 右键单击网格的左上部。将出现弹出菜单栏。单击添加以添加属性。要添加子属性,右键单击父行号并单击添加子代
  2. 为属性或子属性输入值。
  3. 要对属性进行加密,选择加密框。
  4. 选择保存或废弃更改,如设置标准连接器属性所述。

对每个属性显示的“更新方法”指示激活更改的值是否需要重新启动组件或代理程序。

重要提示:
更改预先设置的特定于应用程序的连接器属性名可能导致连接器发生故障。连接器可能需要某些属性名才能连接至应用程序或正确地运行。

连接器属性的加密

可以通过在“特定于连接器的属性”窗口中选择加密复选框来加密特定于应用程序的属性。要将值解密,单击以清除加密复选框,并在验证对话框中输入正确的值,然后单击确定。如果输入的值是正确的,则将解密并显示该值。

每个连接器的适配器用户指南都包含每个属性及其缺省值的列表和描述。

如果属性具有多个值,则加密复选框将对属性的第一个值显示。当您选择加密时,将对属性的所有值进行加密。要将属性的多个值解密,单击以对属性的第一个值清除加密复选框,然后在验证对话框中输入新的值。如果输入值是匹配的,则多个值将全部解密。

更新方法

参阅更新方法的描述,可以在连接器的标准配置属性附录的配置属性值概述中找到这些描述。

指定受支持的业务对象定义

使用“连接器配置器”中的受支持的业务对象选项卡来指定连接器将使用的业务对象。您必须指定通用业务对象和特定于应用程序的业务对象,并且您必须指定这些业务对象之间的映射关联。

注:
有些连接器要求将某些业务对象指定为受支持的,以便执行事件通知或对其应用程序进行额外配置(使用元对象)。有关更多信息,请参阅 Connector Development Guide for C++Connector Development Guide for Java

如果 ICS 是代理程序

要指定业务对象定义受连接器支持,或更改现有业务对象定义的支持设置,单击受支持的业务对象选项卡并使用以下字段。

业务对象名

在系统管理器正在运行的情况下,要指定业务对象定义受连接器支持:

  1. 业务对象名列表中单击一个空字段。将显示一个下拉列表,显示出“系统管理器”项目中存在的所有业务对象定义。
  2. 单击一个业务对象以添加它。
  3. 为该业务对象设置代理程序支持(将在下面描述)。
  4. 在“连接器配置器”窗口的“文件”菜单中,单击保存至项目。修改的连接器定义(包括为添加的业务对象定义指定的支持)将保存至系统管理器中的 ICL(集成组件库)项目。

要从受支持的列表删除业务对象:

  1. 要选择业务对象字段,单击业务对象左边的数字。
  2. 从“连接器配置器”窗口的编辑菜单,单击删除行。将从列表屏幕除去该业务对象。
  3. 文件菜单,单击保存至项目

从受支持的列表删除业务对象将更改连接器定义,并使删除的业务对象不可用于此连接器的此实现。它不会影响连接器代码,它也不会从系统管理器除去业务对象定义。

代理程序支持

如果某个业务对象具有代理程序支持,则系统将尝试使用该业务对象以通过连接器代理程序将数据传递至应用程序。

通常,连接器的特定于应用程序的业务对象受该连接器的代理程序支持,但通用业务对象则不受支持。

要指示该业务对象是否受连接器代理程序支持,选择代理程序支持框。“连接器配置器”窗口不验证您的代理程序支持选择。

最大事务级别

连接器的最大事务级别是该连接器支持的最高事务级别。

对于大多数连接器,最大努力是唯一可能的选项。

您必须重新启动服务器以便事务级别的更改生效。

如果 WebSphere Message Broker 是您的代理程序

如果您以独立方式工作(未连接至系统管理器),则您必须手工输入业务对象名。

如果您已在运行系统管理器,则您可以选择受支持的业务对象选项卡中业务对象名列之下的空框。出现一个组合框,显示可从连接器所属的“集成组件库”项目获得的业务对象列表。从该列表选择您需要的业务对象。

消息集标识是 WebSphere Business Integration Message Broker 5.0 的可选字段,如果提供该标识,则它不必是唯一的。但是,对于 WebSphere MQ Integrator 和 Integrator Broker 2.1,您必须提供唯一标识

如果 WAS 是代理程序

当选择 WebSphere Application Server 作为代理程序类型时,连接器配置器不需要消息集标识。受支持的业务对象选项卡仅对受支持的业务对象显示业务对象名列。

如果您以独立方式工作(未连接至系统管理器),则您必须手工输入业务对象名。

如果您已在运行系统管理器,则您可以选择“受支持的业务对象”选项卡中“业务对象名”列之下的空框。出现一个组合框,显示可从连接器所属的“集成组件库”项目获得的业务对象列表。从此列表选择您需要的业务对象。

相关映射(ICS)

每个连接器都支持业务对象定义列表及这些定义在 WebSphere InterChange Server 中当前活动的相关映射。在您选择相关映射选项卡时将出现此列表。

业务对象列表包含代理程序支持的特定于应用程序的业务对象和控制器发送至预订协作的相应通用对象。映射的关联确定哪个映射用来将特定于应用程序的业务对象转换为通用业务对象,或将通用业务对象转换为特定于应用程序的业务对象。

如果您正在使用为特定的源业务对象和目标业务对象唯一地定义的映射,则当您打开该屏幕时,这些映射将已经与其适当的业务对象相关,您将不需要(或无法)更改它们。

如果多个映射可供受支持的业务对象使用,则您将需要显式地将该业务对象与它应该使用的映射绑定在一起。

相关映射选项卡显示以下字段:

资源(ICS)

资源选项卡允许您设置一个值,用于确定连接器代理程序是否将使用连接器代理程序来同时处理多个进程以及达到的处理程度。

并非所有连接器都支持此功能。如果您要运行在 Java 中旨在用于多线程的连接器代理程序,则建议您不要使用此功能,因为使用多线程通常比使用多进程更有效。

消息传递(ICS)

消息传递选项卡使您能够配置消息传递属性。仅当您已将 MQ 设置为 DeliveryTransport 标准属性的值并将 ICS 设置为代理程序类型时,消息传递属性才可用。这些属性影响连接器将如何使用队列。

验证消息传递队列

在可以验证消息传递队列之前,您必须执行以下操作:

要验证队列,使用“消息传递”选项卡上的“消息传递类型”和“主机名”字段右边的“验证”按钮。

安全性级别(ICS)

可以使用“连接器配置器”中的安全性选项卡来为消息设置各种隐私级别。仅当 DeliveryTransport 属性设置为 JMS 时才能使用此功能。

缺省情况下,“隐私”是关闭的。选择隐私框以启用它。

密钥库目标系统绝对路径名为:

此路径和文件应该与连接器配置器在同一系统上。

仅当目标系统是当前正在运行的系统时,您才能使用右边的“浏览”按钮。除非启用了隐私,并且菜单栏中的目标系统设置为 Windows,否则“浏览”按钮将变灰。

对于三种消息类别(“所有消息”、“所有管理消息”和“所有业务对象消息”),可以按如下所示设置消息隐私级别

密钥维护功能允许您为服务器和适配器生成、导入和导出公用密钥。

在可以将证书导入适配器密钥库之前,必须从服务器密钥库中导出它。当您选择导出适配器公用密钥时,将出现“导出适配器公用密钥”对话框。

当您选择导入适配器公用密钥时,将出现“导入适配器公用密钥”对话框。

仅当 DeliveryTransport 的值为 IDL 时,才会启用适配器访问控制功能。缺省情况下,适配器使用 guest 标识登录。如果未选择使用 guest 标识框,则会启用适配器标识适配器密码字段。

设置跟踪/日志文件值

当您打开连接器配置文件或连接器定义文件时,连接器配置器使用该文件的日志和跟踪值作为缺省值。您可以在连接器配置器中更改那些值。

要更改日志和跟踪值:

  1. 单击跟踪/日志文件选项卡。
  2. 对于日志记录或跟踪,您可以选择将消息写入以下其中一项或全部:

数据处理程序

仅当为 DeliveryTransport 指定了值 JMS 并且为 ContainerManagedEvents 指定了值 JMS 时,数据处理程序节才可用于配置。并非所有适配器都使用数据处理程序。

请参阅“附录 A,标准属性”中的 ContainerManagedEvents 下的描述以获取要用于这些属性的值。有关其它详细信息,请参阅 Connector Development Guide for C++Connector Development Guide for Java

Copyright IBM Corp. 1997, 2004