Mandato createSIBJMSQueue

Utilice el mandato createSIBJMSQueue para crear una nueva cola JMS para el proveedor de mensajería predeterminado en un ámbito específico.

Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.

[IBM i][IBM i]El cliente de scripts wsadmin se ejecuta desde Qshell. [IBM i]Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.

Para los mandatos del bus de integración de servicios se proporciona ayuda de línea de mandatos:
  • Si desea una lista de los mandatos de JMS 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('SIBJMSAdminCommands')

  • 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 utilizando el mandato siguiente:

AdminConfig.save()

Finalidad

El mandato createSIBJMSQueue crea una cola JMS para el proveedor de mensajería predeterminado en un ámbito específico.

Objeto de destino

El ámbito del proveedor de mensajería predeterminado en el cual se va a crear la cola JMS.

Parámetros necesarios

-name
El identificador mediante el cual es conocida esta cola JMS para fines administrativos.
-jndiName
El nombre JNDI que se utiliza para enlazar la cola con el espacio de nombres del servidor de aplicaciones.
-queueName
El nombre del destino de bus de integración de servicios con el que se correlaciona la cola JMS.

Parámetros opcionales

-description
Una descripción opcional del bus para fines administrativos.
-deliveryMode Application | NonPersistent | Persistent
La modalidad de entrega que debe utilizar MessageProducers para los mensajes enviados a esta cola.
-timeToLive
La longitud de tiempo predeterminada desde su tiempo de entrega que un mensaje enviado a esta cola se conservará en el sistema, donde 0 indica que el valor del tiempo de duración no caduca. Se utiliza el valor del generador si el parámetro Tiempo de vida no se ha suministrado.
-priority
La prioridad para los mensajes enviados a esta cola. Se utiliza el valor del generador si no se ha completado. En el rango de 0 a 9, donde 0 es la prioridad más baja y 9 es la prioridad más alta.
-readAhead AsConnection | AlwaysOn | AlwaysOff
Se utiliza para controlar la optimización de lectura anticipada durante la entrega de mensajes. El valor predeterminado es AsConnection.
-busName
El nombre del bus de integración de servicios en el que se configura el destino de bus de integración de servicios, identificado mediante el parámetro queueName. Si no está establecido, se utiliza el bus al que está conectada la aplicación.
-scopeToLocalQP TRUE | FALSE
Indica si el ámbito del destino de la cola del bus de integración de servicios subyacente es un punto de cola local cuando se direcciona utilizando esta cola JMS. Un punto de cola local es un punto de cola configurado en el motor de mensajería al cual está conectada la aplicación JMS. La opción se aplica cuando se utiliza esta cola JMS para enviar y recibir mensajes y cuando se establece una cola de respuesta en un mensaje de petición. Cuando se ha establecido una cola de respuesta en un mensaje de solicitud, el punto de cola local se encuentra en el motor de mensajería al está conectada la aplicación que establece la cola de respuesta y no al motor de mensajería que al que la aplicación que utiliza la cola de respuesta envía el mensaje de respuesta. Si el motor de mensajería conectado no tiene un punto de cola para el destino, esta opción se ignora. El valor predeterminado es FALSE.

Sólo se permite cambiar el valor predeterminado de esta opción cuando ésta es utilizada por una aplicación JMS que se ejecuta con un servidor o cliente WebSphere Application Server Versión 7.0 o posterior y está conectada a un motor de mensajería que se ejecuta en un servidor WebSphere Application Server Versión 7.0 o posterior. La utilización de WebSphere Application Server en versiones anteriores causará una excepción en la aplicación.

-producerBind TRUE | FALSE
Indica cómo se enlazan los generadores JMS a los puntos de cola de la cola en clúster. El valor predeterminado es FALSE.

Sólo se permite cambiar el valor predeterminado de esta opción cuando ésta es utilizada por una aplicación JMS que se ejecuta con un servidor o cliente WebSphere Application Server Versión 7.0 o posterior y está conectada a un motor de mensajería que se ejecuta en un servidor WebSphere Application Server Versión 7.0 o posterior. La utilización de WebSphere Application Server en versiones anteriores causará una excepción en la aplicación.

