Defining SequeLink® Service Attributes

This section describes SequeLink service attributes in alphabetical order.

DataSourceAllowBatchStatements

Specifies whether the SequeLink data source accepts a batch of SQL statements. A batch is used to submit multiple update commands together as a single unit to the underlying DBMS.

Valid values are:

The default is FALSE.

Type=Dynamic

NOTE: This service attribute is used by the ODBC Client and the ADO Client.

DataSourceAllowPrefetch

Specifies whether the JDBC Client launches a request to the server to fetch the next set of rows from the database while the application is processing a previous set of retrieved rows.

Valid values are:

The default is FALSE.

Type=Dynamic

NOTE: This service attribute is used by the JDBC Client.

DataSourceApplID

Specifies a list of application IDs the SequeLink data access service will accept. A valid application ID is an alphanumeric string with a maximum length of 128 characters.

The default is an empty string.

Type=Dynamic

See "Configuring SequeLink® Security" for more information about using application IDs to limit access to SequeLink services.

DataSourceArrayFetchMaxBytes

Specifies the number of bytes the SequeLink Server uses when doing an arrayfetch from the DBMS. The larger the size of the buffer, the more rows that SequeLink will fetch in one database fetch. This will have a positive effect on performance. However, a larger buffer increases the amount of memory that SequeLink uses.

A value of 0 disables the array fetch mechanism. Valid values are 0 to 65536.

The default is 65536.

Type=Dynamic

DataSourceAutoApplId

Specifies an application ID that is automatically generated by the ODBC Client to identify the client application to the SequeLink service. A valid automatically generated application ID contains exactly 40 hexadecimal digits. Each provided value can have an optional text description. For example:

InventoryControl=aaf7798c8c66e6b3a6b1462eff442b39b7be6946 

The default is an empty string.

FSee "Configuring SequeLink® Security" for more information about using application IDs to limit access to SequeLink service.

Type=Dynamic

DataSourceBatchProcessing

Configures the behavior for batch processing on the SequeLink server. Valid values are:

The default is Emulated.

For more information about batch processing, refer to your DBMS documentation.

Type=Dynamic

DataSourceBlockFetchForUpdate

When the isolation level is Read Committed and a SELECT FOR UPDATE statement is issued against some data stores, the SequeLink Client does not lock the expected row. Valid values are:

The default is 1.

Type=Dynamic

For more information, refer to the SequeLink Developer's Reference.

DataSourceCurrentCatalog

Specifies the default catalog to be used when connected to the SequeLink data access service. The valid value is a defined database catalog name.

The default is an empty string.

Type=Dynamic

DataSourceCursorHold

Specifies the effect of transaction completion on open cursors. Valid values are:

For Informix and for DB2 UDB on z/OS, the default is 1.

For all other DBMS, the default is 0.

Type=Dynamic

DataSourceDB2CatalogOwner

Specifies the owner of the DB2 catalog. This parameter allows you to limit the meta-information that is returned by using views on the DB2 catalog.

Specify SYSIBM when making selections on the native DB2 catalog tables. Otherwise, specify a different value for the catalog owner to limit the number of tables retrieved by SequeLink. The valid value is a defined database catalog name.

The default is SYSIBM.

Type=Dynamic

DataSourceDB2CollectionPrefix

Specifies a user-defined prefix, which can be no longer than 15 characters, for the DB2 collection that identifies where the SequeLink package resides.

Based on the isolation level (DataSourceTransactionIsolation attribute), a suffix is added to the DB2 collection name, for example, CollectionPrefix_U. Valid values are:

For example, if you use the default prefix SLD600 for an uncommitted connection, the DB2 collection name is SLD600_U.

The default is SLD600.

Type=Dynamic

DataSourceDB2ConnectOptions

Specifies additional connect options to use when the SequeLink server connects to DB2 on Linux, UNIX, or Windows. This string will be appended to the connect string.

The default is an empty string.

Type=Dynamic

DataSourceDB2DBFilterList

Specifies a list of comma-separated values specifying the databases from which tables can be retrieved by a SQLTables (ODBC), getTables (JDBC), or TABLES (ADO) call. You cannot use quotes.

The default is an empty string.

Type=Dynamic

DataSourceDB2DBMSName

Specifies the value that is returned for SQLGetInfo (SQL_DBMS_NAME). Valid values are:

The default is 0.

Type=Dynamic

DataSourceDB2DecimalPoint

Specifies whether the decimal point for numbers is a comma (,) or a period(.). This setting allows the data source to overwrite the DB2 installation parameter DECIMAL POINT. If no setting is specified, the DB2 installation parameter is read from the load module of DB2.

Valid values are:

The default is PERIOD.

Type=Dynamic

DataSourceDB2LogPath

Defines the log path for all CLI calls executed by the SequeLink service. The valid value is a log path.

Type=Dynamic

DataSourceDB2MaxLobSize

Specifies the size (in bytes) that is reported for BLOB and CLOB data types, for example, in response to a SQLGetTypeInfo call (ODBC) or the equivalent OLE DB and JDBC calls.

Valid values are from 1 to 2147483647.

The default is 2147483647.

Type=Dynamic

DataSourceDB2ReportLobsFirst

Specifies the order in which BLOB and CLOB data types are reported, for example, in response to a SQLGetTypeInfo call (ODBC) or the equivalent OLE DB and JDBC calls.

The default is FALSE.

Type=Dynamic

DataSourceDB2TranslateCount

On DB2 UDB V7 and earlier, specifies whether the service will substitute COUNT(columnName) with COUNT(*).

The default is FALSE.

Type=Dynamic

DataSourceDescribeParam

Defers the fetching of parameter metadata until it is needed by the application.

The default is Enabled for all databases except Sybase, where the Service template contains Disabled.

Type=Dynamic

DataSourceDescription

Specifies a general description of the server data source.

Type=Static

DataSourceDisableWarnings

Turns on and off the filtering of generated warnings.

Type=Dynamic

DataSourceEnableAccess

Determines whether access to a specified data source is enabled.

The default is TRUE.

Type=Dynamic

DataSourceEnableDescribeParam

Turns on a workaround for connections to Oracle data stores only. For more information, refer to the SequeLink Developer's Reference.

The default is 0.

Type=Dynamic

DataSourceFetchNextOnly

Turns on a workaround for Visual Basic/Remote Data Objects (RDO) that circumvents a problem with FORWARD_ONLY cursors when the driver reports other values than FETCH_NEXT for SQLGetInfo(SQL_FETCH_DIRECTION).

For example, if the driver only reports FETCH_NEXT, RDO performs SQLExecDirect, SQLBindCol, and SQLExtendedFetch(NEXT). If the driver supports more than FETCH_NEXT, RDO performs SQLExecDirect, SQLExtendedFetch(NEXT), and SQLGetData. This is only valid when the rowsize is 1, but RDO uses a larger rowsize in this situation.

The default is FALSE.

Type=Dynamic

For more information, refer to the SequeLink Developer's Reference.

DataSourceFetchTimeStampAsString

Specifies whether a workaround for a Microsoft Access problem with timestamps is turned on.

The default is FALSE.

Type=Dynamic

DataSourceFixCharTrim

