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.

[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 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}

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=rjo_cli_dest_modify
File name: rjo_cli_dest_modify.html