Command input format
The input format of the commands is as follows:
Command-name [option ...]
The following is a description of each of these items. Note that $ indicates a command prompt and cmd indicates a command name.
Command-name
Specifies the file name of the command to be executed.
To execute a command by specifying a path containing spaces, the entire path must be enclosed within double quotation marks (" ").
- Example of incorrect specification: $ C:\Program Files\Hitachi\Cosminexus\CC\server\bin\cmd
- Example of correct specification: $ "C:\Program Files\Hitachi\Cosminexus\CC\server\bin\cmd"
Arguments
An argument also includes options. The input format and the rules for specifying the options are as follows:
Input format for options
An option is a string beginning with a hyphen (-). The option input formats include a format where no option argument is specified and a format where one option argument is specified.
- Format without an option argument
- $ cmd - option-flag
- Format with one option argument
- $ cmd - option-flag option-argument
- Legend:
- option-flag
This represents a case-sensitive, single-byte alphanumeric character.
- option-argument
This represents an argument corresponding to the option flag.
Rules for specifying options
- Multiple option flags cannot be combined with a single hyphen (-).
Example of incorrect specification: $ cmd -abc
Example of correct specification: $ cmd -a -b -c
- The option argument of an option flag that requires an option argument cannot be omitted.
- A space or a tab must be specified between an option flag and an option argument.
Example of incorrect specification: $ cmd -afile
Example of correct specification: $ cmd -a file
- The same option flag cannot be specified more than once.
Example of incorrect specification: $ cmd -a 1 -a 2
- To include spaces in an option argument, the entire option argument must be enclosed within double quotation marks (" ").
Example of incorrect specification: $ cmd -a file 1
Example of correct specification: $ cmd -a "file 1"
- To include a special character (escape character) in an option argument, the special character must be enclosed within double quotation marks (" ").
Example of incorrect specification: $ cmd -a xyz;12
Example of correct specification: $ cmd -a "xyz;12"
Priority of options
- A few options of each command can be omitted if they are coded in the HCSC-Manager command definition file. The following priority applies to the HCSC-Manager command definition file and to the command arguments:
- When an option is specified in both the HCSC-Manager command definition file and the command argument:
The option specified in the command argument is valid.
- When an option is not specified in both the HCSC-Manager command definition file and the command argument:
The command terminates abnormally.
For details on the HCSC-Manager command definition file, see HCSC-Manager command definition file in 6.5 Files used for HCSC server operations.
- There are no rules for the order of the options. The following examples 1 and 2 are treated as the same command:
Example 1: $ cmd -a file -b option
Example 2: $ cmd -b option -a file