(a) -hc {on|off}
Specifies whether or not to use hardware compression during DAT access:
- on (initial value): 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.
(b) -pn service-port-name
Specifies the service port name for remote commands. Express the service port name by prefixing pdrshsrv to the identifier (1 to 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.
The initial value is pdrshsrvidentifier.
(c) -a
If multiple HiRDBs are installed (multi-HiRDB configuration), this option displays information about all such HiRDBs.
(d) -os
Displays whether the OS supports shared memory page fixing. In Windows systems that support page fixing, the page size in Windows large pages is also displayed.
(e) -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 (initial value)
- 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.
- Rules
- 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.
(f) -c character-codes-type
Specifies the type of character codes to be used for national character data in HiRDB.
- sjis (initial value): Shift JIS Kanji codes
- lang-c: Single-byte character codes
- chinese: EUC Chinese Kanji codes
- chinese-gb18030: Chinese Kanji codes (GB18030)
- 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 you change the character codes type, you must re-initialize the database.
(g) -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. Remote commands are used in the following cases:
- A system switchover facility that does not inherit IP addresses is used on the HiRDB/Single Server.
- The simple setup tool is used to configure an environment for the HiRDB/Single Server on a separate machine.
- When you specify on, you must also specify the -pn option.
- off (initial value):
- 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.
(h) -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 (initial value):
- 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 9 Installation and Design Guide.
(i) -k {none|force}
Specifies the HiRDB termination method when the OS shuts down.
- none (initial value):
- 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.
If you are running HiRDB version 09-04 or later, force is set. If you want to change it to none, execute the pdntenv command with -k none specified.
For details about how to terminate HiRDB during an OS shutdown, see the HiRDB Version 9 System Operation Guide.
(j) -sr resource-name value [resource-name value]...
Specifies the numbers and capacities of resources for each unit.
- resource-name:
- Specifies the name of a resource to be applied. You can specify the following values as resource names:
- msgmni (number of message queue identifiers)
- msgtql (number of message queue tables)
- semmax (number of semaphore identifiers)
- shmmax (number of shared memory segments)
- If the same resource name is specified more than once or a resource name other than those listed above is specified, an error results.
- value:
- For each resource, value specifies the number of resources or the capacity of the resource. For details about how to determine the values to be specified, see Determining Environment Variables Related to the Number of Resources in the HiRDB Version 9 Installation and Design Guide.
(k) -wd [process-name]
Displays information about Windows dump output.
- process-name:
- Specifies the name (including the extension) of a HiRDB process for which dump information is to be displayed. HiRDB displays a header for the dump information and then displays information about the target HiRDB process. The following table describes the information that is displayed by this option:
No. | Header | Information that is displayed | Maximum length |
---|
1 | Process#1 | Name of the HiRDB process subject to dump output | 20 bytes#2 |
2 | Folder | Dump output destination folder | 259 bytes |
- #1
- If LocalDumps is displayed as the process name, a dump for the specified process is output to the dump output destination folder that is displayed on that line.
- #2
- If the length of a process name exceeds 20 bytes, only the first 20 bytes of the process name are displayed.
- Rules
- If the process name is omitted, dump output information for the executable file (.exe) registered as the dump output target is displayed. HiRDB displays information about all processes registered as dump output targets in the Windows Error Report function. If LocalDumps is displayed as the process name, a dump for the corresponding process is output to the dump output destination folder that is displayed on that line.
- If the specified process name is not registered as a dump output target, the KFPC00105-I message is issued. This message is also issued if process names are omitted or if no process has been registered as the dump output target.
- If the registry has been updated by the time this command is executed, incomplete values might be displayed because the registry is engaged in update processing.
- Note
- For details about dump output, see Windows dump output in the HiRDB Version 9 Installation and Design Guide.
(l) No option specified
The pdntenv command displays the current settings.