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.

[IBM i][IBM i]El cliente de scripts wsadmin se ejecuta desde Qshell. [IBM i]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()

Finalidad

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 mandato crea un nuevo servidor IBM MQ en el ámbito de célula, y utiliza los valores proporcionados para llenar sus parámetros.
Nota: Al crear un servidor IBM MQ, es importante comprender el significado de los parámetros -name y -serverName. Por ejemplo, si la administración de WebSphere Application Server ha creado un objeto de servidor IBM MQ con el nombre "Mi servidor del área europea" que representaba un gestor de colas IBM MQ con el serverName QM1. La administración de WebSphere Application Server podrá crear un segundo objeto de servidor IBM MQ con el nombre "Mi servidor del RU", que también representara el mismo gestor de colas IBM MQ con el serverName QM1.

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.
El valor predeterminado es TRUE.
-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.
El valor predeterminado es TRUE.
-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}

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=rjfp_cli_mqserver_create
File name: rjfp_cli_mqserver_create.html