Mandato modifySIBWMQServerBusMember
El comando modifySIBWMQServerBusMember se usa para modificar los atributos de un miembro del bus del 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.
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 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')
Después de utilizar el mandato,
guarde los cambios en la configuración maestra utilizando el mandato siguiente:
AdminConfig.save()
Objetivo
Un miembro de bus del servidor IBM MQ se utiliza para asignar puntos de cola y de mediación a las colas IBM MQ. Este mandato modifica los atributos de un miembro del bus del servidor IBM MQ.
Objeto de destino
Un miembro de bus del servidor IBM MQ seleccionado.
Parámetros necesarios
- -name
- Este valor es el nombre que ha especificado en el parámetro -name al crear la definición del servidor IBM MQ.
- -bus
- El nombre del bus de integración de servicios del que es miembro el servidor IBM MQ.
Parámetros condicionales
Ninguno
Parámetros opcionales
- -virtualQueueManagerName
- Cuando se envían mensajes a IBM MQ, el gestor de colas de pasarela de IBM MQ ve el bus como un gestor de colas remoto. El nombre del gestor de colas virtual es el nombre que se pasa a
IBM MQ
como nombre de ese gestor de colas remoto. El valor predeterminado es el nombre del bus de integración de servicios. Si este nombre de bus no es un nombre válido para un gestor de colas IBM MQ, o si ya existe otro gestor de colas IBM MQ con el mismo nombre, entonces sustituya el valor predeterminado por un nombre válido, exclusivo, para un gestor de colas IBM MQ.
- Debe contener entre 1 y 48 caracteres.
- Debe cumplir con las reglas de denominación de colas de IBM MQ (consulte el tema Reglas para la denominación de objetos de IBM MQ en el centro de información de IBM MQ).
- -host
- El valor nuevo para el atributo host que se ha alterado temporalmente.
Este valor es el nombre o la dirección IP del host con el que se establece una conexión para la comunicación con un gestor de colas o un grupo de compartimiento 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
- -port
- El valor nuevo para el atributo port que se ha alterado temporalmente. 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
- El valor nuevo para el atributo de canal alterado temporalmente. Este valor es el nombre del canal cliente de IBM MQ que se utiliza cuando se conecta al gestor de colas o al grupo que comparte colas que representa este servidor IBM MQ. El valor predeterminado es SYSTEM.DEF.SVRCONN.
- -securityAuthAlias
- El valor nuevo para el atributo securityAuthAlias alterado temporalmente. 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
- El valor nuevo para el atributo transportChain que se ha alterado temporalmente. 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 TRUE | FALSE
- El valor nuevo para el atributo trustUserIds alterado temporalmente.
Este valor determina si los identificadores de usuario que se reciben en los mensajes procedentes de IBM MQ se propagan en el mensaje (es decir, si los identificadores de usuario que se reciben como parte de los datos del mensaje se utilizan en el bus de integración de servicios). El identificador de usuario de la 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 ha establecido este valor en FALSE, el identificador de usuario se sobrescribirá con el nombre del servidor IBM MQ. Este parámetro tiene dos valores posibles:
- TRUE
- Los identificadores de usuario se propagan en los mensajes.
- FALSE
- Los identificadores de usuario no se propagan en los mensajes.
Ejemplo
- Utilizando Jython:
wsadmin>AdminTask.modifySIBWMQServerBusMember(["-name", "Finance dept QM-Bus1", "-bus", "Bus1", "-trustUserIds", "false"])
- Utilizando Jacl:
wsadmin>$AdminTask modifySIBWMQServerBusMember {-name "Finance dept QM-Bus1" -bus Bus1 -trustUserIds false}