Configuración del conector

Debe definir las propiedades de configuración del conector antes de ejecutarlo, tanto las propiedades estándar como las específicas del conector. Utilice la herramienta Configurador de conectores para definir las propiedades de configuración de un conector:

Para obtener más información sobre el Configurador de conectores, consulte el Apéndice B. Configurador de conectores.

Propiedades de configuración estándar

Las propiedades de configuración estándar proporcionan información que utilizadan todos los conectores. Consulte el Apéndice A. Propiedades de configuración estándar para conectores para obtener información detallada sobre estas propiedades.

Importante:
Como el conector para productos JDBC puede trabajar con ambos intermediarios de integración, InterChange Server y WebSphere MQ Integrator Broker, las propiedades de configuración de ambos intermediarios son relevantes para el conector.

Además, consulte la Tabla 5 para obtener información de configuración específica del producto IBM WebSphere Business Integration Adapter for JDBC. La información de esta tabla complementa la información del apéndice.

Tabla 5. Información sobre propiedades específica del conector
Propiedades Notas
CharacterEncoding Este conector no utiliza la propiedad CharacterEncoding.
Locale Como el conector se ha internacionalizado, se puede cambiar el valor de la propiedad Locale.
Nota:
Si como intermediario utiliza WebSphere MQ Integrator Broker, debe utilizar el mismo entorno local (locale) para el adaptador, el intermediario y las aplicaciones.

Tenga en cuenta que debe proporcionar un valor para la propiedad de configuración ApplicationName antes de ejecutar el conector.

Propiedades específicas del conector

Las propiedades de configuración específicas del conector proporcionan información que el conector necesita durante la ejecución. Las propiedades específicas del conector también proporcionan una manera de cambiar información estática o lógica contenida en el conector, sin tener que volver a codificar y reconstruir el conector.

La Tabla 6 lista las propiedades de configuración del conector que son específicas de él. Consulte las secciones siguientes para obtener explicaciones de las propiedades.

Tabla 6. Propiedades de configuración específicas del conector
Nombre Valores posibles Valor por omisión Obligatorio
ApplicationPassword Contraseña para la cuenta de usuario del conector
Sí*
ApplicationUserName Nombre de la cuenta de usuario del conector
Sí*
ArchiveProcessed true o false
true
No
ArchiveTableName Nombre de la tabla de la cola de archivado
xworlds_archive_events
si Archive Processed es true
AutoCommit true o false
false
No
CheckforEventTableInInit true o false
true
No
ChildUpdatePhyDelete true o false
false
No
CloseDBConnection true o false
false
No
ConnectorID ID exclusivo del conector
null
No
DatabaseURL Nombre del servidor de bases de datos
DateFormat Serie de caracteres para denotar una fecha y una hora
MM/dd/aaaa
 HH:mm:ss
No
DriverConnectionProperties Propiedades adicionales de la conexión del controlador JDBC
No
DriverSupportForLong true o false
true
No
EventKeyDel Carácter o caracteres para delimitar las columnas de clave de objeto en la tabla de sucesos
punto y coma (;)
No
EventOrderBy
none, NombreColumna,
 NombreColumna, ...]
