You specify the environment variables for a source Datareplicator in the user environment where the source Datareplicator's commands are executed. The following table shows the information that is specified in the environment variables for a source Datareplicator.

Table 2-8 Information specified in the environment variables for a source Datareplicator

Environment variable	Description
PATH	Specify the name of the source Datareplicator's commands library.#1
LANG	Specify the character code set to be used in the source Datareplicator's messages and definitions. Be sure to specify the correct character code set based on the information specified in the dblocale and msglocale operands in the extraction system definition.
TZ	Specify the time zone of the messages output from the source Datareplicator.
PDDIR#2, #3	Specify the source HiRDB directory.
PDCONFPATH#2, #3	Specify the directory for storing the source HiRDB's system definition files.
PDNAMEPORT#2	Specify the source HiRDB's port number.
PDHOST#2	Specify the source HiRDB's host name.
PDUSER#2	Specify the user connected to the source HiRDB.
PDLANG#2	If the character code set used in the source HiRDB is UTF-8, specify UTF-8. If the character code set used in the source HiRDB is not UTF-8, there is no need to specify this environment variable.
SHLIB_PATH#2, #3, #4, #5	Specify $PDDIR/lib. If you use the Linux (IPF) or HP-UX (IPF) edition, specify $PDDIR/lib:$PDDIR/client/lib.
HDEPATH	Specify the source Datareplicator's operation directory. The source Datareplicator's definition files, status files, error information files, and activity trace files are created in this directory. Notes: Make sure that the specified directory path name is 64 bytes or less. If the source and target Datareplicators are located on the same machine, do not specify the same directory in the HDEPATH and HDSPATH environment variables. If the source HiRDB is a parallel server consisting of multiple server machines, specify the same operation directory for the source Datareplicator at each server machine.
HDE_BIN_COL_MAXLEN	Specify a value (kilobytes) that is smaller than the actual definition length of any BLOB-type column that is handled internally in Datareplicator. If a BLOB-type column has a definition length of 2 GB or greater but its actual data is small, this environment variable enables the column data to be linked without having to redefine the table. Notes: The definition length of each BLOB-type column must be 262,143 KB or less. The value specified in this environment variable apples to all BLOB-type columns that are subject to extraction. For details about the handling of BLOB-type columns whose definition length exceeds the value specified in this environment variable, see 6.4.3(4) Notes about the HDE_BIN_COL_MAXLEN environment variable.
EXTSHM (AIX only)	Specify ON, which indicates that there is no limit to the number of shared memory spaces in the process space. Specify it if a shortage occurs on the shared memory. If there is no shortage, specification of this environment variable is optional.
PSALLOC (AIX only)	Specify early, which indicates that a required paging space is to be allocated immediately during memory allocation. With AIX, paging space is not normally allocated during memory allocation. Make sure that this variable is set.
LDR_CNTRL (AIX only)	MAXDATA=memory-size Specify the size of memory required for program execution. Available memory size is 2 gigabytes in the range from 0x20000000 to 0x80000000. Set the memory in units of 256 megabytes. The memory must be allocated in good balance because the memory size is common to both shared memory and mmap memory. Specify it if a shortage occurs on the shared memory. If there is no shortage, specification of this environment variable is optional. If a memory shortage occurs, set 0x20000000 and then start. If a memory shortage recurs, increase the memory in increments of 0x10000000 and then restart.
NODISCLAIM (AIX only)	For free(), set True as the call processing method, indicating that issuance of nodisclaim() is to be suppressed. Make sure that this variable is set.

#1: The name of the commands library is opt/hirdbds/bin/.

#2: This is a source HiRDB environment variable. For details about the HiRDB design, see the HiRDB Version 9 Installation and Design Guide.

#3: If the source HiRDB is a parallel server and this setting varies from one server to another, extraction system definitions can be used to define this information for each server machine. If definitions for a specific server are omitted from the extraction system definitions, the corresponding server uses the values of the environment variables that were specified for the user environment where the source Datareplicator's commands are executed.

#4: This environment variable for the Solaris and Linux Datareplicators is LD_LIBRARY_PATH. The environment variable for the AIX Datareplicator is LIBPATH.

#5: If the value specified in this environment variable exceeds 255 bytes in length, an invalid value error results at the source Datareplicator. If it is necessary to specify a value greater than 255 bytes in length, specify in the node_shlibpath operand of the extraction system definition only as much of the library path required for the source Datareplicator as can be specified in no more than 255 bytes. By specifying the node_shlibpath operand, you can avoid having an invalid value error for the environment variable.

To apply the node_shlibpath operand value, you must initialize the source Datareplicator. If you expect the length of the environment variable value might exceed 255 bytes in the future, we recommend that you specify the node_shlibpath operand during initial configuration.

The following are examples of environment variables for a source Datareplicator. These examples are for the HP-UX Datareplicator.

Bourne shell (sh)

$ PATH=$PATH:/opt/hirdbds/bin
$ LANG=ja_JP.SJIS#
$ HDEPATH=/opt/hirdbds/define
$ export PATH LANG HDEPATH

C shell (csh)

% set path=($path /opt/hirdbds/bin)
% setenv LANG ja_JP.SJIS#
% setenv HDEPATH /opt/hirdbds/define

#: For details about how to specify the LANG environment variable, see the applicable manual.

These examples assume that the source Datareplicator definitions are stored in the /opt/hirdb/define/ directory. These examples omit the TZ environment variable as well as the HiRDB environment variables.

For details about how to specify the TZ environment variable, see the applicable manual.

For an example of specifying a source HiRDB's environment variables ($PDDIR, $PDCONFPATH, $PDNAMEPORT, $PDHOST, $PDUSER, and $SHLIB_PATH), see the HiRDB Version 9 Installation and Design Guide.