Header Data: Symptom

SAP Note
1737415 - Sybase IQ: Enable remote/secondary connect to SAP IQ

Version 44 Validity: 31.08.2015 - active Language English (Master)
Header Data
Released On 31.08.2015 11:04:04
Release Status Released for Customer
Component BC-DB-SYB SAP Business Suite on Sybase ASE Database Platform
Priority Correction with medium priority
Category Special development
Symptom
Remote/secondary connect to SAP IQ
Other Terms
SAP Sybase IQ, SAP IQ
Reason and Prerequisites

This patch includes the necessary steps for enabling remote connects to SAP IQ.
Solution
The correction includes the required preparations and corrections for lib_dbsl to enable SAP IQ for
remote connects from SAP NetWeaver Unicode. For more information, refer to SAP note 1796393.
Prerequisites:
1. The SAP IQ server is installed.

a. Minimum required version is 15.4 ESD3 (15.4.0.3027).
b. Minimum required version for SAP IQ 16.0 is 16.0 SP1 PL1 -(64 bit).
c. The code page of the database must be CESU-8 with collation/sort order CESU8BIN binary.
Incorrect code pages cause data corruption and require a new setup of the IQ database with
the correct collation and a reimport of the data.
2. The SQL Anywhere ODBC driver is installed and accessible from the SAP NetWeaver Application
Server.
a. Minimum required version is 12.00.3027 - shipped as SQL Anywhere ODBC 15.4 ESD3.
b. Minimum required version for IQ Server 16.0 is 16.00.0481 - shipped as SQL Anywhere ODBC
16.0. This driver is also available for AIX, for IBM i and for Solaris.
c. The SQL Anywhere ODBC driver 16.0 is available for 64 -bit Linux AMD (linuxx86_64), AIX 64
bit, OS/400, Solaris on SPARC 64bit and Windows for 64 bit (ntamd64) at:
https://support.sap.com/swdc
-> Support Packages and Patches
-> Browse our Download Catalog
-> Sybase Products
-> SYBASE IQ ODBC NLS
-> SYBASE IQ ODBC NLS 16.0
-> Linux on x86_64 64bit or AIX 64bit or Windows on x64 64bit or OS/400 or Solaris on SPARC
64bit IQCLIENT160SP01
N o t e : SYBASE IQ ODBC NLS 15.4 is deprecated. Use SQL Anywhere ODBC driver 16.0 instead.
d. Use SAPCAR -xvf IQCLIENT154.SAR (or IQCLIENT160SP01.SAR) to extract the libraries directly
into the instance exe directory (e.g. /usr/sap/SID/DVEBMGS00/exe ).
This way - once the lib_dbsl and the DBCO entries are available (see steps below) - no
restart of the application server is required. Also no adaption of the library path is
required.
Alternatively, extract the archive to an empty directory of your choice which will then
contain only the client (for example, /usr/sap/SID/DVEBMGS00/exe/iqodbc).
The library path of the application server must then be adapted to include the ODBC driver.
This requires a restart of the application server after the installation of the driver:
n IBM i:
If it does not exist yet, add profile parameter as4/ADDLIBPATH to your default profile.
(It will only be recognized by IBM i application servers). Set it to the IQ client
directory <iqclient_dir>. If it exists already, add the IQ client directory separated by
colon (as4/ADDLIBPATH = <existing_libpath>:<iqclient_dir>)
(We recommend this procedure, because APYSIDKRN MODE(*FULLY) will remove the client
software from the kernel directory.)
n All other:
Add the directory to the LD_LIBRARY_PATH environment variable of <SAPSID>adm user
(Windows: PATH variable, AIX LIBPATH variable) and restart the application server
(Windows: the SAP service (SAPService<SAPSID>) must be restarted also).
e. For more details on how to install the ODBC driver, refer to the SAP SQL Anywhere
documentation (http://help.sap.com/sql-anywhere).
f. In case the SAP IQ ODBC NLS driver is missing in the SAP Support Portal, see KBA 2205476.
3. The SAP NetWeaver kernel release must be 720, 721, 738, or 7.4x.
720: patch level 321 and higher for disp+work and 440 for lib_dbsl
For SAP IQ SP8 16.0 the following patch levels are required for lib_dbsl. For more information,
refer to SAP note 2016130.
720: patch level 616
721: patch level 311
740: patch level 72
741: patch level 35
In addition the following restrictions apply:
a. Only Unicode systems are supported.

b. 64 -bit Linux AMD (linuxx86_64), AIX 64 bit, OS/400, Solaris on SPARC 64bit and Windows for
64 bit (ntamd64) are supported.
c. For 720 and 721 only the EXT kernel version is supported.
4. The lib_dbsl for SAP ASE (dbsybslib.so/dll) must be copied to the standard exe directory AND the
instance exe directory. If the SAP NetWeaver system is running with SAP ASE, this step is not
required. lib_dbsl (dbsybslib.so/dll) is available on the SAP Service Marketplace, for example
for 7.22 EXT 64-BIT UC:
Support Packages and Patches -> Browse Download Catalog -> Additional Components -> SAP Kernel -
> SAP KERNEL 64-BIT UNICODE -> SAP KERNEL 7.22 EXT 64-BIT UC -> SAP ASE.
5. A DBCO entry must be created for the connection to SAP IQ:
DBMS: SYB
Connection info: SYBASE_CONTYPE=IQ SYBASE_SERVER=<IQ Server Host> SYBASE_PORT=<IQ ServerPort>

SYBASE_IQ_ENGINE=<IQ ServerName> SYBASE_DBNAME=<IQ DatabaseName> SYBASE_IQ_LOCKWAIT=600
The general format of the connection info is: key_1=<value_1>

key_2=<value_2> ....key_n=<value_n>
The key value pairs are separated by a space character.

SYBASE_SERVER, SYBASE_PORT, SYBASE_IQ_ENGINE, SYBASE_DBNAME, SYBASE_CONTYPE are mandatory keys.
IQ SYBASE_IQ_LOAD, SYBASE_IQ_LOCKWAIT, SYBASE_IQ_BUFFER_SIZE are optional.
Additional optional parameter is: SYBASE_IQ_LOAD_DIR.

a. SYBASE_CONTYPE:
SYBASE_CONTYPE must be set to IQ.
SYBASE_IQ_CESU-8:
SYBASE_IQ_CESU-8 must be set to 1. This is the default.
b. SYBASE_IQ_LOAD:
SYBASE_IQ_LOAD can be set to 0 or 1; 1 is default.
If set to 1, the IQ load command will be used to insert mass data. The ABAP statement
INSERT (iq_table_name) CONNECTION (iq_db_connection) FROM TABLE <data>
will use the IQ load statement. This results in a performance gain of approximately factor 6
to 8 compared to the array insert for mass data.
If ACCEPTING DUPLICATE KEYS is specified - that is -
INSERT (iv_table_name) CONNECTION (iv_db_connection) FROM TABLE <data> ACCEPTING DUPLICATE

KEYS
the insert will be executed using array insert.

Also, if the table definition in the SAP ABAP Dictionary and in the IQ database do not match
completely, the insert will be executed using array insert.
SYBASE_IQ_LOAD set to 1 requires READCLIENTFILE authorization in the IQ server:
set option allow_read_client_file=on

c. SYBASE_IQ_LOCKWAIT:
Before execution of the load command the table will be locked for write access. With
SYBASE_IQ_LOCKWAIT it is possible to overwrite the lock wait time. Default is 300 seconds.
Example: SYBASE_IQ_LOCKWAIT=600 will set a lock wait time of 600 seconds.
d. SYBASE_IQ_BUFFER_SIZE:
The buffer size for array operation to IQ can be modified using SYBASE_IQ_BUFFER_SIZE - to
be set in bytes. Default is 40 kB.
Example: SYBASE_IQ_BUFFER_SIZE=500000 will set a buffer size of 500 kB.
Note that the ODBC driver has a fixed limit of 32 kB rows per buffer.
e. SYBASE_IQ_LOAD_DIR:
By default the data directory of the instance is used to temporarily store the load files.
In special cases the directory can be changed by using the SYBASE_IQ_LOAD_DIR parameter.
<sapsid>adm must have write permission on this directory. I/O performance should be high.
Validity
Software Component From Rel. To Rel. And Subsequent
KRNL64UC 7.20 7.20
7.20EXT 7.20EXT
7.21 7.21
7.21EXT 7.21EXT
7.38 7.38
SAPHOSTAGENT 7.20 7.20
7.20EXT 7.20EXT
Support Packages & Patches
Support Package Patches
Software Component Support Package Patch Level

SAP KERNEL 7.20 32-BIT SP000 000440
SAP KERNEL 7.20 32-BIT UNICODE SP000 000440
SP320 000320
SAP KERNEL 7.20 EXT 32-BIT SP000 000440
SAP KERNEL 7.20 EXT 32-BIT UC SP000 000440
References
This document refers to:
SAP Notes
1858550 Downport NLS IQ to BW 7.0X
1796393 SAP BW near-line solution with Sybase IQ
This document is referenced by:

SAP Notes (4)
1858550 Downport NLS IQ to BW 7.0X
1946327 IBM i: Multi-connect to SYBASE IQ
2128579 Data Load into SAP IQ during Copy Phase utilizes only one server-side Thread
1796393 SAP BW near-line solution with Sybase IQ
Attachments
File Name File Size (KB) Mime Type
stopdb.zip 10 application/x-zip-compressed

Header Data: Symptom

Uploaded by

Copyright:

Available Formats

Header Data: Symptom

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Header Data: Symptom

Uploaded by

Copyright:

Available Formats

SAP Note

1737415 - Sybase IQ: Enable remote/secondary connect to SAP IQ

Reason and Prerequisites

1. The SAP IQ server is installed.

In addition the following restrictions apply:

a. Only Unicode systems are supported.

5. A DBCO entry must be created for the connection to SAP IQ:

Connection info: SYBASE_CONTYPE=IQ SYBASE_SERVER=<IQ Server Host> SYBASE_PORT=<IQ ServerPort>

The general format of the connection info is: key_1=<value_1>

The key value pairs are separated by a space character.

IQ SYBASE_IQ_LOAD, SYBASE_IQ_LOCKWAIT, SYBASE_IQ_BUFFER_SIZE are optional.

Additional optional parameter is: SYBASE_IQ_LOAD_DIR.

INSERT (iv_table_name) CONNECTION (iv_db_connection) FROM TABLE <data> ACCEPTING DUPLICATE

the insert will be executed using array insert.

SYBASE_IQ_LOAD set to 1 requires READCLIENTFILE authorization in the IQ server:

set option allow_read_client_file=on

Example: SYBASE_IQ_BUFFER_SIZE=500000 will set a buffer size of 500 kB.

Support Packages & Patches

Support Package Patches

Software Component Support Package Patch Level

This document is referenced by:

You might also like