Mandato createSIBDestinations

Utilice el mandato createSIBDestinations para crear nuevos destinos 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()

Finalidad

El mandato createSIBDestinations crea varios destinos de bus nuevos para un bus de integración de servicios, todos con las mismas propiedades. Si los destinos creados son destinos de alias, todos hacen referencia al mismo destino. Con este mandato, también se pueden localizar nuevos destinos de bus en un miembro de bus del servidor WebSphere MQ.

Objeto de destino

Un bus de integración de servicios.

Parámetros necesarios

-bus
El nombre del bus de integración de servicios en el cual se crean los destinos de bus. Para listar los nombres de los buses existentes, utilice el mandato listSIBuses.
-nameList
La lista de los identificadores a través de los cuales son conocidos estos destinos para fines administrativos.
-type
Indica el tipo de destino de bus que desea crear:
Alias
Un destino de alias, que proporciona un nivel de abstracción entre aplicaciones y los destinos de bus de destino subyacentes que contienen mensajes. Las aplicaciones interactúan con el destino de alias, de modo que el destino de bus de destino puede cambiarse sin modificar la aplicación.
Foráneo
Un destino foráneo, que identifica un destino en otro bus y permite a las aplicaciones de un bus acceder directamente al destino de otro bus.
Puerto
Representa un mensaje y enlace de transporte específico para un servicio de salida que se comunica con un servicio web de destino con host externo.
Cola
Cola para mensajería punto a punto.
TopicSpace
Espacio de temas, para mensajería de publicación/suscripción.
WebService
Representa un servicio web de destino con host externo.

Parámetros condicionales

Ninguna.

Parámetros opcionales

-cluster
Para asignar los destinos de bus a un miembro de bus del clúster, especifique el nombre del clúster. No especifique los parámetros -node, -server o -wmqServer.
-node
Para asignar los destinos de bus a un miembro de bus del servidor, especifique el nombre del nodo en el que se ejecuta el servidor y el nombre del servidor. No especifique los parámetros -cluster o -wmqServer.
-server
Para asignar los destinos de bus a un miembro de bus del servidor, especifique el nombre del nodo en el que se ejecuta el servidor y el nombre del servidor. No especifique los parámetros -cluster o -wmqServer.
-wmqServer
Para asignar destinos de bus a una cola IBM MQ, especifique tanto el nombre del miembro de bus del servidor WebSphere MQ donde se haya asignado el destino (este parámetro), como el nombre de la cola IBM MQ utilizada para almacenar los mensajes enviados a los destinos (el parámetro -wmqQueueName). Establezca el parámetro -wmqServer en el nombre que ha proporcionado cuando ha creado el servidor WebSphere MQ. Establezca el parámetro -wmqQueueName en el nombre que ha asignado a la cola IBM MQ la administración de IBM MQ. No especifique los parámetros -cluster, -node o -server .
-aliasBus
Si está creando destinos de alias, especifique el nombre del bus de origen de la correlación de alias.
-targetBus
Si está creando destinos de alias, especifique el nombre del bus con el que se correlacionan los destinos de alias.
-targetName
Si está creando destinos de alias, especifique el nombre del destino con el que se correlacionan los destinos de alias.
-foreignBus
Si está creando destinos foráneos, especifique el nombre del bus foráneo.
-description
Especifique una descripción de los destinos de bus para fines administrativos.
-reliability
Especifique el nivel de fiabilidad predeterminado que asignar a los mensajes generados en estos destinos 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.

-maxReliability
Especifique el nivel de fiabilidad máximo aceptado para los valores especificados por las aplicaciones generadoras. La integración de servicios soporta cinco niveles de fiabilidad (también conocidos como opciones de entrega o calidades de servicio):
BEST_EFFORT_NONPERSISTENT
EXPRESS_NONPERSISTENT
RELIABLE_NONPERSISTENT
RELIABLE_PERSISTENT
ASSURED_PERSISTENT

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.

-nonPersistentReliability

Especifique la calidad de integración de servicios del servicio que se utilizará con los mensajes IBM MQ no persistentes que recibe la integración de servicios desde una red IBM MQ. Los mensajes de una red IBM MQ tienen su propio nivel de calidad de servicio. Se trata de persistente o no persistente. Cuando una aplicación de integración de servicios recibe estos mensajes, se asigna una calidad de nivel de servicio de integración de servicios que depende de su propio nivel de calidad de servicio de IBM MQ.

Para los mensajes IBM MQ no persistentes recibidos, la calidad de servicio predeterminada de la integración de servicios es RELIABLE_NONPERSISTENT. Si opta por alterar temporalmente este valor predeterminado, probablemente seleccionará una de las otras calidades de servicio no persistentes de la integración de servicios BEST_EFFORT_NONPERSISTENT o EXPRESS_NONPERSISTENT. No obstante, puede seleccionar cualquiera de las cinco calidades de servicio de la integración de servicios posibles:
BEST_EFFORT_NONPERSISTENT
EXPRESS_NONPERSISTENT
RELIABLE_NONPERSISTENT
RELIABLE_PERSISTENT
ASSURED_PERSISTENT

