Utilice este mandato para crear un bus externo nuevo en la celda.
Antes de empezar
El mandato que se describe en este
tema se ejecuta utilizando el objeto AdminTask del cliente de creación de scripts wsadmin.
Estos scripts de línea de mandatos se ejecutan desde Qshell.
Para obtener más información, consulte el tema "Configurar Qshell para ejecutar
scripts de WebSphere Application Server".
Se proporciona ayuda de la línea de mandatos para cada uno de los mandatos
de tecnologías de integración de servicios:
Para obtener detalles adicionales sobre las propiedades del mandato,
consulte el tema de consulta relacionado.
Finalidad
Este mandato crea un bus externo nuevo
para un bus de integración de servicios especificado. Un bus externo representa
un bus que está en otra celda (o dentro de la misma celda) o una red de WebSphere
MQ, con el que el bus de integración de servicios puede intercambiar mensajes.
- Nombre del mandato
- createSIBForeignBus
- Destino
- Ninguno
- Resultado
- Un objeto de bus externo.
Para guardar los cambios realizados por el
mandato, invoque el mandato "save" en el objeto AdminConfig.
Parámetros necesarios
- -bus nombre_bus
- Nombre del bus de integración de servicios para el que se crea el bus
externo. Puede utilizar el mandato listSIBuses para obtener
una lista de nombres de los buses existentes.
- -name nombre_bus
- Nombre con el que desea que se reconozca al bus externo.
Notas : - Cuando se crea un bus externo que representa otro bus de integración de
servicios, el nombre del bus externo debe coincidir con el nombre del otro
bus de integración de servicios.
- Al intentar enlazar dos buses directamente, debe asignarles nombres únicos.
- No debe cambiar el nombre de un bus externo una vez que se ha configurado.
- -routingType Direct | Indirect
- Crear un bus externo con el enlace físico (conocido también como tipo
de direccionamiento) especificado:
- Direct
- Un enlace de bus de integración de servicios del
motor de mensajería en el bus local para un motor de mensajería en el bus
externo.
- Indirect
- Un enlace indirecto, es
decir, un enlace que se crea a través de uno o más buses externos intermedios.
Parámetros condicionales
Ninguno
Parámetros opcionales
- -description texto
- Descripción opcional del bus a efectos administrativos.
- -type MQ | SIBus
- Crear un bus externo con el tipo especificado:
- MQ
- Crear un bus externo para enlazar el bus de integración de servicios con
una red WebSphere MQ.
- SIBus
- Crear un bus externo para enlazar el bus de integración de servicios con
otro bus de integración de servicios.
- -sendAllowed True | False
- (Valor predeterminado: True) Indica si los productores pueden enviar mensajes
al bus externo.
- False
- Los productores no pueden enviar mensajes al bus externo.
- True
- Los productores pueden enviar mensajes al bus externo.
- -inboundUserid IDUsuario
- El ID de usuario de entrada se utiliza para autorizar la llegada de mensajes
individuales del bus externo a destinos del bus de integración de servicios.
Si no es un bus seguro, esta propiedad no afecta a los mensajes. Es recomendable
especificar un ID de usuario de entrada:
- Si el bus externo se encuentra en un dominio de seguridad distinto de
este bus y los ID de usuario del bus externo no se reconocen en este bus.
- Para controlar localmente el acceso de mensajes de entrada a este bus.
Si se trata de un bus seguro y el bus externo no es seguro, y no se
ha definido ningún ID de usuario de entrada, los mensajes de entrada del bus
externo sólo se autorizan a los destinos que permiten el acceso de usuarios
no autenticados.
- -outboundUserid IDUsuario
- El ID de usuario de salida sustituye el ID de usuario que identifica el
origen de un mensaje en todos los mensajes que se envían al bus externo. El
bus externo también utiliza este ID de usuario para autorizar el mensaje en
su destino si ambos buses son seguros y el bus externo no ha sobrescrito el
ID de usuario con su propio ID de usuario de entrada.
- -nextHopBus nombre_bus
- (Si -routingType es Indirect) Nombre del siguiente bus de integración
de servicios en la secuencia de buses conectados. Un bus intermediario puede
ser un sistema WebSphere MQ en lugar de un bus de integración de servicios.
Ejemplo
wsadmin>$AdminTask createSIBForeignBus {-bus SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -name SCA.SYSTEM.IBM-AA8DA602255Cell02.Bus -routingType Direct -type SIBus}
SCA.SYSTEM.IBM-AA8DA602255Cell02.Bus(cells/IBM-AA8DA602255Cell01/buses/SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus|sib-bus.xml#SIBForeignBus_1132530748562)
wsadmin>