HP 3000 Manuals HP 3000 Manuals
DEFINE Command
Before the forms file definitions can be loaded, the 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 ("") if a double quotation
mark is desired as 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 command prompt. 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 the version in the domain in which the
dictionary is to be opened. 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.
>