Para obtener más información, consulte Correlación de la opción de entrega JMS y de la fiabilidad de mensajes con y hacia el valor de persistencia de IBM MQ.

-persistentReliability

Especifique la calidad de integración de servicios del servicio que se utilizará con los mensajes IBM MQ persistentes que recibe la integración de servicios desde una red IBM MQ. Los mensajes de una red IBM MQ tienen su propio nivel de calidad de servicio. Se trata de persistente o no persistente. Cuando una aplicación de integración de servicios recibe estos mensajes, se asigna una calidad de nivel de servicio de integración de servicios que depende de su propio nivel de calidad de servicio de IBM MQ.

Para los mensajes IBM MQ persistentes recibidos, la calidad de servicio predeterminada de la integración de servicios es ASSURED_PERSISTENT. Si opta por alterar temporalmente este valor predeterminado, probablemente seleccionará la otra calidad de servicio persistente de la integración de servicios RELIABLE_PERSISTENT. No obstante, puede seleccionar cualquiera de las cinco calidades de servicio de la integración de servicios posibles:
BEST_EFFORT_NONPERSISTENT
EXPRESS_NONPERSISTENT
RELIABLE_NONPERSISTENT
RELIABLE_PERSISTENT
ASSURED_PERSISTENT

Para obtener más información, consulte Correlación de la opción de entrega JMS y de la fiabilidad de mensajes con y hacia el valor de persistencia de IBM MQ.

-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 excepciones 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 estos destinos.
  • 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 a un 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.
-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.
-wmqQueueName
Para asignar estos destinos de bus a una cola IBM MQ, especifique tanto el nombre del miembro de bus del servidor WebSphere MQ donde se haya asignado el destino (el parámetro -wmqServer), como el nombre de la cola IBM MQ utilizada para almacenar los mensajes enviados a estos destinos (este parámetro). Establezca el parámetro -wmqServer en el nombre que ha proporcionado cuando ha creado el servidor WebSphere MQ. Establezca el parámetro -wmqQueueName en el nombre que ha asignado a la cola IBM MQ la administración de IBM MQ. No especifique los parámetros -cluster, -node o -server .
-useRFH2 o -mqRfh2Allowed TRUE | FALSE
Determina si los mensajes enviados a estos destinos tienen una cabecera MQRFH2.
Cuando la integración de servicios convierte un mensaje del formato de integración de servicios al formato de IBM MQ, de forma predeterminada incluye una cabecera MQRHF2 en el mensaje IBM MQ. Esta cabecera contiene los atributos de mensaje como, por ejemplo, atributos de mensaje JMS, que no son atributos de mensaje IBM MQ y, por lo tanto, no aparecen en el descriptor de mensaje IBM MQ (MQMD). Algunas aplicaciones IBM MQ no pueden procesar los mensajes que incluyen una cabecera MQRFH2. Si los mensajes enviados a este destino los procesarán las aplicaciones IBM MQ que no pueden tolerar una MQRFH2, borre esta opción (estableciéndola en FALSE).
Si está asignando destinos de tipo cola a un miembro de bus de servidor WebSphere MQ, utilice el parámetro -useRFH2. Si está creando destinos de alias o destinos foráneos, utilice el parámetro -mqRfh2Allowed.
-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.

Se especifica un punto de cola con el formato nombre_destino@nombre_motor_mensajería.

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

Se especifica un punto de mediación con el formato nombre_destino@nombre_motor_mensajería.

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

  • Utilizando Jython:
    wsadmin>AdminTask.createSIBDestinations("[-bus bus1 -type QUEUE
    -cluster cluster1 -nameList [[-identifier myqueue1][-identifier myqueue2]]]")
    "(cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)"
  • Utilizando Jacl:
    wsadmin>$AdminTask createSIBDestinations {-bus bus1 -type QUEUE 
    -cluster cluster1 -nameList {{myqueue1} {myqueue2}}}
    (cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)

Ejemplo 2:

Crear alias para "MyDestination1" denominados "MyAlias1" y "MyAlias2". Estos destinos de alias proporcionan acceso a un único punto de cola del destino:
  • Utilizando Jython:
    wsadmin>AdminTask.createSIBDestinations("[-bus bus1 -type ALIAS 
    -nameList [[MyAlias1][MyAlias2]] -aliasBus bus1
    -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT 
    -overrideOfOQSByProducerAllowed INHERIT -sendAllowed INHERIT 
    -receiveAllowed INHERIT -queuePoints [[MyDestination1@cluster1.001-bus1]
    [MyDestination1@cluster1.002-bus1]]]")
  • Utilizando Jacl:
    wsadmin>set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ] 
    wsadmin>$AdminTask createSIBDestinations {-bus bus1 -type ALIAS 
    -nameList {{MyAlias1} {MyAlias2}} -aliasBus bus1 
    -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT 
    -overrideOfOQSByProducerAllowed INHERIT -sendAllowed INHERIT 
    -receiveAllowed INHERIT -queuePoints {{"MyDestination1@cluster1.001-bus1"} 
    {"MyDestination1@cluster1.002-bus1}}}

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_dests_create
File name: rjo_cli_dests_create.html