Mandato modifySIBEngine
Utilice el mandato modifySIBEngine para modificar las propiedades de un motor de mensajería para un miembro de bus de integración de servicios.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
- 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')
AdminConfig.save()
Objetivo
Este mandato modifica las propiedades de un motor de mensajería.
Objeto de destino
Un motor de mensajería.
Parámetros necesarios
- -bus nombre_bus
- El nombre del bus de integración de servicios en el que está configurado el miembro del bus. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
Parámetros condicionales
- -node nombre_nodo-server nombre_servidor
- Para cambiar las propiedades de un motor de mensajería de un servidor de aplicaciones como un miembro de bus, especifique tanto el nombre del nodo en el que se ejecuta el servidor como el nombre del servidor.
- -cluster clúster
- Para cambiar las propiedades de un motor de mensajería para un clúster de servidores como un miembro del bus, especifique el nombre del clúster.
- -engine nombre_motor
- Si el miembro del bus sólo tiene un motor de mensajería, no es necesario especificar el nombre del motor. Si el miembro del bus tiene varios motores de mensajería, debe especificar el nombre del motor cuyas propiedades desea cambiar.
Parámetros opcionales
- -description texto
- Descripción opcional del motor de mensajería, a efectos administrativos.
- -initialState STARTED | STOPPED
- El estado inicial determina si el motor de mensajería se inicia automáticamente cuando se inicia el servidor o el clúster de servidores.
- Detenido
- Cuando se inicia el servidor de aplicaciones asociado, se detiene el motor de mensajería y deja de estar disponible para procesar mensajes.
- Iniciado
- Cuando se inicia el servidor de aplicaciones asociado, el motor de mensajería se inicia y queda disponible para procesar mensajes.
- -highMessageThreshold número
- El número máximo total de mensajes que el motor de mensajería puede colocar en sus puntos de mensaje.
Cuando se crea el motor de mensajería, se utiliza el umbral alto de mensajes del bus para establecer el valor predeterminado para esta propiedad. Cuando se crea un punto de mensaje en este motor de mensajería, el valor de esta propiedad se utiliza para establecer el umbral alto de mensajes predeterminado para el punto de mensaje.
- -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.
Ejemplo
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STARTED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'
wsadmin>AdminTask.modifySIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 -initialState STOPPED ]')
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STOPPED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'