Mandato modifySIBWMQServer
El comando modifySIBWMQServer se usa para modificar un servidor IBM MQ.
Se puede modificar un servidor IBM MQ con la herramienta wsadmin, como se describe en este tema, o bien utilizando la consola administrativa como se describe en Modificación de una definición de servidor IBM MQ.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
- Si desea una lista de los mandatos 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('SIBAdminCommands')
- Si desea ayuda general sobre un mandato determinado,
especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('nombre_mandato')
AdminConfig.save()
Objetivo
Un servidor de IBM MQ representa un gestor de colas IBM MQ o un grupo de compartimiento de colas (para IBM MQ for z/OS). Este comando modifica un servidor IBM MQ. No es posible modificar los atributos name o type utilizando este mandato.
Objeto de destino
Un servidor IBM MQ seleccionado.
Parámetros necesarios
- -name
- El nombre del servidor IBM MQ. El nombre se especifica al crear la definición del servidor IBM MQ.
Parámetros condicionales
Ninguno
Parámetros opcionales
- -serverName
- El nombre del gestor de colas o del grupo de compartición de colas. Éste es el nombre mediante el cual se identifica el gestor de colas o grupo de compartición de colas. El valor es asignado por la administración IBM MQ para el recurso IBM MQ. El administrador siempre utiliza el mismo nombre que ha asignado la administración de IBM MQ.
- -host
- Un valor nuevo para el atributo host. Este valor es el nombre o la dirección IP del host con el que se establece una conexión cuando se comunica con un gestor de colas o un grupo de compartición de colas que representa este servidor IBM MQ. El valor es una serie y debe ser una de las siguientes:
- Nombre de host simbólico
- Dirección IPv4
- Dirección IPv6
- -bindingsMode
- Un valor nuevo para el atributo bindingsMode.
Este valor determina si se utilizarán las conexiones de modalidad de transporte de enlaces cuando se conecte a un gestor de colas o a un grupo de compartición de colas.
La conexión de modalidad de enlaces es posible si el servidor de aplicaciones y el gestor de colas están en el mismo nodo, pero la conexión sólo se autoriza para un único gestor de colas, aunque existan múltiples gestores de colas en el mismo nodo. Este parámetro tiene dos valores posibles:
- TRUE
- Se utiliza la modalidad de enlaces si está disponible. Si selecciona esta opción y la modalidad de enlaces no está disponible, el mecanismo de conexiones es de forma predeterminada la modalidad de transporte cliente.
- FALSE
- Siempre se utiliza la modalidad cliente.
- -port
- Nuevo valor para el atributo IBM MQ port. Este valor es el número de puerto TCP/IP en el que escucha el gestor de colas o el grupo de compartimiento de colas que representa este servidor IBM MQ. El valor predeterminado es 1414.
- -channel
- Nuevo valor para el atributo IBM MQ channel. Este valor es el nombre del canal cliente de IBM MQ que se utiliza cuando se conecta al gestor de colas o al grupo de compartición de colas que representa este servidor IBM MQ. Este nombre es asignado por la administración de IBM MQ al objeto IBM MQ y siempre debe ser utilizado por el administrador de WebSphere Application Server. El valor predeterminado es SYSTEM.DEF.SVRCONN.
- -description
- Un valor nuevo para el atributo description. Este valor es una breve descripción del servidor IBM MQ y solo se utiliza con fines administrativos.
- -securityAuthAlias
- Un valor nuevo para el atributo securityAuthorizationAlias. Este valor es el alias de autenticación que se utiliza cuando se conecta con un gestor de colas o un grupo de compartición de colas. Este parámetro no es el mismo que el alias de autenticación del descubrimiento.
- -transportChain
- Un valor nuevo para el atributo transportChain. Este valor es la cadena de transporte de salida que se utiliza cuando se establece una conexión con IBM MQ. El valor predeterminado es OutboundBasicWMQClient.
- -trustUserIds
- Un valor nuevo para el atributo trustUserIds.
Determina si los ID de usuario que se reciben en los mensajes procedentes de IBM MQ se propagan en el mensaje o no (es decir, si los ID de usuario que se reciben como parte de los datos del mensaje se utilizan en el bus de integración de servicios). El ID de usuario de aplicación se establece siempre a partir del valor RFH2 de jsAppUserId. Si no está presente, (ya sea porque no está presente el par clave/valor en la cabecera RFH2 o porque el mensaje no tiene cabecera RFH2), este campo no se establecerá. Si se establece este valor a FALSE, el identificador de usuario se sobrescribirá con el nombre del servidor IBM MQ. Este parámetro tiene dos valores posibles:
- TRUE
- Los ID usuario se propagan en los mensajes.
- FALSE
- Los ID usuario no se propagan en los mensajes.
- -allowDiscovery
- Un valor nuevo para el atributo allowDiscovery.
Este valor determina si se realiza
un descubrimiento automatizado de los recursos IBM MQ.
Este parámetro tiene dos valores posibles:
- TRUE
- El descubrimiento de recursos automatizado está habilitado.
- FALSE
- El descubrimiento de recursos automatizado está inhabilitado.
- -discoveryAuthAlias
- Un valor nuevo para el atributo discoveryAuthAlias. Este valor es el alias de autenticación que se utilizará cuando se establezca una conexión de descubrimiento de recursos con un gestor de colas o un grupo de compartición de colas, y no es lo mismo que el parámetro del alias autenticación de seguridad.
- -replyToQueue
- Un valor nuevo para el atributo replyToQueue. Este valor es la cola responder a que se debe utilizar para el descubrimiento de recursos, es el nombre asignado por la administración de IBM MQ al objeto IBM MQ y debe ser el nombre de una cola modelo para una cola dinámica temporal. La administración de WebSphere Application Server siempre debe utilizar el nombre acordado con la administración de IBM MQ. El valor predeterminado es SYSTEM.DEFAULT.MODEL.QUEUE.
Ejemplo
- Utilizando Jython:
wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM", "-allowDiscovery", "false"] )
- Utilizando Jacl:
wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM" -allowDiscovery false}