Mandato createSIBMQLink

Utilice el mandato createSIBMQLink para crear un nuevo enlace IBM MQ para un bus de integración de servicios especificado.

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

El mandato createSIBMQLink crea un nuevo enlace IBM MQ para un bus de integración de servicios especificado. El enlace IBM MQ conecta un motor de mensajería como un gestor de colas a IBM MQ y, de este modo, proporciona un puente entre un bus de integración de servicios y una red IBM MQ.

Objeto de destino

Un bus.

Parámetros necesarios

-bus
El nombre del bus de integración de servicios para el cual desea crear el enlace de bus de IBM MQ. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
-messagingEngine
El nombre del motor de mensajería para el cual desea crear el enlace IBM MQ. El enlace IBM MQ conecta un motor de mensajería como un gestor de colas a IBM MQ y, de este modo, proporciona un puente entre un bus de integración de servicios y una red IBM MQ.
-name
El nombre mediante el cual desea que se conozca el enlace IBM MQ.
-foreignBusName
El nombre del bus foráneo que define la red IBM MQ para el enlace IBM MQ. Puede utilizar el mandato listSIBForeignBuses para lista los nombres de los buses foráneos existentes.
-queueManagerName
El nombre del gestor de colas virtual asociado al motor de mensajería, y a través del cual es conocido el motor de mensajería para una red IBM MQ remota.

El nombre del gestor de colas cumple los convenio de denominación de IBM MQ; por ejemplo, el nombre debe tener como máximo 48 caracteres.

-senderChannelTransportChain OutboundBasicMQLink | OutboundSecureMQLink
El nombre del canal emisor que envía los mensajes al gestor de colas de la pasarela. El canal emisor se comunica con un canal receptor IBM MQ en el gestor de colas de pasarela, y convierte los mensajes del bus de integración de servicios a mensajes de formato MQ.

Parámetros condicionales

Ninguna.

Parámetros opcionales

Parámetros de configuración del enlace IBM MQ:
-description
Descripción opcional para el bus a efectos administrativos.
-exceptionDestination
El destino de un mensaje de entrada cuando el enlace IBM MQ no puede entregar el mensaje a su destino de bus señalado, o al destino de excepción que se haya configurado para dicho destino, o cuando el destino no existe.
Sistema
El enlace IBM MQ utiliza el destino de excepción predeterminado. Todos los mensajes que no se pueden entregar al destino de bus se redireccionan automáticamente al destino de excepción predeterminado del sistema para el motor de mensajería al que se haya asignado este enlace: _SYSTEM.Exception.Destinationnombre_motor_mensajería.
Ninguno
El enlace IBM MQ no tiene ningún destino de excepción. Los mensajes no entregados no se redireccionan a un destino de excepción, y pueden bloquear el proceso de otros mensajes que estén esperando a que se entreguen a través del enlace al mismo bus. Esta opción se puede utilizar para conservar el orden de los mensajes.
Especificar
El enlace IBM MQ utiliza el destino de excepción especificado aquí. Si esto no es posible, utiliza el destino de excepción del sistema.
-batchSize

El tamaño de lote no afecta al modo en que los canales emisor y receptor para este enlace transfieren los mensajes. Los mensajes siempre se transfieren individualmente, pero se confirman o se retrotraen como un lote.

Para obtener más información acerca de cómo seleccionar el tamaño de lote, consulte la descripción de la propiedad de tamaño de lote (BATCHSZ) en la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 50
Rango 1 a 9999
-maxMsgSize

Para obtener información sobre cómo elegir un número adecuado, consulte la descripción de la propiedad de longitud máxima de mensaje (MAXMSGL) en la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 4194304 bytes (4 MB)
Rango 0 a 104857600

Especifique 0 para utilizar el valor más alto que pueda admitir el gestor de colas de destino.

-heartBeat

Los pulsos permiten al canal receptor inmovilizar la conexión de canal.

Para obtener más información acerca de cómo seleccionar el valor de esta propiedad, consulte la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 300 segundos
Rango 0 a 999999
-sequenceWrap
Por ejemplo, si especifica un valor de 1000, cuando el número de secuencia de mensajes alcanza 1001, se reiniciará en 1.

