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
REMOTESYS
CORPINFO
MGR
COM.MFGCO
:DSLINE REMOTESYS
ENVIRONMENT 1:
Represents
The name of the remote system
The account on the remote system that contains the specified that contains the specified dictionary
The user in account CORPINFO
The communications system being used
Establishes communications to the 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 or the NS3000/XL Network Manager Reference manual.
RUNNING WITH NS3000
After the remote session has been established, the remote dictionary can be accessed by including the
4-68
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 DE-
FINE 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>>
>
4- 69