Turns on a workaround for applications that have a problem using SQL_CHAR data padded with spaces. The ODBC driver returns SQL_CHAR data padded with spaces as mandated by the ODBC specification. For more information, refer to the SequeLink Developer's Reference.

The default is 0.

Type=Dynamic

DataSourceGetOutputParams

Turns on a workaround that allows you to control when output parameters of stored procedures are returned to calling applications. For more information, refer to the SequeLink Developer's Reference.

The value for this service attribute should be set to the cumulative value of all chosen options added together.

Valid values are:

The default is 7.

Type=Dynamic

NOTE: Set GetOutputParams=3 when executing stored procedures with output parameters in RDO (Visual Basic 5 and 6).

DataSourceINFClientLocale

Sets the Informix CLIENT_LOCALE environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFDbAnsiWarn

Sets the Informix DBANSIWARN environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFDbLang

Sets the Informix DBLANG environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFDbLocale

Sets the Informix DBLOCALE environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFDbNls

Sets the Informix DBNLS environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFDelimldent

Sets the Informix DELIMIDENT environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFHost

Sets the Informix INFORMIXHOST environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFInformixDir

Sets the Informix INFORMIXDIR environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFInformixServer

Sets the Informix INFORMIXSERVER environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFLang

Sets the Informix LANG environment variable used by the SequeLink service.

Type=Dynamic

DataSourceINFService

Sets the value of the Informix SERVICE network parameter used by the SequeLink service.

Type=Dynamic

DataSourceKeySetDataType

Specifies the SQL data type of the auto-unique column (ROWID) in a database table. Valid values are:

  • SQL_BINARY
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_INTEGER
  • SQL_LONGVARCHAR
  • SQL_NUMERIC
  • SQL_REAL
  • SQL_SMALLINT
  • SQL_TYPE_DATE
  • SQL_TYPE_TIME
  • SQL_TYPE_TIMESTAMP
  • SQL_VARBINARY
  • SQL_VARCHAR

Examples include:

DB2
SQL_BINARY, SQL_TIMESTAMP
Microsoft SQL Server
SQL_VARCHAR
Sybase
SQL_NUMERIC
ODBC Socket and JDBC Socket
Depends on the backend driver

Type=Dynamic

NOTE: This service attribute is not used by the SequeLink Server for Informix and SequeLink Server for Oracle.

DataSourceKeySetName

Specifies the name of the auto-unique column (Rowid) in a database table, as shown in the following examples:

DB2
The name of any column that enforces uniqueness of the column data, such as ROWID.
Microsoft SQL Server
IDENTITYCOL
Sybase
SYB_IDENTITY
ODBC Socket and JDBC Socket
Depends on the backend driver

The default is an empty string.

Type=Dynamic

NOTE: This service attribute is not used by the SequeLink Server for Informix and SequeLink Server for Oracle.

DataSourceKeySetOptions

Specifies the behavior of SQL Select statements with a auto-unique column (Rowid). Valid values are:

Type=Dynamic

NOTE: This service attribute is not used by the SequeLink Server for Informix and SequeLink Server for Oracle.

DataSourceKeySetSize

Specifies the bind size of the auto-unique column (ROWID) in a database table.

DB2
40
Microsoft SQL Server
38
Sybase
38
ODBC Socket and JDBC Socket
Depends on the backend driver.

The default is 0.

Type=Dynamic

DataSourceLimitCursorColumnSize

Limits the columnSize of a result set column to an acceptable value. When a default varchar column is created in FileMaker, the database defines it as 1000000 characters. When the application requests a static cursor on a Unicode datasource, the driver reserves 3000000 (UTF-8) bytes in its internal row buffer for this type of column.

NOTE: In earlier SequeLink releases, this attribute was called DataSourceLimitColumnBindSize.

Limiting the column size makes the row buffer size smaller and reduces disk access.

The default is 0. No value is set.

Type=Dynamic

DataSourceLimitParamBindSize

Specifies the bind size to use when exporting a table that contains null data in a memo column from Microsoft Access. Microsoft Access binds the parameter with a columnSize of 4294967295. The SequeLink Client attempts to allocate a buffer of this size, and typically fails due to lack of memory.

To configure the bind size and get around this application bug, set the parameter bind size for SQL_CHAR, SQL_VARCHAR, SQL_BINARY, SQL_VARBINARY values to a reasonable value.

The default is 0.

Type=Dynamic

DataSourceLogoffBehaviour

Specifies the database action that needs to be taken when an abnormal logoff terminates a transaction. When the attribute is not set, the current transaction will be ended according to the database default logoff behavior.

Valid values are:

Type=Dynamic

DataSourceLogonMethod

Specifies the data store logon method to be used to log on to the data store. The values you use depend on the SequeLink security configuration. Valid values are:

Setting DataSourceLogonMethod=OSIntegrated means that database authentication relies on the operating system user credentials supplied in the Kerberos ticket. See "ServiceAuthMethods" for more information.

See "Configuring Data Store Logon" for more information about configuring data source logons refer to the SequeLink Administrator's Guide.

Type=Dynamic

DataSourceMaxCpuAction

Specifies the action to be taken when DataSourceMaxCpuTime is exceeded. Valid values are:

The default is LOG.

Type=Dynamic

DataSourceMaxCpuTime

Specifies (in seconds) the total amount of CPU time that the connection is allowed to consume. If unspecified or set to zero (0), the service is not monitored for exceeding total CPU time. Valid values are:

The default is 0.

Type=Dynamic

DataSourceMSSBindAllLOBs

Specifies which columns will be buffered. Valid values are:

The default is False.

Type=Dynamic

DataSourceMSSConnectOptions

Specifies additional connection options to use when the SequeLink Server connects to Microsoft SQL Server. This string is appended to the connection string. Keyword-value pairs are separated by a semicolon.

You can use this option to connect to a non-default Microsoft SQL Server instance located on another machine. For example:

DataSourceMSSConnectOptions=Server=Belg-John\MSSS2000;SnapshotSerializable=1; 

connects to the Microsoft SQL Server instance named MSSS2000 on the machine Belg-John and enables Snapshot isolation level.

The default is an empty string.

Type=Dynamic

DataSourceMSSCursorType

Specifies the type of cursor the SequeLink Server will use. Valid values are:

The default is Serverside.

Type=Dynamic

DataSourceMSSCursorWarnings

Microsoft SQL Server sometimes has problems opening server-side cursors for select or stored procedure result sets. This setting masks the warning issued by Microsoft SQL Server each time it encounters this problem. Valid values are:

The default is False.

Type=Dynamic

DataSourceMSSLogPath

Specifies the log path to be used for all ODBC calls executed by the SequeLink data access service.

Type=Dynamic

DataSourceMSSMapLongToDecimal

Specifies whether the JDBC Client uses the NUMERIC data types instead of the BIGINT data type. Because Microsoft SQL Server 7 does not support the SQL data type BIGINT, a call to setLong results in an exception. Valid values are:

The default value is 0.

Type=Dynamic

DataSourceMSSODBCConnStr

This service attribute is obsolete. Instead, use "DataSourceMSSConnectOptions" to specify additional connection options to use when the SequeLink Server connects to Microsoft SQL Server.

DataSourceMSSODBCLogPath