Para obtener más información acerca de cómo seleccionar el valor esta propiedad, consulte la descripción de la propiedad de reinicio de número de secuencia (SEQWRAP) en la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 999999999
Rango 1 a 999999999
-nonPersistentMessageSpeed Fast | Normal
Información Valor
Valor predeterminado Rápido
Rango
Rápido
Los mensajes no persistentes se pueden perder si existe una anomalía de transmisión o si el canal se detiene cuando los mensajes están en tránsito.
Normal
Los mensajes no persistentes no se pierden si existe una anomalía de transmisión o si el canal se detiene cuando los mensajes están en tránsito.
-adoptable True | False
Una propiedad del enlace IBM MQ, que muestra si se debe adoptar una instancia de un canal receptor del enlace IBM MQ (asociada a este enlace IBM MQ) que se está ejecutando. En el caso de una anomalía de comunicaciones, es posible que una instancia en ejecución de un canal receptor del enlace IBM MQ esté a la espera de mensajes. Cuando se vuelve a establecer la comunicación y el canal emisor de IBM MQ de asociado efectúa el siguiente intento de establecer una sesión con el canal receptor del enlace de IBM MQ, la solicitud fallará ya que hay una instancia en ejecución del canal receptor del enlace de IBM MQ que cree que comparte una sesión con el canal receptor del enlace de IBM MQ de asociado. Puede solucionar este problema seleccionando esta opción, que hace que la instancia que ya está en ejecución del canal receptor del enlace IBM MQ se detenga y se inicie otra instancia nueva.

Si establece esta opción en True, es posible que los canales emisores de IBM MQ vuelvan a establecer una conexión con este enlace IBM MQ, en el caso de que se produzca un error de comunicaciones y el enlace todavía no haya detectado la condición de error.

Información Valor
Valor predeterminado True
-initialState Started | Stopped
El estado del enlace IBM MQ, que muestra si el enlace se ha iniciado o detenido cuando se inicia por primera vez el motor de mensajería que lo aloja. Hasta que se inicia, el enlace IBM MQ no está disponible.
Información Valor
Valor predeterminado Iniciado
Rango
Detenido
Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ está en un estado detenido y no se puede comunicar con la red IBM MQ.
Iniciado
Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ se inicia automáticamente y está habilitado para la comunicación con la red IBM MQ.
Parámetros de canal emisor de enlace IBM MQ:
-senderChannelName

Este nombre debe ser igual que el nombre del canal receptor en IBM MQ.

Para obtener más información acerca de cómo seleccionar nombres de canal, consulte la descripción de la propiedad de nombre de canal (CHANNEL) en la sección Intercomunicación del Information Center de IBM MQ.

-hostName
El nombre de host o la dirección TCP/IP del gestor de colas de pasarela que se utiliza para conectarse a la red IBM MQ.

Escriba el nombre de host o la dirección IP del host en donde se ejecuta el gesto de colas de pasarela.

Si este campo está en blanco, se da por supuesto que el gestor de colas de pasarela se ejecutará en el mismo host que el motor de mensajería en el cual se ha definido el enlace IBM MQ.

-port
Información Valor
Valor predeterminado 1414
Rango De 0 a 65535
-connameList
La lista de nombres de conexión para el gestor de colas de pasarela que se utiliza para conectarse a la red IBM MQ. Las conexiones se intentan en el orden en el que se especifican en la lista de nombres de conexión hasta que se establece correctamente una conexión. Si no hay ninguna conexión satisfactoria, el canal inicia el proceso de reintento.

Los nombres de conexión deben proporcionarse como una lista separada por comas en el formato siguiente:

NombreDns1(NúmeroPuerto1) , NombreDns2(NúmeroPuerto2)

Escriba el nombre DNS o la dirección IP del host en el que el gestor de colas de pasarela se está ejecutando. Escriba el número de puerto en el rango de 0 a 65535.

Si no especifica el parámetro de lista de nombres de conexión, se da por supuesto que el gestor de colas de pasarela se ejecuta en el mismo host que el motor de mensajería en el cual se ha definido el enlace IBM MQ.

Si no especifica el parámetro de lista de nombres de conexión, debe haber especificado un valor para el parámetro de nombre del canal emisor; de lo contrario, el valor que especifique para el parámetro de lista de nombres de conexión se ignora.

Si especifica el parámetro de nombre de host y puerto, así como el parámetro de lista de nombres de conexión y, en tiempo de ejecución la lista de nombres de conexión tiene prioridad y los valores de nombre de host y puerto se ignoran.

-discInterval

El valor predeterminado es un intervalo razonable. Cambie este valor sólo si conoce su repercusión en el rendimiento y necesita especificar un valor diferente debido a los requisitos del flujo de tráfico hacia los canales.

El valor especificado para el intervalo de desconexión afecta al rendimiento. Un valor muy bajo (unos pocos segundos) puede provocar una carga excesiva de proceso al iniciar constantemente el canal. Un valor muy alto (más de una hora) podría significar que los recursos del sistema se retrasen innecesariamente.

Si desea que los canales estén activos sólo cuando existan mensajes para ellos que deben transmitirse, debería establecer el intervalo de desconexión en un valor realmente bajo. Tenga en cuenta que el valor predeterminado es algo alto y no es recomendable para canales en los que se necesite este nivel de control. Como es difícil interrumpir el canal de recepción, la opción más económica es que el canal se desconecte y vuelva a conectar automáticamente según los requisitos de carga de trabajo. En la mayoría de los canales, el valor adecuado del intervalo de desconexión puede establecerse de forma heurística.

