使用服务集成属性文件

您可以使用属性文件来创建、修改或删除服务集成总线对象。服务集成总线是产品的缺省 Java 消息服务 (JMS) 消息传递提供程序。

开始之前

确定您要为服务集成总线配置设置的属性值。

启动 wsadmin 脚本编制工具。要使用 Jython 语言来启动 wsadmin,请从服务器概要文件的 bin 目录运行 wsadmin -lang Jython 命令。

关于此任务

您可以使用属性文件来创建、修改或删除服务集成总线对象及其配置属性。

表 1. 服务集成总线属性文件的操作. 您可以创建、更改或删除服务集成总线配置属性。
操作 过程
create 在属性文件中指定 commandName=createSIBus。运行 applyConfigProperties 命令。
modify 在属性文件中指定 commandName=modifySIBus。运行 applyConfigProperties 命令。
delete 在属性文件中指定 commandName=deleteSIBus。运行 applyConfigProperties 命令。
create Property 不适用
delete Property 不适用

过程

  1. 创建、修改或删除服务集成总线对象。
    • 创建服务集成总线对象。

      打开编辑器,在头中指定 commandName=createSIBus,指定服务集成总线属性,然后保存文件。您可以将以下服务集成总线配置复制到属性文件,然后根据需要编辑属性。

      #
      # Header
      #
      CreateDeleteCommandProperties=true
      commandName=createSIBus
      #
      
      #
      # Properties
      #
      secure=null #Boolean
      useServerIdForMediations=null #Boolean
      interEngineAuthAlias=null #String
      auditAllowed=null #Boolean
      discardOnDelete=null #Boolean
      scriptCompatibility=null #String
      mediationsAuthAlias=null #String
      busSecurity=null #Boolean
      highMessageThreshold=null #Long
      bus=myBus #String,required
      configurationReloadEnabled=null #Boolean
      securityGroupCacheTimeout=null #Long
      bootstrapPolicy=null #String
      description=null #String
      protocol=null #String
    • 修改服务集成总线对象。

      打开编辑器,在头中指定 commandName=modifySIBus,根据需要更改服务集成属性,然后保存文件。

      #
      # Header
      #
      CreateDeleteCommandProperties=true
      commandName=modifySIBus
      #
      
      #
      # Properties
      #
      secure=null #Boolean
      useServerIdForMediations=null #Boolean
      interEngineAuthAlias=null #String
      auditAllowed=null #Boolean
      discardOnDelete=null #Boolean
      mediationsAuthAlias=null #String
      busSecurity=null #Boolean
      highMessageThreshold=null #Long
      bus=myBus #String,required
      configurationReloadEnabled=null #Boolean
      securityGroupCacheTimeout=null #Long
      bootstrapPolicy=null #String
      permittedChains=null #String
      description=null #String
      protocol=null #String
    • 删除服务集成总线对象。

      打开编辑器,在头中指定 commandName=deleteSIBus,指定总线属性,然后保存文件。

      #
      # Header 
      #
      CreateDeleteCommandProperties=true
      commandName=deleteSIBus
      #
      
      #
      # Properties
      #
      bus=myBus #String,required
  2. 运行 applyConfigProperties 命令。

    运行 applyConfigProperties 命令会将属性文件应用于配置。在此 Jython 示例中,可选的 -reportFileName 参数生成名为 report.txt 的报告:

    AdminTask.applyConfigProperties(['-propertiesFileName mySIBus.props -reportFileName report.txt '])

    您可以选择以交互方式使用该命令:

    AdminTask.applyConfigProperties('-interactive')

结果

您可以使用属性文件来配置和管理服务集成对象。

示例

此部分包含若干属性文件示例,其创建、修改或删除服务集成对象。运行 applyConfigProperties 命令来应用属性文件。

使用 createSIBJMSConnectionFactory 命令的属性文件

此示例创建服务集成 JMS 连接工厂:

#
# Header
#
CreateDeleteCommandProperties=true
commandName=createSIBJMSConnectionFactory
#

