Utilisation des fichiers de propriétés de l'intégration de services

Vous pouvez utiliser des fichiers de propriétés pour créer, modifier ou supprimer des objets de bus d'intégration de services. Le bus d'intégration de services est le fournisseur de messagerie JMS (Java Message Service) par défaut du produit.

Avant de commencer

Déterminez les valeurs de propriétés à définir pour la configuration du bus d'intégration de services.

Démarrez l'outil de scriptage wsadmin. Pour démarrer wsadmin à l'aide du langage Jython, exécutez la commande wsadmin -lang Jython à partir du répertoire bin du profil de serveur.

Pourquoi et quand exécuter cette tâche

Grâce à un fichier de propriétés, vous pouvez créer, modifier ou supprimer un objet de bus d'intégration de services et ses propriétés de configuration.

Tableau 1. Actions associées aux fichiers de propriétés du bus d'intégration de services. Vous pouvez créer, modifier ou supprimer des propriétés de configuration du bus d'intégration de services.
Action Procédure
création Spécifiez commandName=createSIBus dans le fichier de propriétés. Exécutez la commande applyConfigProperties.
modify Spécifiez commandName=modifySIBus dans le fichier de propriétés. Exécutez la commande applyConfigProperties.
suppression Spécifiez commandName=deleteSIBus dans le fichier de propriétés. Exécutez la commande applyConfigProperties.
création d'une propriété Non applicable
suppression d'une propriété Non applicable

Procédure

  1. Créez, modifiez ou supprimez un objet de bus d'intégration de services.
    • Créez un objet de bus d'intégration de services.

      Ouvrez un éditeur, spécifiez commandName=createSIBus dans l'en-tête, spécifiez les propriétés du bus d'intégration de services, puis enregistrez le fichier. Vous pouvez copier la configuration du bus d'intégration de services dans le fichier de propriétés et éditer les propriétés si nécessaire.

      #
      # 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
    • Modifiez un objet de bus d'intégration de services.

      Ouvrez un éditeur, spécifiez commandName=modifySIBus dans l'en-tête, modifiez les propriétés d'intégration de services si nécessaire, puis enregistrez le fichier.

      #
      # 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
    • Supprimez un objet de bus d'intégration de services.

      Ouvrez un éditeur, spécifiez commandName=deleteSIBus dans l'en-tête, spécifiez la propriété de bus, puis enregistrez le fichier.

      #
      # Header 
      #
      CreateDeleteCommandProperties=true
      commandName=deleteSIBus
      #
      
      #
      # Properties
      #
      bus=myBus #String,required
  2. Exécutez la commande applyConfigProperties.

    L'exécution de la commande applyConfigProperties applique le fichier de propriétés à la configuration. Dans cet exemple Jython, le paramètre -reportFileName facultatif génère un rapport nommé report.txt:

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

    Vous pouvez éventuellement utiliser la commande en mode interactif :

    AdminTask.applyConfigProperties('-interactive')

Résultats

Vous pouvez utiliser le fichier de propriétés pour configurer et gérer l'objet d'intégration de services.

Exemple

Cette section contient plusieurs exemples de fichiers de propriétés qui créent, modifient ou suppriment des objets d'intégration de services. Exécutez la commande applyConfigProperties pour appliquer un fichier de propriétés.

Fichier de propriétés qui utilise la commande createSIBJMSConnectionFactory

Cet exemple crée une fabrique de connexions JMS d'intégration de services :

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

Fichier de propriétés qui utilise la commande createSIBJMSQueue

Cet exemple crée une file d'attente JMS d'intégration de services :

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

Fichier de propriétés qui utilise la commande addGroupToBusConnectorRole

Cet exemple ajoute un bus à un groupe d'intégration de services :

#
# Header
#
CreateDeleteCommandProperties=true
commandName=addGroupToBusConnectorRole
#

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

Fichier de propriétés qui utilise diverses commandes pour créer et modifier des objets d'intégration de services

Cet exemple crée et modifie des objets d'intégration de services. Vous pouvez modifier les variables d'environnement nodeName et serverName à la fin du fichier pour qu'elles correspondent à votre système. Définissez dontCreate avec la valeur false pour créer et modifier la configuration de l'intégration de services. Définissez dontDelete avec la valeur false pour supprimer la totalité de la configuration de l'intégration de services.

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

Que faire ensuite

Sauvegardez les modifications de la configuration.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_config_prop_sib
Nom du fichier : txml_config_prop_sib.html