No
EventQueryType Fixed o Dynamic
Fixed
No
EventTableName Nombre de la tabla de la cola de sucesos
xworlds_events
, si es necesario el sondeo de la tabla de sucesos; null (como serie de caracteres) si el sondeo no es necesario
JDBCDriverClass nombre de clase del controlador
MaximumDatabaseConnections Número de conexiones simultáneas de base de datos
5
PingQuery
SELECT 1 FROM <nombre_tabla>
No
PollQuantity Valores entre 1 y 500
1
No
PreserveUIDSeq true o false
true
No
QueryTimeOut Valor entero, expresado en segundos
No
RDBMS.initsession Sentencia de SQL mediante la que se inicializa cada sesión de base de datos
No
RDBMSVendor Oracle, Others
ReplaceAllStr true o false
false
No
ReplaceStrList Conjunto formado por un carácter individual, un delimitador de caracteres y la serie de caracteres de sustitución del carácter. También, varios conjuntos así con un delimitador de terminación entre ellos. Q,DSQ Nota: en la herramienta de configuración de conectores, estos caracteres representan una comilla simple, seguida de una coma y dos comillas simples.
No
RetryCountAndInterval Cuenta, intervalo en segundos 3,20
No
ReturnDummyBOForSP true o false
false
No
SchemaName Esquema en el que residen los sucesos
No
SelectiveCommitForPoll true o false
false
No
SPBeforePollCall Nombre del procedimiento almacenado que se debe ejecutar para cada llamada de sondeo
No
StrDelimiter Delimitadores de caracteres y de terminación utilizados en la propiedad ReplaceStrList
,:
No
TimingStats 0, 1, 2
0
No
UniqueIDTableName Nombre de la tabla utilizada para crear los ID
xworlds_uid
No
UseDefaults true o false
false
UseDefaultsForCreatingChildBOs true o false
false
No
UseDefaultsWhenPolling true o false
true
No

* No es necesario utilizar ApplicationPassword ni ApplicationUserName si se utiliza la autenticación fiable.

ApplicationPassword

Contraseña para la cuenta de usuario del conector.

No existe valor por omisión.

ApplicationUserName

Nombre de la cuenta de usuario del conector.

No existe valor por omisión.

ArchiveProcessed

Especifica si el conector archiva sucesos para los cuales no existen suscripciones actuales.

Asigne el valor true a esta propiedad si desea que los sucesos se inserten en la tabla de archivado antes de ser suprimidos de la tabla de sucesos.

Asigne el valor false a esta propiedad si desea que el conector no realice el proceso de archivado. En este caso, el conector no comprueba el valor de la propiedad ArchiveTableName. Si ArchiveProcessed tiene el valor false, el conector realiza estas acciones:

Si el valor de esta propiedad se establece en false y el volumen de sondeo (PollQuantity) es bajo, el conector parece estar sondeando la tabla de sucesos, pero en realidad está simplemente captando los mismos sucesos repetidamente.

Si esta propiedad no tiene ningún valor asignado, el conector considera que el valor es true. Si la propiedad ArchiveTableName tampoco tiene ningún valor asignado, el conector considera que el nombre de la tabla de archivado es xworlds_archive_events.

El valor por omisión es true.

ArchiveTableName

Nombre de la tabla de la cola de archivado.

Si el valor de la propiedad ArchiveProcessed está establecido en false, no es necesario especificar un valor para la propiedad ArchiveTableName.

El nombre por omisión es xworlds_archive_events.

AutoCommit

Esta propiedad permite configurar el valor de AutoCommit. Cuando el valor es true, todas las transacciones se confirman automáticamente. Algunas bases de datos (tales como Sybase) necesitan que AutoCommit se establezca en true. Si se establece en false, los procedimientos almacenados de Sybase fallarán.

Si se pierde la conexión con la base de datos, el conector intentará crear una nueva conexión para reiniciar el proceso completo siempre que AutoCommit tenga el valor false. Si la nueva conexión no es válida o si AutoCommit tiene el valor true, el conector devuelve el código de retorno APPRESPONSETIMEOUT, que hace que concluya la ejecución del conector.

El valor por omisión es false.

CheckforEventTableInInit

Si esta propiedad del conector se establece en false, se impide que el conector compruebe la existencia de las tablas de sucesos y de archivado durante la inicialización del conector. Es recomendable que establezca siempre esta propiedad en true a menos que el controlador JDBC utilizado no sea compatible con la clase DatabaseMetaData de JDBC.

Cuando el valor de esta propiedad es false, aunque el conector no comprueba la existencia de las tablas de sucesos y de archivado, estas tablas deben existir siempre, pues el conector las utiliza durante el proceso de inicialización. Para impedir que el conector utilice las tablas de sucesos y de archivado durante la inicialización, establezca la propiedad EventTableName en null.

