HiRDB Datareplicator Version 8 Description, User's Guide and Operator's Guide

[Contents][Glossary][Index][Back][Next]

2.8.2 Environment variables for a target Datareplicator

The following table lists and describes the environment variable settings for a target Datareplicator.

Table 2-18 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
TZ Specify the time zone of the messages output from the target Datareplicator. This value must match the comparable value specified in the HiRDB system definition.
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.
HDSPATH Specify the target Datareplicator's operation directory. The target Datareplicator's definition files, status files, and error information files are created in this directory. The target Datareplicator's core file (complete processing dump file) is also output to this directory.
In Windows, you can use parentheses in the operation directory name.

Note:
  • 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, or 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#3 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#3 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)#4 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#5 + 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 65535, 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.

#1
The name of the commands library is specified during installation; for details, see 2.6.4 Information registered during installation.

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

#3
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

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

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