Esta sección lista y define cada una de las propiedades de configuración estándar de conector.
Es la cola utilizada por el intermediario de integración para enviar mensajes administrativos al conector.
El valor por omisión es NOMBRECONECTOR/ADMININQUEUE.
Es la cola utilizada por el conector para enviar mensajes administrativos al intermediario de integración.
El valor por omisión es NOMBRECONECTOR/ADMINOUTQUEUE.
sólo es aplicable si RepositoryDirectory es <REMOTE>.
La propiedad AgentConnections controla el número de conexiones de ORB (Object Request Broker) abiertas por orb.init[].
El valor por omisión de esta propiedad está establecido en 1. Puede cambiar este valor según convenga.
Es nivel de los mensajes de rastreo para el componente específico de la aplicación. El valor por omisión es 0. El conector entrega todos los mensajes de rastreo aplicables con el nivel de rastreo establecido o un nivel menor.
Es el nombre que identifica de forma exclusiva la aplicación del conector. El administrador del sistema utiliza este nombre para supervisar el entorno del sistema WebSphere Business Integration. Debe asignar un valor a esta propiedad antes de ejecutar el conector.
Identifica el tipo de intermediario de integración que el usuario está utilizando. Las opciones son ICS, intermediarios de mensajes WebSphere (WMQI, WMQIB o WBIMB) o WAS.
Especifica el conjunto de códigos de caracteres utilizado para correlacionar un carácter (letra del alfabeto, representación numérica o signo de puntuación) con un valor numérico.
Por omisión, la lista desplegable sólo muestra un subconjunto de los juegos de caracteres admitidos. Para añadir otros valores admitidos a la lista desplegable, debe modificar manualmente el archivo \Data\Std\stdConnProps.xml en el directorio del producto. Para obtener más información, consulte el apéndice referente al Configurador de conectores.
sólo es aplicable si RepositoryDirectory es <REMOTE>.
Determina cuántos objetos comerciales pueden ser procesados simultáneamente por el conector para la entrega de sucesos. Asigne como valor de este atributo el número de objetos comerciales que desee que se correlacionen y entreguen a la vez. Por ejemplo, establezca el valor de esta propiedad en 5 para hacer que se procesen cinco objetos comerciales simultáneamente. El valor por omisión es 1.
Establecer esta propiedad en un valor mayor que 1 permite que el conector de una aplicación de origen correlacione al mismo tiempo varios objetos comerciales de sucesos y los entregue simultáneamente a varias instancias de colaboración. Esto acelera la entrega de objetos comerciales al intermediario de integración, especialmente si los objetos comerciales utilizan correlaciones complejas. El aumento del ritmo de llegada de objetos comerciales a las colaboraciones puede aumentar el rendimiento general del sistema.
Para implementar el proceso simultáneo para un flujo completo (desde una aplicación de origen a una aplicación de destino), debe seguir estos pasos:
La propiedad ConcurrentEventTriggeredFlows no afecta al sondeo realizado por el conector, el cual tiene una sola hebra y se ejecuta secuencialmente.
Esta propiedad permite que un conector habilitado para JMS que hace uso de un almacén de sucesos JMS proporcione una entrega de sucesos garantizada, en la que un suceso se elimina de la cola de origen y se coloca en la cola de destino como transacción JMS individual.
No existe valor por omisión.
Cuando ContainerManagedEvents tiene el valor JMS, debe configurar las propiedades siguientes para habilitar la entrega de sucesos garantizada:
Debe también configurar un gestor de datos con las propiedades MimeType, DHClass (clase de gestor de datos) y DataHandlerConfigMOName (nombre del metaobjeto, que es opcional). Para definir esos valores, utilice la pestaña Gestor de datos del Configurador de conectores.
Estas propiedades son específicas del adaptador, pero los valores de ejemplo son:
Los campos para estos valores en la pestaña Gestor de datos sólo se muestran si ha establecido ContainerManagedEvents en JMS.
Esta propiedad sólo se muestra si la propiedad DeliveryTransport tiene el valor JMS.
sólo es aplicable si RepositoryDirectory es <REMOTE>.
Determina cómo actúa el controlador del conector después de que éste detecte que el componente específico de la aplicación de destino no está disponible.
Si esta propiedad tiene el valor true y el componente específico de la aplicación de destino no está disponible cuando un suceso llega a ICS, el controlador del conector bloquea la petición dirigida al componente específico de la aplicación. Cuando el componente específico de la aplicación pasa a ser funcional, el controlador le reenvía la petición.
Sin embargo, si el componente específico de la aplicación de destino pasa a estar no disponible después de que el controlador del conector le reenvíe una petición de llamada de servicio, el controlador del conector cancela la petición.
Si esta propiedad tiene el valor false, el controlador del conector comienza a cancelar todas las peticiones de llamada de servicio tan pronto como detecta que el componente específico de la aplicación de destino no está disponible.
El valor por omisión es true.
sólo es aplicable si RepositoryDirectory es <REMOTE>.
Es nivel de los mensajes de rastreo para el controlador del conector. El valor por omisión es 0.
sólo es aplicable si DeliveryTransport es JMS.
Es la cola utilizada por el conector para enviar objetos comerciales al intermediario de integración.
El valor por omisión es NOMBRECONECTOR/DELIVERYQUEUE.
Especifica el mecanismo de transporte para la entrega de sucesos. Los valores posibles son MQ para WebSphere MQ, IDL para CORBA IIOP, o JMS para Java Messaging Service.
El conector envía peticiones de llamada de servicio y mensajes administrativos a través de CORBA IIOP si el valor configurado para la propiedad DeliveryTransport es MQ o IDL.
Utilice WebSphere MQ en lugar de IDL para el transporte de la entrega de sucesos, a menos que tenga un sólo producto. WebSphere MQ proporciona las ventajas siguientes respecto a IDL:
Permite la comunicación entre el conector y la infraestructura del conector cliente utilizando Java Messaging Service (JMS).
Si selecciona JMS como transporte de entrega, el Configurador de conectores muestra más propiedades de JMS, como jms.MessageBrokerName, jms.FactoryClassName, jms.Password y jms.UserName. Las primeras dos de estas propiedades son necesarias para este mecanismo de transporte.
En este entorno, puede tener dificultades para iniciar el controlador del conector (en el extremo del servidor) y el conector (en el extremo del cliente) debido al uso de la memoria dentro del cliente WebSphere MQ. Si su instalación utiliza menos de 768M como tamaño del almacenamiento dinámico de proceso, IBM recomienda que siga estos pasos:
Este script reside en el directorio \bin, dentro del directorio del producto. Mediante un editor de texto, añada la línea siguiente como primera línea del script CWSharedEnv.sh:
export LDR_CNTRL=MAXDATA=0x30000000
Esta línea restringe el uso de la memoria a un máximo de 768 MB (3 segmentos de 256 MB). Si la memoria de proceso crece por encima de este límite, puede producirse un intercambio de páginas de memoria, lo cual puede afectar negativamente al rendimiento del sistema.
Cuando establece esta propiedad en true, un conector habilitado para JMS puede garantizar que no se entreguen sucesos duplicados a la cola de entrega. Para utilizar esta característica, el conector debe tener definido en el código específico de la aplicación un identificador de sucesos exclusivo para el atributo ObjectEventId del objeto comercial. Esto se realiza durante el desarrollo del conector.
Esta propiedad también se puede establecer en false.
Si el conector encuentra un error al procesar un mensaje, el conector coloca el mensaje en la cola especificada por esta propiedad, junto con un indicador de estado y una descripción del problema.
El valor por omisión es NOMBRECONECTOR/FAULTQUEUE.
Es el tamaño máximo del almacenamiento dinámico del agente (expresado en megabytes). Esta propiedad sólo es aplicable si el valor de RepositoryDirectory es <REMOTE>.
El valor por omisión es 128m.
Es el tamaño máximo de la pila nativa del agente (expresado en kilobytes). Esta propiedad sólo es aplicable si el valor de RepositoryDirectory es <REMOTE>.
El valor por omisión es 128k.
Es el tamaño mínimo del almacenamiento dinámico del agente (expresado en megabytes). Esta propiedad sólo es aplicable si el valor de RepositoryDirectory es <REMOTE>.
El valor por omisión es 1m.
Especifica el nombre de clase para el que se debe crear una instancia para un proveedor JMS. Debe definir esta propiedad del conector si selecciona JMS como mecanismo de transporte de entrega (DeliveryTransport).
El valor por omisión es CxCommon.Messaging.jms.IBMMQSeriesFactory.
Especifica el nombre del intermediario que se debe utilizar para el proveedor JMS. Debe definir esta propiedad del conector si selecciona JMS como mecanismo de transporte de entrega (DeliveryTransport).
El valor por omisión es crossworlds.queue.manager. Utilice el valor por omisión cuando se conecte a un intermediario de mensajes local.
Cuando se conecta a un intermediario de mensajes remoto, esta
propiedad toma los valores (obligatorios) siguientes:
nombreGestorColas:<Canal>:<nombreSistemaPrincipal>:<númeroPuerto>,
donde las variables son:
nombreGestorColas: el nombre del gestor de colas.
Canal: el canal utilizado por el cliente.
nombreSistemaPrincipal: el nombre de la
máquina donde debe residir el gestor de colas.
númeroPuerto: el número de puerto que
debe utilizar el gestor de colas para estar a la escucha.
Por ejemplo:
jms.MessageBrokerName = WBIMB.Queue.Manager:CHANNEL1:RemoteMachine:1456
Especifica el número máximo de peticiones simultáneas de llamada de servicio que se pueden enviar a un conector al mismo tiempo. Cuando se alcanza ese máximo, las nuevas llamadas de servicio se bloquean y esperan a que finalice otra petición antes de continuar.
El valor por omisión es 10.
Especifica la contraseña del proveedor JMS. Es opcional especificar un valor para esta propiedad.
No existe valor por omisión.
Especifica el nombre de usuario del proveedor JMS. Es opcional especificar un valor para esta propiedad.
No existe valor por omisión.
Esta propiedad permite la ejecución paralela en MQ Listener cuando el intermediario de integración es ICS. Esta propiedad hace posible la escritura por lotes de varios sucesos en la base de datos, con lo que mejora el rendimiento del sistema. El valor por omisión es 1.
Esta propiedad sólo es aplicable a los conectores que hacen uso del mecanismo de transporte MQ. La propiedad DeliveryTransport debe tener el valor MQ.
Especifica el código de idioma, el país o territorio y, opcionalmente, el correspondiente juego de caracteres. El valor de esta propiedad determina convenios culturales tales como la secuencia de ordenación y orden de clasificación de los datos, los formatos de fecha y hora, y los símbolos de moneda.
El nombre especificado para "locale" (entorno local) tiene este formato:
ll_TT.juegoCódigos
donde:
Por omisión, la lista desplegable sólo muestra un subconjunto de los entornos locales admitidos. Para añadir otros valores admitidos a la lista desplegable, debe modificar manualmente el archivo \Data\Std\stdConnProps.xml en el directorio del producto. Para obtener más información, consulte el apéndice referente al Configurador de conectores.
El valor por omisión es en_US. Si el conector no se ha globalizado, el único valor válido para esta propiedad es en_US. Para determinar si un conector determinado se ha globalizado, consulte la lista de versiones de conector en estos sitios Web:
http://www.ibm.com/software/websphere/wbiadapters/infocenter, o http://www.ibm.com/websphere/integration/wicserver/infocenter
sólo es aplicable si RepositoryDirectory es <REMOTE>.
Especifica si se deben registrar errores en el archivo de anotaciones cronológicas del intermediario de integración de destino. El registro de anotaciones en el archivo de registro del intermediario de destino también activa la notificación por correo electrónico, la cual genera mensajes de correo electrónico para el receptor de mensajes (MESSAGE_RECIPIENT) especificado en el archivo InterchangeSystem.cfg cuando se producen errores.
Por ejemplo, cuando un conector pierde la conexión con su aplicación y LogAtInterChangeEnd tiene el valor true, se envía un mensaje de correo electrónico al receptor de mensajes especificado. El valor por omisión es false.
Es el número máximo de sucesos contenidos en el almacenamiento intermedio del controlador. Esta propiedad es utilizada por el control de flujo y sólo es aplicable si el valor de la propiedad RepositoryDirectory es <REMOTE>.
El valor puede ser un número entero positivo comprendido entre 1 y 2147483647. El valor por omisión es 2147483647.
Es el nombre del archivo de mensajes del conector. La ubicación estándar del archivo de mensajes es \connectors\messages, dentro del directorio del producto. Especifique el nombre del archivo de mensajes en forma de vía de acceso absoluta si el archivo de mensajes no está situado en la ubicación estándar.
Si no existe un archivo de mensajes de conector, el conector utiliza InterchangeSystem.txt como archivo de mensajes. Este archivo está situado en el directorio del producto.
Es la cola lógica que el conector utiliza para supervisar sucesos duplicados. Esta propiedad sólo es aplicable si el valor de la propiedad DeliveryTransport es JMS y DuplicateEventElimination está establecido en TRUE.
El valor por omisión es NOMBRECONECTOR/MONITORQUEUE.
sólo es aplicable si RepositoryDirectory es <REMOTE>.
Especifica si el conector utiliza el reinicio automático y remoto. Esta característica hace uso de OAD (Object Activation Daemon) desencadenado por MQ para reiniciar el conector después de una terminación anómala o para iniciar un conector remoto desde el Supervisor del sistema.
Esta propiedad debe tener el valor true para permitir el reinicio automático y remoto. Para obtener información sobre cómo configurar OAD desencadenado por MQ, consulte el manual Installation Guide for Windows o Installation Guide for UNIX.
El valor por omisión es false.
sólo es aplicable si RepositoryDirectory es <REMOTE>.
Especifica el número máximo de veces que OAD desencadenado por MQ intenta automáticamente reiniciar el conector después de una terminación anómala. La propiedad OADAutoRestartAgent debe tener el valor true para que esta propiedad sea aplicable.
El valor por omisión es 1000.
sólo es aplicable si RepositoryDirectory es <REMOTE>.
Especifica el número de minutos dentro del intervalo de tiempo de reintento para el daemon OAD desencadenado por MQ. Si el agente del conector no se reinicia dentro de este intervalo de tiempo de reintento, el controlador del conector solicita al daemon OAD que reinicie de nuevo el agente del conector. El daemon OAD repite este proceso de reintento tantas veces como especifique la propiedad OADMaxNumRetry. La propiedad OADAutoRestartAgent debe tener el valor true para que esta propiedad sea aplicable.
El valor por omisión es 10.
Es la hora para detener el sondeo de la cola de sucesos. El formato es HH:MM, donde HH representa 0-23 horas, y MM representa 0-59 segundos.
Debe proporcionar un valor válido para esta propiedad. El valor por omisión es HH:MM, pero cambiarse.
Es el intervalo que transcurre entre el final del último sondeo y el inicio del sondeo siguiente. PollFrequency especifica la cantidad de tiempo (en milisegundos) que transcurre entre el final de una acción de sondeo y el inicio de la acción de sondeo siguiente. Esto no es el intervalo entre acciones de sondeo, sino que la lógica es la siguiente:
Establezca PollFrequency en uno de los valores siguientes:
El valor por omisión es 10000.
Especifica el número de elementos de la aplicación para los que debe efectuar el sondeo el conector. Si el adaptador tiene una propiedad específica del conector para definir PollQuantity, el valor establecido en esa propiedad prevalece sobre el valor de la propiedad estándar.
FIX
Un mensaje de correo electrónico también se considera un suceso. El conector actúa del modo siguiente cuando se le sondea para correo electrónico.
Cuando se sondea una vez (PO), el conector va a recoger el cuerpo del mensaje, porque también se considera un anexo. Puesto que no se ha especificado ningún manejador de datos (DH) para este tipo mime, se pasará por alto el cuerpo. El conector procesa el primer anexo PO. DH se encuentra disponible para este tipo mime, por lo que envía el objeto comercial al Conector de prueba visual (VTC). Cuando se sondea por segunda vez, el conector procesa el segundo anexo PO. El DH se encuentra disponible para este tipo mime, por lo que envía el objeto comercial al Conector de prueba visual. Una vez aceptado, debería pasar el tercer anexo PO. Este es el comportamiento correcto.
Es la hora para iniciar el sondeo de la cola de sucesos. El formato es HH:MM, donde HH representa 0-23 horas, y MM representa 0-59 segundos.
Debe proporcionar un valor válido para esta propiedad. El valor por omisión es HH:MM, pero debe cambiarse.
Es la cola utilizada por el intermediario de integración para enviar objetos comerciales al conector.
El valor por omisión es CONNECTOR/REQUESTQUEUE.
Es la ubicación del depósito donde el conector lee los documentos de esquema XML donde se guardan los metadatos para definiciones de objetos comerciales.
Cuando el intermediario de integración es ICS, esta propiedad debe tener el valor <REMOTE>, pues el conector obtiene esa información del depósito de InterChange Server.
Cuando el intermediario de integración es un intermediario de mensajes WebSphere o WAS, este valor debe ser el <directorio local>.
Es aplicable sólo si DeliveryTransport es JMS y es necesario sólo si RepositoryDirectory es <REMOTE>.
Designa la cola de respuestas JMS, la cual entrega un mensaje de respuesta desde la infraestructura del conector al intermediario de integración. Cuando el intermediario de integración es ICS, el servidor envía la petición y espera a que aparezca un mensaje de respuesta en la cola de respuestas JMS.
Especifica el número de veces que el conector intenta reiniciarse a sí mismo. Cuando esta propiedad se utiliza para un conector paralelo, especifica el número de veces que el componente específico de la aplicación del conector maestro intenta reiniciar el componente específico de la aplicación del conector esclavo.
El valor por omisión es 3.
Especifica el intervalo, en minutos, tras el cual el conector intenta reiniciarse a sí mismo. Cuando esta propiedad se utiliza para un conector paralelo, especifica el intervalo tras el cual el componente específico de la aplicación del conector maestro intenta reiniciar el componente específico de la aplicación del conector esclavo. Los valores posibles están comprendidos entre 1 y 2147483647.
El valor por omisión es 1.
sólo aplicable a los intermediarios de mensajes WebSphere y WAS.
Esta propiedad le permite configurar el valor del campo correspondiente al nombre de dominio en la cabecera JMS. Cuando se envían datos a WMQI a través del mecanismo de transporte JMS, la infraestructura del adaptador escribe información para la cabecera JMS, con un nombre de dominio y un valor fijo de mrm. Un nombre de dominio configurable permite a los usuarios hacer un seguimiento de cómo el intermediario WMQI procesa los datos de mensajes.
Esto es un ejemplo del aspecto que tendría una cabecera:
<mcd><Msd>mrm</Msd><Set>3</Set><Type>
Retek_POPhyDesc</Type><Fmt>CwXML</Fmt></mcd>
El valor por omisión es mrm, pero también se puede asignar el valor xml. Esta propiedad sólo se muestra cuando DeliveryTransport tiene el valor JMS y WireFormat tiene el valor CwXML.
Esta propiedad sólo es aplicable si DeliveryTransport es JMS y ContainerManagedEvents está especificado.
Esta propiedad designa la cola JMS de origen que la infraestructura del conector utiliza para permitir la entrega de sucesos garantizada mediante conectores habilitados para JMS que hacen uso de un almacén de sucesos JMS. Para obtener más información, consulte ContainerManagedEvents.
El valor por omisión es CONNECTOR/SOURCEQUEUE.
sólo es aplicable si DeliveryTransport es JMS.
La cola especificada por esta propiedad entrega mensajes de peticiones que necesitan una respuesta síncrona desde la infraestructura del conector al intermediario. Esta cola es necesaria sólo si el conector hace uso de la ejecución síncrona. Cuando se utiliza la ejecución síncrona, la infraestructura del conector envía un mensaje a la cola SynchronousRequestQueue y espera la respuesta del intermediario en la cola SynchronousResponseQueue. El mensaje de respuesta enviado al conector lleva un ID de correlación que coincide con el ID del mensaje original.
El valor por omisión es NOMBRECONECTOR/SYNCHRONOUSREQUESTQUEUE
sólo es aplicable si DeliveryTransport es JMS.
La cola especificada por esta propiedad entrega mensajes de respuesta enviados en respuesta a una petición síncrona desde el intermediario a la infraestructura del conector. Esta cola es necesaria sólo si el conector hace uso de la ejecución síncrona.
El valor por omisión es NOMBRECONECTOR/SYNCHRONOUSRESPONSEQUEUE
sólo es aplicable si DeliveryTransport es JMS.
Especifica el tiempo, en minutos, que el conector espera una respuesta a una petición síncrona. Si la respuesta no se recibe dentro del tiempo especificado, el conector traslada el mensaje original de petición síncrona a la cola de errores, junto con un mensaje de error.
El valor por omisión es 0.
Es el formato del mensaje en el mecanismo de transporte.
sólo aplicable si el intermediario de integración es WAS.
Especifica el tiempo, en minutos, que el conector espera una respuesta a una petición síncrona. Si la respuesta no se recibe dentro del tiempo especificado, el conector traslada el mensaje original de petición síncrona a la cola de errores, junto con un mensaje de error.
El valor por omisión es 0.
sólo aplicable a los intermediarios de mensajes WebSphere y al intermediario de integración WAS.
Esta poderosa propiedad permite al usuario especificar espacios de nombres cortos ("short") y largos ("long") en el formato XML de definiciones de objetos comerciales.
El valor por omisión es short.