This service attribute is obsolete. Use one of the following service attributes:

DataSourceName

Specifies the name of the server data source. The data source name is defined during configuration and cannot be changed afterward.

The default data source has a fixed name, such as "Default".

Type=Dynamic

DataSourceORAMapTSWTZ

Determines whether columns with a TIMESTAMP WITH TIME ZONE data type are mapped to a timestamp data type when they are retrieved from an Oracle 9i or higher database. Valid values are:

The default is FALSE.

Type=Dynamic

DataSourceORANumber0IsNumeric

Specifies how the JDBC Client treats FLOAT columns and columns that are the result of a function (for example, COUNT(*), SUM(...)). Because Oracle describes both types of columns as NUMBER(0,0), the SequeLink Server cannot differentiate between them. SequeLink therefore handles these columns as SQL data type FLOAT. Valid values are:

The default is 0.

Type=Dynamic

DataSourceORAPublicSchemaSupp

Determines whether the Oracle schema named PUBLIC is supported in catalog statements (for example, SQLTables). Valid values are:

Type=Dynamic

DataSourceORARecyclebinSupp

Determines whether database objects in the Oracle recycle bin are shown in the SequeLink catalog statements. Valid values are:

The default is FALSE.

Type=Dynamic

DataSourceORAReportDBLinkAsCatalog

Specifies whether DBLinks are reported as catalogs. Valid values are:

The default is FALSE.

Type=Dynamic

DataSourceORAServiceName

Specifies the Oracle service name to which the application wants to connect. The valid value is a defined Oracle service name.

Type=Dynamic

DataSourceORASynDBLinkObjSupp

Turns on and off support for synonyms of remote Oracle objects in Catalog statements. Valid values are:

The default is FALSE.

Type=Dynamic

DataSourceProviderTypesFile

Specifies the name of the file that contains the information returned from the OLE DB ProviderTypes call by an ADO provider data source. The file must be located in the SequeLink installation directory.

Each driver is assigned a specific section name, which is configured in the SequeLink server data source using DataSourceProviderTypesSection.

The default file is swsoc.ini.

Type=Dynamic

DataSourceProviderTypesSection

Specifies the section within the providertypes file that will be used to retrieve OLE DB ProviderTypes information.

The default is Default.

Type=Dynamic

DataSourceReadOnly

Controls read-only access to the SequeLink data access service. Valid values are:

The default is No.

Type=Dynamic

DataSourceReportLobsAsLongvar

Enables the JDBC Client to map BLOB and CLOB data types to LONGVARCHAR or LONGVARBINARY.

The default is FALSE.

Type=Dynamic

DataSourceSchemaFilterList

A schema name filter for SQLTables and SQLProcedures (ODBC), getTables and getProcedures (JDBC), and TABLES and PROCEDURES (OLE DB/ADO). This attribute is not valid when ServiceCodePage=Database. Valid values are any defined schemas including:

The default is an empty string.

Type=Dynamic

DataSourceSessionToken

Specifies a setting that allows easy correlation of the SequeLink session as displayed in SequeLink monitoring/tracing tools, and the RDBMS session as it can be visualized using the RDBMS-specific monitoring/tracing tools.

Associated with each connection, the SequeLink 6.0 server creates a session token, which is exported to:

If the length of the session token exceeds the allowed length of the DBMS field, the session token is truncated and a warning is issued as shown in the following table:

DB2 UDB on Linux, UNIX, and Windows
TP Monitor client accounting string
DB2 on z/OS
Accounting-token (in DB2 statistics and accounting trace records)
Oracle9 or higher
view v$session:column CLIENT_IDENTIFIER
SQL Server
Sysprocesses.program_name
Sybase
table sysprocesses: column clientname

Valid values are a combination of static text and the following placeholders that will be replaced at runtime by the corresponding values. For example:

Session from ${ClientInfo} connected to ${DataSourceName}

Placeholder Value
Runtime Value
${ClientApi}
One of JDBC, ODBC, ADMIN, or OLEDB
${ClientInfo}
Client IP address or host name
${ClientApplName}
Application name provided by the client application through the ApplicationName connect attribute/keyword
${DataSourceName}
Name of data source for the current session
${ServiceName}
Name of the SequeLink service for the current session
${SessionId}
SequeLink session ID
${ClientApplId}
Application ID being used for the current session
${ClientAutoApplIdDesc}
The text part of the automatic application ID is used for the current session

Type=Dynamic

DataSourceSLKStcCrsrLngCLBuff

Turns on a workaround that allows you to specify the amount of data (in KB) that is buffered for SQL_LONGVARCHAR and SQL_LONGVARBINARY columns with a static cursor. For more information about this client attribute, refer to the SequeLink Developer's Reference.

The default is 4.

Type=Dynamic

DataSourceSOCEmptyRowSyntax

Specifies the syntax to use when inserting an empty row into a database table. Valid values are:

Type=Dynamic

DataSourceSOCJDBCConnectOptions

Specifies additional connection options to use when the SequeLink Service for JDBC Socket connects to the ODBC-to-JDBC bridge. This string will be appended to the connection string.

NOTE: Set this attribute only when instructed to do so by DataDirect Technologies technical support.

The default value is an empty string.

Type=Dynamic

DataSourceSOCJDBCConnectionURL

Specifies the URL string to pass to the JDBC driver to connect to the database. For example, if you are using the Websphere Information Integrator Classic Federation for z/OS (also known as CrossAccess or DB2 II Classic Federation) driver, the value could be:

jdbc:dd-crossaccess30:datasource:tcp/host/port:CODEPAGE=USS 

The default value is an empty string.

Type=Dynamic

To set up a DataDirect Spy log with the SequeLink Server for JDBC Socket, add the key-value pair spy_log=Spy log specification to the DataSourceSOCJDBCConnectionURL to include the DataDirect Spy driver as follows:

DataSourceSOCJDBCConnectionURL=DataSourceSOCJDBCConURL;spy_log=(file)filename 

For example:

DataSourceConnectionURL= 
jdbc:dd-crossaccess30:EXIMS:tcp/10.30.14.109/9001:CODEPAGE=USS};
spy_log=(file)/tmp/spy.log 

Other DataDirect Spy options can be specified by adding key-value pairs in which the original Spy-option name is prefixed with spy_. For example:

DataSourceConnectionURL= 
jdbc:dd-crossaccess30:EXIMS:tcp/10.30.14.109/9001:CODEPAGE=USS;
spy_log= (file)/tmp/spy.log;spy_timestamp_yes 

DataSourceSOCJDBCDbProperties
Name

Specifies the name of a JDBC driver/database-specific properties file that contains the configuration values. Valid values are the file name of a properties file minus the .properties extension.

This properties file is used to set specific database properties that cannot be retrieved by the JDBC driver. In other words, it corrects differences between the ODBC and JDBC APIs. A number of examples are provided, for example, crossaccess30, db2v7mvs, db2v8udb, derby, oracle9i, sqlsrv2000, sybase125.

If you need a properties file for your specific JDBC driver, contact SequeLink technical support.

The default value is an empty string.

Type=Dynamic

DataSourceSOCJDBCDriverClassName

Specifies the name of the JDBC driver being used to connect to the database. For example, if you are using the SequeLink JDBC driver, the value would be:

com.ddtek.jdbc.crossaccess30.CrossAccessDriver

The default value is an empty string.

Type=Dynamic

DataSourceSOCJDBCLogPath

Specifies the log path to be used for tracing the calls executed by the SequeLink data access service. The valid value is a defined path for a log file.

Type=Dynamic

DataSourceSOCJDBCReadLongDataLength

Specifies whether the SequeLink Server for JDBC Socket can cache long data in order to read the length and provide this information to the application. Valid values are:

Type=Dynamic

DataSourceSOCODBCConnStr

Specifies the connection string used by a SequeLink client application for a connection to an ODBC system data source. When the application provides the optional DBMS user name, password and database values, the values will be appended to the values of the UID, PWD, and DB keywords provided by the client when connecting to the ODBC Socket. The data source specified in the value for this attribute must be a system ODBC data source on Windows.

Example 1

Suppose you want to connect to a Microsoft Access database. You use DataSourceSOCODBCConnStr to connect to the Microsoft Access driver. You specify the backend ODBC data source name for DataSourceSOCODBCConnStr, for example, DSN=MS_Access_2003.

You can also specify other connection options to overwrite the backend ODBC data source settings that were specified in the ODBC Administrator. For example, the data source MS_Access_2003 is set up to access the database D:\DATA\MSACCESS\db1.mdb.

Example 2

Suppose you want to access two Access databases (db1.mdb and db2.mdb) with one SequeLink Service Socket for ODBC.

First, you create an ODBC data source for your application that uses the SequeLink ODBC driver, specifying only the host and port of the SequeLink Server Socket for ODBC in the ODBC administrator. In this case, you connect to the default SequeLink Server data source, which is configured to access db1.mdb.

To access db2.mdb, you create a new SequeLink server data source, for example, SLAccess_db2mdb, using the SequeLink Command Line Administrator or the SequeLink MMC snap-in.

After creating this new SequeLink server data source, the service attribute DataSourceSOCODBCConnStr contains DSN=MS_Access2003.

Change this value to DSN=MS_Access2003;DBQ=D:\DATA\MSACCESS\db2.mdb.

On the client side, specify the SequeLink server data source SLAccess_db2mdb in your connection string or define it in your ODBC data source.

The default is an empty string.

Type=Dynamic

DataSourceSOCODBCLogPath

Specifies the log path to be used for all ODBC calls executed by the SequeLink data access service for SequeLink Server for ODBC Socket. The valid value is a defined path for a log file.

Type=Dynamic

NOTE: This service attribute replaces DataSourceMSSODBCLogPath, which was used in earlier versions of SequeLink.

DataSourceSybConnectOptions

Specifies additional connection options to use when the SequeLink server connects to the Sybase DBMS. This string will be appended to the connect string.

Valid connection options include:

CharSet

Use the CharSet connection option only on Windows when ServiceCodePage=OS. Use
CS=cpACP, where ACP is determined through the registry (see earlier for an explanation on how to find this out).
On a typical English Windows installation, use CS=cp1252.
IANAAppCodePage

Use the IANAAppCodePage connection option only on Linux/UNIX when ServiceCodePage=OS. Use IANAAppCodePage=value, where value refers to an entry in Table D-11, namely IANAAppCode value. In order to find the correct value to use, you must map the value that is specified in the LC_ALL environment variable to one of the entries in Table D-11 using the first column of the table.

Table D-11. Values for DataSourceSybConnectOptions 
OS Code Page
Description1
IANAAppCodePage Value
ascii_8
US_ASCII
3
big5
Big5
2026
cp437
IBM437
2008
cp850
IBM850
2009
cp852
IBM852
2013
cp855
IBM855
2046
cp857
IBM857
2047
cp860
IBM860
2048
cp864
IBM864
2051
cp866
IBM866
2052
cp869
IBM869
2054
cp1250
WINDOWS_1250
2250
cp1251
WINDOWS_1251
2251
cp1252
WINDOWS_1252
2252
cp1253
WINDOWS_1253
2253
cp1254
WINDOWS_1254
2254
cp1255
WINDOWS_1255
2255
cp1256
WINDOWS_1256
2256
cp1257
WINDOWS_1257
2257
cp1258
WINDOWS_1258
2258
iso_1
ISO_8859_1
4
iso88592
ISO_8859_2
5
iso88595
ISO_8859_5
8
iso88596
ISO_8859_6
9
iso88597
ISO_8859_7
10
iso88598
ISO_8859_8
11
iso88599
ISO_8859_9
12
iso885915
ISO_8859_15
111
koi8
KOI8_R
2084
roman8
roman8
2004
sjis
sjis
17
tis620
tis620
2259

1Depending on the version of Linux/UNIX that you are using, the actual description of the code page will be different.

The default is an empty string.

Type=Dynamic

DataSourceSYBLogPath

Specifies the log path for all CLI calls executed for the data access service for SequeLink Server for Sybase.

Type=Dynamic

NOTE: This service attribute replaces DataSourceMSSODBCLogPath, which was used in earlier versions of SequeLink.

DataSourceSybNetworkAddress

Specifies the Sybase network address. This string will be appended to the connect string.

The default is installation-dependent.

Type=Dynamic

DataSourceTableTypeFilterList

Specifies a table-type filter for SQLTables (ODBC), getTables (JDBC), and TABLES and PROCEDURES (OLE DB/ADO). This attribute is not applicable when ServiceCodePage=database.

The valid value is a comma-separated list of table types. Valid table types on this platform are:

The default is an empty string.

Type=Dynamic

DataSourceThreadMaxRpc

Specifies the number of connection requests that will be accepted before the thread allocated to the connection is released to the thread pool. Valid values are from 0 to 1 000.

If 0 is specified, the thread is only released when the connection terminates.

The default is 10.

Type=Dynamic

DataSourceThreadRpcTimeOut

Specifies the idle time (in milliseconds) for threads allocated to connections. Once this value is reached, the thread allocated to the connection is released to the thread pool. Valid values are from 0 to 1 000 000.

Specify 0 to disable the timeout mechanism.

The default is 2 000.

Type=Dynamic

DataSourceTransactionIsolation

Specifies the transaction isolation level used for the connection. Valid values are:

Committed
Dirty reads are not possible. Phantoms and reads that cannot be repeated are possible.
Uncommitted
Phantoms, dirty reads, and reads that cannot be repeated are possible.
RepeatableRead
Dirty reads and reads that cannot be repeated are not possible. Phantoms are possible.
Serializable
Transactions can be serialized. Phantoms, dirty reads, and reads that cannot be repeated are not possible.
Not supported
SequeLink cannot set the transaction isolation level. The DBMS default transaction isolation level will be used.

Refer to your database documentation for a definition of each isolation level.

For DB2 UDB on z/OS: The default is Committed. The Not Supported value is not allowed.

All other DBMS: The default is Not Supported.

Type=Dynamic

DataSourceWorkArounds

Turns on workarounds that allow you to take full advantage of the ODBC driver with ODBC applications requiring nonstandard or extended behavior.

When this attribute is set in the configuration file, it is valid for all clients that connect to SequeLink. When you add this attribute in the connection string, it is set for that client connection only.

