Mandato modifySIBDestination
Utilice el mandato modifySIBDestination para cambiar las propiedades de un destino de bus para un 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
El mandato modifySIBDestination cambia las propiedades de un destino de bus para un bus de integración de servicios.
Objeto de destino
Un destino de bus.
Parámetros necesarios
- -bus
- El nombre del bus de integración de servicios en el que se configura el destino de bus. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
- -name
- El identificador mediante el cual se conoce este destino para fines administrativos.
Parámetros condicionales
Ninguno.
Parámetros opcionales
- -description
- Especifique una descripción opcional para el destino de bus, a efectos administrativos.
- -reliability
- Especifique el nivel de fiabilidad predeterminado que asignar a un mensaje generado en este destino cuando la aplicación generadora no ha establecido una fiabilidad explícita. La integración de servicios soporta cinco niveles de fiabilidad (también conocidos como opciones de entrega o calidades de servicio):
- BEST_EFFORT_NONPERSISTENT
- Los mensajes se descartan cuando se detiene o falla un motor de mensajería. Los mensajes también se pueden descartar, si una conexión utilizada para enviarlos deja de estar disponible o como resultado de los recursos del sistema limitados.
- EXPRESS_NONPERSISTENT
- Los mensajes se descartan cuando se detiene o falla un motor de mensajería. Los mensajes también pueden ser descartados si una conexión utilizada para enviarlos deja de estar disponible.
- RELIABLE_NONPERSISTENT
- Los mensajes se descartan cuando se detiene o falla un motor de mensajería.
- RELIABLE_PERSISTENT
- Los mensajes pueden descargarse si un motor de mensajería da error.
- ASSURED_PERSISTENT
- Los mensajes no se descartan.
Nota: Los niveles más altos de fiabilidad tiene impactos mayores en el rendimiento.Para obtener más información sobre los niveles de fiabilidad de integración de servicios, consulte Niveles de fiabilidad de mensajes - modalidad de entrega JMS y calidad de servicio de integración de servicios.
- -overrideOfQOSByProducerAllowed TRUE | FALSE
- Controla la calidad de servicio de los flujos de mensajes entre generadores y el destino. Seleccione esta opción para utilizar la calidad de servicio especificado por los generadores, en lugar de la calidad definida por el destino.
- -defaultPriority número
- -maxFailedDeliveries número
- Especifique un valor dentro del rango de 0 a 2147483647. Un valor 0 (cero) significa que si un mensaje no se puede entregar en el primer intento, se reenvía al destino de excepción o se descarta, como se haya definido en la propiedad -exceptionDestination.
- -exceptionDestination valor
- De forma predeterminada, todos los mensajes que no se pueden entregar en este destino se redireccionan al destino de excepción
predeterminado del sistema para el motor de mensajería al que está asignado este destino (_SYSTEM.Exception.Destination.nombre_motor_mensajería). Utilice este parámetro para alterar temporalmente el valor predeterminado. Puede establecer un destino de excepción específico para este destino o puede especificar que los mensajes que no se pueden entregar no se vuelvan a direccionar a un destino de excepción especificando una serie vacía ("") y, en este caso, el recuento de entregas fallidas máximas no tiene ningún efecto. Nota: Un mensaje que no puede entregarse puede bloquear el proceso de otros mensajes que esperan para su entrega en el mismo destino.
- Puede utilizar esta opción y no especificar ningún destino de excepción para conservar el orden de los mensajes.
- -sendAllowed TRUE | FALSE
- Borre esta opción (estableciéndola en FALSE) para evitar que los productores puedan enviar mensajes a este destino.
- Para un punto de cola de un destino sin mediación o un punto de mediación de un destino mediado, si borra esta opción, los nuevos mensajes (de los generadores conectados o reenviados desde otro destino) se redirigen a cualquier punto de mensaje disponible. Si no hay puntos de destino disponibles, entonces los mensajes que ya se han aceptado en el bus y los nuevos mensajes de generadores conectados seguirán en el bus hasta que no pase a estar disponible un punto de destino. La única excepción a esto es el caso de un destino con un solo punto de destino (punto de cola o punto de mediación, en función de si el destino se media o no se media), en el que el generador se conecta al mismo motor de mensajería. En este caso, se genera un mensaje de excepción en cada llamada de envío. El mensaje de excepción indica que la única localización existente se ha inhabilitado para envío. El generador sigue abierto con normalidad y las llamadas de envío posteriores serán satisfactorias si la propiedad Enviar permitido de la localización se vuelve a seleccionar (se vuelve a establecer en TRUE).
- Para un punto de cola de un destino mediado, si borra esta opción, entonces los mensajes de las instancias de mediación se redirigen a cualquier punto de mensaje disponible. Si no hay puntos de mensaje disponibles, entonces el bus conserva los mensajes hasta que pasa a estar disponible un punto de mensaje. Para una instancia de mediación (es decir, en un servidor que tiene un punto de mediación), si el mismo servidor aloja un punto de cola, y es el único punto de cola del destino, la mediación cambia al estado "detenido a causa de un error".
- -receiveAllowed TRUE | FALSE
- Para el punto de mensaje, si borra esta opción cualquier consumidor abierto cambia de estado y se genera una excepción si el consumidor solicita un mensaje. Los mensajes se pueden continuar enviando y acumulando en el punto de mensaje.
- -receiveExclusive TRUE | FALSE
- Seleccione esta opción (estableciéndola en true) para permitir que se conecte un consumidor a un destino. Si selecciona esta opción, sólo se puede conectar un único consumidor a cada punto de cola de un destino de cola cada vez. Se rechazarán los consumidores que posteriormente se intenten conectar a un punto de cola con un consumidor que ya esté conectado.
- -maintainStrictMessageOrder TRUE | FALSE
- Seleccione esta opción (estableciéndola en TRUE) para mantener el orden en el que un generador envía mensajes al destino.
- En el tiempo de ejecución, esta propiedad tiene prioridad sobre otros valores de propiedades de configuración. Para obtener más información sobre las propiedades de configuración que se alteran temporalmente en tiempo de ejecución, consulte Orden de mensajes estricto para los destinos del bus.Nota: Si el orden de mensajes estricto está habilitado en un destino de tema existente, las suscripciones duraderas existentes, junto con los mensajes asociados, dejarán de ser válidos. Cuando el orden de mensajes estricto esté habilitado y se reinicie el entorno, las suscripciones duraderas existentes se suprimirán y se volverán a crear; los mensajes que estén asociados a las suscripciones duraderas también se suprimirán.
- -topicAccessCheckRequired
- Incluya esta opción si son necesarias comprobaciones de autorización para acceder a los temas.
- -replyDestination
- Esta propiedad está concebida para su uso con mediaciones en mensajes de respuesta. Para obtener más información acerca de cómo utilizar esta propiedad, consulte Configuración de una ruta de direccionamiento inverso de destino.
- -replyDestinationBus
- El nombre del bus en el que está configurado el destino de respuesta. Esta propiedad se utiliza con mediaciones en mensajes de respuesta. Para obtener más información acerca de cómo utilizar esta propiedad, consulte Configuración de una ruta de direccionamiento inverso de destino.
- -delegateAuthorizationCheckToTarget
- Incluya esta opción si desea que se lleve a cabo la comprobación de autorización en el destino señalado.
- -auditAllowed TRUE | FALSE
- Deseleccione esta opción (estableciéndola en FALSE) para impedir que el bus audite las comprobaciones de autorización de nivel de tema cuando el bus y el servidor de aplicaciones tengan habilitada la auditoría. El valor predeterminado es TRUE. Debe tener los privilegios de administrador de auditoría para utilizar este parámetro. El parámetro se ignora si se utiliza en la creación de otros tipos de destino.
- -defaultForwardRoutingPath
- El valor en que se establece la ruta de direccionamiento de reenvío de mensajes si el mensaje no contiene una ruta de direccionamiento de reenvío. Esto identifica una lista secuencial de destinos de bus intermediarios por los que deben pasar los mensajes para llegar al destino de bus señalado. El formato del campo es una lista de destinos de bus especificados como nombre_bus:nombre_destino.
- -queuePoints
- Una lista de los puntos de cola utilizados por los usuarios del destino de alias.
Si no se proporciona ningún punto de cola específico, se pueden utilizar todos los puntos de cola. El destino debe ser un destino de cola en el mismo bus que la definición del destino de alias. El destino también debe ser un destino de cola con varios puntos de cola.
Un punto de cola se especifica con el formato siguiente: nombre_destino@nombre_motor_mensajería
- -useAllQueuePoints TRUE | FALSE
- Si establece esta opción en TRUE, se utilizarán todos los puntos de cola disponibles, mientras que si establece esta opción en FALSE, sólo se utilizarán los puntos de cola de la lista especificados mediante la opción -queuePoints.
- -mediationPoints
- Una lista de los puntos de mediación que utilizan los usuarios del destino de alias.
Si no se proporciona ningún punto de mediación específico, se pueden utilizar todos los puntos de mediación.
El destino debe ser un destino de cola mediado en el mismo bus que la definición del destino de alias. El destino también debe ser un destino de cola con varios puntos de mediación.
Un punto de mediación se especifica con el formato siguiente: nombre_destino@nombre_motor_mensajería
- -useAllMediationPoints TRUE | FALSE
- Si establece esta opción en TRUE, se utilizarán todos los puntos de cola disponibles, mientras que si establece esta opción en FALSE, sólo se utilizarán los puntos de cola de la lista especificados mediante la opción -mediationPoints.
- -persistRedeliveryCount TRUE | FALSE
- Seleccione esta opción (estableciéndola en TRUE) para persistir el recuento de entregas anómalas
de mensajes JMS en el almacén de mensajes. El valor de la opción se establece en FALSE de forma predeterminada. 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
- Utilizando Jython:
wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue}" wsadmin>AdminTask.modifySIBDestination(["-bus", "abus", "-name", "myqueue", "-receiveAllowed", "FALSE"]) wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}"
- Utilizando Jacl:
wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue} wsadmin>$AdminTask modifySIBDestination {-bus abus -name myqueue -receiveAllowed FALSE} (cells/9994GKCCell01/buses/abus|sib-destinations.xml#SIBQueue_1098215169998) wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}
Ejemplo: Modificar un alias de destino "MyAlias2" para utilizar un subconjunto de los puntos de cola y los puntos de mediación disponibles:
- Utilizando Jython:
cluster=AdminConfig.list("ServerCluster").splitlines()[0] Qp1=AdminConfig.list("SIBQueueLocalizationPoint" , cluster).splitlines()[0] Mp1=AdminConfig.list("SIBMediationLocalizationPoint").splitlines()[0] AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[Qp1]], "-mediationPoints" , [[Mp1]]])
- Utilizando Jacl:
set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ] set Qp1 [ lindex [ $AdminConfig list SIBQueueLocalizationPoint $cluster ] 0 ] set Mp1 [ lindex [ $AdminConfig list SIBMediationLocalizationPoint ] 0 ] $AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -queuePoints [[$Qp1]]-mediationPoints [[$Mp1]]}
Ejemplo: modifique un alias de destino para eliminar cualquier limitación en los puntos de colas utilizados:
- Utilizando Jython:
AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[]]])
- Utilizando Jacl:
$AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -useAllQueuePoints=true -useAllMediationPoints=true}