Información Valor
Valor predeterminado 900 segundos
Rango 0 a 999999

Un valor de 0 (cero) significa que no se desconecta nunca; el canal espera de forma indefinida los mensajes.

-shortRetryCount

Para obtener más información acerca de cómo utilizar los mecanismos de reintento con IBM MQ, consulte la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 10
Rango 0 a 999999999
-shortRetryInterval

Para obtener más información acerca de cómo utilizar los mecanismos de reintento con IBM MQ, consulte la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 60 segundos
Rango 0 a 999999
-longRetryCount

Para obtener más información acerca de cómo utilizar los mecanismos de reintento con IBM MQ, consulte la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 999999999
Rango 0 a 999999999
-longRetryInterval

Para obtener más información acerca de cómo utilizar los mecanismos de reintento con IBM MQ, consulte la sección Intercomunicación del Information Center de IBM MQ.

Información Valor
Valor predeterminado 1200 segundos
Rango 0 a 999999
-senderChannelInitialState Started | Stopped
El estado del enlace IBM MQ, que muestra si el canal emisor se inicia o se detiene cuando se inicia por primera vez el enlace IBM MQ asociado. Hasta que se inicia, el canal no está disponible.
Información Valor
Valor predeterminado Iniciado
Rango
Detenido
Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ está en un estado detenido y no se puede comunicar con la red IBM MQ.
Iniciado
Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ se inicia automáticamente y está habilitado para la comunicación con la red IBM MQ.
Parámetros de canal receptor de enlace IBM MQ:
-receiverChannelName

Este nombre debe ser igual que el nombre del canal emisor en IBM MQ.

-inboundNonPersistentReliability Best Effort | Reliable

Esta opción de entrega de fiabilidad se asigna a todos los mensajes no persistentes de IBM MQ que fluyen sobre este canal receptor.

Información Valor
Valor predeterminado Fiable
Rango
Mejor esfuerzo
Los mensajes se descartan cuando se detiene o falla un motor de mensajería. Los mensajes también se pueden descartar, si una conexión utilizada para enviarlos deja de estar disponible o como resultado de los recursos del sistema limitados.
Express
Los mensajes se descartan cuando se detiene o falla un motor de mensajería. Los mensajes también pueden ser descartados si una conexión utilizada para enviarlos deja de estar disponible.
Fiable
Los mensajes se descartan cuando se detiene o falla un motor de mensajería.
-inboundPersistentReliability Reliable | Assured
Información Valor
Valor predeterminado Garantizado
Rango
Fiable
Los mensajes pueden descargarse si un motor de mensajería da error.
Garantizado
Los mensajes no se descartan.
-receiverChannelInitialState Started | Stopped
El estado del enlace IBM MQ, que muestra si el canal receptor se inicia o se detiene cuando se inicia por primera vez el enlace IBM MQ asociado. Hasta que se inicia, el canal no está disponible.
Información Valor
Valor predeterminado Iniciado
Rango
Detenido
Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ está en un estado detenido y no se puede comunicar con la red IBM MQ.
Iniciado
Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ se inicia automáticamente y está habilitado para la comunicación con la red IBM MQ.
-preferLocal TRUE | FALSE
Esta opción indica que el enlace prefiere enviar los mensajes entrantes al punto de cola del destino situado en el mismo motor de mensajería que el enlace, si está disponible. El enlace debe ser propiedad de un motor de mensajería que se ejecuta en un servidor WebSphere Application Server Versión 7.0 o posterior o posterior.

Esta opción sólo está soportada cuando la utiliza una aplicación JMS que se ejecuta con un servidor o cliente WebSphere Application Server Versión 7.0 o posterior, y que está conectado a un motor de mensajería que se ejecuta en el servidor WebSphere Application Server Versión 7.0 o posterior. La utilización de WebSphere Application Server en versiones anteriores causará una excepción en la aplicación.

Información Valor
Valor predeterminado TRUE
Rango
TRUE
Envíe cada mensaje entrante al punto de cola del destino situado en el mismo motor de mensajería que el enlace, si está disponible.
FALSE
Envíe los mensajes de entrada a cualquier punto de cola de los destinos.

Ejemplos

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name myMQLink2 -foreignBusName MQNetwork2 -queueManagerName MQMgrIPL 
-senderChannelTransportChain OutboundBasicMQLink]')
'myMQLink2(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#
SIBMQLink_1132607756126)'

Cree un SIBMQLink que utilice los puntos de cola en el mismo motor de mensajería que el destino, siempre que sea posible.

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name MyMQLink -foreignBusName -MQQMgr1 -queueManagerName bus1 
-senderChannelTransportChain OutboundBasicMQLink  -preferLocal TRUE]')

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