Mandato createSIBWMQServer
Utilice el mandato createSIBWMQServer para crear un nuevo servidor IBM MQ en el ámbito de célula.
Puede crear un nuevo servidor IBM MQ utilizando la herramienta wsadmin tal como se describe en este tema, o bien utilizando la consola administrativa como se describe Creación de un perfil de servidor de 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()
Finalidad
Objeto de destino
Una célula de WebSphere Application Server.
Parámetros necesarios
- -name
- Nombre del servidor IBM MQ. Este valor sólo tiene motivos administrativos y puede decidirlo el administrador. El nombre sólo tiene sentido dentro de la administración de WebSphere Application Server y debe ser exclusivo en el nivel de célula. No hay ningún valor predeterminado. Este parámetro no se puede modificar.
- -serverName
- El nombre del gestor de colas o del grupo de compartimiento de colas. Este valor es el nombre mediante el cual se identifica el gestor de colas o el grupo de compartimiento de colas y es asignado por la administración del IBM MQ para dicho objeto IBM MQ. El administrador de WebSphere Application Server debe utilizar siempre el nombre asignado por la administración de IBM MQ.
- -host
- El 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. Este valor es el nombre de host o la dirección IP del gestor de colas o del 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
- -transportChain
- La cadena de transporte de salida de Infraestructura de canales que se utilizará cuando se establezca una conexión con IBM MQ. Si no especifica esta opción, se presupone un valor predeterminado de OutboundBasicWMQClient.
Parámetros condicionales
Ninguno
Parámetros opcionales
Los atributos opcionales de host, puerto, canal y alias de autenticación especifican de forma conjunta la vía de acceso de la conexión con este servidor IBM MQ, para las aplicaciones de mensajería que se ejecutan en la integración de servicios. Para obtener más información, consulte Servidor IBM MQ: conexión y autenticación.
- -port
- 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 nombre del canal de cliente IBM MQ para utilizar al conectarse al gestor de colas o al grupo de compartimiento de colas que representa este servidor IBM MQ. Este valor es el nombre asignado por la administración de IBM MQ al objeto IBM MQ y siempre debe ser utilizado por la administración de WebSphere Application Server. El valor predeterminado es SYSTEM.DEF.SVRCONN.
- -description
- Descripción breve del servidor IBM MQ. Este valor sólo se utiliza por motivos administrativos.
- -securityAuthAlias
- El alias de autenticación que se utilizará cuando se conecte a un gestor de colas o a un grupo de compartimiento de colas. Este parámetro no se debería confundir con el alias de autenticación del descubrimiento.
- -trustUserIds
- Determina si el bus de integración de servicios pasa o no los
ID de usuario recibidos en los mensajes de
IBM MQ con los mensajes. 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 ha establecido este valor en FALSE, el ID de usuario se sobrescribe por 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
- Determina si se realiza un descubrimiento automatizado de los recursos IBM MQ. Este parámetro tiene dos valores posibles:
- TRUE
- Se utiliza el descubrimiento automatizado.
- FALSE
- No se utiliza el descubrimiento automatizado.
- -discoveryAuthAlias
- El alias de autenticación que se utilizará cuando se establezca una conexión de descubrimiento de recursos con el gestor de colas o el grupo de compartimiento de colas. Este valor no se debería confundir con el alias de autenticación de seguridad.
- -replyToQueue
- La cola de respuesta que se utilizará para el descubrimiento de recursos. Este valor es el nombre asignado por la administración de IBM MQ para el objeto IBM MQ y debe ser el nombre de una cola modelo para una cola dinámica temporal. El administrador de WebSphere Application Server debe utilizar siempre el nombre asignado por la administración de IBM MQ. El valor predeterminado es SYSTEM.DEFAULT.MODEL.QUEUE.
- -type
- Determina si el objeto de servidor IBM MQ es un gestor de colas o un grupo de compartimiento de colas, tal como lo determina la administración de WebSphere Application Server.
Este parámetro tiene dos valores posibles:
- MQ_QUEUE_MANAGER
- El servidor IBM MQ representa un gestor de colas. Si selecciona este valor, el proceso de descubrimiento de recursos recupera los nombres de cola que pertenecen a los gestores de colas.
- MQ_QUEUE_SHARING_GROUP
- El servidor IBM MQ representa un grupo de compartimiento de colas. Si selecciona este valor, el proceso de descubrimiento de recursos recupera los nombres de cola que pertenecen a los grupos de compartimiento de cola.
- -bindingsMode
- Determina si se utilizan las conexiones de modalidad de transporte de enlaces cuando se conecta con un gestor de colas o un grupo de compartimiento de colas.
Está disponible la conexión de modalidad de enlaces si el servidor de aplicaciones y el gestor de colas se encuentran en el mismo nodo. Sólo es posible conectarse a un gestor de colas único utilizando la modalidad de enlaces, 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.
Ejemplo
- Utilizando Jython:
wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", "-host", "findep01.ibm.com", "-port", 1414, "-transportChain", "OutboundSecureWMQClient"])
- Utilizando Jacl:
wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" -serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true -host findep01.ibm.com -port 1414 -transportChain OutboundSecureWMQClient}