Mandato modifyWMQConnectionFactory

Utilice el mandato modifyWMQConnectionFactory para cambiar algunos parámetros de una fábrica de conexiones 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()

Objetivo

Utilice el mandato modifyWMQConnectionFactory para modificar una fábrica de conexiones del proveedor de mensajería de WebSphere MQ definido en el ámbito donde se emite el mandato.

Nota: Al modificar una fábrica de conexiones del proveedor de mensajería de WebSphere MQ, hay una interacción entre los parámetros mappingAlias y containerAuthAlias. Esta interacción se produce si se especifica el parámetro containerAuthAlias, pero no se especifica el parámetro mappingAlias. En esta situación, el parámetro mappingAlias se establece automáticamente en el valor DefaultPrincipleMapping.

Objeto de destino

Una fábrica de conexiones del proveedor de mensajería WebSphere MQ en el ámbito específico.

Parámetros necesarios

Los parámetros para este mandato son idénticos a los utilizados para crear una fábrica de conexiones 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 fábrica de conexiones del proveedor de mensajería de WebSphere MQ.

Nota: Si se especifican los parámetros -qmgrHostname o -qmgrPortNumber sin que se especifique el parámetro -connectionNameList, se da por supuesto que la lista de nombres de conexión deje de utilizarse para conectarse a WebSphere MQ y que en su lugar se utilice la información especificada de nombre de host y de número de puerto. 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 fábrica de conexiones de proveedor de mensajería de WebSphere MQ. En general, las propiedades personalizadas se utilizan para establecer atributos de la fábrica de conexiones 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}
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.listWMQConnectionFactories("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)") 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)  
    
    wsadmin>AdminTask.modifyWMQConnectionFactory("cf1(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#MQConnectionFactory_1098737234986)", ["-description
     'My new description'"])  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)
  • Utilizando Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    
    wsadmin>$AdminTask listWMQConnectionFactories 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)  
    
    wsadmin>$AdminTask modifyWMQConnectionFactory 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986) {-description "My new description"}  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_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_jmscf_modify
File name: rmj_wmq_jmscf_modify.html