#
# Properties
#
logMissingTransactionContext=null #Boolean
password=null #String
readAhead=null #String
type=null #String
tempQueueNamePrefix=null #String
shareDurableSubscriptions=null #String
durableSubscriptionHome=null #String
targetTransportChain=null #String
authDataAlias=null #String
userName=null #String
targetSignificance=null #String
shareDataSourceWithCMP=null #Boolean
providerEndPoints=null #String
persistentMapping=null #String
nonPersistentMapping=null #String
jndiName=mySIBJndiName #String,required
clientID=null #String
targetObject=targetObject #null,required
manageCachedHandles=null #Boolean
consumerDoesNotModifyPayloadAfterGet=null #String
category=null #String
targetType=null #String
busName=myBus #String,required
description=null #String
xaRecoveryAuthAlias=null #String
containerAuthAlias=null #String
mappingAlias=null #String
producerDoesNotModifyPayloadAfterSet=null #String
tempTopicNamePrefix=null #String
connectionProximity=null #String
target=null #String
name=mySIBJmsCF #String,required

使用 createSIBJMSQueue 命令的属性文件

此示例创建服务集成 JMS 队列:

#
# Header
#
CreateDeleteCommandProperties=true
commandName=createSIBJMSQueue
#

#
# Properties
#
name=mySIBJmsQ #String,required
queueName=mySIBJmsQ #String,required
producerPreferLocal=null #Boolean
jndiName=mySIBQJndiName #String,required
readAhead=null #String
busName=myBus #String
priority=null #Integer
gatherMessages=null #Boolean
scopeToLocalQP=null #Boolean
deliveryMode=null #String
description=null #String
# target object can be either configId or scope format such as cell=cellName:node=nodeName:JDBCProvider=…
targetObject=targetObject #ObjectName,required
producerBind=null #Boolean 
timeToLive=null #Long

使用 addGroupToBusConnectorRole 命令的属性文件

此示例将总线添加到服务集成组:

#
# Header
#
CreateDeleteCommandProperties=true
commandName=addGroupToBusConnectorRole
#

#
# Properties
#
uniqueName=null #String
bus=myBus #String,required
group=mySibGroup #String,required

使用许多命令来创建和修改服务集成对象的属性文件

此示例创建和修改服务集成对象。您可以在文件末尾更改环境变量 nodeNameserverName 以匹配您的系统。将 dontCreate 设置为 false 以创建和修改服务集成配置。将 dontDelete 设置为 false 以删除所有创建的服务集成配置。

#
# Create SIBus
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=createSIBus

#
# parameters
#
bus=!{sibus} #String,required
#

#
# Modify SIBus
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=modifySIBus

#
# parameters
#
bus=!{sibus} #String,required
description="modified description of this bus"
busSecurity=true

#
# Add SIBus Member
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=addSIBusMember
#

#
# parameters
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}

#
# Modify SIBEngine
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=modifySIBEngine 
#

#
# parameters
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}
#engine=single_engine // not required if single engine

description="message engine"
initialState=STOPPED
#

#
# Create new SIB Destination
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=createSIBDestination 

#
# parameters
#
bus=!{sibus} #String,required
name=myQueue
type=QUEUE
node=!{nodeName}
server=!{serverName}
#

#
# Delete SIB Destination
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBDestination 
#

#
# parameters
#
bus=!{sibus} #String,required
name=myQueue
#

#
# Delete SIB Engine
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBEngine 

#
# parameters
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}
#engine=single_engine // not required if single engine
#

#
# Delete SIB Bus Member
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=removeSIBusMember
#

#
# parameters
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}

#
# Delete SIBus
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBus
#

#
# parameters
#
bus=!{sibus} #String,required
#

EnvironmentVariablesSection
#
#  Environment Variables
sibus=newSib
serverName=server1
nodeName=myNode05
dontDelete=true
dontCreate=false

下一步做什么

将更改保存到配置。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_config_prop_sib
文件名:txml_config_prop_sib.html