Mandato manageWMQ

Utilice el mandato manageWMQ para gestionar los valores del adaptador de recursos de IBM MQ que ha instalado en un ámbito concreto.

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 manageWMQ para gestionar los valores asociados al adaptador de recursos de IBM MQ que ha instalado en un ámbito concreto.

Puede utilizar el mandato manageWMQ para gestionar la vía de acceso de la biblioteca nativa y consultar los metadatos del adaptador de recursos IBM MQ especificado.

Objeto de destino

Un adaptador de recursos de IBM MQ.

Parámetros necesarios

Ninguno.

Parámetros opcionales

-nativePath
Este parámetro especifica la vía de acceso a las bibliotecas nativas del proveedor de mensajería de IBM MQ que el adaptador de recursos de IBM MQ utiliza para establecer una conexión de modalidad de enlaces con el gestor de colas. Este parámetro se puede especificar en un adaptador de recursos de IBM MQ en cualquier ámbito.
-query
Este parámetro proporciona información sobre el nivel del adaptador de recursos de IBM MQ que utiliza el proveedor de mensajería de IBM MQ. Este parámetro se puede especificar en un adaptador de recursos de IBM MQ en cualquier ámbito.
[z/OS]-enableInbound
[z/OS]Este parámetro permite la entrega de mensajes JCA (Java™ EE (Java Platform, Enterprise Edition) Connector Architecture) entrantes a las especificaciones de activación del adaptador de recursos de IBM MQ en la plataforma z/OS. Este valor sólo se puede especificar si el adaptador de recursos de IBM MQ de destino está en el ámbito de servidor. Si es necesario, se reinicia un servidor de aplicaciones para que estos cambios entren en vigor.

El valor de este parámetro debe ser true o false.

El valor predeterminado es false.

-disableWMQ
Este parámetro especifica si inhabilitar o no la funcionalidad de IBM MQ en el ámbito del adaptador de recursos especificado y en todos los ámbitos por debajo.

El valor de este parámetro debe ser true o false.

El valor predeterminado es false.

En un entorno de servidor único, este parámetro sólo es válido en el ámbito de servidor. En un entorno de despliegue de red, este parámetro es válido en todos los ámbitos. El efecto de establecer el valor de este parámetro en true depende del ámbito en el que lo establece:

  • Para un adaptador de recursos de IBM MQ con ámbito de célula, se inhabilita toda la funcionalidad de IBM MQ en todos los servidores de aplicaciones de la célula.
  • Para un adaptador de recursos de IBM MQ con ámbito de nodo, se inhabilita toda la funcionalidad de IBM MQ en todos los servidores de aplicaciones que forman parte del nodo.
  • Para un adaptador de recursos de IBM MQ con ámbito de clúster, se inhabilita toda la funcionalidad de IBM MQ en todos los servidores de aplicaciones del clúster.
  • Para un adaptador de recursos de IBM MQ con ámbito de servidor, se inhabilita toda la funcionalidad de IBM MQ en dicho servidor de aplicaciones.

En todos los casos, todos los procesos afectados se deben reiniciar para que los cambios surtan efecto.

El valor del parámetro en un ámbito superior prevalece sobre el valor de ámbitos inferiores. Por ejemplo, si establece el parámetro en false en el ámbito de servidor pero un proveedor de mensajería de IBM MQ de un ámbito superior (por ejemplo, de célula) está establecido en true, el valor de ámbito de célula prevalece y la funcionalidad de IBM MQ se inhabilita para todos los servidores de aplicaciones de la célula, independientemente del valor del parámetro en el ámbito del servidor.

-maxConnections
Este parámetro especifica el número máximo de conexiones a un gestor de colas de IBM MQ.

El valor predeterminado es 10.

Para obtener más información, consulte Configuración del objeto ResourceAdapter en el Information Center de IBM MQ.

-connectionConcurrency
Este parámetro especifica el número máximo de beans controlados por mensaje que puede suministrar cada conexión.

El valor predeterminado es 1.

El establecimiento de esta propiedad solamente afecta a nodos de la versión 7 de WebSphere Application Server. La propiedad no tiene repercusión para los nodos de WebSphere Application Server versión 8 o posteriores.

Para obtener más información, consulte Configuración del objeto ResourceAdapter en el Information Center de IBM MQ.

-reconnectionRetryCount
Este parámetro especifica el número máximo de intentos realizados por una especificación de activación de proveedor de mensajería de IBM MQ para volver a conectarse a un gestor de colas de IBM MQ si falla una conexión.

El valor predeterminado es 5.

Para obtener más información, consulte Configuración del objeto ResourceAdapter en el Information Center de IBM MQ.

-reconnectionRetryInterval
Este parámetro especifica el tiempo, en milisegundos, que una especificación de activación de proveedor de mensajería de IBM MQ espera antes de realizar otro intento de volver a conectarse a un gestor de colas de IBM MQ.

El valor predeterminado es 300000.

Para obtener más información, consulte Configuración del objeto ResourceAdapter en el Information Center de IBM MQ.

-customProperties
Este parámetro especifica las propiedades personalizadas que se deben pasar al adaptador de recursos de IBM MQ. En general, las propiedades personalizadas se utilizan para establecer atributos del adaptador de recursos de IBM MQ a los que no se da soporte directamente a través de las interfaces de administración de WebSphere Application Server.
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}
Se han añadido nuevos pares de nombre/valor al conjunto existente de propiedades personalizadas utilizando las reglas siguientes:
  • Si el conjunto de propiedades existente no contiene una propiedad con el mismo nombre que la que se proporciona, se añade la propiedad proporcionada al conjunto de propiedades personalizadas, a menos que la propiedad personalizada no tenga ningún valor especificado, en cuyo caso se descarta.
  • Si el conjunto de propiedades existente contiene una propiedad con el mismo nombre que la proporcionada como parte de un mandato de modificación, y dicho mandato también especifica un valor para la propiedad, el valor existente se sustituye por el valor proporcionado.
  • Si el conjunto de propiedades existente contiene una propiedad con el mismo nombre que la que se ha proporcionado como parte de un mandato de modificación, pero el mandato de modificación no especifica un valor para la propiedad, la propiedad con el mismo nombre se suprimirá del conjunto existente de propiedades personalizadas.

Ejemplos

En el ejemplo siguiente se muestra cómo habilitar la entrega de mensajes JCA entrantes en la plataforma z/OS.
  • En Jython:
    wsadmin>AdminTask.manageWMQ("IBM MQ Resource Adapter
    (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml#
    J2CResourceAdapter_1201601803796)", ["-enableInbound true"])
  • En Jacl:
    wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter
    (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml#
    J2CResourceAdapter_1201601803796)" {-enableInbound true}
En el ejemplo siguiente se establece el valor de -maxConnections en 100 y se añade una propiedad personalizada con el nombre name1 y el valor value1.
  • En Jython:
    AdminTask.manageWMQ("IBM MQ Resource Adapter(
    cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)",
    ["-maxConnections 100 -customProperties [[name1 value1]]"])
  • En Jacl:
    wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter(
    cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)"
    {-maxConnections 100 -customProperties {{name1 value1}}}

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_jmswmq_manage
File name: rmj_wmq_jmswmq_manage.html