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

Table 2-9 Information specified in the environment variables for a target Datareplicator

Environment variable	Description
PATH	Specify the name of the target Datareplicator's commands library.#1
LANG	Specify the character code set to be used in the target 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 import system definition.
TZ	Specify the time zone of the messages output from the target Datareplicator.
PDDIR#2	Specify the target HiRDB directory.
PDNAMEPORT#2	Specify the target HiRDB's port number.
PDHOST#2	Specify the target HiRDB's host name.
PDLANG#2	If the character code set used in the target HiRDB is UTF-8, specify UTF-8. If the character code set used in the target HiRDB is not UTF-8, there is no need to specify this environment variable.
SHLIB_PATH#2, #3	Specify $PDDIR/lib. If you use the Linux (IPF) or HP-UX (IPF) edition, specify $PDDIR/lib:$PDDIR/client/lib.
HDSPATH	Specify the target Datareplicator's operation directory. The target 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.
HDS_MST_STDCLOSE	Specify whether the standard input, standard output, and standard error output are to be closed by the target Datareplicator. When this environment variable is omitted or TRUE is specified: The standard input, standard output, and standard error output will be closed by the target Datareplicator. When FALSE is specified: The standard input, standard output, and standard error output will not be closed by the target Datareplicator. When you specify FALSE, an import information editing UOC routine can use the standard input, standard output, and standard error output. If an import information editing UOC routine uses the standard input, standard output, or standard error output when this environment variable is not specified, data might not be imported correctly. If you plan to have an import information editing UOC routine use the standard input, standard output, or standard error output, make sure that you specify FALSE in this environment variable.
HDS_RFI_ELANG#4	Specify the character encoding used in the source system. If this information has not been specified, the system automatically identifies the character encoding on the basis of the import status file. This automatic identification is not available when the definition information is displayed immediately after the target system has been initialized. If automatic identification is not available, ja_JP.SJIS is assumed.
HDS_RFI_PLANG#4	Specify the character encoding used in the target system. If this information has not been specified, ja_JP.SJIS is assumed.
HDSCLTWAITTIME	Specify whether the values of PDCWAITTIME (client's maximum wait time) and PDSWAITTIME (server's maximum wait time)#5 specified in the HiRDB client environment definition are to take effect on the target Datareplicator. This environment variable is optional; we recommend that you omit it if it is not needed. USER Uses the values specified in the HiRDB client environment definition. REPL Ignores the values specified in the HiRDB client environment definition and sets the following values: PDCWAITTIME Sets 0 (wait until there is a response). PDSWAITTIME Sets the commit_wait_time operand value in the import system definition#6 + 600 (seconds). If the import transaction synchronization facility is used, the syncwait_limit_tim operand value in the import system definition + 600 (seconds) is set. If the specified setting exceeds 65,535, 65535 is set. When this environment variable is omitted: If an import information editing UOC routine is used, USER is assumed. If the import SQL process is used, REPL is assumed. When USER is specified: Set in PDCWAITTIME and PDSWAITTIME in the client environment definition values that are greater than the following operand values: PDCWAITTIME pd_lck_wait_timeout operand in HiRDB PDSWAITTIME commit_wait_time and syncwait_limit_time operands in the import system definition If the values set in PDCWAITTIME and PDSWAITTIME are too small, HiRDB's monitoring interval might be reached. In such a case, the target Datareplicator's SQL process detects an SQL error, resulting in abnormal termination.
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 in 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 the memory required for program execution. The maximum 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 in 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 the 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 target HiRDB environment variable. For details about the HiRDB design, see the HiRDB Version 9 Installation and Design Guide.

#3

This environment variable for the Solaris and Linux Datareplicators is LD_LIBRARY_PATH. This environment variable for the AIX Datareplicator is LIBPATH.

#4

The following table shows the values of HDS_RFI_ELANG and HDS_RFI_PLANG:

Environment variable	Character encoding
	JIS8 Shift JIS	EUC	Unicode (UTF-8)	EBCDIC/KEIS EBCDIK/KEIS
HDS_RFI_ELANG	ja_JP.SJIS	ja_JP.UJIS	ja_JP.UTF8	EBCDIK
HDS_RFI_PLANG	ja_JP.SJIS	ja_JP.UJIS	ja_JP.UTF8	--

Legend:

--: Not applicable

#5

This does not apply to PDSWATCHTIME in the HiRDB client environment definition. The value specified in the HiRDB client environment definition always takes effect.

#6

If the commit_wait_time operand is specified in the import environment definition, the value specified in the import environment definition takes effect.

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

Bourne shell (sh)

$ PATH=$PATH:/opt/hirdbds/bin
$ LANG=ja_JP.SJIS#
$ HDSPATH=/opt/hirdbds/define
$ HDSCLTWAITTIME=USER
$ export PATH LANG HDSPATH HDSCLTWAITTIME

C shell (csh)

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

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

These examples assume that the target 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 target HiRDB's environment variables ($PDDIR, $PDCONFPATH, $PDNAMEPORT, $PDHOST, and $SHLIB_PATH), see the HiRDB Version 9 Installation and Design Guide.