Mandato createSIBLink

Utilice el mandato createSIBLink para crear un nuevo enlace de bus de integración de servicios.

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()

Objetivo

El mandato createSIBLink crea un nuevo enlace de bus para un bus especificado. Un enlace de bus define un enlace entre un motor de mensajería en un bus y un motor de mensajería en el bus foráneo.

Objeto de destino

Ninguno.

Parámetros necesarios

-bus
El nombre del bus de integración de servicios para el cual desea crear el enlace de bus de integración de servicios. 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 de bus de integración de servicios. El enlace de bus de integración de servicios conecta un motor de mensajería con otro en un bus de integración de servicios diferente, por lo tanto, se proporciona un puente entre dos buses de integración de servicios.
-name
El nombre a través del cual desea que se conozca el enlace de bus de integración de servicios.
-foreignBusName
El nombre del bus foráneo que define el bus de integración de servicios remoto para el enlace de bus de integración de servicios. Puede utilizar el mandato listSIBForeignBuses para lista los nombres de los buses foráneos existentes.
-bootstrapEndpoints

Esta propiedad se establece del mismo modo que la propiedad Punto final de proveedor en los valores de la fábrica de conexiones JMS. Si desea más información, consulte los pasos relacionados con la definición de puntos finales de rutina de carga en Configuración de una conexión con un servidor de rutina de carga que no es el valor predeterminado.

El puerto del punto final de rutina de carga es el puerto definido en la dirección de punto final SIB que se ha configurado en el servidor de aplicaciones de destino del bus foráneo.

-remoteMessagingEngineName

Parámetros condicionales

Ninguno.

Parámetros opcionales

-description
Descripción opcional para el bus a efectos administrativos.
-protocolName

El nombre de la cadena de transporte debe ser el nombre de la cadena de transporte definido en el servidor en el que está alojado el motor de mensajería de destino.

-authAlias

Debe tener un alias de autenticación J2C predefinido.

-exceptionDestination
El destino de un mensaje de entrada cuando el enlace de bus de integración de servicios 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 de bus de integración de servicios 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.Destination.nombre_motor_mensajería.
Ninguno
El enlace de bus de integración de servicios 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 en el mismo destino. Esta opción se puede utilizar para conservar el orden de los mensajes.
Especificar
El enlace de bus de integración de servicios utiliza el destino de excepción especificado aquí. Si esto no es posible, utiliza el destino de excepción del sistema.
-initialState Started | Stopped
El estado del enlace de pasarela, que muestra si se inicia automáticamente el enlace cuando se inicia el motor de mensajería.
Información Value
Default Iniciado
Rango
Detenido
Cuando se inicia el motor de mensajería asociado, el enlace de pasarela está en estado detenido y no puede procesar ninguna petición nueva de conexiones.
Iniciado
Cuando se inicia el motor de mensajería asociado, el enlace de pasarela está en estado iniciado y puede procesar cualquier petición nueva de conexión.
-preferLocal TRUE | FALSE
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 WebSphere Application Server versión 7.0 o un servidor posterior.

Esta opción sólo tiene soporte cuando la utiliza una aplicación JMS que se ejecuta con un servidor o cliente WebSphere Application ServerVersión 7.0 o posterior y se ha conectado a un motor de mensajería que se ejecuta en un servidor WebSphere Application ServerVersió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 Value
Default 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.createSIBLink('[-bus bus1 -messagingEngine node01.server1-myBus
-name mySIBLink -foreignBusName bus2 -bootstrapEndpoints host1:1111:chain1 
-remoteMessagingEngineName node02.server2-bus2]') 

Cree un enlace de bus de integración de servicios que utilice un punto de cola en el mismo motor de mensajería que el enlace, siempre que sea posible.

AdminTask.createSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1
-name mySIBLink -foreignBusName bus2 -bootstrapEndpoints host1:1111:chain1 
-remoteMessagingEngineName node02.server2-bus2 -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_siblink_create
File name: rjj_siblink_create.html