Working with service integration properties files
You can use properties files to create, modify, or delete service integration bus objects. Service integration bus is the default Java Message Service (JMS) messaging provider for the product.
Before you begin
Determine the property values that you want to set for the service integration bus configuration.
Start the wsadmin scripting tool. To start wsadmin using the Jython language, run the wsadmin -lang Jython command from the bin directory of the server profile.
About this task
Using a properties file, you can create, modify, or delete a service integration bus object and its configuration properties.
Action | Procedure |
---|---|
create | Specify commandName=createSIBus in the properties file. Run the applyConfigProperties command. |
modify | Specify commandName=modifySIBus in the properties file. Run the applyConfigProperties command. |
delete | Specify commandName=deleteSIBus in the properties file. Run the applyConfigProperties command. |
create Property | Not applicable |
delete Property | Not applicable |
Procedure
Results
You can use the properties file to configure and manage the service integration object.
Example
This section contains several example properties files that create, modify, or delete service integration objects. Run the applyConfigProperties command to apply a properties file.
- Properties file that uses createSIBJMSConnectionFactory
- Properties file that uses createSIBJMSQueue
- Properties file that uses addGroupToBusConnectorRole
- Properties file that uses many commands to create and modify SIB objects
Properties file that uses the createSIBJMSConnectionFactory command
This example creates a service integration JMS connection factory:
#
# 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
Properties file that uses the createSIBJMSQueue command
This example creates a service integration JMS queue:
#
# 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
Properties file that uses the addGroupToBusConnectorRole command
This example adds a bus to a service integration group:
#
# Header
#
CreateDeleteCommandProperties=true
commandName=addGroupToBusConnectorRole
#
#
# Properties
#
uniqueName=null #String
bus=myBus #String,required
group=mySibGroup #String,required
Properties file that uses many commands to create and modify service integration objects
This example creates and modifies service integration objects. You can change the Environment Variables nodeName and serverName at the end of the file to match your system. Set dontCreate to false to create and modify the service integration configuration. Set dontDelete to false to delete all the created service integration configuration.
#
# 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
What to do next
Save the changes to your configuration.