1.1 Overview
(1) Command input method
A HiRDB command is input at the command prompt.
Before you can execute commands, you must set as the current drive the drive where the HiRDB server is installed. For example, if you have installed the HiRDB server on drive D, set drive D as the current drive in the command prompt and then execute the command.
The command execution mode is shown in Figure 1-1 Command execution mode: HiRDB/Single Server (for a HiRDB/Single Server) and Figure 1-2 Command execution mode: HiRDB/Parallel Server (for a HiRDB/Parallel Server).
Figure 1-1 Command execution mode: HiRDB/Single Server
![[Figure]](figure/zw010010.gif)
- Explanation
Enter the command at the server machine where the single server is located.
Figure 1-2 Command execution mode: HiRDB/Parallel Server
![[Figure]](figure/zw010020.gif)
- Explanation
Enter the command at the server machine where the system manager is located.
Some commands are executed from a server machine other than the system manager. For details about the server machine used to execute each command, see Table 1-1: List of operation commands and Table 1-2: List of utilities, and the details about each command.
(2) Command descriptive format
The following shows the command descriptive format:
command-name options command-arguments |
(a) command-name
The command name is the file name of the command that is to be executed.
(b) options
An option either qualifies the command's operation or specifies the object of the operation.
In the following explanations, cmd indicates a command name.
- An option is a character string beginning with a minus sign (-) that may or may not be followed by one or more flag arguments.
The following shows the descriptive formats of options:
-option-flag or -option-flag flag-argument(s)
- option-flag
- One alphanumeric character (case sensitive).
- flag-argument
- Argument of the option flag (multiple flag arguments can be specified by separating them with a comma (,)).
- Multiple option flags without flag arguments can be specified consecutively, preceded by a single minus sign.
- Example
- The following two specifications are treated as being the same:
- cmd -a -b -c
- cmd -abc
- If an option requires a flag argument, the flag argument cannot be omitted.
- When an option flag argument contains a space, the entire flag argument must be enclosed in double quotation marks (").
- Example
- An option with argument "1 2" must be specified as follows:
- cmd -f "1 2"
Also, when you specify as a flag argument a path name that contains a space, you must enclose the entire flag argument in double quotation marks.
- If the same option flag is specified more than once, the last specification is effective.
- Example
- If the following is specified, -a 2 is effective:
- cmd -a 1 -a 2
- All options must be specified before any command arguments.
- Example
- If option flag a does not take a flag argument, file and -b in the following specification are assumed to be command arguments:
- cmd -a file -b
- Two consecutive minus signs (--) indicate the end of the options.
- Example
- In the following specification, -b is assumed to be a command argument:
- cmd -a -- -b
- An option consisting of a minus sign only cannot be entered.
- Example
- In the following specification, - is assumed to be a command argument:
- cmd -
(c) command-arguments
A command argument specifies the direct object of a command's operation. If the object is to be qualified, options are used to specify the object.
(d) Notes
If the control statement file contains a path name that contains a space, the entire path name must be enclosed in double quotation marks.
- Example: In the following specification, the source statement of pdload specifies a path name that contains a space:
- source host1:"c:\hirdb data\data1","c:\hirdb data\data2"
(3) Using a command by specifying an alias
If an operating system command or command in another program has the same name as a HiRDB command, the HiRDB command may fail to execute. If this happens, solve the problem as follows:
- In environmental variable settings, assign a higher priority to the HiRDB command.
- Execute the command by specifying its absolute path.
In situations when these two methods cannot be used, HiRDB commands can still be executed by assigning arbitrary names to them. For details about how to create a batch file for executing commands by using aliases, see the HiRDB Version 9 Installation and Design Guide.
(4) Notes about specifying options and control statements
- If you use lowercase letters to specify an authorization identifier or a password in a command option, enclose the authorization identifier or password between \"" and "\".
Example:
If pddbst -u \""hitachi"\" -p \""hitachi"\" is specified, HiRDB interprets it as pddbst -u "hitachi" -p "hitachi".
- If you are using a text editor such as Notepad to edit control statements, save the file as a text file using the Save As command. If you save it as any other file type, a control statement error may occur during utility execution because the character encoding system has been changed.
- When you are creating a control statement, be sure to enter a linefeed code at the end of the line. If the system detects EOF without a linefeed code at the end of the line, HiRDB cannot identify the control statement correctly.