Refer to the SequeLink Developer's Reference for more information about connecting using a connection string.

IMPORTANT: Each of these options has potential side effects related to its use. An option should only be used to address the specific problem for which it was designed.

produces the column names col1 and C2. SQLColAttributes/
SQL_COLUMN_NAME returns an empty string for result columns that are expressions. Use this option for applications that cannot handle empty strings in column names.

The default is 0.

Type=Dynamic

DataSourceWorkarounds2

Turns on workarounds that allow you to take full advantage of the ODBC driver with ODBC applications requiring nonstandard or extended behavior.

When this attribute is set in the configuration file, it is valid for all clients that connect to SequeLink. When you add this attribute in the connection string, it is set for that client connection only.

Refer to the SequeLink Developer's Reference for more information about connecting using a connection string.

IMPORTANT: Each of these options has potential side effects related to its use. An option should only be used to address the specific problem for which it was designed.

Type=Dynamic

DataSourceWorkaroundsXliteration

Turns on multiple transliteration workarounds that resolve transliteration issues between Shift-JIS/Windows-31j and EUC-JP by mapping "look-alike" characters:

The default is 0.

Type=Dynamic

MVSDataSourceDB2Plan

Specifies the DB2 plan name used by the data source. This attribute is required only when MVSGlobalDB2Attachment=CAF (see "MVSGlobalDB2Attachment").

The default is SLD600PL.

Type=Dynamic

MVSDataSourceMaxStmtLength

Specifies the maximum length of a SQL statement that the SequeLink Server for DB2 on z/OS can handle.

This setting is only effective for DB2 v8 or higher (new function mode). For DB2 v7 or DB2 v8 (compatibility mode), this setting has no effect; the maximum statement is limited to 32700 bytes.

The default is 128 KB.

Type=Dynamic

MVSDataSourceUIDMap

Specifies the name of a user ID (UID) map. UID maps can be referenced at both the service and data source level. The valid value is a defined UIDMap name.

A UID map specified with MVSDataSourceUIDMap takes precedence over the UID map specified in the SequeLink service (see the attribute "MVSServiceUIDMap"). If neither MVSDataSourceUIDMap or MVSServiceUIDMap is specified, no UID map is used.

The default is an empty string. The default for the data source level UIDMap is the UID map specified for the SequeLink service.

Type=Dynamic

MVSDB2ExitLibrary

Specifies the name of the fully qualified DB2 exit-library (without quotes) for this DB2 interface used to generate JCL. Valid values are z/OS data set names.

NOTE: This library must be APF-authorized.

Type=Static

MVSDB2LoadLibrary

Specifies the name of the fully qualified DB2 load-library (without quotes) for this DB2 interface used to generate JCL. Valid values are z/OS data set names.

NOTE: This library must be APF-authorized.

Type=Static

MVSDB2RootDescription

Specifies a general description of the DB2 interface. The valid value is a defined DB2 interface.

Type=Static

MVSDB2SubsystemName

Specifies the subsystem ID of the DB2 address space. The valid value is a defined interface ID.

The default is MVSDB2InterfaceID.

Type=Static

MVSDB2Version

Specifies the DB2 version of the DB2 interface. Valid values are:

Type=Static

MVSGlobalClustername

Specifies the clustername to which the SequeLink Server must register for DNS/WLM-supported Sysplex connection distribution.

Type=Static

MVSGlobalCommandChar

This attribute is obsolete.

MVSGlobalCompTrace

Turns on and off tracing for server core components. Valid values are ALL or one of the following component_IDs:

C - Core components
D - DB2 component
L - Generic Log component
S - Server controller component
T - Threadpool component

If unspecified, no tracing will be performed.

The default is no component trace.

Type=Static

MVSGlobalDB2Attachment

Specifies the type of DB2 attachment to be used for the DB2 service.

MVSGlobalDB2Attachment=RRSAF can only be used when RRS is active. Valid values are:

The default is RRSAF.

NOTE: When ServiceConnectionModel=Threadpool is selected, RRSAF must be selected.

Type=Static

MVSGlobalDescCode

Specifies the WTO descriptor code for all messages directed to a console by the message logging task. The valid value is a defined WTO descriptor code.

The default is 06.

Type=Static

MVSGlobalID

NOTE: Set this attribute only when instructed to do so by DataDirect Technologies technical support.

Specifies an identifier to make this "section" unique. This attribute must be set to GLOBAL and must not be changed.

The default is GLOBAL.

Type=Static

MVSGlobalRouteCode

Specifies the WTO route code for all messages directed to a console by the message logging task. The valid value is a defined WTO route code.

The default is 11.

Type=Static

MVSGlobalSMFRecordType

Specifies the System Management Facility (SMF) record type to be used for SMF records produced by the server. Valid values are from 128 to 255.

If 0, SMF recording is turned off.

If unspecified, no SMF records are produced.

If you set this value to a positive number, you must inform the system of these records by changing the z/OS SMF parameters in the SMFPRMxx member of the SYS1.PARMLIB data set. You can activate the collection of these records using the SET command.

The recommended value is 197.

Type=Static

MVSGlobalSosLimit

Specifies the global short-on-storage (SOS) limit, which is the total amount of private storage (in KB) that must be available in the address space to accept further connections. If this amount of storage is unavailable, the incoming connections will be rejected. To turn this feature off, specify 0 or delete this attribute. Valid values are from 0 to 2048.

The default is 1024.

Type=Static

MVSGlobalSubSysID

Specifies an ID that the SequeLink Server will use as a suffix to construct a unique ResourceManager name to register to RRS. This is a required parameter when MVSGlobalDB2Attachment=RRSAF.

The default is SQLK.

Type=Static

MVSGlobalWLMEnclaves

Specifies whether the server address space will use WLM enclaves. Valid values are:

The default is NONE.

Type=Static

MVSServiceAdminAuthorizationClass

Specifies a general resource class name to be used by the server.

The default is FACILITY.

Type=Dynamic

MVSServiceAdminAuthorizationEnable

Enables authorization for the SequeLink Agent service. Valid values are:

See "Configuring SequeLink® Security" for more information about configuring SequeLink security.

The default is FALSE.

Type=Dynamic

MVSServiceAdminSecurity

This attribute is obsolete. Instead, use MVSServiceAdminAuthorization.

MVSServiceAdminSecurityClass

This attribute is obsolete. Instead, use MVSServiceAdminAuthorizationClass.

MVSServiceAdminSecurityResource

This attribute is obsolete. Instead, use MVSServiceAdminAuthorizationResource.

MVSServiceAuthorizationClass

Specifies a general resource class name used by the SequeLink Server when authorization is enabled. The valid value is a string.

The default is FACILITY.

Type=Dynamic

MVSServiceAuthorizationEnable

Enables authorization for the data access service. Valid values are:

See "Configuring SequeLink® Security" for more information about configuring SequeLink security.

Type=Dynamic

MVSServiceAuthorizationResource

If MVSServiceAuthorization is enabled, the resource name is used to validate a connection request against the z/OS security system. If the attribute's value is blank or an empty string, the server uses the service name as the resource name to be checked.

NOTE: The value specified for the data source takes precedence over the value specified for the SequeLink service.

The default is the service name.

