Mandato addSIBusMember

Utilice el mandato addSIBusMember para añadir un miembro a un bus de integración de servicios utilizando la herramienta wsadmin. Un miembro de bus puede ser un servidor de aplicaciones, un servidor WebSphere MQ o un clúster de servidores.

Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.

[IBM i][IBM i]El cliente de scripts wsadmin se ejecuta desde Qshell. [IBM i]Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.

Para los mandatos del bus de integración de servicios se proporciona ayuda de línea de mandatos:
  • Si desea una lista de los mandatos disponibles del bus de integración de servicios en Jyton y una breve descripción de cada mandato, especifique el mandato siguiente en el indicador de wsadmin:

    print AdminTask.help('SIBAdminCommands')

  • Si desea ayuda general sobre un mandato determinado, especifique el mandato siguiente en el indicador de wsadmin:

    print AdminTask.help('nombre_mandato')

Después de utilizar el mandato, guarde los cambios en la configuración maestra utilizando el mandato siguiente:

AdminConfig.save()

Objetivo

El mandato addSIBusMember añade un nuevo miembro a un bus de integración de servicios. Cuando un servidor de aplicaciones se añade como miembro de un bus, se crea automáticamente un motor de mensajería con los valores predeterminados.

Cuando un clúster se añade como miembro de un bus, si la asistencia para la política del motor de mensajería no está habilitada, se crea automáticamente un motor de mensajería con los valores predeterminados. Para crear un motor de mensajería adicional para un miembro del bus, utilice el mandato createSIBEngine.

Cuando un clúster se añade a un bus, si la asistencia para la política del motor de mensajería está habilitada y se especifica el tipo de política de motor de mensajería de alta disponibilidad, se crea automáticamente un motor de mensajería con valores que dan soporte a la política de alta disponibilidad.

Cuando un clúster se añade a un bus, si se especifica la asistencia para la política del motor de mensajería está habilitada y la escalabilidad o escalabilidad con alta disponibilidad, tipo de política de motor de mensajería, se crea automáticamente un motor de mensajería con valores que dan soporte a la política seleccionada. Entonces deberá utilizar el mandato createSIBEngine para crear motores de mensajería adicionales (uno para cada servidor de aplicaciones del clúster). Para cada nuevo motor de mensajería, se crean automáticamente los valores que dan soporte a la política seleccionada.

Si utiliza el mandato addSIBusMember con la asistencia para la política del motor de mensajería habilitada y se ha especificado el tipo de política de motor de mensajería personalizado, puede establecer el comportamiento para el primer motor de mensajería y, a continuación, utilice el mandato createSIBEngine para crear motores de mensajería adicionales.

Cuando se añade un servidor WebSphere MQ como un miembro de un bus, se crea un servidor proxy que puede alterar temporalmente las propiedades de la conexión padre (host, puerto, canal y alias de configuración de seguridad SSL) definidas en el servidor WebSphere MQ. Gracias a ello se podrá asignar un conjunto diferente de propiedades de conexión a cada miembro del bus.

Objeto de destino

Ninguno.

Se crea un objeto de miembro de bus. Si el miembro de bus es un servidor o un clúster de servidores, también se crea un motor de mensajería.

Parámetros necesarios

-bus nombre_bus
El nombre mediante el que se conoce el bus de integración de servicios. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.

Parámetros condicionales

-node nombre_nodo
-server nombre_servidor
Para añadir un servidor de aplicaciones como miembro de bus, especifique el nombre y el nodo en el que se ejecuta el servidor, y el nombre del servidor.

Si especifica estos parámetros, no especifique los parámetros -cluster o -wmqServer.

-cluster nombre_clúster
Para añadir un clúster de servidor como miembro de bus, especifique el nombre del clúster.

Si especifica estos parámetros, no especifique los parámetros -node, -server, o -wmqServer.

-wmqServer
Para añadir un servidor WebSphere MQ como un miembro de bus, especifique el nombre del servidor WebSphere MQ. Éste es el nombre que se ha especificado en el parámetro -name cuando se ha creado el servidor WebSphere MQ.

