Mandato modifySIBJMSQueue

Utilice el mandato modifySIBJMSQueue para cambiar las propiedades de una 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()

Objetivo

El mandato modifySIBJMSQueue cambia las propiedades de una cola JMS para el proveedor de mensajería predeterminado en un ámbito específico.

Objeto de destino

Una cola JMS.

Parámetros necesarios

Ninguno.

Parámetros opcionales

-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.
-description
Descripción opcional para el bus a efectos 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 no se ha proporcionado este parámetro.
-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 ha configurado el destino de bus,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 solicitud. 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.

Ejemplo

  • Utilizando Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)'
    
    wsadmin>AdminTask.modifySIBJMSQueue("jmsq2(cells/9994GKCNode01Cell/nodes/
    9994GKCNode01|resources.xml#J2CAdminObject_1098737234986)", 
    ["-queueName", "q2forjms"])
    '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 modifySIBJMSQueue 
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)
     {-queueName q2forjms}
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_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=rjn_jmsqueue_modify
File name: rjn_jmsqueue_modify.html