Mandato modifyWMQActivationSpec

Utilice el mandato modifyWMQActivationSpec para cambiar algunos parámetros de una especificación de activación del proveedor de mensajería de WebSphere MQ.

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 modifyWMQActivationSpec para modificar una especificación de activación del proveedor de mensajería de WebSphere MQ definido en el ámbito donde se emite el mandato.

Nota: No puede cambiar el tipo de una especificación de activación. Por ejemplo, no puede crear una especificación de activación donde se especifica toda la información de configuración manualmente y, a continuación, modificarla para que utilice una CCDT.
Para una especificación de activación basada en CCDT, no puede modificar ninguno de los parámetros siguientes:
  • qmgrName
  • qmgrHostname
  • qmgrPortNumber
  • qmgrSrvconnChannel
  • transportChain
  • wmqTransportType
Para una especificación de activación genérica, no puede modificar ninguno de los parámetros siguientes:
  • ccdtUrl
  • ccdtQmgrName

Objeto de destino

Una especificación de activación del proveedor de mensajería de WebSphere MQ en un ámbito específico.

Parámetros necesarios

Los parámetros para este mandato son idénticos a los utilizados para crear una especificación de activación del proveedor de mensajería de WebSphere MQ.

Parámetros opcionales

Los parámetros para este mandato son idénticos a los utilizados para crear una especificación de activación del proveedor de mensajería de WebSphere MQ.

Nota: Si se especifica uno de los parámetros -qmgrHostname o -qmgrPortNumber sin el parámetro -connectionNameList, se supone que ya no se debe utilizar ninguna lista de nombres de conexiones para conectarse a WebSphere MQ y que, en su lugar, se debe utilizar la información del nombre de host y del número de puerto especificados. Como resultado, el parámetro -connectionNameList se establece en blanco.

Tenga en cuenta el comportamiento de este mandato en el parámetro -customProperties.

-customProperties
Este parámetro especifica las propiedades personalizadas que se deben pasar a la implementación de especificación de activación de proveedor de mensajería de WebSphere MQ. En general, las propiedades personalizadas se utilizan para establecer atributos de la especificación de activación 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}

Por ejemplo, -WAS_EndpointInitialStatees una propiedad personalizada que se pueden utilizar con el parámetro -customProperties. El valor de -WAS_EndpointInitialStatedebe ser ACTIVE o INACTIVE. -WAS_EndpointInitialStatedetermina si el punto final está activado cuando el punto final está registrado. Si el parámetro se establece en activo, el consumo de mensajes empieza desde el destino JMS tan pronto como la especificación de activación se utiliza para un bean controlado por mensaje para conectarse con el destino.

Este parámetro debe ser ignorado para la activación o desactivación posterior mediante MBean J2CMessageEndpoint.

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 el que se ha proporcionado como parte de un mandato de modificación, la propiedad proporcionada se añadirá al conjunto de propiedades personalizadas, siempre que la propiedad personalizada no tenga un valor especificado cuando se descarte.
  • 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.

Ejemplo

  • Utilizando Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01")
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    
    wsadmin>AdminTask.listWMQActivationSpecs("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)")
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
    
    
    wsadmin>AdminTask.modifyWMQActivationSpec("spec1(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#J2CActivationSpec_1098737234986)", 
    ["-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic"]) 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
  • Utilizando Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    
    wsadmin>$AdminTask listWMQActivationSpecs
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
    
    
    wsadmin>$AdminTask modifyWMQActivationSpec
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
    {-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic} 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
  • En el ejemplo siguiente se modifica una especificación de activación activando la propiedad personalizada WAS_EndpointInitialState, utilizando Jython:
    wsadmin>AdminConfig.getid("/Node:myNode01")
    'myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)'
    wsadmin>wsadmin>AdminTask.listWMQActivationSpecs("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)")
    'newas(cells/myCell01/nodes/myNode01|resources.xml#J2CActivationSpec_1298546034140)'
    wsadmin>AdminTask.modifyWMQActivationSpec("newas(cells/myCell01/nodes/myNode01|resources.xml
    #J2CActivationSpec_1298546034140)", '-customProperties [[WAS_EndpointInitialState ACTIVE]]')

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_jmsas_modify
File name: rmj_wmq_jmsas_modify.html