创建 JMS 传输

要创建 JMS 传输:

  1. 在工作台左侧窗格中,展开想要与新传输相关联的节点。
  2. 展开 Enterprise(企业),右键单击 Transports(传输)图标以显示其弹出菜单,然后单击 New(新建)。
    随即显示 Create Transport(创建传输)窗口。
  3. Name(名称)框中,键入传输的唯一名称。
    JMS 传输名称长度最多为 64 个字符,可以包括字母、数字和下划线字符。不得输入无效字符。例如,不允许使用空格。不得在名称中插入空格。

  4. 单击 Type(类型)向下箭头,然后单击 JMS
    更改 Transport(传输)窗口以适应 JMS 传输。

参数选项卡

参数 描述
JMS Provider(JMS 提供商) 单击向下箭头以指定 JMS 提供商的类型:


WebSphere - SIB:此项将要求您分别在 Queue Factory(队列工厂)和 Queue Name(队列名称)字段中指定队列连接工厂 (QCF) 和队列的 JNDI 注册名称。还必须指定 SIB 消息接入点。
WebSphere - SIB Direct:此项将要求您指定 Bus Name(总线名称)和 Queue Name(队列名称)参数以及 SIB 消息接入点的值。直接访问目标队列,而无需执行 JNDI 查找。
以下选项无需指定 SIB 平台接入点的规范,因此如果选择 Endpoint Information(平台接入点信息)字段,它们将被隐藏
NetWeaver:此项将要求您分别在 Queue Factory(队列工厂)和 Queue Name(队列名称)字段中指定队列连接工厂 (QCF) 和队列的 JNDI 注册名称。
WebSphere - WMQ:使用此项访问作为 JMS 目标的 WebSphere WMQ 队列。此项要求您指定目标 WebSphere MQ 队列的队列名称。

Host(主机) 此项为 JMS 服务器的主机名或 IP 地址。此信息将由您的应用服务器管理员提供。
Port(端口) 此项为 JMS 传输将连接到的 TCP/IP 端口标识符。
Queue Factory(队列工厂) 此项为队列连接工厂的 JNDI 注册名称。此信息将由您的应用服务器管理员提供。
Bus Name(总线名称) 仅适用于 WebSphere - SIBDirect。此项为 WAS 管理员已配置为来自节点的 SIB 请求的平台接入点的 WebSphere SIB 总线名称。此信息将由您的 WAS 管理员提供。
Queue Name(队列名称) 指定目标队列的 JNDI 注册名称。传输将 JMS 消息加入此队列中。队列名称将由您的应用服务器管理员提供。
Manager(管理器) 仅适用于 WebSphere - WMQ。此项为 WebSphere MQ 管理器名称。此项将由您的 WebSphere MQ 管理员提供。
Channel(信道) 仅适用于 WebSphere - WMQ。此项为 WebSphere MQ 信道名称。此项将由您的 WebSphere MQ 管理员提供。
User(用户) 可选。指定将用于访问 JMS 服务器的用户 id。请咨询您的应用服务器管理员。
Password(密码) 可选。指定将用于访问 JMS 服务器的关联密码。请咨询您的应用服务器管理员。
Extended Attributes(扩展静态属性) 选择此按钮以指定 JMS Header Properties(JMS 标头测量值)面板。该方法在下一节有所描述。
Endpoints(平台接入点) 仅当您选择 WebSphere - SIBWebSphere - SIB Direct 作为 JMS 提供商时,此字段集才可见。
Host(主机) 此项为 WebSphere SIB 安装的主机名或 IP 地址。此信息将由您的 WAS 管理员提供。
Port(端口) 此项为 WebSphere SIB 平台接入点服务将侦听的 TCP/IP 端口标识符。此信息将由您的 WAS 管理员提供。
Defined Hosts(定义的主机) 单击 Add(添加)时,来自主机和端口的值随即添加至此框中。可以添加多个定义的主机和端口组合。
在初始化时加载传输 选择 Load transport at initialization(初始化时加载传输)复选框,使传输在节点启动后(或离开存储和转发后)立即连接到主机。

可用性

由于平台限制,以下企业网关产品不支持指示的 JMS 服务器。

  • MESInterface IT
    • NetWeaver
  • 用于 Siemens ERPC 的 deviceWISE 企业网关
    • WebSphere - SIB
    • NetWeaver

Extended Attributes(扩展静态属性)

通过选择 JMS 传输定义面板上的 Extended Attributes(扩展静态属性)按钮,可访问此面板。可指定此传输所传送的 JMS 消息的 JMS 标头测量值。此处指定的值将替代设置 JMS 提供商的客户端库的默认 JMS 标头测量值。

参数 描述
Expiration(到期) 此项为组合字段和列表框。输入值,以指定传输所传送的所有 JMS 消息的过期时间值(以秒为单位)。默认值为 Unlimited(无限制)。
Priority(优先级) 此选择列表指定此传输所传送的所有 JMS 消息的优先级。选择 0(最低)至 9(最高)之间的值。如果未指定,默认值为 4。
Correlation ID(关联 ID) 此项为此传输所传送的所有 JMS 消息中设置的关联 ID。默认值为不设置关联 ID。
Delivery Mode(传送模式) 此选择列表可用于指定传输所传送的所有 JMS 消息的 JMS 传送模式。选择 Persistent(永久)或 Non-Persistent(非永久)。如果未指定,默认值为 Persistent(永久)。
Reply Queue(回复队列) 此字段允许为传输所传送的所有 JMS 消息指定 JMSReplyToQueue 值。默认值为不指定此 JMS 标头字段。

应用定义的测量值

如果您的企业应用程序希望将用户定义的 JMS 标头测量值添加至此传输所传送的所有 JMS 消息中,请使用 Extended Attributes(扩展静态属性)面板的此部分。通过选择 Add(添加)按钮并在 New Item(新建项目)弹出面板中输入测量值信息,可一次指定一个测量值。


参数 描述
Property(测量值) 在此字段中指定 JMS 标头测量值的键值。此 JMS 标头测量值将出现在传输所传送的所有 JMS 消息中。
Type(类型) 此选择列表指定 JMS 标头测量值的数据类型。数据类型通常由使用此 JMS 消息的商业应用指定。将 JMS 标头测量值添加至此传输所传送的所有 JMS 消息中时,类型信息用于调用相应的 JMS 标头测量值资源库。
Default Value(默认值) 输入用于 JMS 标头测量值的值。在此输入的值将是此传输所传送的所有 JMS 消息中添加的 JMS 标头测量值。输入适用于指定的类型的值。如果在设置 JMS 标头测量值时发生错误,则传输将使请求失败。

测试并保存 JMS 传输

  1. 填写参数后,单击 Validate(验证)。将尝试访问应用服务器上的队列。如果未收到错误,则可以正确访问目标队列。
  2. 单击 Save(保存),将此传输写入节点。

新传输的名称已添加至 Transports(传输)选项卡中,可用于传输映射。

相关主题

超时选项卡

存储和转发选项卡

映射日志选项卡

Custom Payloads(自定义有效负载)选项卡