El valor por omisión es true.

ChildUpdatePhyDelete

Durante una operación de actualización, esta propiedad especifica cómo el conector maneja los datos representados por un objeto comercial hijo que falta en el objeto comercial entrante, pero que existe en la base de datos.

Establezca esta propiedad en true si desea que el conector suprima físicamente el registro de datos de la base de datos.

Establezca esta propiedad en false si desea que el conector realice una supresión lógica del registro de datos en la base de datos asignando el valor apropiado a la columna de estado. La información específica de la aplicación obtiene el nombre de la columna de estado y su valor a partir del parámetro StatusColumnValue (SCN) especificado en la información específica de la aplicación a nivel de objeto comercial. Para obtener más información, consulte Información específica de la aplicación a nivel de objeto comercial.

El valor por omisión es false.

CloseDBConnection

Esta propiedad permite configurar el cierre de la conexión de base de datos. Cuando su valor es true, la conexión de base de datos se cierra para cada petición de llamada de servicio y llamada de sondeo. No es aconsejable asignar el valor true a esta propiedad, pues ello disminuye el rendimiento.

El valor por omisión es false.

ConnectorID

Es un ID exclusivo para el conector. Este ID es útil para recuperar sucesos para una instancia determinada del conector.

El valor por omisión es null.

DatabaseURL

Nombre del servidor de bases de datos al cual se debe conectar el conector.

Si utiliza el controlador SQLServer de WebSphere Business Integration designado por el sistema, el URL recomendado es:

jdbc:ibm-crossworlds:sqlserver://nombre_máquina:número_puerto;DatabaseName=nombre_ base_datos
Importante

Si AutoCommit se establece en false, debe definir un parámetro adicional, SelectMethod :jdbc:ibm-crossworlds:sqlserver://nombre_máquina:número_puerto; DatabaseName=nombre_base_datos;SelectMethod=cursor

Por omisión, SelectMethod se establece en direct. Para obtener más información, consulte AutoCommit.

Debe asignar un valor a esta propiedad para que el conector procese satisfactoriamente.

DateFormat

Especifica el formato de fecha que el conector espera recibir y devolver. Esta propiedad es compatible con cualquier formato que esté basado en la sintaxis que se describe en la Tabla 7.

La Tabla 7 define la sintaxis de DateFormat utilizando una serie de caracteres para denotar una fecha y una hora. En esta serie de caracteres, todas las letras ASCII son letras reservadas.

Tabla 7. Sintaxis de DateFormat
Símbolo Significado Presentación Ejemplo
G
designador de la era
(Texto)
AD
y
año
(Número)
1996
M
mes del año
(Texto & Número)
Julio & 07
d
día del mes
(Número)
10
h
hora en notación am/pm (1-12)
(Número)
12
H
hora del día (0-23)
(Número)
0
m
minuto dentro de la hora
(Número)
30
s
segundo dentro del minuto
(Número)
55
S
milisegundo
(Número)
978
E
día de la semana
(Texto)
Martes
D
día del año
(Número)
189
F
día de la semana dentro del mes
(Número)
2
 (2 miércoles
 de julio)
w
semana dentro del año
(Número)
27
W
semana dentro del mes
(Número)
2
a
marcador am/pm
(Texto)
PM
k
hora del día (1-24)
(Número)
24
K
hora en notación am/pm (0-11)
(Número)
0
z
zona horaria
(Texto)
Hora
 estándar
 del Pacífico
' 
carácter de escape para texto (Delimitador)
''
comilla simple (Literal)
'

Tabla 8. Ejemplos para el entorno local de Estados Unidos
Patrón de formato Resultado
"aaaa.MM.dd G 'at' hh:mm:ss z"
1996.07.10 AD at 15:08:56 PDT
"EEE, MMM d, ''aa"
Wed, July 10, '96
"h:mm a"
12:08 PM
"hh 'o''clock' a, zzzz"
12 o'clock PM, Pacific Daylight Time
"K:mm a, z"
0:00 PM, PST
"aaaa.MMMMM.dd GGG hh:mm aaa"
1996.July.10 AD 12:08 PM

