Mandato modifySIBLink
Utilice el mandato modifySIBLink para modificar las propiedades de un enlace de bus de integración de servicios.
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()
Objetivo
El mandato modifySIBLink modifica las propiedades de un enlace de bus de integración de servicios.
Objeto de destino
Ninguno.
Parámetros necesarios
- -bus
- El nombre del bus de integración de servicios para el cual desea modificar 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 modificar 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.
Parámetros condicionales
Ninguno.
Parámetros opcionales
- -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
- -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 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 si 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
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=host1:1111:chain1, protocolName=null, authAlias=null,
preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
wsadmin>AdminTask.modifySIBLink('[-bus bus1 -messagingEngine node01.server1-bus1
-name MySIBLink -foreignBusName -bus2
-bootstrapEndpoints anotherhost:2222:BootstrapBasicMessaging]')
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=anotherhost:2222:BootstrapBasicMessaging, protocolName=null,
authAlias=null, preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
Modifique un enlace de bus de integración de servicios de modo que no exista ninguna preferencia sobre los puntos de cola que se van a utilizar.
AdminTask.modifySIBLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name MyLink
-foreignBusName -FB1 bootstrapEndpoints host1:1111:chain1 -remoteMessagingEngineName
-cluster2.000-FB1 -preferLocal FALSE]')