TRUE
El sistema de mensajería selecciona un punto de cola cuando esté abierta la sesión. Todos los mensajes generados por la sesión se envían al punto de cola elegido. El sistema de mensajería utiliza el valor producerPreferLocal para seleccionar el punto de cola.
FALSE
El sistema de mensajería selecciona un punto de cola cada vez que se envía un mensaje, equilibrando potencialmente la carga de trabajo de los mensajes entre todos los puntos de cola disponibles. El sistema de mensajería utiliza el valor producerPreferLocal para seleccionar el punto de cola.
-producerPreferLocal TRUE | FALSE
Indica si se prefiere un punto de cola que es local al generador respecto a otros puntos de cola disponibles cuando el sistema de mensajería selecciona un punto de cola al que generar mensajes. Un punto de cola local es un punto de cola configurado en el motor de mensajería al cual está conectada la aplicación JMS. El valor predeterminado es TRUE.

Sólo se permite cambiar el valor predeterminado de esta opción cuando ésta es utilizada por una aplicación JMS que se ejecuta con un servidor o cliente WebSphere Application Server Versión 7.0 o posterior y está conectada a un motor de mensajería que se ejecuta en un servidor WebSphere Application Server Versión 7.0 o posterior. La utilización de WebSphere Application Server en versiones anteriores causará una excepción en la aplicación.

-consumerGatherMessages TRUE | FALSE
Un consumidor o navegador JMS está conectado a un único punto de cola del destino de bus de integración de servicios mediante el sistema de mensajería. Este parámetro indica si un consumidor o navegador JMS toma los mensajes de cualquier punto de cola disponible del destino de bus de integración de servicios (TRUE), o bien del único punto de cola al que está conectado (FALSE). El valor predeterminado es FALSE. La recopilación de mensajes desde varios puntos de cola produce una mayor sobrecarga de rendimiento y no puede mantenerse el orden de los mensajes.

Sólo se permite cambiar el valor predeterminado de esta opción cuando ésta es utilizada por una aplicación JMS que se ejecuta con un servidor o cliente WebSphere Application Server Versión 7.0 o posterior y está conectada a un motor de mensajería que se ejecuta en un servidor WebSphere Application Server Versión 7.0 o posterior. La utilización de WebSphere Application Server en versiones anteriores causará una excepción en la aplicación.

Ejemplos

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.
  • Utilizando Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)'
    wsadmin>AdminTask.createSIBJMSQueue("WASINSTALL2Node01(cells/WASINSTALL2Cell01/
    nodes/WASINSTALL2Node01|node.xml#Node_1)", ["-name", "jmsq2", "-jndiName",
     "jms/jnmsq2", "-queueName", "busq4jmsq2"])
    'jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml
    #J2CAdminObject_1098737234986)'
    wsadmin>AdminTask.listSIBJMSQueues("WASINSTALL2Node01(cells/WASINSTALL2Cell01
    /nodes/WASINSTALL2Node01|node.xml#Node_1)")
    'queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098711838691)
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)'
  • Utilizando Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>$AdminTask createSIBJMSQueue 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
     {-name jmsq2 -jndiName jms/jnmsq2 -queueName busq4jmsq2}
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)
    wsadmin>$AdminTask listSIBJMSQueues 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098711838691)
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)
En el ejemplo siguiente se muestra cómo crear una cola JMS de proveedor de mensajería predeterminada que selecciona un punto de cola cuando se abre una sesión y que nunca se modifica:
  • Utilizando Jython:
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-producerBind", "TRUE"])
  • Utilizando Jacl:
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -producerBind TRUE }
En el ejemplo siguiente se muestra cómo crear una cola JMS de proveedor de mensajería predeterminado que selecciona un punto de cola cada vez que se envía un mensaje. No existe ninguna preferencia sobre qué punto de cola seleccionar y los consumidores obtienen los mensajes de cualquier punto de cola:
  • Utilizando Jython:
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-producerBind", "FALSE",
     "-producerPreferLocal", "FALSE", "-gatherMessages", "TRUE"])
  • Utilizando Jacl:
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -producerBind FALSE -producerPreferLocal FALSE 
    -gatherMessages TRUE}
El ejemplo siguiente muestra cómo crear la cola JMS de proveedor de mensajería predeterminado que tiene como ámbito todas las operaciones hasta el punto local de cola en el usuario de la cola JMS:
  • Utilizando Jython:
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-scopeToLocalQP", "TRUE"])
  • Utilizando Jacl:
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -scopeToLocalQP TRUE}

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