HP System Dictionary/XL COBOL Definition Extractor (32257-90001)

2- 18
{.}
Parameters
dictionary-filename Specifies the name of the dictionary to be opened. The initial default for the DICTIO-
NARY parameter is SYSDIC. After the dictionary is opened, the default is the currently
opened dictionary.
scope-name Specifies the name of the scope from which to retrieve definitions. The SCOPE 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 (that is, on the restricted list),
you must enter the password within quotes to allow recognition of the "restricted" charac-
ters.
If you specify the SCOPE parameter and not the PASSWORD parameter, you will be prompt-
ed 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 the correct password
is not entered after three tries, the DEFINE command terminates and the command prompt
(>) is displayed. If you are in batch mode and the correct password is not entered after three
tries, the program terminates. The password is always read from $STDINX.
domain-name Specifies the name of the dictionary domain in which the dictionary is to be opened. The
initial default for the DOMAIN parameter is the common domain. After the dictionary is
opened, the default is the current domain. If you are in another domain and you want to
get back to the common domain, specify "DOMAIN=;" with no value.
version-name Specifies the name of the version under which the dictionary is opened. When the VER-
SION parameter is blank, the value of the STATUS parameter opens the latest version of
the current status. The default version is blank.
version-status The value of the STATUS parameter opens the latest version of this status. Options are:
TEST Uses the version status TEST. Dictionary definitions in a version of
TEST status can be modified.
PRODUCTION Uses the version status PRODUCTION. Dictionary definitions in a
version of PRODUCTION status can only be read.
ARCHIVAL Uses the version status ARCHIVAL. Dictionary definitions in a ver-
sion of ARCHIVAL status can only be read.
TheSTATUSparameteriseffective only when thevalueoftheVERSIONparameter is blank.
If you specify both the VERSION parameter and the STATUS parameter with the DEFINE
command, only the VERSION parameter is used. SDCDE issues a warning message indicat-
ing that the STATUS parameter was ignored. The initial default for the STATUS parameter
is PRODUCTION. After the dictionary is open, the default is the current status value.
open-mode Specifies the mode in which to open the dictionary. Options are:
READ-ALLOW-READ AllowsyoutoreadSystemDictionarydatadefinitions,butdoesnot
allow definitions to be created when the UPDATE-DICT option of the
COPYLIB command is ON. Others can access the dictionary only for
reading.