DriverConnectionProperties

Además del nombre de usuario y la contraseña, puede ser necesario especificar otras propiedades o información para un controlador JDBC. La propiedad de conector DriverConnectionProperties acepta propiedades adicionales que pueden ser necesarias para un controlador JDBC, especificadas en forma de pares nombre-valor. Las propiedades se deben especificar de esta manera:

propiedad1=valor1[;propiedad2=valor2...]

Las propiedades se deben proporcionar en forma de pares nombre-valor, separados por signos de punto y coma. La propiedad está separada de su valor por un signo de igualdad (sin espacios en blanco adicionales).

Por ejemplo, suponga que es necesario especificar la información sobre licencias y el número de puerto para el controlador JDBC. El nombre de propiedad que el controlador espera para la información sobre licencias es MyLicense y el valor es ab23jk5. El nombre de propiedad que el controlador espera para el número de puerto es PortNumber y el valor es 1200. La propiedad DriverConnectionProperties se debe establecer en este valor: MyLicense=ab23jk5;PortNumber=1200.

DriverSupportForLong

Especifica cómo se manejan los parámetros enteros para sentencias preparadas. Cuando el valor de esta propiedad es "true", se utiliza setLong para definir el parámetro entero. Cuando el valor de la propiedad es "false", se utiliza setInt para definir el parámetro.

El valor por omisión es "true".

EventKeyDel

Especifica el delimitador cuando la columna object_key de la tabla de sucesos contiene varios valores de atributos.

Existen dos formas de recuperar el objeto comercial que se ha creado, actualizado o suprimido en la aplicación desencadenante.

Nota:
El orden en el que se definen los valores de clave debe ser el mismo orden que los atributos de clave en un objeto comercial.

Importante:
Si utiliza datos para un atributo de fecha, evite utilizar el signo de dos puntos (:) como delimitador, pues puede estar incluido en los datos del atributo.

El valor por omisión es un signo de punto y coma (;), el cual está basado en claves, no en pares nombre-valor.

EventOrderBy

Especifica si se debe desactivar la ordenación de sucesos, o especifica un orden para el proceso de sucesos que es diferente del orden por omisión.

Por omisión, en cada sondeo el conector recupera sólo el número de sucesos especificado en la propiedad de conector PollQuantity, y ordena el proceso de sucesos de acuerdo con los valores de las columnas event_time y event_priority de la tabla de sucesos.

Para hacer que el conector no ordene los sucesos, establezca esta propiedad en none.

Para hacer que el conector ordene los sucesos de acuerdo con columnas diferentes de la tabla de sucesos, especifique los nombres de esas columnas. Separe los nombres de las columnas con una coma (,). El valor especificado para esta propiedad prevalece sobre el comportamiento definido por omisión para el conector.

No existe valor por omisión para esta propiedad.

EventQueryType

La propiedad EventQueryType se utiliza para indicar si el conector debe generar dinámicamente una consulta para recuperar sucesos de la tabla de sucesos o debe utilizar la consulta definida internamente en el conector. Para la consulta generada dinámicamente, el conector correlaciona su estructura de sucesos con las columnas de la tabla de sucesos. El orden de los datos en las columnas de la tabla es muy importante. Consulte Esquema de las tablas de sucesos y de archivado para ver el orden correcto.

Si el valor de EventQueryType es Fixed (como serie de caracteres), se ejecuta la consulta definida por omisión. Si el valor es Dynamic (como serie de caracteres), se crea una nueva consulta obteniendo los nombres de las columnas de la tabla que está especificada en la propiedad EventTableName.

