Mandato createWMQQueue
Utilice el mandato createWMQQueue para crear un destino de tipo de cola 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 createWMQQueue para crear un destino de tipo de cola del proveedor de mensajería de WebSphere MQ en un ámbito específico.
- Un destino de tipo de cola 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 cola del proveedor de mensajería de WebSphere MQ.
Parámetros necesarios
- -name
- Nombre administrativo asignado a este destino de tipo de cola del proveedor de mensajería de WebSphere MQ.
- -jndiName
- Nombre utilizado para enlazar este objeto en la JNDI de WebSphere Application Server.
- -queueName
- Nombre de la cola de WebSphere MQ que se utiliza para almacenar mensajes para la definición de destino de tipo de cola del proveedor de mensajes de WebSphere MQ.
Parámetros opcionales
- -description
- Descripción administrativa asignada al destino de tipo de cola.
- -qmgr
- Gestor de colas que alberga la cola de WebSphere MQ
- -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
- QDEF
- PERS
- NON
- HIGH
El valor predeterminado es APP.
- -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)>
El valor predeterminado es APP.
- APP
- -expiry
- Periodo de tiempo tras el cual los mensajes que se envían a este destino
caducan y se tratan según sus opciones de descarte. 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.
Al dejar este campo vacío indica que debe utilizarse el valor predeterminado.
- -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.
El valor predeterminado es Normal.
- -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 mayúsculas y minúsculas: YES, NO o QDEF.
El valor predeterminado es QDEF.
- -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 mayúsculas y minúsculas: YES, NO o QDEF.
El valor predeterminado es QDEF.
- -readAheadClose
- Este parámetro especifica el método de cierre de lectura anticipada para el consumidor de mensajes.
Especifique uno de los siguientes valores sensibles a mayúsculas y minúsculas: DELIVERALL o DELIVERCURRENT.
El valor predeterminado es DELIVERALL.
- -customProperties
- Este parámetro especifica las propiedades personalizadas que se deben pasar a la implementación de destino de tipo de cola del proveedor de mensajería de WebSphere MQ. En general, las propiedades personalizadas se utilizan para establecer atributos del destino de tipo de cola 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}
El ejemplo siguiente crea un destino de tipo de cola del proveedor de mensajería de WebSphere MQ.
- Utilizando Jython:
wsadmin>AdminTask.createWMQQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1"])
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)
- Utilizando Jacl:
wsadmin>$AdminTask createWMQQueue 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1}
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)