Mit Eigenschaftendateien für die Serviceintegration arbeiten
Sie können Eigenschaftendateien verwenden, um SIB-Objekte (Service Integration Bus) zu erstellen, zu ändern oder zu löschen. Service Integration Bus (SIB) ist der Standard-JMS-Messaging-Provider für das Produkt (JMS = Java Message Service).
Vorbereitende Schritte
Stellen Sie fest, welche Eigenschaftswerte für die SIB-Konfiguration festgelegt werden sollen.
Starten Sie das Scripting-Tool "wsadmin". Zum Starten von "wsadmin" in der Sprache Jython führen Sie im Verzeichnis bin des Serverprofils den Befehl wsadmin -lang Jython aus.
Informationen zu diesem Vorgang
Mit einer Eigenschaftendatei können Sie ein SIB-Objekte und dessen Konfigurationseigenschaften erstellen, ändern und löschen.
Aktion | Prozedur |
---|---|
create | Legen Sie in der Eigenschaftendatei commandName=createSIBus fest. Führen Sie den Befehl "applyConfigProperties" aus. |
modify | Legen Sie in der Eigenschaftendatei commandName=modifySIBus fest. Führen Sie den Befehl "applyConfigProperties" aus. |
delete | Legen Sie in der Eigenschaftendatei commandName=deleteSIBus fest. Führen Sie den Befehl "applyConfigProperties" aus. |
create Property | Nicht zutreffend |
delete Property | Nicht zutreffend |
Vorgehensweise
Ergebnisse
Sie können die Eigenschaftendatei verwenden, um das Serviceintegrationsobjekt zu konfigurieren und zu verwalten.
Beispiel
Dieser Abschnitt enthält mehrere Beisieleigenschaftendateien, die SIB-Objekte erstellen, ändern oder löschen. Führen Sie den Befehl "applyConfigProperties" aus, um eine Eigenschaftendatei anzuwenden.
- Eigenschaftendatei mit Verwendung von "createSIBJMSConnectionFactory"
- Eigenschaftendatei mit Verwendung von "createSIBJMSQueue"
- Eigenschaftendatei mit Verwendung von "addGroupToBusConnectorRole"
- Eigenschaftendatei mit Verwendung mehrerer Befehle zum Erstellen und Ändern von SIB-Objekten
Eigenschaftendatei mit Verwendung des Befehls "createSIBJMSConnectionFactory"
In diesem Beispiel wird eine JMS-Verbindungsfactory für die Serviceintegration erstellt:
#
# Header
#
CreateDeleteCommandProperties=true
commandName=createSIBJMSConnectionFactory
#
#
# Eigenschaften
#
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
Eigenschaftendatei mit Verwendung des Befehls "createSIBJMSQueue"
In diesem Beispiel wird eine JMS-Warteschlange für die Serviceintegration erstellt:
#
# Header
#
CreateDeleteCommandProperties=true
commandName=createSIBJMSQueue
#
#
# Eigenschaften
#
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
# Zielobjekt darf weder configId oder Bereichsformat wie cell=cellName:node=nodeName:JDBCProvider=… sein
targetObject=targetObject #ObjectName,required
producerBind=null #Boolean
timeToLive=null #Long
Eigenschaftendatei mit Verwendung des Befehls "addGroupToBusConnectorRole"
In diesem Beispiel wird ein Bus einer Serviceintegrationsgruppe hinzugefügt:
#
# Header
#
CreateDeleteCommandProperties=true
commandName=addGroupToBusConnectorRole
#
#
# Eigenschaften
#
uniqueName=null #String
bus=myBus #String,required
group=mySibGroup #String,required
Eigenschaftendateien mit Verwendung mehrerer Befehle zum Erstellen und Ändern von Serviceintegrationsobjekten
In diesem Beispiel werden Serviceintegrationsobjekte erstellt und geändert. Sie können die Umgebungsvariablen nodeName und serverName am Ende der Datei so ändern, dass sie mit Ihrem System übereinstimmen. Legen Sie dontCreate den Wert false fest, um die Serviceintegrationskonfiguration zu erstellen und zu ändern. Wenn Sie die gesamte erstellte Serviceintegrationskonfiguration löschen möchten, geben Sie für dontDelete den Wert false an.
#
# SIBus erstellen
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=createSIBus
#
# Parameter
#
bus=!{sibus} #String,required
#
#
# SIBus ändern
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=modifySIBus
#
# Parameter
#
bus=!{sibus} #String,required
description="geänderte Beschreibung dieses Busses"
busSecurity=true
#
# SIBus-Member hinzufügen
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=addSIBusMember
#
#
# Parameter
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}
#
# SIBEngine ändern
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=modifySIBEngine
#
#
# Parameter
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}
#engine=single_engine // nicht erforderlich bei einzelner Engine
description="Messaging-Engine"
initialState=STOPPED
#
#
# Neues SIB-Ziel erstellen
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=createSIBDestination
#
# Parameter
#
bus=!{sibus} #String,required
name=myQueue
type=QUEUE
node=!{nodeName}
server=!{serverName}
#
#
# SIB-Ziel löschen
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBDestination
#
#
# Parameter
#
bus=!{sibus} #String,required
name=myQueue
#
#
# SIB-Engine löschen
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBEngine
#
# Parameter
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}
#engine=single_engine // nicht erforderlich bei einzelner Engine
#
#
# SIB-Busmember löschen
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=removeSIBusMember
#
#
# Parameter
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}
#
# SIBus löschen
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBus
#
#
# Parameter
#
bus=!{sibus} #String,required
#
EnvironmentVariablesSection
#
# Umgebungsvariablen
sibus=newSib
serverName=server1
nodeName=myNode05
dontDelete=true
dontCreate=false
Nächste Schritte
Speichern Sie die Änderungen in Ihrer Konfiguration.