Type=Dynamic

MVSServiceDataSourceAuthorization

Specifies that RACF resource security is used for this server data source. When the resource-based authorization has been set up, you can specify resource-based authorization for your server-side data source by setting this attribute to TRUE. See "MVSServiceAuthorizationResource" for information about defining the name of the SequeLink server data source.

The default is FALSE.

Type=Dynamic

MVSServiceDataSourceSecurity

This attribute is obsolete. Instead, use MVSServiceDataSourceSecurity.

MVSServiceDB2InterfaceID

Specifies the ID of a DB2 interface. A DB2 interface is a set of parameters that describe a DB2 subsystem which can be accessed by the SequeLink Server for z/OS.

Type=Static

MVSServiceLoadModule

Specifies the name of the load module for the service. Valid values are uppercase.

The default is VAISTHRD (for SequeLink Server for DB2 services).

Type=Static

MVSServiceSecurity

This attribute is obsolete. Instead, use MVSServiceAuthorizationEnable.

MVSServiceSecurityClass

This attribute is obsolete. Instead, use MVSServiceAuthorizationClass.

MVSServiceSecurityResource

This attribute is obsolete. Instead, use MVSServiceAuthorizationResource.

MVSServiceUIDMap

Specifies the name of a user ID (UID) map. The valid value is a defined UIDMap name. A UID map specified in the server data source takes precedence over the UID specified in the SequeLink service (see "MVSDataSourceUIDMap").

If this attribute is not specified, it is possible to have some data sources that use UID maps while other data sources do not.

The default is an empty string.

Type=Dynamic

MVSUID

Specifies an entry in the user ID (UID) map. The format of this entry is: user=mapped_user or *=mapped_user, where:

*=mapped_user is required when anonymous authentication is configured for the z/OS server (ServiceAuthMethods=Anonymous).

Type=Dynamic

MVSUIDDefaultAccess

Specifies the default action for a user ID (UID) map. A UID map set in the server data source takes precedence over a UID map set in the SequeLink service. If the server data source does not specify a UID map, the UID map defined in the SequeLink service is used.

Valid values are:

Type=Dynamic

MVSUIDMapDescription

Specifies a general description of the user ID (UID) mapping table. The valid value is a defined user ID map name.

Type=Dynamic

ServiceAdminAuthMethods

Specifies one or multiple authentication mechanisms that the SequeLink Manager can use to authenticate itself to the server. Valid values are:

See "Configuring SequeLink® Security" for more information about SequeLink security features.

Type=Dynamic

ServiceAdministrator

Sets authorization for users who are allowed to manage SequeLink services using the SequeLink Manager.

NOTES:

Valid values for the ServiceAdministrator attribute are:

See "Configuring SequeLink® Security" for more information about configuring SequeLink security.

Type=Dynamic

ServiceAdministratorGroup

Sets authorization for defined Linux, UNIX, and Windows user groups who are allowed to manage SequeLink services using the SequeLink Manager. Valid values are user groups defined on Linux, UNIX, and Windows.

To configure authorization for multiple user groups, you must set the ServiceAdministrator attribute multiple times, one time for each user group. For example:

ServiceAdministratorGroup=SLUSERG1 
ServiceAdministratorGroup=SLUSERG2 
ServiceAdministratorGroup=SLUSERG3 

NOTE: On Windows servers, you must prefix the user group ID with the Windows server name or the Windows domain name where the group is defined, for example, SALES\SLUSERG1.

See "Configuring SequeLink® Security" for more information about configuring SequeLink security.

Type=Dynamic

ServiceAdminKerberosPrincipalName

Specifies the case-sensitive service principal name to be used for Kerberos authentication for the SequeLink Agent service. Use this attribute to specify another service principal name other than the default service principal name. The name must match the service principal name in the KDC.

For example:

SLDB2UDB60/server1.eu.datadirect.com@XYZ.COM 
DB2SRV/IRONFLEX.DATADIRECT.COM@IRONFLEX.TEST 

Default=host/fully_qualified_domain_name@REALM

Type=Dynamic

For information about specifying a service principal name to be used for Kerberos authentication to a SequeLink data access service, see "ServiceKerberosPrincipalName".

ServiceAuthMethods

Specifies one or multiple authentication mechanisms the service accepts. The client must select the supported mechanism to authenticate itself to the server.

Valid values are:

Windows
  • anonymous
  • OSLogon(UID,PWD)
  • OSLogon(HUID,HPWD)
  • OSLogon(UID,PWD,NPWD)
  • OSLogon(HUID,HPWD,NPWD)
  • kerberos
  • integrated_nt
Linux/UNIX
  • anonymous
  • OSLogon(UID,PWD)
  • OSLogon(HUID,HPWD)
  • kerberos
z/OS
  • Anonymous
  • Kerberos
  • OSLogon(UID,PWD)
  • OSLogon(HUID,HPWD)
  • OSLogon(UID,PWD,NPWD)
  • OSLogon(HUID,HPWD,NPWD)

See "Configuring SequeLink® Security" for more information about configuring SequeLink security.

NOTE: UID mapping is required when ServiceAuthMethods=Anonymous.

Type=Dynamic

ServiceAuthorizedAdminClient

Specifies one or multiple client TCP/IP network identifiers that are allowed to access the service using an administrator client. Use configuration values to limit the clients that are allowed administrative connections to the agent service.

This attribute supports both address and name formats as shown in the following examples:

Client TCP/IP host name
burner.ddtek.com
Client TCP/IP domain names through the use of a wild card
192.16.2.* or *.ddtek.com
Client TCP/IP address
127.0.0.1??
Client TCP/IP address range
192.16.*.*

NOTE: When using host names, ServiceResolveHostNames must be set to True, and only primary domain names can be used.

To configure multiple TCP/IP location filters, you must set the ServiceAuthorizedAdminClient attribute multiple times, one instance for each location filter. For example:

ServiceAuthorizedAdminClient=192.16.*.* 
ServiceAuthorizedAdminClient=192.17.*.* 
ServiceAuthorizedAdminClient=192.18.*.* 

See "TCP/IP Location Filters" for more information.

Type=Dynamic

ServiceAuthorizedClient

Specifies one or multiple client TCP/IP network identifiers that are allowed to access the service using a client application. Use configuration values to limit the number of clients that are allowed data access connections to data access services.

The attribute supports both address and name formats as shown in the following examples:

Client TCP/IP host name
burner.ddtek.com
Client TCP/IP domain names through the use of a wild card
192.16.2.* or *.ddtek.com
Client TCP/IP address
127.0.0.1
Client TCP/IP address range
192.16.*.*

NOTE: When using host names, ServiceResolveHostNames must be set to True, and only primary domain names can be used.

To configure multiple TCP/IP location filters, you must set the ServiceAuthorizedClient attribute multiple times, one instance for each location filter. For example:

ServiceAuthorizedClient=192.16.*.* 
ServiceAuthorizedClient=192.17.*.* 
ServiceAuthorizedClient=192.18.*.* 

See "TCP/IP Location Filters" for more information.

Type=Dynamic

ServiceCancelEnabled

Specifies whether cancelling connection requests using SQLCancel is supported. Valid values are:

The default is TRUE.

Type=Static

