HP 3000 Manuals HP 3000 Manuals
FROM
Specifies the source dictionary.
Syntax
FROM [;DICTIONARY=dictionary-filename]
[;SCOPE=scope-name]
[;PASSWORD=[scope-password]]
[;NAME-MODE=name-mode]
[;OPEN-MODE=open-mode]
[;DOMAIN=[domain-name]]
[;VERSION=version-name ]
[;STATUS=version-status]
{.}
Parameters
dictionary- Filename of the source dictionary to be opened. The
filename dictionary can be either a master or a compiled
dictionary and 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 (ie. is in 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're running the program interactively and the correct
password is not entered after three tries, the FROM
command will terminate and you will be returned to the
highest prompt level. If you're 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 $STDINX.
name-mode Specifies which name mode to open the dictionary with.
The valid choices are:
Internal
External
The default is to use the external name mode. See
Chapter 2 for more details regarding name modes.
open-mode Specifies which mode to open the dictionary with. The
valid choices are:
Read-Allow-Read
Read-Only
Shared-Update
Exclusive-Update
Customization
The 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. See Chapter 2 for more
details regarding open modes.
domain-name Name of the dictionary domain to merge or compile
definitions from. If not specified the default is 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 to be used when merging or compiling
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
The default is to the production version of definitions.
Discussion
The environment from which the definitions or structure are to be merged
or compiled must be defined before the merge or compile process can
begin. The source dictionary can be either a master or a compiled
dictionary. Once a parameter in the FROM command is specified, its value
will be retained, until a new value is specified.
Example
>FROM DICTIONARY=sysdic.pub;
>>SCOPE=manager;
>>PASSWORD=mgr*;
>>VERSION=version-1;
>>OPEN-MODE=exclusive-update.
>