(a) -d
Specifies that the HiRDB system under the HiRDB directory is to be deleted from the OS. When this option is omitted, the HiRDB system is registered into the OS.
If you specify the -d option, the following message is displayed, asking whether or not to delete the files required for HiRDB execution:
KFPS00036-Q Specify whether to delete files necessary for execution from specified HiRDB home directory?
[y: Yes, n: No]
If you enter y, the command deletes the files and directories required for HiRDB execution. In this case, the files required for HiRDB execution will be copied from the installation directory the next time the pdsetup command is executed.
If you enter n, the command does not delete the files or directories.
Enter y in the following cases:
- The current HiRDB is to be replaced with the installed HiRDB (to upgrade the HiRDB, you need to terminate the HiRDB normally with the pdstop command).
- The HiRDB administrator's ID is to be changed.
- The files in the HiRDB directory, the directory owner, or file mode was changed or deleted by mistake.
- Rules
- When the -d option is specified, deletion of the HiRDB directory from the OS may fail if that directory is in use. If this happens, use the rm command to delete the applicable files and directories from the OS.
- If you specify -d option and enter y as a response and if there are many HiRDB-created files in the HiRDB directory, command execution may take some time. In this case, use the rm OS command or the pdcspool -d 0 command to delete any unneeded files beforehand.
- If you are deleting the HiRDB directory, be sure to terminate any UAP that is using Java Virtual Machine (JVM). Otherwise, the HiRDB directory may not be deleted completely. In this case, use the rm OS command to delete the HiRDB directory.
- If you delete the HiRDB system from the OS, all shared memory used by the HiRDB system is released.
(b) -f
Specifies registration and deletion of HiRDB from the operating system. The -f option can be specified only in combination with the d option. Even when HiRDB is running or is being abnormally terminated, this option can force the registration and deletion of the HiRDB from the operating system. If this option is omitted, any HiRDB processing is immediately suspended. The load modules stored in the HiRDB directory are not deleted. This option should be specified only when the pdstop -f command cannot be accepted. Normally, the pdsetup -d command should be executed after stopping the HiRDB system using the pdstop command. If the -f option is specified, some of the HiRDB processes may remain unstopped. If this happens, use the ps command of the operating system to locate those processes and use the kill command to delete them. Without this action, the HiRDB system may fail to start when the pdsetup command is executed the next time.
(c) -c character-code-type
~<Other than Linux: sjis> or <Linux: ujis>
Specifies the type of character encoding used by the HiRDB system:
- sjis
- Shift JIS Kanji Code
- chinese
- EUC Chinese Kanji Code
- chinese-gb18030
- Chinese Kanji Code (GB18030)
- ujis
- EUC Japanese Kanji Code
- utf-8
- Unicode (UTF-8)
- According to the ISO/IEC 10646 standard, a range of from 1 to 4 bytes is assigned to each character, and bytes 5 and 6 are reserved for future standardization. Although HiRDB supports a range of from 1 to 6 bytes for each character, problems might arise in the future if you use bytes 5 to 6, to which no characters have been assigned.
- utf-8_ivs: Unicode (IVS-supported UTF-8)
- According to the ISO/IEC 10646 standard, characters are assigned using the byte range 1 to 4, and bytes 7 and 8. Bytes 5, 6, 9, and 10 are reserved for future use and no characters are assigned. Therefore, problems might arise in the future if you use bytes 5, 6, 9, or 10, to which no characters have been assigned.
- lang-c
- Single-byte character code
- Rules
- If this option is specified when the HiRDB directory and installation directory are different, and if the HiRDB directory already contains lib, the -c option is ignored and the previous character code setting is inherited.
- To change the character code setting, execute pdsetup -d to delete the HiRDB directory once from the OS, and then re-execute pdsetup -c. Note that the -c and -d options are mutually exclusive. If both of them are specified, the -c option is ignored.
- In a HiRDB parallel server configuration, specify the same character encoding for all servers.
(d) -v {recom|v0904}
In HiRDB, the default values for system definition operands might change from one version to the next. This option specifies the default operation when operands are omitted:
- recom: Recommended mode
- v0904: 0904 compatibility mode
- Rules
- If this option is omitted, the KFPS00073-Q message is displayed. Use the displayed message to select a default operation for when operands are omitted.
- If the following conditions are all satisfied, the previous default operation is inherited, in which case the KFPS00073-Q message is not displayed:
- This option is omitted.
- The HiRDB directory differs from the installation directory.
- The last time the pdsetup -d command was executed, n was entered as the response to the KFPS00036-Q message.
- For the selected operation to be applied when operands are omitted, the same value must be specified in all units in the HiRDB system.
- HiRDB-directory ~<path name>
Specifies the HiRDB directory used to install the HiRDB system. In the case of a multi-HiRDB system, this command must be executed for each HiRDB system with the appropriate HiRDB directory specified.
Do not specify a symbolically linked HiRDB directory.