Los nombres de las columnas de la tabla de sucesos pueden cambiar, pero el orden y tipo de datos de las columnas deben seguir siendo los especificados en la sección referente a la creación de la tabla de sucesos. EventOrderBy se añadirá a la consulta definida por omisión o a la consulta generada dinámicamente.

Si no se añade la propiedad EventQueryType o no contiene ningún valor, su valor se establece en Fixed por omisión.

El valor por omisión es Fixed (como serie de caracteres).

EventTableName

Es el nombre de la tabla de la cola de sucesos, que es utilizado por el mecanismo de sondeo del conector.

El nombre por omisión es xworlds_events.

Establezca esta propiedad en null (como serie de caracteres) cuando el sondeo esté desactivado para el conector. De esta forma se evita que se compruebe la existencia de las tablas de sucesos y de archivado.

Para una tabla de sucesos definida por el usuario, asegúrese de que id_suceso se correlaciona con uno de los tipos siguientes de JDBC: INTEGER, BIGINT, NUMERIC, VARCHAR.

JDBCDriverClass

Especifica el nombre de clase de un controlador. Para utilizar un controlador JDBC determinado, especifique el nombre de clase del controlador en esta propiedad de configuración. Por ejemplo, para especificar el controlador thin de Oracle, establezca el valor de esta propiedad en: oracle.jdbc.driver.OracleDriver.

Para obtener más información, consulte Habilitación del soporte para varios controladores y UseDefaultsForCreatingChildBOs.

No se proporciona ningún valor por omisión.

MaximumDatabaseConnections

Especifica el número máximo de conexiones simultáneas que se permiten establecer con la base de datos. Durante la ejecución, el número conexiones abiertas con la base de datos es la suma de este valor más 1.

Si el valor de la propiedad PreserveUIDSeq se establece en "false", el número de conexiones de base de datos abiertas durante la conexión es la suma del valor MaximumDatabaseConnections más 2.

El valor por omisión es 5.

PingQuery

Especifica la sentencia de SQL o procedimiento almacenado que el conector ejecuta para comprobar (sondear) la conectividad con la base de datos.

Lo siguiente es un ejemplo de sentencia de SQL utilizada como consulta de sondeo:

SELECT 1 FROM <nombre_tabla>

Lo siguiente es un ejemplo de una llamada de procedimiento almacenado (sampleSP) utilizada como consulta de sondeo con una base de datos Oracle:

call sampleSP( )

Observe que las llamadas de procedimiento almacenado no pueden tener parámetros de salida. Si es necesario un parámetro de entrada para la base de datos, el valor de entrada se debe especificar como parte de la consulta de sondeo. Por ejemplo:

Call checkproc(2)

No existe valor por omisión. Para obtener más información, consulte Manejo de conexiones perdidas de base de datos y Pérdida de la conexión con la aplicación.

PollQuantity

Es el número de filas de la tabla de base de datos que el conector recupera en cada intervalo de sondeo. Los valores permitidos están comprendidos entre 1 y 500.

El valor por omisión es 1.

PreserveUIDSeq

Especifica si la secuencia identificadora exclusiva entrante se conservará o no en la tabla de identificadores exclusivos.

Si el valor de esta propiedad es true, el ID exclusivo no se confirma hasta que se procesa satisfactoriamente el objeto comercial en la aplicación de destino. Todos los demás procesos que intenten acceder a la tabla de identificadores exclusivos deberán esperar hasta que se confirme la transacción.

Si el valor de esta propiedad es false, el ID exclusivo se confirma cuando lo solicita el objeto comercial. El proceso del objeto comercial y el proceso del ID exclusivo tienen su propio bloque de transacciones (interno respecto al conector). Esto sólo es posible si la transacción referente a la tabla de identificadores exclusivos tiene su propia conexión.

Nota:
Si esta propiedad no se añade a la configuración del conector, el comportamiento por omisión del conector es el mismo que si la propiedad se añadiera y su valor se estableciera en true. Además, si el valor de AutoCommit es true, el conector tiene el mismo comportamiento que si PreserveUIDSeq se estableciera en false.

