MACHINE SPECIFIC NOTES
FOR
HCL OneDB Client SDK 1.0.1.1 PRODUCT RELEASE
HCL oneDB ESQL/C Version 1.0.1.1
On AIX 7.2 64bit
DATE: 30 Dec 2021
=================================
OS Information : Built on AIX 7.2 Technology.
Machine Specific Notes
======================
1. This product was built on AIX 7.2 Technology using the
following compilers:
IBM XL C/C++ for AIX, V11.1 (5724-X13)
XL C/C++ Runtime 13.1.3
2. AIX patch requirement:
3. ESQL/C support for static libraries
ESQL/C product libraries are supported as both static and shared
libraries. By default the script uses shared libraries.
To use static libraries, the 'esql' script must be invoked with the
-static option:
esql -static
To use ESQL/C shared libraries, the environment variable LIBPATH
must include $INFORMIXDIR/lib and $INFORMIXDIR/lib/esql. During
runtime of the executable, the dynamic loader will look in this
path for HCL OneDB ESQL/C shared libraries.
(for Bourne or Korn Shell)
LIBPATH=$INFORMIXDIR/lib:$INFORMIXDIR/lib/esql:$LIBPATH
export LIBPATH
(for C Shell)
setenv LIBPATH $INFORMIXDIR/lib:$INFORMIXDIR/lib/esql:$LIBPATH
4. ESQL/C support for thread safe libraries
The thread safe ESQL/C libraries are supported on this platform using
POSIX threads. The THREADLIB environment variable must be to POSIX:
(for Bourne or Korn Shell)
THREADLIB=POSIX
export THREADLIB
(for C Shell)
setenv THREADLIB POSIX
To build thread safe ESQL/C programs, use the following command:
esql -thread prog.ec -o prog
Applications that have not been compiled with the -thread option cannot be
linked with applications that have been compiled with the -thread option.
To do so, compile all applications with the -thread option.
5. IPv6 Support
The product supports Internet Protocol Version 6 (128 Bit Internet Addresses)
as well as IPv4 (32 Bit Addresses).
In order for the machine name specified in the SQLHOSTS file to resolve
to the correct IP address, the name services files on the Operating System
should be correctly configured. If the machine has IPv6 address configured
and the listener thread is bound to an IPv6 address, then the name
resolution files /etc/netsvc.conf should be configured to fetch IPv6
address. Also use the appropriate /etc/hosts setting if local machine
settings are used.
For compatibility with older HCL oneDB client and server products,
assign the same hostname with both an IPv4 address and an IPv6 address.
If the listener needs to be bound to an IPv4 address and the name services
resolve the name in the order of the IPv6 address followed by IPv4 address,
then an explicit IPv4 address needs to be put in nodename field of SQLHOSTS
file. Client applications should also use the same setting.
6. Pluggable Authentication Module (PAM)
PAM functionality is supported on AIX 7.2 operating systems. The PAM is
dependent on the libpam.a library supplied by the Operating System vendor.
Use of PAM can be enabled or disabled by the system administrator. By
default, HCL OneDB will use the traditional authentication mechanism in
order to avoid widespread changes required by the users.
The PAM service identifies the PAM module. This PAM module typically
resides in /usr/lib/security and its parameters are listed in
/etc/pam.conf.