HP 3000 Manuals HP 3000 Manuals
DEFINE
Opens the dictionary and defines the dictionary environment.
Syntax
DEF[INE] [;DICT[IONARY] = dictionary-filename]
[;S[COPE] = scope-name]
[;P[ASSWORD] = [scope-password]]
[;O[PEN-]M[ODE] = open-mode]
[;N[AME-]M[ODE] = name-mode]
[;D[OMAIN] = [domain-name]]
[;V[ERSION] = version-name ]
[;STAT[US] = version-status]
.
Parameters
dictionary-filename File name of the dictionary to open. If you do not
specify a value when opening the dictionary, the
default for this parameter is SYSDIC. You can
access a remote dictionary using the DEFINE command
and the DICTIONARY parameter. This method is
described in the discussion part of this command.
scope-name Name of the scope that definitions are assigned to.
Required for the initial opening of the dictionary.
scope-password Gives access to the scope. Any characters are
allowed in a password. If a character is desired
in the password that is not valid in other System
Dictionary names, you must enter the password
inside a pair of quotes to allow recognition of the
restricted characters. (See "Scope Password" in
Chapter 3.) If you specify the keyword with no
value, a blank password is used.
Remember that the case of the password you enter
also counts when the password is checked.
If you specify the SCOPE parameter and not the
PASSWORD parameter, you are 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 in session mode and
you do not enter the correct password after three
tries, the DEFINE command terminates with no change
to the dictionary environment. If you are in batch
mode and you do not enter the correct password
after three tries, the program terminates. The
password is always read from $STDINX.
open-mode Specifies the mode with which to open the
dictionary. Valid choices are:
read-allow- Allows you to read System Dictionary
read data definitions, but does not allow
the creation, deletion, or
modification of these data
definitions. Others can access the
dictionary only for reading.
read-only Allows you to read System Dictionary
data definitions, but does not allow
the creation, deletion, or
modification of these data
definitions. Others can also access
the dictionary.
shared- Allows you to read, create, modify,
update or delete System Dictionary data
definitions. Others can also access
the dictionary.
exclusive- Allows you to read, create, modify,
update or delete System Dictionary data
definitions. No one else can access
the dictionary.
customiza- Allows you to interact with the
tion dictionary structure by using
structure commands. No one else can
access the dictionary.
The default open mode for a dictionary that is not
open is read-only.
name-mode Specifies which group of names you wish to use.
Valid choices are:
internal
external
The default for the first open is external.
domain-name Name of the domain used for creating or retrieving
definitions. If you do not specify the keyword,
the default is the common domain. To return to the
common domain from another domain, specify the
keyword with no value. This parameter is
applicable only if the dictionary is open in
read-allow-read, read-only, shared-update, or
exclusive-update mode.
version-name Name of the version used for creating or retrieving
definitions. If you do not specify this parameter,
the version status parameter is used to determine
the default version. This parameter is
applicable only if the dictionary is opened in
read-allow-read, read-only, shared-update, or
exclusive-update mode.
The default version for the first open is
determined by the setting of the version-status
parameter.
version-status Version status indicating to choose the latest
version of the status as the version to be used for
creating or retrieving definitions. Valid choices
are:
test
production
archival
The default status for the first open is
production.
The version-status parameter is used only if you do
not specify version-name.
Description
Once the dictionary is open you may redefine the environment while in a
session. For example, you may open a new dictionary, or the same
dictionary with a different scope or open mode. It is not necessary to
respecify any parameters that remain the same after redefining the
environment. For example, if you open a new dictionary, but the scope,
open mode, etc., are to be the same as in the previous DEFINE command,
the previous values carry over from the first DEFINE command.
If the dictionary was initially opened in customization mode and the new
DEFINE calls for a change of the dictionary or open mode, a RESTRUCTURE
of the dictionary is automatically done. The restructure operation may
take some time if many dictionary occurrences are affected by the
structure changes.
Open Mode: Any
Scope: Any
Remote Dictionary Access
System Dictionary includes a feature that allows you to access
dictionaries on remote systems, a remote system being any other system
than the one to which you are currently logged on. The uses for this
feature are explained in the HP System Dictionary/XL General Reference
Manual, Volume 1 (32256-90004). The following information explains how
to use this feature using the DEFINE command.
A remote dictionary is accessed by first establishing a session on a
remote system, as shown in the example below. The following names are
used in the example:
Name Represents
REMOTESYS The name of the remote system
CORPINFO The account on the remote system
that contains the specified
dictionary
MGR The user in account CORPINFO
COM.MFGCO The communications system being
used
:DSLINE REMOTESYS Establishes communications to the
ENVIRONMENT 1: REMOTESYS.COM.MFGCO (Returned) name of the established
line
:REMOTE HELLO MGR.CORPINFO Remote logon
ENTER ACCOUNT PASSWORD: Password is "blind" for security
reasons
:
For more information on system to system communications, refer to the
NS3000/XL User/Programmer Reference Manual (36920-90001) or the NS3000/XL
Network Manager Reference manual (36920-90002).
RUNNING WITH NS3000
After the remote session has been established, the remote dictionary can
be accessed by including the remote system name in the dictionary name.
For example, the DEFINE command could be specified in the following form:
DEFINE DICTIONARY=SYSDIC.PUB.SYS:NODEB;
It is also possible to use a file equation to completely identify the
remote dictionary, as shown in the following example.
FILE RDICT1=SYSDIC.PUB.CORPINFO:REMOTESYS
where RDICT1 would be passed to the DICTIONARY parameter when using the
DEFINE command, as shown in the following example.
DEFINE DICTIONARY=RDICT1
RUNNING WITH DS3000
When either the local or remote system (or both) is a DS3000 node the
above methods of addressing the remote dictionary do not work. Instead,
the device number of the remote node must be used, as shown in the
following example.
FILE RDICT1=SYSDIC.PUB.CORPINFO;DEV=17#
where 17 is the device number of the remote system, and must be known to
the user. The DEFINE command can then be used as follows:
DEFINE DICTIONARY=RDICT1
NOTE The dictionary on the remote system must be compatible with the
System Dictionary software on the local system, that is, it must be
the same version. If it is not, the DEFINE command will fail.
Note also, that as with any subsystem or program being accessed on a
remote system, the performance of System Dictionary is likely to be
slower than when run on a local system.
Example
The first of the following examples opens the dictionary sysdic for the
scope manager in customization open mode. The password Mgr* allows
access to the scope.
The second of the following examples changes the current scope leaving
the dictionary open in the same state otherwise. Note that the password
was prompted for (with echo off) since the SCOPE keyword clause is
specified without a PASSWORD clause.
>DEFINE DICTIONARY = sysdic;
>>SCOPE = manager;
>>PASSWORD = Mgr*;
>>OPEN-MODE = customization.
>
>DEFINE SCOPE = da.
Scope Password>>
>