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.

[IBM i]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.

Para obtener una lista de los mandatos administrativos del proveedor de mensajería IBM MQ disponibles, además de una breve descripción de cada mandato, especifique el mandato siguiente en el indicador de wsadmin:

print AdminTask.help('WMQAdminCommands')

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. Por ejemplo, utilice el mandato siguiente:

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.

No puede crear un destino de tipo de cola del proveedor de mensajería de WebSphere MQ bajo alguna de las condiciones siguientes:
  • 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:
  • APP
    Nota: (APP es sensible a mayúsculas y minúsculas.)
  • QDEF
    Nota: (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.

-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:
  • APP
    Nota: (APP es sensible a mayúsculas y minúsculas.)
  • UNLIM
    Nota: (UNLIM no es sensible a mayúsculas y minúsculas.)
  • <Cualquier entero positivo>

El valor predeterminado es 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}
Nota: En los siguientes ejemplos, los bloques de código que empiezan con wsadmin> muestran código especificado por el usuario. Las líneas que no empiezan con wsadmin> muestran código que ha devuelto la consola.

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) 

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