Optim™ provides a
Command Line Interface that allows you to perform certain configuration
tasks, without using the graphical user interface for Optim. You can run the Command Line Interface
from the command line, in a batch file, or from another program.
Command Line Tasks
You
can use the Command Line Interface to:
- Create one or more DB Aliases.
- Update (refreshing the DB signature) one or more
DB Aliases.
- Apply maintenance to one or more DB Aliases.
- Delete objects in one or more Optim Directories.
- Apply maintenance to one or more Optim Directories.
The following sections explain and describe
how to perform each of these tasks.
Guidelines
The
typical command consists of PR0CNFG or PR0CMND followed by keywords
and associated arguments. The following guidelines apply:
- All keywords must be prefixed by a forward slash
(/) or a dash (‑) and separated from one another by one or more spaces.
Do not use commas.
- Keywords must be separated from arguments by an
equal sign (=) or a colon (:).
- Using a keyword that is inappropriate for the type
of processing may cause a fatal conflicting-parameter error.
- The DBMS type keyword must precede the DBMS version
keyword. All other keywords can be specified in any order.
- If you use a keyword more than once for a task,
the last instance applies.
- You can include all keywords and arguments for one
or more tasks in a text file, and reference this parameter file on
the command line.
- In a parameter file, keywords and arguments for
a task may be on more than one line. Note that lines after the line
containing the TASK keyword are processed in the next task, if any.
- If a keyword required for a task is omitted, values
specified for the previous task, or values specified the last time
the Configuration program was run, are used by default.
Note: This feature may be advantageous for a series of tasks
that share the same setting for one or more parameters.
- An argument that includes spaces must be enclosed
in single or double quotes.
- To clear a parameter, specify the value as an empty
string, i.e., “ ” .
Syntax Conventions
The
syntax conventions used to describe these statements are
- KEYWORD
- Keywords are shown in upper case for emphasis, but
can be specified in lower or mixed case.
- text
- Variable text is shown in lower-case italics.
- ( )
- Statement delimiter to group a series of qualifiers
for a parameter.
- [ ]
- An optional keyword or argument is shown in square
brackets.
- { }
- A choice of settings from which only one must be
selected is shown in curved brackets.
- < >
- A choice of settings from which none or any may
be selected is shown in angle brackets.
- |
- Separates options.