ServiceCatchExceptions

Specifies how the SequeLink service will handle exceptions. Valid values are:

The default is TRUE.

Type=Static

ServiceCodePage

Controls transliteration for the SequeLink service. Valid values are:

The default is Default.

Type=Dynamic.

ServiceCodePageMap

Controls transliteration for the SequeLink service when the code page retrieved from the operating system or database is not recognized. When ServiceCodePage is set to OS or Database, operating system- or database-specific code pages can be mapped to the IANA character set name, overwriting or extending the service built-in mappings. For more information about the IANA character set, refer to the IANA Web site.

The format of the value depends on the type of mapping that is being extended. In general, the value is a semi-colon separated list of values, where the first or second value specified is the code page value retrieved from either the operating system or the database. The ianaName is the official IANA identifier for the code page.

Valid values are:

Type=Dynamic

ServiceConnectInfo

Specifies the TCP/IP port on which the service is listening for connection requests. The port is specified using the syntax:

tcp://host.port

where host is the name of the host on which the SequeLink service runs and port is an available TCP port.

Type=Static

ServiceConnectionModel

Specifies the connection model to be used for connections to the SequeLink service. If you change to another connection model, you must delete and recreate any monitoring or event trace profiles. Valid values are:

The default is ThreadPool.

Type=Static

ServiceDB2MaxThreads

Limits the number of DB2 threads used by the SequeLink DB2 service. This value must be higher than the value of the ServiceMaxThreads parameter and lower than the value of the MAX_BATCH_CONNECT parameter in the Thread Management panel (DSNTIPE) of the DB2 installation.

A value of 0 means that the number of threads will not be limited by the SequeLink DB2 service.

The default is 0.

Type=Dynamic

ServiceDB2MaxTransactions

Specifies the number of DB2 transactions that a DB2 thread is allowed to service before it is closed. This ensures that when the DB2 thread terminates, the locks set on temporary tables are released.

A value of 0 means that the DB2 thread is not terminated.

The default is 0.

Type=Dynamic

ServiceDB2MinThreads

Specifies the number of reusable DB2 threads that will not be released by the release timer routine or by the RRS RELEASE operator command.

A value of 0 means that all reusable DB2 threads that exceed an age of 300 seconds will be released.

The default is 0.

Type=Dynamic

ServiceDBConnectionPooling

Enables the connection pooling feature in the Driver Manager that is used for SequeLink Server for ODBC Socket and SequeLink Server for JDBC Socket on Windows. Valid values are:

The default is Disabled.

Type=Static

ServiceDeadClntDetInt

Specifies the interval (in seconds) between requests that are sent from the SequeLink Server to the SequeLink Client to verify the availability of the SequeLink Client. Valid values are 0 and any integer from 61 to 1000000.

A value of 0 disables the dead client detection feature.

The default is 600.

Type=Static

ServiceDebugLogLevel

Specifies the level of detail for messages logged in the debug log file. One or multiple message levels can be enabled/disabled. Valid values are:

The default is Fatal.

NOTE: The value of this attribute is a bitmask with each bit having the following decimal values when turned on:

Fatal: Bit 0=1
Error: Bit 1=2
Warnings: Bit 2=4
Information: Bit 3=8
Debug: Bit 4=16
SSP Packet Log: Bit 5=32
SSP Requests: Bit 6=64

If you set this attribute using a SequeLink Manager command that prompts for a decimal value, such as the ServiceAttributeReplace command, the value you set must equal the total decimal value of the bits you want to turn on. For example, if you want to turn all bits on, meaning all options would be logged, you would set the attribute to 127 (1+2+4+8+16+32+64=127). To turn off all bits, set the attribute to 0.

Type=Dynamic

ServiceDebugLogPath

Specifies the directory where debug log files are written. If the log path is fully specified, the log is written to the specified directory. If only a filename is specified, the log file is written in the install_dir\logging directory.

Contains the directory in which debug log files will be written.

Specifies a UNIX System Services HFS directory to which Log files will be written.

The default is none.

Type=Static

ServiceDescription

Specifies a general description of the SequeLink service.

Type=Static

ServiceDetailedOSLogonErrors

Specifies what type of error will be returned when the OSLogon based authentication fails. Valid values are:

The default is TRUE.

Type=Dynamic

ServiceEncryptionAlgorithm

Specifies the data scrambling algorithm used when sending requests or replies across the network between client and server. Valid values are:

The default is None, which means cleartext.

See "Configuring SequeLink® Security" for more information about configuring SequeLink security.

Type=Static

ServiceEnvironmentVariable

Specifies a list of variables that will be set before the SequeLink service is started. The syntax for valid values is varname=value. For example, ORACLE_SID=ORA10g.

To define more than one variable, you must add more than one instance of the attribute to your service.

Examples:

ServiceEnvironmentVariable=PATH=D:\Programs\java\j2sdk1.4.2_05\jre\bin\
server;D:\Programs\java\j2sdk1.4.2_05\jre\bin  
ServiceEnvironmentVariable=SL_JAVA_OPTIONS=-Xms32m -Xms64m -Xcomp -verbose 
ServiceEnvironmentVariable=ISLVINI=/usr/sl60/server/ipe  

Type=Static

ServiceEventTraceLocation

Specifies the directory where the event trace file is located. The valid value is an existing directory.

The default is an empty string.

Type=Static

ServiceEventTraceSize

Specifies the size (in bytes) of the event trace file. Valid values are from 10 000 to 2 000 000 000. On z/OS, the specified value is rounded to a 4 KB page value.

The default is 1 000 000.

Type=Static

ServiceEvQGetNrEventsMax

Specifies the number of events to get from the event queue in one read operation.

The default is 10.

Type=Static

NOTE: Set this attribute only when instructed to do so by DataDirect Technologies technical support.

ServiceEvQPingTimeout

Specifies the timeout (in milliseconds) the SequeLink Agent will wait for a SequeLink data access service response while determining whether the service is started.

The default is 1000.

Type=Static

ServiceEvQShmMonitorSize

Specifies the size of the shared memory segment (in bytes) to be used for the shared monitor counters. The shared monitor counters are monitor values that are accessible using the Windows performance monitor integration.

The default is 4096.

Type=Static

ServiceEvQShmQMaxResend

Specifies the number of attempts while sending events on the event queue before generating a fatal error.

The default is 5.

Type=Static

ServiceEvQShmQSize

Specifies the size of the shared memory segment for the event queue. The event queue is used as a communication path between SequeLink services.

The default is 65536.

Type=Static

ServiceEvQShmQWaitResend

Specifies the time (in milliseconds) to wait between successive attempts to send events on the event queue.

The default is 50.

Type=Static

NOTE: Set this attribute only when instructed to do so by DataDirect Technologies technical support.

ServiceExecPath

Specifies the path of a SequeLink Server executable and is used differently depending on platform. The valid value is a defined location of a SequeLink server executable.

Do not alter this attribute.

Type=Static

ServiceExecPath2

Specifies the path of a SequeLink server executable to start by SequeLink service starter. The valid value is a defined location of a SequeLink server executable.

Type=Static

ServiceHost

Specifies the name of the host on which the SequeLink service is installed.

Type=Dynamic for newly-created services