Si especifica este parámetro, no especifique los parámetros -cluster, -node o -server.

Parámetros opcionales

-description texto
Una descripción opcional del miembro de bus, para fines administrativos.
-virtualQueueManagerName
El valor de alteración temporal para el nombre del gestor de colas virtual del servidor WebSphere MQ. Cuando se envían mensajes a IBM MQ, el gestor de cola de pasarela IBM MQ ve el bus como un gestor de colas remoto. El nombre del gestor de colas virtual es el nombre que se pasa a IBM MQ como nombre de ese gestor de colas remoto. El valor predeterminado es el nombre de bus. Si este valor no es un nombre válido para un gestor de colas IBM MQ o si ya existe otro gestor de colas IBM MQ con el mismo nombre, sustituya el valor predeterminado por otro valor que sea un nombres exclusivo y válido para un gestor de colas IBM MQ. Para que sea válido, el nombre debe cumplir los criterios siguientes:
  • Debe contener entre 1 y 48 caracteres.
  • Debe cumplir con las reglas de denominación de colas de IBM MQ (consulte el tema Reglas para la denominación de objetos de IBM MQ en el centro de información de IBM MQ).
-host
El valor de alteración temporal para el atributo del host del miembro de bus del servidor WebSphere MQ. Este valor es el nombre de host o la dirección IP del host con el que se establece una conexión para la comunicación con un gestor de colas o un grupo de compartición de colas. Utilice este parámetro si se especifica el parámetro -wmqServer.
-port
El valor de alteración temporal para el atributo del puerto del miembro de bus del servidor WebSphere MQ. El número del puerto que es supervisado por un escucha del gestor de colas o un escucha del grupo que comparte colas, que está a la escucha de las conexiones. El valor predeterminado es 1414. Utilice este parámetro si se especifica el parámetro -wmqServer.
-channel
El valor de alteración temporal para el atributo del canal del miembro de bus del servidor WebSphere MQ. Éste es el nombre del canal de conexión del servidor utilizado para establecer una conexión con el gestor de colas IBM MQ o el grupo de compartimiento de colas IBM MQ for z/OS. El valor predeterminado es SYSTEM.DEF.SVRCONN. Utilice este parámetro si se especifica el parámetro -wmqServer.
-securityAuthAlias
El valor de alteración temporal para el atributo securityAuthAlias del miembro de bus del servidor WebSphere MQ. Éste es el alias de autenticación proporcionado al conectarse al servidor WebSphere MQ. Este parámetro no tiene ningún valor predeterminado. Utilice este parámetro si se especifica el parámetro -wmqServer.
-transportChain
El valor de alteración temporal para el atributo transportChain del miembro de bus del servidor WebSphere MQ. Éste es el nombre de la cadena de transporte que se debe utilizar al comunicarse con IBM MQ. El valor predeterminado es OutboundBasicWMQClient. Utilice este parámetro si se especifica el parámetro -wmqServer.
-trustUserIds TRUE | FALSE
El valor de alteración temporal para el atributo trustUserIds del miembro de bus del servidor WebSphere MQ. Esto determina si los ID de usuario que se reciben en los mensajes procedentes de IBM MQ se propagan en los mensajes. El ID de usuario de aplicación se establece siempre a partir del valor RFH2 de jsAppUserId. Si no está presente (ya sea porque el par clave/valor no está presente en la carpeta <sib> de la cabecera RFH2 o bien porque el mensaje no tiene una cabecera RFH2), este campo no se establecerá. Este parámetro tiene dos valores posibles:
TRUE
Los ID usuario se propagan en los mensajes.
FALSE
Los ID usuario no se propagan en los mensajes.

El valor predeterminado es TRUE. Utilice este parámetro si se especifica el parámetro -wmqServer.

