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.

Tabelle 1. Aktionen für SIB-Eigenschaftendateien. Sie können SIB-Konfigurationseigenschaften erstellen, ändern oder 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

  1. Erstellen, ändern oder löschen Sie ein SIB-Objekt.
    • Erstellen Sie ein SIB-Objekt,

      Öffnen Sie einen Editor, geben Sie im Header commandName=createSIBus an, legen Sie die SIB-Eigenschaften fest und speichern Sie die Datei. Sie können die folgende SIB-Konfiguration in die Eigenschaftendatei kopieren und die Eigenschaften nach Bedarf bearbeiten.

      #
      # Header
      #
      CreateDeleteCommandProperties=true
      commandName=createSIBus
      #
      
      #
      # Eigenschaften
      #
      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
    • Ändern Sie ein SIB-Objekt,

      Öffnen Sie einen Editor, geben Sie im Header commandName=modifySIBus an, ändern Sie die SIB-Eigenschaften nach Bedarf und speichern Sie die Datei.

      #
      # Header
      #
      CreateDeleteCommandProperties=true
      commandName=modifySIBus
      #
      
      #
      # Eigenschaften
      #
      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
    • Löschen Sie ein SIB-Objekt,

      Öffnen Sie einen Editor, geben Sie im Header commandName=deleteSIBus an, legen Sie die Eigenschaft "bus" fest und speichern Sie die Datei.

      #
      # Header 
      #
      CreateDeleteCommandProperties=true
      commandName=deleteSIBus
      #
      
      #
      # Eigenschaften
      #
      bus=myBus #String,required
  2. Führen Sie den Befehl "applyConfigProperties" aus.

    Der Befehl "applyConfigProperties" wendet die Eigenschaftendatei auf die Konfiguration an. In diesem Beispiel für Jython erzeugt der optionale Parameter -reportFileName einen Bericht mit dem Namen report.txt:

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

    Sie können den Befehl wahlweise im Dialogmodus verwenden:

    AdminTask.applyConfigProperties('-interactive')

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 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.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_config_prop_sib
Dateiname:txml_config_prop_sib.html