Type=Read-only for existing services

ServiceIdleTimeInt

Specifies time (in seconds) a connection can be idle before it is terminated by the SequeLink Server. Because ServiceIdleTimeInt is static, you must restart the SequeLink service to make the change effective.

Valid values are 0 and any integer from 60 to 1000000.

The default is 0. Idle time checks are disabled.

Type=Static

ServiceIIOPObjectKey

Specifies IIOP object key in IIOP header.

The default is IIOP:slx::.

Type=Static

NOTE: Set this attribute only when instructed to do so by DataDirect Technologies technical support.

ServiceIIOPOperationTarget

NOTE: Set this attribute only when instructed to do so by DataDirect Technologies technical support.

Specifies IIOP operation target in IIOP header.

The default is SSP.

Type=Static

ServiceINFMaxNrActStat

Specifies the maximum number of active statements that are allowed for each connection to an Informix database.

The default is 250.

Type=Dynamic

ServiceInternalTimeout

Specifies the number (in milliseconds) that thread pool synchronization actions block before generating an internal error. Valid values are positive numbers.

The default is 60000.

Type=Static

ServiceKerberosPrincipalName

Specifies the case-sensitive service principal name to be used for Kerberos authentication to the SequeLink data access service. Use this attribute to specify another service principal name other than the default service principal name. The name must match the service principal name in the KDC.

For example:

SLDB2UDB60/server1.eu.datadirect.com@XYZ.COM 
DB2SRV/IRONFLEX.DATADIRECT.COM@IRONFLEX.TEST 

Default=host/fully_qualified_domain_name@REALM

Type=Dynamic

On Linux/UNIX, the service principal name must exist in the keytab file.

For information about specifying a service principal name to be used for Kerberos authentication to a SequeLink Agent service, see "ServiceAdminKerberosPrincipalName".

ServiceLanguage

The specified language for SequeLink messages. The only valid value and the default is 1= English.

Type=Static

ServiceMaxSessions

Specifies the maximum number of sessions a multithreaded SequeLink Server will accept.

On z/OS, verify that this parameter does not exceed the value of MAXFILEPROC in BPXPRMxx. The MAXFILEPROC parameter can be changed dynamically.

On Linux, UNIX, and Windows, the default value is 0. A value of 0 means unlimited number of sessions is accepted.

Type=Dynamic

ServiceMaxThreads

The maximum number of threads that can be started in the thread pool. This attribute is ignored when ServiceConnectionModel is set to Thread/Connection or Process/Connection.

Valid values are:

The default is 64.

Type=Static

ServiceMessageFile

The location of the service message file:

On Windows: The valid value is the path to a resource-only DLL.

On Linux/UNIX: The valid value is the path to a .cat file.

Type=Static

ServiceMinThreads

The number of pre-started threads that will be started in the thread pool. The value should be equal to or less than the value of ServiceMaxThreads. This attribute is ignored when ServiceConnectionModel is set to Thread/Connection or Process/Connection.

Valid values are:

The default is 8.

Type=Static

ServiceMSSMergeXaBranches

When accessing Microsoft SQL Server, enables the application to merge all XA branches as one transaction branch, emulating tightly coupled branch transactions. When disabled, multiple connections within the same distributed transaction ignore each other's locks.

Valid values are:

The default is FALSE.

Type=Static

ServiceName

Specifies the name of the service to be specified during service creation. After a service is created, the name of a service cannot be changed.

Type=Dynamic for new services

Type=Read-only for existing services

ServiceORASerializeLogon

Specifies whether all Oracle API calls that are executed to establish a connection with the Oracle database are serialized.

Valid values are:

The default is TRUE.

Type=Static

ServiceRegisterTCPPort

Specifies whether the TCP/IP port will be registered automatically in the operating systems services file (/etc/services on Linux/UNIX or %SystemRoot%\system32\drivers\etc\services on the Microsoft Windows platforms on which SequeLink Server runs, for example).

The default is FALSE.

Type=Static

ServiceResolveHostNames

Specifies how host names are resolved. Valid values are:

The default is FALSE.

Type=Dynamic

ServiceSSLCipherSuites

Specifies the SSL cipher suites that SequeLink supports for data transfers between the SequeLink Client and SequeLink Server. Valid values are:

The default is TLS_DH_anon_WITH_AES_128_CBC_SHA.

Type=Static

ServiceSSLEnabled

Specifies whether SSL is enabled for the SequeLink service. Valid values are:

The default is FALSE.

Type=Static

ServiceSSLSessionCacheSize

Specifies the maximum number of SSL (or TLS) session identifiers that are cached on the SequeLink Server before the sessions are flushed from the cache. Caching SSL session identifiers so that clients can reuse them in a subsequent connection improves performance because the CPU-intensive computations required to create an SSL session are eliminated.

Valid values are from 0 to 100000.

The default is 10000.

Type=Static

ServiceSSLSessionCacheTimeout

Specifies the maximum time (in seconds) to keep a SSL (or TLS session in the SequeLink Server session cache.

Valid values are from 0 to 100000.

The default is 300.

Type=Static

ServiceSSLVersions

Specifies the version of the SSL standard that is used for encryption. Valid values are:

The default is TLS 1.0.

Type=Static

ServiceTCP1stRecvTimeLimit

Maximum amount of time (in seconds) the server will wait to receive the first network packet.

The default is 30.

Type=Static

NOTE: Set this attribute only when instructed to do so by DataDirect Technologies technical support.

ServiceThreadLockThreshold

Specifies a percentage of the value of ServiceMaxThreads. When the number of active threads is less than this percentage, a connection that has executed more RPCs than DataSourceThreadMaxRpc on the current thread is allowed to lock this thread for another DataSourceThreadRpcTimeOut period.

This attribute is required when
ServiceConnectionModel=Threadpool (see "ServiceConnectionModel" for more information).

Valid values are from 0 to 50.

On Linux, UNIX, and Windows, the default is 0 (the thread switching mechanism is disabled, improving performance in times of low system activity).

On z/OS, the default is 10.

Type=Dynamic

ServiceUnixSyslogFacility

Facility with which all SequeLink syslog messages are logged. Valid values are:

The default is USER.

Type=Dynamic

ServiceUser

Sets authorization for users who are allowed to access the service for data access.

On Linux, UNIX, and Windows: Specify everyone when ServiceAuthMethods=anonymous. To configure authorization for multiple users, you must set the ServiceUser attribute for each user. Valid values are:

RSee "Configuring SequeLink® Security" for more information about configuring SequeLink security.

Type=Dynamic

ServiceUserGroup

Sets authorization for defined Linux, UNIX, and Windows user groups who are allowed to access the service for data access. Valid values are user groups defined on Linux, UNIX, and Windows.

To configure authorization for multiple user groups, you must set the ServiceAdministrator attribute multiple times, one time for each user group. For example:

ServiceUserGroup=SLUSERG1 
ServiceUserGroup=SLUSERG2 
ServiceUserGroup=SLUSERG3 

NOTE: On Windows servers, you must prefix the user group ID with the Windows server name or the Windows domain name where the user group is defined, for example, SALES\SLUSERG1.

See "Configuring SequeLink® Security" for more information about configuring SequeLink security.

Type=Dynamic