Si el valor de la propiedad PreserveUIDSeq se establece en "false", el número de conexiones de base de datos abiertas durante la conexión es la suma de este valor más 2.

El valor por omisión es true.

QueryTimeOut

El valor de esta propiedad es un número entero de segundos que define el tiempo de espera de las consultas (QueryTimeOut) para todas las acciones de recuperación. Si no se especifica este valor, se supone que no existe ningún tiempo de espera definido para la consulta. Si la consulta emplea más tiempo que el número de segundos especificado, la base de datos emite una excepción de SQL que es capturada. El mensaje asociado se registra en el archivo de anotaciones cronológicas.

No se proporciona ningún valor por omisión.

RDBMS.initsession

Es la sentencia de SQL por la que se inicializa cada sesión con la base de datos. El conector recibe una consulta y la ejecuta durante el proceso de inicio. Normalmente esta consulta no produce ningún valor de retorno. Es necesario el nombre de la propiedad, pero no es necesario un valor.

No existe valor por omisión.

RDBMSVendor

Especifica el sistema de gestión de bases de datos relacionales (RDBMS) que el conector utiliza para procesos especiales. Establece el valor de esta propiedad en Oracle para la base de datos Oracle.

Si utiliza una base de datos diferente de la base de datos por omisión, asegúrese de que se cargue el controlador apropiado. Si el valor de esta propiedad es Others, el conector localiza el controlador para determinar la base de datos que se debe utilizar.

Es necesario especificar un valor para que el conector se ejecute satisfactoriamente.

No se proporciona ningún valor por omisión.

ReplaceAllStr

Especifica si el conector sustituye todas las apariciones de cada carácter identificado en la propiedad ReplaceStrList por la serie de caracteres de sustitución especificada en esa propiedad. El conector evalúa ReplaceAllStr sólo si el parámetro ESC=[true|false] de la propiedad AppSpecificInfo de cada atributo no contiene un valor. Es decir, si se ha especificado el parámetro ESC, su valor tiene prioridad sobre el valor definido para la propiedad ReplaceAllStr. Para hacer que el conector utilice el valor de ReplaceAllStr, verifique que no se haya especificado el parámetro ESC.

El valor por omisión de ReplaceAllStr es false.

Nota:
El parámetro ESC y las propiedades ReplaceAllStr y ReplaceStrList son compatibles con la utilización de caracteres de escape para una base de datos (por ejemplo, comillas simples utilizadas como carácter de escape). Como esta misma funcionalidad está también disponible utilizando las sentencias preparadas proporcionadas por el controlador JDBC, estas propiedades se eliminarán en versiones futuras del conector. El conector es actualmente compatible con el uso de las sentencias preparadas de JDBC.

ReplaceStrList

Especifica uno o más conjuntos de sustitución, cada uno formado por un carácter individual a sustituir, un delimitador de caracteres y una serie de caracteres de sustitución. El conector efectúa esta sustitución para un valor de atributo sólo si se ha especificado un valor para el parámetro ESC=[true|false] de la propiedad AppSpecificInfo del atributo o para la propiedad ReplaceAllStr del conector.

Nota:
El parámetro ESC y las propiedades ReplaceAllStr y ReplaceStrList son compatibles con la utilización de caracteres de escape para una base de datos (por ejemplo, comillas simples utilizadas como carácter de escape). Como esta misma funcionalidad está también disponible utilizando las sentencias preparadas proporcionadas por el controlador JDBC, estas propiedades se eliminarán en versiones futuras del conector. El conector es actualmente compatible con el uso de las sentencias preparadas de JDBC.

La sintaxis de este atributo es:

carácter_individual1,serie_sustitución1[:carácter_individual2,serie_sustitución2[:...]]

donde:

