HP 3000 Manuals HP 3000 Manuals
DEFINE COMMAND
Before the schema and root file for an Image database can be created, the
dictionary must be opened. When opening the dictionary, the scope name
and scope password are required. Once the dictionary is opened, one can
redefine other options to change the environment while in a session.
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]
[;STATUS=version-status]
{.}
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 to retrieve definitions from.
This parameter is required when opening the
dictionary.
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.
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:
read-allow-read
read-only
shared-update
exclusive-update
Default is to open the dictionary in read-only
mode. After the dictionary is opened, this
parameter can be used to change the open mode.
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 to be used for
creating or retrieving definitions. If not
specified, the default is the common domain.
If you're in another domain and you want to get
back to the common domain, specify DOMAIN= with
no value.
version-name: Name of version to be used on creating or
retrieving definitions. If not specified, the
version status parameter is used to determine
the default version.
version-status: Used to default the version to the latest test,
production, or archival version of definitions.
The valid choices are:
Test
Production
Archival
Default is to the production version of
definitions.
Example: (Creating the initial environment)
> DEFINE DICTIONARY=sysdic;
>> SCOPE=manager;
>> PASSWORD=Mgr*;
>> OPEN-MODE=shared-update.
>