-enableAssistance TRUE | FALSE
Un parámetro que especifica si se debe habilitar la asistencia para la política del motor de mensajería. Este parámetro tiene dos valores posibles:
TRUE
La asistencia para la política del motor de mensajería está habilitada. Debe proporcionar un parámetro -policyName.
FALSE
La asistencia para la política del motor de mensajería no está habilitada. Éste es valor predeterminado. Utilice este parámetro si se especifica el parámetro -cluster.
-policyName HA | SCALABILITY | SCALABILITY_HA | CUSTOM
El tipo de política de motor de mensajería que se debe aplicar en el clúster. Este parámetro tiene cuatro valores posibles:
HA
Aplicar la política del motor de mensajería de alta disponibilidad en el clúster.
SCALABILITY
Aplicar la política del motor de mensajería de escalabilidad en el clúster.
SCALABILITY_HA
Aplicar la escalabilidad con la política del motor de mensajería de alta disponibilidad en el clúster.
CUSTOM
Aplicar la política de motor de mensajería personalizado en el clúster.

Este parámetro no tiene ningún valor predeterminado. Utilice este parámetro si se especifica el parámetro -cluster y el parámetro -enableAssistance se ha establecido en TRUE.

-failover TRUE | FALSE
Un parámetro que especifica si el motor de mensajería del clúster puede realizar una migración tras error en otro servidor del clúster, si el servidor del host para el motor de mensajería falla. Este parámetro tiene dos valores posibles:
TRUE
El motor de mensajería realizará la migración tras error.
FALSE
El motor de mensajería no puede realizar la migración tras error.

El valor predeterminado es FALSE. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.

-failback TRUE | FALSE
Un parámetro que especifica si el motor de mensajería del clúster que ha realizado una migración tras error puede invertir este proceso en otro servidor con mayor preferencia de la lista de servidores preferidos si dicho servidor vuelve a estar disponible. Este parámetro tiene dos valores posibles:
TRUE
El motor de mensajería puede invertir la migración. Si utiliza esta opción, proporcione un parámetro -preferredServerList.
FALSE
El motor de mensajería no puede invertir la migración.

El valor predeterminado es FALSE. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.

-preferredServersOnly TRUE | FALSE
Un parámetro que especifica si el motor de mensajería del clúster sólo se debe ejecutar en servidores de la lista de servidores preferidos, o en cualquier servidor del clúster. Este parámetro tiene dos valores posibles:
TRUE
El motor de mensajería sólo puede ejecutarse en servidores de la lista de servidores preferidos. Si utiliza esta opción, proporcione un parámetro -preferredServerList.
FALSE
El motor de mensajería se puede ejecutar en cualquier servidor del clúster.

El valor predeterminado es FALSE. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.

-preferredServerList {{nombre_nodo nombre_servidor}}
La lista de servidores, en orden de prioridad, en los que prefiere ejecutarse el motor de mensajería del clúster. Para cada servidor de la lista, especifique el nombre del nodo en el que se ejecuta el servidor y el nombre del servidor. No hay ningún valor predeterminado para este parámetro. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.
-fileStore
Cree un almacén de archivos para utilizarlo como un almacén de mensajes para el motor de mensajería. Un almacén de archivos es un tipo de almacén de mensajes que utiliza directamente archivos de un sistema de archivos a través del sistema operativo. la alternativa es utilizar un almacén de datos. Para obtener más información, consulte los enlaces relacionados.
-logSize tamaño_anotación
El tamaño del archivo de registro en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
-logDirectory nombre_directorio_registro
El nombre del directorio de archivos de registro, en caso de que no desee utilizar el directorio de registro predeterminado. Utilice este parámetro si se especifica el parámetro -fileStore.
-minPermanentStoreSize tamaño_mínimo_almacén_permanente
El tamaño mínimo del archivo del almacén permanente en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
-minTemporaryStoreSize tamaño_mínimo_almacén_temporal
El tamaño mínimo del archivo del almacén temporal en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
-maxPermanentStoreSize tamaño_máximo_almacén_permanente
El tamaño máximo del archivo del almacén permanente en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
-maxTemporaryStoreSize tamaño_máximo_almacén_temporal
El tamaño máximo del archivo del almacén temporal en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
-unlimitedPermanentStoreSize TRUE | FALSE
Un parámetro que especifica si el tamaño del almacén permanente es ilimitado. Este parámetro tiene dos valores posibles:
TRUE
El tamaño del almacén permanente es ilimitado.
FALSE
El tamaño del almacén permanente es limitado. Si utiliza esta opción, proporcione un parámetro -maxPermanentStoreSize.