carácter_individual
Es un carácter a sustituir.
serie_sustitución
Es la serie de caracteres de sustitución que el conector utiliza para sustituir el carácter.
,
Es el delimitador de caracteres, el cual separa el carácter a sustituir respecto de la serie de caracteres que sustituirá al carácter. El delimitador de caracteres por omisión es una coma (,). Puede configurar este delimitador estableciendo el primer delimitador en la propiedad StrDelimiter.
:
Es el delimitador de terminación, el cual separa conjuntos de sustitución (cada uno de los cuales está formado por el carácter a sustituir, un delimitador de caracteres y la serie de caracteres de sustitución). El delimitador de terminación por omisión es un signo de dos puntos (:). Puede configurar este delimitador estableciendo el segundo delimitador en la propiedad StrDelimiter.

Por ejemplo, suponga que desea sustituir un signo individual de porcentaje (%) por dos signos de porcentaje (%%), y sustituir un signo de intercalación (^) por una barra inclinada invertida y un signo de intercalación (\^). Por omisión, StrDelimiter especifica una coma (,) como delimitador de caracteres, y un signo de dos puntos (:) como delimitador de terminación. Si conserva los delimitadores por omisión, utilice la serie de caracteres siguiente como valor de ReplaceStrList:

%,%%:^,\^

