HP 3000 Manuals HP 3000 Manuals
DEFINE Command
Before the database definition can be loaded, dictionary must be opened.
When opening the dictionary for the first time, the scope name and scope
password are required.
Syntax
DEFINE [;DICTIONARY=dictionary-filename]
[;SCOPE=scope-name]
[;PASSWORD=[scope-password]]
[;OPEN-MODE=open-mode]
[;NAME-MODE=name-mode]
[;DOMAIN=[domain-name]]
[;VERSION=[version-name]]
{.}
Parameters
dictionary-filename: Filename of the dictionary to be opened. The
default for this parameter is SYSDIC if not
specified when opening the dictionary.
scope-name: Name of the scope by which the definitions are
to be loaded. This parameter is required when
opening the dictionary for the first time.
scope-password: Gives access to the scope. Any characters are
allowed in a password. If a character in the
password is NOT valid in other System
Dictionary names (i. e., is on the restricted
list), the password must be entered inside a
pair of quotes to allow recognition of the
`restricted' characters. Specify two
consecutive quotes ("") to include a quote as a
part of the password.
If the SCOPE parameter is specified and the
PASSWORD parameter is not, you will be prompted
for the password. For security reasons, the
echo is turned off and you are given three
chances to enter the correct password. If you
are running the program interactively and the
correct password is not entered after three
tries, the DEFINE command will terminate and
you will be returned to the highest prompt
level. If you are running the program in batch
mode and the correct password is not entered
after three tries, the program will terminate.
The password is always read from $STDIN.
open-mode: Specifies which mode to open the dictionary
with. The valid choices are:
shared-update
exclusive-update
Default is to open the dictionary in
shared-update mode. If the dictionary is
opened in exclusive-update mode, you will have
exclusive access to the dictionary and others
will be denied access.
name-mode: Specifies which group of names (internal or
external) the user wishes to use. The valid
choices are:
internal
external
Default is to use the external name mode.
domain-name: Name of the dictionary domain in which the
dictionary is to be opened. If not specified,
the default is the common domain. Use the SHOW
command to initially examine the default value
of the DEFINE and IMAGE parameters. A blank
entry for this parameter represents the common
domain. If you are in another domain and you
want to get back to the common domain, specify
"DOMAIN=;" with no value.
version-name: Name of version within the dictionary domain.
Use the SHOW command to initially examine the
value of this parameter. A blank entry
represents the latest test version. The latest
test version can be specified by entering
"VERSION=;".
Example: (Creating the initial environment)
> DEFINE DICTIONARY=sysdic;
>> SCOPE=manager;
>> PASSWORD=Mgr*;
>> OPEN-MODE=shared-update.
>