Utilice este parámetro si se especifica el parámetro -fileStore.

-unlimitedTemporaryStoreSize TRUE | FALSE
Un parámetro que especifica si el tamaño del almacén temporal es ilimitado. Este parámetro tiene dos valores posibles:
TRUE
El tamaño del almacén temporal es ilimitado.
FALSE
El tamaño del almacén temporal es limitado. Si utiliza esta opción, proporcione un parámetro -maxTemporaryStoreSize.

Utilice este parámetro si se especifica el parámetro -fileStore.

-permanentStoreDirectory nombre_directorio_almacén_permanente
El nombre del directorio del almacén permanente si no desea utilizar el directorio del almacén permanente predeterminado. Utilice este parámetro si se especifica el parámetro -fileStore.
-temporaryStoreDirectory nombre_directorio_almacén_temporal
El nombre del directorio del almacén temporal si no desea utilizar el directorio del almacén temporal predeterminado. Utilice este parámetro si se especifica el parámetro -fileStore.
-dataStore
Cree un almacén de datos para utilizarlo como un almacén de mensajes para el motor de mensajería.

Un almacén de datos consta de un conjunto de tablas que un motor de mensajería utiliza para almacenar datos persistentes en una base de datos.Consulte Tablas de almacén de datos para obtener una lista de las tablas que forman un almacén de datos. Todas las tablas de un almacén de datos se conservan en el mismo esquema de base de datos. Puede crear varios almacenes de datos en la misma base de datos, siempre que utilice un nombre de esquema diferente para cada almacén de datos.

La alternativa es utilizar un almacén de archivos (el valor predeterminado). Para obtener más información, consulte los enlaces relacionados.
-createDefaultDatasource TRUE | FALSE
Un parámetro que especifica si se debe crear un origen de datos predeterminado cuando se crea el motor de mensajería. Este parámetro tiene dos valores posibles:
TRUE
Crear un origen de datos predeterminado.
FALSE
No crear un origen de datos predeterminado.

Utilice este parámetro si se especifica el parámetro -dataStore. No utilice este parámetro si se especifica el parámetro -cluster.

-datasourceJndiName nombre_jndi
El nombre JNDI del origen de datos que utiliza el motor de mensajería para acceder al sistema de gestión de bases de datos relacionales (RDBMS) del almacén de datos. Utilice este parámetro si se especifica el parámetro -dataStore.
-authAlias alias_auten
El nombre del alias de autenticación que el motor de mensajería utiliza para conectarse a la base de datos de su almacén de datos. Utilice este parámetro si se especifica el parámetro -dataStore.
-createTables origen_datos
Crear automáticamente las tablas de base de datos para el origen de datos especificado. Si esta opción no se especifica, el administrador de base de datos debe crear las tablas. Utilice este parámetro si se especifica el parámetro -dataStore.
-restrictLongDBLock TRUE | FALSE
Parámetro que especifica si el motor de mensajería debe mantener bloqueos de larga ejecución en la tabla SIBOWNER de la base de datos. Cuando se selecciona esta opción, el motor de mensajería establece un bloqueo en la base de datos sólo por períodos breves. En el caso de que el motor de mensajería activo no responda a la base de datos, estará disponible el motor de mensajería en espera para hacerse con la base de datos porque el motor de mensajería activo solo mantiene bloqueos de breve duración. Este parámetro tiene dos valores posibles:
TRUE
Restrinja los bloqueos de larga ejecución en la base de datos.
FALSE
No restrinja los bloqueos de larga ejecución en la base de datos.

Utilice este parámetro si se especifica el parámetro -dataStore.