Nota:
Una restricción de la herramienta de configuración de conectores impide especificar comillas simples. Por tanto, debe utilizar el carácter Q para representar una comilla simple, y los caracteres DSQ para representar dos comillas simples. En el ejemplo anterior, si también desea sustituir una comilla simple (') por dos comillas simples ('' ), utilice esta notación: Q,DSQ:%,%%:^,\^

RetryCountAndInterval

Especifica el número de intentos y el intervalo en segundos que el conector debe utilizar cuando no puede bloquear datos al realizar una operación de actualización.

Antes de realizar una actualización, el conector bloquea las filas afectadas por la actualización e intenta recuperar datos actuales. Si el conector no puede bloquear las filas, intenta de nuevo realizar el bloqueo de acuerdo con los valores de cuenta e intervalo especificados en esta propiedad de configuración. Finalmente se produce un tiempo de espera excedido para el conector si no se puede obtener el bloqueo dentro de los valores especificados en esta propiedad.

Especifique el valor utilizando este formato: cuenta, intervalo en segundos. Por ejemplo, el valor 3,20 especifica tres reintentos con un intervalo de 20 segundos entre ellos.

El valor por omisión es 3,20.

ReturnDummyBOForSP

Esta propiedad se utiliza para devolver parámetros de salida aún cuando el conjunto de resultados esté vacío.

En el caso de RetrieveSP, se devuelve un conjunto de resultados. Si el conjunto de resultados está vacío, no se crean objetos comerciales, y los parámetros de salida devueltos por la llamada de procedimiento no se pueden recuperar. Sin embargo, si el valor de ReturnDummyBOForSP es true, se devuelve un objeto comercial ficticio cuyos valores de atributo se han obtenido de parámetros de salida y parámetros de entrada/salida.

El valor por omisión es "false".

SchemaName

Esta propiedad restringe la búsqueda de las tablas de sucesos y de archivado al esquema especificado por esta propiedad. Si esta propiedad no se añade o se deja vacía, el conector buscará en todos los esquemas a los que tenga acceso el usuario. El nombre de esquema especificado en esta propiedad también se utiliza al crear las consultas para acceder a las tablas de sucesos y de archivado.

La base de datos Oracle es compatible con la utilización de nombres de esquema. Consulte la documentación del controlador JDBC para obtener información específica.

No se proporciona ningún valor por omisión.

SelectiveCommitForPoll

Especifica cuándo tendrán lugar las operaciones de confirmación para la base de datos. Si el valor es true, se producirá una sola confirmación, una vez procesado el suceso. Si el valor es false, se produce el comportamiento estándar; es decir, las confirmaciones se producen en cada etapa del proceso de los sucesos.

El valor por omisión es "false".

SPBeforePollCall

Esta propiedad especifica el procedimiento almacenado que se ejecuta para cada llamada de sondeo. Si la propiedad SPBeforePollCall tiene un valor (el nombre de un procedimiento almacenado), entonces, al inicio de cada llamada de sondeo, el conector invoca el procedimiento almacenado, pasándole los valores de las propiedades de conector ConnectorID y PollQuantity. El procedimiento actualizará el número de filas especificado por PollQuantity, y establecerá la columna del ID de conector en ConnectorID, donde status=0 y el ID de conector es null. Esto permite el equilibrado de la carga de trabajo en el conector.

Nota:
En el caso en que una llamada de sondeo falla prematuramente (la base de datos está inactiva o se pierde la conexión), el ID de conector permanece definido. Esto puede hacer que se pasen por alto registros durante el sondeo. Por tanto, es recomendable restablecer periódicamente el ID de conector en el valor null para todos los registros de la tabla de sucesos cuyo estado sea 0.

StrDelimiter

Especifica los delimitadores de caracteres y de terminación que se deben utilizar en la propiedad ReplaceStrList.

El usuario puede especificar un valor propio para cualquiera de estos delimitadores o para ambos. En este caso, no especifique un espacio en blanco ni ningún otro carácter entre los caracteres delimitadores.

El valor por omisión es una coma seguida inmediatamente por un signo de dos puntos (,:)

TimingStats

Esta propiedad permite calcular la duración de cada operación de verbo del conector para detectar problemas. Los valores posibles son:

0
No se realizan estadísticas de tiempo
1
Se muestra la hora al comienzo y final de la operación de verbo para un objeto comercial jerárquico completo.
2
Se muestra la hora al comienzo y final de cada operación de verbo para cada objeto comercial individual de un objeto comercial jerárquico.

Los mensajes de cronometraje son mensajes de anotaciones cronológicas más que mensajes de rastreo. Se pueden activar y desactivar, con independencia de los niveles de rastreo.

El valor por omisión es 0.

UniqueIDTableName

Especifica la tabla donde reside el último valor utilizado para la creación de un ID exclusivo. Por omisión, la tabla tiene una sola columna (id). Puede personalizar la tabla para añadir una columna para cada atributo que necesite la creación de un UID.

El valor por omisión es xworlds_uid.

UseDefaults

Si UseDefaults tiene el valor true o no está definido, el conector comprueba si se proporciona un valor válido o valor por omisión para cada atributo necesario de objeto comercial. Si se proporciona una valor, la operación de creación se ejecuta satisfactoriamente; de lo contrario, la operación falla.

Si UseDefaults tiene el valor false, el conector sólo comprueba si se proporciona un valor válido para cada atributo necesario de objeto comercial; la operación de creación falla si no se proporciona un valor válido.

El valor por omisión es false.

UseDefaultsForCreatingChildBOs

Si UseDefaultsForCreatingChildBOs tiene el valor true o no está definido, el conector comprueba si se proporciona un valor válido o valor por omisión para cada atributo necesario de objeto comercial. Si se proporciona una valor, la operación de creación se ejecuta satisfactoriamente; de lo contrario, la operación falla.

Si UseDefaultsForCreatingChildBOs tiene el valor false, el conector sólo comprueba si se proporciona un valor válido para cada atributo necesario de objeto comercial; la operación de creación falla si no se proporciona un valor válido.

El valor por omisión es "false".

UseDefaultsWhenPolling

Si UseDefaultsWhenPolling tiene el valor true, los valores por omisión se establecerán en el objeto comercial antes de recuperarlo de la base de datos y enviarlo al servidor.

Si UseDefaultsWhenPolling tiene el valor false, los valores por omisión no se establecerán en el objeto comercial antes de recuperarlo de la base de datos y enviarlo al servidor.

El valor por omisión es true.

Nota:
Esta propiedad de configuración específica del conector sustituye a UseDefaultsForRetrieve.

Copyright IBM Corp. 1997, 2004