Trabajo con archivos de propiedades de integración de servicios

Puede utilizar archivos de propiedades para crear, modificar o suprimir objetos del bus de integración de servicios. El bus de integración de servicios es el proveedor de mensajería JMS (Java Message Service) predeterminado para el producto.

Antes de empezar

Determine los valores de propiedades que desea establecer para la configuración del bus de integración de servicios.

Inicie la herramienta de scripts wsadmin. Para iniciar wsadmin utilizando el lenguaje Jython, ejecute el mandato wsadmin -lang Jython desde el directorio bin del perfil del servidor.

Acerca de esta tarea

Utilizando un archivo de propiedades, puede crear, modificar o suprimir un objeto del bus de integración de servicios y sus propiedades de configuración.

Tabla 1. Acciones para los archivos de propiedades del bus de integración de servicios. Puede crear, cambiar o suprimir propiedades de configuración del bus de integración de servicios.
Acción Procedimiento
crear Especifique commandName=createSIBus en el archivo de propiedades. Ejecute el mandato applyConfigProperties.
modify Especifique commandName=modifySIBus en el archivo de propiedades. Ejecute el mandato applyConfigProperties.
delete Especifique commandName=deleteSIBus en el archivo de propiedades. Ejecute el mandato applyConfigProperties.
crear Propiedad No se aplica
suprimir Propiedad No se aplica

Procedimiento

  1. Crear modificar o suprimir un objeto del bus de integración de servicios.
    • Cree un objeto del bus de integración de servicios.

      Abra un editor, especifique commandName=createSIBus en la sección header, especifique las propiedades del bus de integración de servicios y guarde el archivo. Puede copiar la configuración del bus de integración de servicios siguiente en el archivo de propiedades y editar las propiedades según sea necesario.

      #
      # 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
    • Modificar un objeto del bus de integración de servicios.

      Abra un editor, especifique commandName=modifySIBus en la sección header, modifique las propiedades del bus de integración de servicios, según sea necesario, y guarde el archivo.

      #
      # 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
    • Suprima un objeto del bus de integración de servicios.

      Abra un editor, especifique commandName=deleteSIBus en la sección header, especifique la propiedad bus y guarde el archivo.

      #
      # Header 
      #
      CreateDeleteCommandProperties=true
      commandName=deleteSIBus
      #
      
      #
      # Properties
      #
      bus=myBus #String,required
  2. Ejecute el mandato applyConfigProperties.

    La ejecución del mandato applyConfigProperties aplica el archivo de propiedades a la configuración. En este ejemplo de Jython, el parámetro opcional -reportFileName produce un informe llamado report.txt:

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

    Opcionalmente, puede utilizar el mandato en modalidad interactiva:

    AdminTask.applyConfigProperties('-interactive')

Resultados

Puede utilizar el archivo de propiedades para configurar y gestionar el objeto del bus de integración de servicios.

Ejemplo

Esta sección contiene varios archivos de propiedades de ejemplo que crean, modifican o suprimen objetos del bus de integración de servicios. Ejecute el mandato applyConfigProperties para aplicar un archivo de propiedades.

Archivo de propiedades que utiliza el mandato createSIBJMSConnectionFactory

Este ejemplo crea una fábrica de conexiones JMS de integración de servicios:

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

Archivo de propiedades que utiliza el mandato createSIBJMSQueue

Este ejemplo crea una cola JMS de integración de servicios:

#
# Header
#
CreateDeleteCommandProperties=true
commandName=createSIBJMSQueue
#

#
# Properties
#
name=mySIBJmsQ #String,required
aueueName=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

Archivo de propiedades que utiliza el mandato addGroupToBusConnectorRole

Este ejemplo añade un bus a un grupo de integración de servicios:

#
# Header
#
CreateDeleteCommandProperties=true
commandName=addGroupToBusConnectorRole
#

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

Archivo de propiedades que utiliza muchos mandatos para crear y modificar objetos de integración de servicios

Este ejemplo crea y modifica objetos de integración de servicios. Puede cambiar las variables de entorno nodeName y serverName al final del archivo para que coincidan con su sistema. Establezca dontCreate en false para crear y modificar la configuración de integración de servicios. Establezca dontDelete en false para suprimir toda la configuración de integración de servicios creada.

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

#
# Añadir miembro SIBus
#
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 // no es necesario si es un solo motor

description="message engine"
initialState=STOPPED
#

#
# Crear nuevo destino de SIB
#
CreateDeleteCommandProperties=true
SKIP=!{dontCreate}
commandName=createSIBDestination 

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

#
# Suprimir destino de SIB
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBDestination 
#

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

#
# Suprimir motor de SIB
#
CreateDeleteCommandProperties=true
SKIP=!{dontDelete}
commandName=deleteSIBEngine 

#
# parameters
#
bus=!{sibus} #String,required
node=!{nodeName}
server=!{serverName}
#engine=single_engine // no es necesario si es un solo motor
#

#
# Suprimir miembro de bus SIB
#
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

Qué hacer a continuación

Guarde los cambios en la configuración.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_config_prop_sib
File name: txml_config_prop_sib.html