Mandato createWMQTopic
Utilice el mandato createWMQTopic para crear un destino de tema JMS para el proveedor de mensajería de WebSphere MQ en un ámbito específico.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de
script wsadmin se ejecuta desde Qshell. Para más información, consulte el tema "Configurar Qshell
para ejecutar scripts de WebSphere Application Server".
Este mandato sólo es válido cuando se utiliza con servidores de aplicaciones WebSphere Application Server versión 7 y posteriores. No lo utilice con versiones anteriores.
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('nombre_mandato')
AdminConfig.save()
Finalidad
Utilice el mandato createWMQTopic para crear un destino de tipo de tema del proveedor de mensajería de WebSphere MQ en un ámbito específico.
- Un destino de tipo de tema del proveedor de mensajería de WebSphere MQ ya existe con el mismo nombre en el mismo ámbito.
- El nombre de JNDI entra en conflicto con otra entrada en la JNDI de WebSphere Application Server.
Objeto de destino
El ámbito del proveedor de mensajería de WebSphere MQ en el que se va a crear el destino de tipo de tema del proveedor de mensajería de WebSphere MQ.
Parámetros necesarios
- -name
- Nombre administrativo asignado a este destino de tipo de tema del proveedor de mensajería de WebSphere MQ.
- -jndiName
- Nombre utilizado para enlazar este objeto en la JNDI de WebSphere Application Server.
- -topicName
- Nombre del tema de WebSphere MQ donde las publicaciones se reciben o se envían, cuando se utiliza esta definición de destino.
Parámetros opcionales
- -description
- Descripción administrativa asignada al destino de tipo de tema.
- -persistence
- Este parámetro determina el nivel de persistencia utilizado para almacenar mensajes enviados a este destino. Especifique uno de los siguientes valores sensibles a mayúsculas y minúsculas:
- APP
- TDEF
- PERS
- NON
- HIGHT
APP es el valor predeterminado.
- -priority
- Nivel de prioridad que se asigna a los mensajes enviados a este destino.Especifique uno de los valores siguientes:
- APPNota: (APP es sensible a mayúsculas y minúsculas.)
- QDEFNota: (QDEF es sensible a mayúsculas y minúsculas.)
- <Un entero positivo en el rango de 0 a 9 (inclusive)>
Especifique uno de los valores siguientes:- APPNota: (APP es sensible a mayúsculas y minúsculas.)
- QDEFNota: (QDEF es sensible a mayúsculas y minúsculas.)
- <Un entero positivo en el rango de 0 a 9 (inclusive)>
El valor predeterminado es APP.
- APP
- -expiry
- El periodo de tiempo tras el cual los mensajes que se envían a este destino caducan y se tratan de acuerdo con sus opciones de eliminación. Especifique uno de los valores siguientes:
- APPNota: (APP es sensible a mayúsculas y minúsculas.)
- UNLIMNota: (UNLIM no es sensible a mayúsculas y minúsculas.)
- <Cualquier entero positivo>
El valor predeterminado es APP.
- APP
- -ccsid
- Identificador del juego de caracteres codificado (CCSID).
El valor de este parámetro debe ser un entero positivo o vacío. Consulte Valores de propiedades avanzadas de cola y tema de proveedor de mensajería de IBM MQ para obtener más detalles.
El valor predeterminado es 1208.
- -useNativeEncoding
- Este parámetro especifica si se debe utilizar codificación nativa o no.
Puede tomar el valor true o false.
Si se establece en true, se omitirán los valores de los atributos -integerEncoding, -decimalEncoding y -floatingPointEncoding.
Si se establece en false, los atributos -integerEncoding, -decimalEncoding y -floatingPointEncoding especifican la codificación.
- -integerEncoding
- Valor de codificación de entero para esta cola.
Especifique uno de los siguientes valores sensibles a mayúsculas y minúsculas: Normal o Reversed.
Normal es el valor predeterminado.
- -decimalEncoding
- Valor de codificación de decimal para esta cola.
Especifique uno de los siguientes valores sensibles a mayúsculas y minúsculas: Normal o Reversed.
El valor predeterminado es Normal.
- -floatingPointEncoding
- Valor de codificación de coma flotante para esta cola.
Especifique uno de los siguientes valores sensibles a mayúsculas y minúsculas: IEEENormal, IEEEReversed o z/OS.
El valor predeterminado es IEEENormal.
- -useRFH2
- Este parámetro determina si una cabecera RFH versión 2 se añade a los mensajes enviados a este destino, también conocido como targetClient..
Especifique uno de los siguientes valores sensibles a mayúsculas y minúsculas: true o false (equivalentes a JMS targetClient o MQ targetClient, respectivamente).
El valor predeterminado es true (JMS targetClient).
- -sendAsync
- Este parámetro determina si los mensajes se pueden enviar a este destino sin que el gestor de colas reconozca que han llegado.
Especifique uno de los siguientes valores sensibles a las mayúsculas y minúsculas: YES, NO o TDEF.
El valor predeterminado es YES.
- -readAhead
- Este parámetro determina si los mensajes para consumidores no persistentes se pueden leer y almacenar en memoria caché.
Especifique uno de los siguientes valores sensibles a las mayúsculas y minúsculas: YES, NO o TDEF.
El valor predeterminado es YES.
- -readAheadClose
- Esta propiedad determina el comportamiento que se produce al cerrar un consumidor de
mensajes que recibe mensajes asíncronamente, mediante un escucha de mensajes, desde un destino que tenga el parámetro readAhead establecido en
True.
Si se especifica un valor de deliverAll, todos los mensajes de lectura por adelantado se entregan antes de cerrar el consumidor.
Si se especifica un valor de deliverCurrent, sólo se entregan los mensajes en curso antes de cerrar el consumidor.
El valor predeterminado es deliverCurrent.
- -wildcardFormat
- Este parámetro determina qué conjuntos de caracteres se interpretan como comodines de temas.
Los valores válidos son Topic o Char.
El valor predeterminado es Topic.
- -brokerDurSubQueue
- Nombre de la cola, definida en el gestor de colas, desde la que un consumidor de conexión recibe mensajes de suscripción no duradera.
El valor de este parámetro debe ser un nombre de cola válido o dejarse en blanco.
El valor predeterminado es SYSTEM.JMS.D.SUBSCRIBER.QUEUE.
- -brokerCCDurSubQueue
- Nombre de la cola, definida en el gestor de colas, desde la que un consumidor de conexión recibe mensajes de suscripción duradera.
El valor de este parámetro debe ser un nombre de cola válido o dejarse en blanco.
El valor predeterminado es SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.
- -brokerPubQueue
- Nombre de la cola, definida en el gestor de colas, a la que se envían los mensajes de publicación.
El valor de este parámetro debe ser un nombre de cola válido o dejarse en blanco.
El valor predeterminado es SYSTEM.BROKER.DEFAULT.STREAM.
- -brokerPubQmgr
- Nombre del gestor de colas donde se ejecuta el intermediario.
El valor de este parámetro debe ser un nombre de gestor de colas válido o dejarse en blanco.
No hay ningún valor predeterminado.
- -brokerVersion
- Este parámetro determina el nivel de funcionalidad requerido para operaciones de publicación/suscripción.
El valor de este parámetro debe ser V1 o V2.
El valor predeterminado es V1.
- -customProperties
- Este parámetro especifica las propiedades personalizadas que se deben pasar a la implementación de destino de tipo de tema del proveedor de mensajería de WebSphere MQ. En general, las propiedades personalizadas se utilizan para establecer atributos del destino de tipo de tema a los que no se da soporte directamente a través de las interfaces de administración de WebSphere.Cada propiedad personalizada se especifica utilizando los parámetros de paso de tabla de nombre y valor. Dado que éstos son pasos de tabla, el orden de los dos parámetros es fijo, por lo que siempre debe especificar el nombre primero y luego el valor:
- En Jython: [nombre valor]
- En Jacl: {nombre valor}
- Utilizando Jython:
wsadmin>AdminConfig.getid("/Node:9994GKCNode01") MQTopic_1098737234986)
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
wsadmin>AdminTask.createWMQTopic("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name T1 -jndiName jms/topic/t1 -topicName myTopic"])
T1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
- Utilizando Jacl:
wsadmin>$AdminConfig getid /Node:9994GKCNode01
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
wsadmin>$AdminTask createWMQTopic 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name T1 -jndiName jms/topic/t1 -topicName myTopic}
T1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQTopic_1098737234986)