Mandato modifySIBForeignBus
Utilice el mandato modifySIBForeignBus para modificar las propiedades de un bus foráneo.
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.
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
Este mandato modifica las propiedades de un bus foráneo. Un bus foráneo representa un bus de otra célula (o dentro de la misma célula) o una red IBM MQ, con el cual un bus de integración de servicios puede intercambiar mensajes.
Objeto de destino
Un bus foráneo.
Parámetros necesarios
- -bus nombre_bus
- El nombre del bus de integración de servicios para el cual desea modificar un bus foráneo. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
- -name nombre_bus
- El nombre del bus foráneo que desea modificar. Puede utilizar el mandato listSIBForeignBuses para listar los nombres de buses existentes.
Parámetros condicionales
Ninguno.
Parámetros opcionales
- -description texto
- Descripción opcional para el bus a efectos administrativos.
- -sendAllowed False | True
- (Predeterminado: True) Determina si los generadores pueden enviar mensajes al bus foráneo.
- False
- Los generadores no pueden enviar mensajes al bus foráneo.
- True
- Los generadores pueden enviar mensajes al bus foráneo.
- -inboundUserid ID_usuario
- El ID de usuario de entrada se utiliza para autorizar los mensajes individuales que llegan del bus foráneo a destinos del bus de integración de servicios.
Si este no es un bus seguro, esta propiedad no afecta a los mensajes.
Es posible que desee
especificar un ID de usuario de entrada:
- Si el bus foráneo está en un dominio de seguridad distinto de este bus y los ID de usuario del bus foráneo no se reconocen en este bus
- Para controlar el acceso localmente de los mensajes de entrada hacia este bus.
- -outboundUserid ID_usuario
- El ID de usuario de salida sustituye al ID de usuario que identifica el origen de un mensaje en todos los mensajes enviados al bus foráneo. Este ID de usuario también lo utiliza el bus foráneo para autorizar el mensaje en su destino si ambos buses son buses seguros y el bus foráneo no ha alterado el ID de usuario con su propio ID de usuario de entrada.
- -nextHopBus nombre_bus
- (Si -routingType es Indirect) El nombre del siguiente bus de integración de servicios en la secuencia de buses conectados. Un bus intermedio puede ser un sistema IBM MQ en lugar de un bus de integración de servicios.
- -topicSpaceMappings nombre_espaciotemas local : nombre_espaciotemas remoto
- Una correlación de espacio de temas permite a los suscriptores del espacio de temas local recibir los mensajes publicados en el espacio de temas foráneo. Para que se produzca el flujo de publicaciones del espacio de temas local al bus foráneo, el bus foráneo necesita una correlación de espacio de temas equivalente. Los nombres de los espacios de temas para el bus local se correlacionan con los nombres del espacio de temas que se han definido en el bus foráneo. Lo común es que estos dos nombres coincidan. Tenga en cuenta que la correlación de dos espacios de temas implica que los temas contenidos sean iguales. Puede especificar varios pares de espacios de temas.
Ejemplo
El ejemplo siguiente especifica las propiedades adicionales de un bus foráneo existente denominado foreignbus1:- Una identidad de usuario de entrada denominada iuserid para autorizar los mensajes enviados desde foreignbus1 al bus local, cuando la seguridad está habilitada en foreignbus1 y en el bus local.
- Una identidad de usuario de salida denominada ouserid para autorizar los mensajes enviados desde el bus local foreignbus1, cuando la seguridad está habilitada en foreignbus1 y en el bus local.
- Una correlación de espacios de temas entre Topic.Space1 en el bus local y Topic.Space2 en foreignbus1. La correlación permite que los suscriptores de Topic.Space1 en el bus local reciban los mensajes que se publicados en Topic.Space2 en foreignbus1.
AdminTask.modifySIBForeignBus('[-bus bus1 -name foreignbus1 -inboundUserid iuserid
-outboundUserid ouserid -topicSpaceMappings [[Topic.Space1 Topic.Space2]]]')
'foreignbus1(cells/cell01/buses/bus1|sib-bus.xml#SIBForeignBus_1213023645293)'