Importante: Aunque la propiedad está seleccionada, la propiedad no entrará en vigor hasta que las tablas de base de datos se actualicen utilizando el mandato sibDBUpgrade para WebSphere Application Server Versión 9.0 y posteriores.
-schemaName nombre_esquema
El nombre del esquema de base de datos que contiene las tablas para el almacén de datos, si no desea utilizar el nombre de esquema predeterminado. Si desea detalles sobre el esquema predeterminado, consulte Creación de usuarios y esquemas de la base de datos. Utilice este parámetro si se especifica el parámetro -dataStore.
-initialHeapSize tamaño
El tamaño del almacenamiento dinámico inicial de la máquina virtual Java™ (JVM), en megabytes, del servidor o de cada uno de los servidores del clúster. No hay ningún valor predeterminado. Si no se especifica este parámetro, no se realiza ningún cambio. Si se especifica este parámetro, el valor proporcionado debe ser mayor o igual que cero y menor o igual que 2048. Si el parámetro se proporciona sin ningún valor, se genera un mensaje de error.
[z/OS]Nota: Este parámetro se ignora si el servidor que es el sujeto del mandato addSIBusMember se ejecuta en z/OS, o si el sujeto es un clúster, cualquier servidor del clúster se ejecuta en z/OS.
-maxHeapSize tamaño
El tamaño de almacenamiento dinámico máximo de la JVM, en megabytes, del servidor o de cada uno de los servidores de un clúster. No hay ningún valor predeterminado. Si no se especifica este parámetro, no se realiza ningún cambio. Si se especifica este parámetro, el valor proporcionado debe ser mayor o igual que cero y menor o igual que 2048. Si el parámetro se proporciona sin ningún valor, se genera un mensaje de error.
[z/OS]Nota: Este parámetro se ignora si el servidor que es el sujeto del mandato addSIBusMember se ejecuta en z/OS, o si el sujeto es un clúster, cualquier servidor del clúster se ejecuta en z/OS.

Ejemplos

Añada un server1 en node1 como miembro de bus1 con un almacén de archivos predeterminado.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 ]')

Añada el server1 como miembro de bus1, y utilice un almacén de archivos para guardar los mensajes.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore ]')

Añada el server1 como miembro de bus1, y utilice un almacén de archivos para guardar los mensajes, con opciones.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore 
-logSize 100 -logDirectory C:\\filestore1 ]')

Añada el server1 como miembro de bus1, y utilice un almacén de datos para guardar los mensajes.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore ]')

Añada el server1 como miembro de bus1, y utilice un almacén de datos para guardar los mensajes, con opciones.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore 
-createDefaultDatasource true -datasourceJndiName myjndi]') 

Añada el cluster1 a bus1 sin utilizar la asistencia para la política del motor de mensajería y utilice un almacén de archivos para el motor de mensajería.

AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -fileStore true 
-logDirectory C:\\filestore1 -permanentStoreDirectory C:\\filestore2
-temporaryStoreDirectory C:\\filestore3]')

Añada el cluster1 a bus1 y utilice la asistencia para la política del motor de mensajería y la política del motor de mensajería de alta disponibilidad. Utilice un almacén de archivos como almacén de mensajes para el motor de mensajería.

AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true 
-policyName HA -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\filestore1 ]')

Añada el cluster1 a bus1 y utilice la asistencia para la política del motor de mensajería y la política del motor de mensajería personalizado. Utilice un almacén de archivos como almacén de mensajes para el motor de mensajería. Establezca el motor de mensajería de modo que pueda realizar la migración tras error, no invertirla, y que sólo se ejecute en server1 y server2.

AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true 
-policyName CUSTOM -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\temp\filestore
-failover true -failback false -preferredServersOnly true 
-preferredServerList [[node1 server1] [node2 server2]]]') 

[AIX Solaris HP-UX Linux Windows][IBM i]Cambie el tamaño inicial del almacenamiento dinámico de JVM a 256 y el tamaño máximo del almacenamiento dinámico de JVM a 512.

[AIX Solaris HP-UX Linux Windows][IBM i]
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1
-initialHeapSize 256 -maxHeapSize 512]')

Icon that indicates the type of topic Reference topic



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