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.

[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 createWMQTopic para crear un destino de tipo de tema del proveedor de mensajería de WebSphere MQ en un ámbito específico.

No puede crear un destino de tipo de tema del proveedor de mensajería de WebSphere MQ bajo alguna de las condiciones siguientes:
  • 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:
  • 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)>
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
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:
  • 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.

-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}
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.
En el siguiente ejemplo se crea una definición de tema, especificando el mínimo número de parámetros.
  • 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)

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_jmstopic_create
File name: rmj_wmq_jmstopic_create.html