Mandato mediateSIBDestination
Utilice el mandato mediateSIBDestination para mediar un destino de bus para un bus de integración de servicios.
Al mediar un destino se asocia una mediación con un destino de bus seleccionado. Durante el tiempo de ejecución, la mediación aplica un proceso de mensajes a los mensajes manejados por el destino de bus. Observe que sólo puede mediar un destino con una mediación cada vez. Puede mediar más de un destino con la misma mediación.
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()
Finalidad
Este mandato media un destino de bus para un bus de integración de servicios. Existen parámetros que puede utilizar para crear un punto de cola de mediación en un servidor IBM MQ y crear el punto de ejecución de mediación correspondiente en un clúster o un servidor.
Objeto de destino
Ninguno.
Parámetros necesarios
- -bus nombre_bus -destinationName nombre_destino
- El destino que se va a mediar.
- -mediationName nombre_mediación
- El nombre de la mediación que se ha de aplicar al destino de bus. Esta mediación debe existir para poder utilizar este mandato.
Parámetros condicionales
- -wmqServer nombre_servidor_mq -wmqQueueName nombre_cola_mq
- [Destino de servicio web o cola] Para asignar el punto de mediación a una cola IBM MQ, especifique el nombre del miembro de bus de servidor IBM MQ donde se asignará el punto de mediación, y el nombre de la cola IBM MQ que se utilizará para almacenar mensajes listos para mediación. nombre_servidor_mq es el nombre del servidor IBM MQ tal como se especifica en el parámetro -name al crear el servidor IBM MQ. nombre_cola_mq es el nombre asignado a la cola IBM MQ por la administración de IBM MQ.
- -node nombre_nodo -server nombre_servidor
- [No para el espacio de temas] Para mediar el destino de bus con un miembro de bus de servidor, especifique tanto el nombre del nodo en el que se ejecuta el servidor como el nombre del servidor.
- -cluster nombre_clúster
- [No para el espacio de temas] Para mediar el destino de bus con un miembro de bus del clúster, especifique el nombre del clúster.
Parámetros opcionales
- -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
- 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, 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.
- -useRFH2
- Determina si las tecnologías de integración de servicios incluyen una cabecera RFH2 en los mensajes, o lo coloca en el punto de mediación. Los valores posibles son:
- TRUE
- FALSE
- -maintainStrictMessageOrder
- Mantener el orden estricto de los mensajes.
Los valores posibles son:
- Seleccionado
- Conserva el orden en el cual 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. Si desea más información sobre las propiedades de configuración que se alteran temporalmente en el tiempo de ejecución, consulte Orden de mensajes estricto para los destinos del bus.
- Deseleccionado
- El orden de los mensajes no se conserva para este destino.
Ejemplo
- Utilizando Jython:
wsadmin>AdminTask.mediateSIBDestination("-bus abus -destinationName myqueue -mediationName filterMed -cluster cluster1")
- Utilizando Jacl:
wsadmin>$AdminTask mediateSIBDestination {-bus abus -destinationName myqueue -mediationName filterMed -cluster cluster1}