pdntenv (Set up HiRDB operating environment)

Specifies whether or not to use hardware compression during DAT access:

on: Use hardware compression.

off: Do not use hardware compression.

The information specified at the server machine connected to the DAT device takes effect.

This option is applicable only when the DAT drive supports hardware compression. For the same DAT, use the same setting for both write and read operations.

-pn service-port-name

Specifies the service port name for remote commands. Express the service port name by prefixing pdrshsrv to the identifier (1-4 single-byte alphanumeric characters without spaces).

Example: pdrshsrvUNT1

Specify the port number and the service port name specified in the %windir%\system32\drivers\etc\SERVICES file.

The specified value takes effect the next time the service starts.

-a

If multiple HiRDBs are installed (multi-HiRDB configuration), this option displays information about all such HiRDBs.

-sc {auto|manual}

When a HiRDB/Single Server is to be terminated by the pdstop command, specifies whether or not to also stop Windows services at the same time.

auto: Specifies that Windows services are to be stopped when HiRDB is terminated. In such a case, you must start Windows services before you start HiRDB the next time.

manual: Specifies that Windows services are not to be stopped when HiRDB is terminated. In such a case, there is no need to start Windows services the next time you start HiRDB. This option can reduce the time required for locking the Windows service control manager.

If this option is omitted, the system assumes auto if the HiRDB version is earlier than 06-00 and manual if it is 06-00 or later. If you have installed HiRDB over an existing HiRDB, this option value is inherited.

The specified value takes effect the next time the service starts. You cannot specify this option for a HiRDB/Single Server.

Whenever you use the pdchgconf or pdprgrenew command, manual must be specified. If the pdchgconf or pdprgrenew command is executed in an environment with auto specified, an error results and HiRDB may stop.

-c character-codes-type <<sjis>>

Specifies the type of character codes to be used for national character data in HiRDB.

sjis: Shift JIS Kanji codes

lang-c: Single-byte character codes

chinese: EUC Chinese Kanji codes

utf-8: Unicodes (UTF-8)^#

#: According to the ISO/IEC 10646 standard, a range of 1 to 4 bytes is assigned per character and bytes 5 and 6 are reserved for a future standard. Although HiRDB supports a range of 1 to 6 bytes per character, problems may be introduced in the future if you use the range of bytes 5 and 6 in which no characters have been assigned.

If the version of HiRDB Text Search Plug-in is 02-02 or earlier, utf-8 is not supported.

If you change the character codes type, you must re-initialize the database.

-ro {on|off}

Specifies whether or not remote commands are to be used. This option is applicable to a HiRDB/Single Server.

on:: Specifies that remote commands are to be used. Specify this option when you use the system switchover facility with the HiRDB/Single Server. If you specify on, also specify the -pn option.

off:: Specifies that remote commands are not to be used.

This option's settings take effect the next time the service starts. This option is disabled for a HiRDB/Parallel Server.

-shmfile {regular|page}

Specifies the allocation target for shared memory used in HiRDB. If this option is omitted, the previous allocation target is used.

regular:: Allocates shared memory to files under the HiRDB directory.

page:: Allocates shared memory to paging files (virtual memory).

The following describes how to change the shared memory allocation target.

How to change the allocation target

To change the shared memory allocation target:

Terminate HiRDB normally and then stop the HiRDB services.
Specify the shared memory allocation target in the -shmfile operand of the pdntenv command and then execute the command.
Extend the size of the paging file (virtual memory size) and restart Windows.^#
Restart HiRDB and the HiRDB services.

#: If the estimation of paging file size shows that there is sufficient capacity, there is no need to perform this procedure.

Rules

If you have specified regular, you must add the size of the shared memory that is used in HiRDB^# to the capacity of the drive that contains the HiRDB directory.
If you have specified page, you must add the size of the shared memory that is used in HiRDB^# to the maximum capacity of the paging file (virtual memory) that is used. In this case, note that the shared memory part of the paging file is fixed for use.

#: For details about the size of the shared memory that is used in HiRDB, see the formula for determining the required memory size in the manual HiRDB Version 8 Installation and Design Guide.

-k {none|force}

Specifies the HiRDB termination method when the OS shuts down.

none:: Does not terminate HiRDB when the OS shuts down.

force:: Terminates HiRDB explicitly and forcibly when the OS shuts down.

If OS shutdown occurs while HiRDB services are in the process of being stopped, HiRDB is terminated forcibly by the OS (unit down) even if force is specified.

For details about how to terminate HiRDB during an OS shutdown, see the manual HiRDB Version 8 System Operation Guide.

No option specified

The pdntenv command displays the current settings.

No option specified

***** HiRDB setup information *****
Program Name        = HiRDB/SingleServer
Version             = 07-03
Character Code      = sjis
Dat Hard Compress   = on
Setup ID            = ----
Rsh Port Name       = pdrshsrv
Path Name           = C:\win32app\hitachi\hirdb_s
Service Complete    = manual
Rsh Online          = on
ShmFile             = regular
Shutdown mode       = none

Explanation

Program Name: Name of HiRDB program

Version: HiRDB version

Character Code: HiRDB's character codes type; sjis: Shift JIS Kanji codes; lang-c: Single-byte character codes; chinese: EUC Chinese Kanji codes; utf-8: Unicodes (UTF-8)

Dat Hard Compress: Setting for hardware compression during DAT access; on: Compress; off: Do not compress

Setup ID: Setup identifier (if standard installation is used, ---- is displayed)

Rsh Port Name: Service port name for remote commands

Path Name: HiRDB installation directory

Service Complete: Time at which HiRDB services startup is completed; auto: HiRDB services startup is completed when the KFPS01001-I message is displayed.; manual: HiRDB services startup is completed when the system waits for execution of pdstart.; blank: Not applicable.

Rsh Online: Specification of remote commands: on: Uses remote commands.; off: Does not use remote commands.; blank: Not applicable.

Shmfile: Allocation target of the shared memory that is used in HiRDB: regular: Allocates to files under the HiRDB directory; page: Allocates to paging files; Blank: Not applicable

Shutdown mode: How to terminate HiRDB during OS shutdown: none: Does not terminate HiRDB when the OS shuts down.; force: Terminates HiRDB explicitly and forcibly when the OS shuts down.; Blank: Not applicable

-a option specified (applicable to multi-HiRDB)

***** HiRDB setup information *****
Program Name        = HiRDB/SingleServer
Version             = 06-02-/D
Character Code      = sjis
Dat Hard Compress   = on
Setup ID            = UNT1
Rsh Port Name       = pdrshsrvUNT1
Path Name           = C:\win32app\hitach\hirdb_sUNT1
Service Complete    = manual
Rsh Online          = on
ShmFile             = 
Shutdown mode       =
***** HiRDB setup information *****
Program Name        = HiRDB/ParallelServer
Version             = 07-03
Character Code      = sjis
Dat Hard Compress   = on
Setup ID            = UNT2
Rsh Port Name       = pdrshsrvUNT2
Path Name           = C:\win32app\hitach\hirdb_pUNT2
Service Complete    = manual
Rsh Online          = on
ShmFile             = regular
Shutdown mode       = none

Explanation

See the previous explanation for No option specified.