Dictionary/3000 Reference Manual (32244-90001)

234 Chapter7
The Dictionary DICTCDE Utility
The DICTCDE Main Prompt
IMAGE Database Files. If the specified file is an IMAGE database, DICTCDE will issue
the following message and prompts:
File filename is an IMAGE database
Define all data sets in one module (N/Y)>
Enter Y if the generated source code for all the data sets is to be written to one copylib
module. This module will also contain the source code for the IMAGE special parameters.
These are the IMAGE special name-constant parameters that identify the database and
password for use by the IMAGE intrinsics. To generate the IMAGE standard parameters,
see the discussion for the P (Parameters) response to the main prompt. (The IMAGE
standard parameters include the DB-STATUS array definition, the eight MODES as
constants, and the various LIST parameters.)
When all data sets are to be defined in one module, DICTCDE will prompt for the copylib
module for the database definition:
Copylib module for database name >
Enter the name of the copylib module (8 characters maximum). DICTCDE then begins the
generation process. The generated source code is echoed to the terminal as it is written to
the copylib module. If [[RETURN]] is pressed in response to this prompt, DICTCDE will
reissue the main prompt and no source code would be generated for the database.
If the source code generated for the data sets is to be written to different copylib modules,
enter N or press [[RETURN]] in response to Define all data sets in one module (N/Y)>.
DICTCDE will then prompt for the copylib module for each of the data sets in turn and for
the IMAGE special parameters as shown:
Copylib module for database name special parameters>
Enter the copylib module to which you will direct the source code for the IMAGE special
parameters. If [[RETURN]] is pressed in response to this prompt, the code for the IMAGE
special parameters will not be generated and DICTCDE will issue the next prompt.
Copylib module for data set name >
Enter the copylib module for the data set specified by DICTCDE in data set name. If
[[RETURN]] is pressed in response to this prompt, the source code for this data set will not
be generated and DICTCDE will prompt for the copylib module for the next data set that
belongs to the specified database. Once [[RETURN]] has been pressed in response to a
prompt for a data set, that data set is skipped (code can not be generated for that data set).
If ] is entered in response to this prompt, DICTCDE will again prompt for a file name.
After a copylib module has been defined for a data set, DICTCDE issues the following
prompt:
Prefix for data items in data set name >
This prompt allows you to enter a prefix which is used in the COBOL identifier for each
data item in the specified data set. The prefix you choose can be 8 characters maximum
and must begin with a letter to be a valid COBOL identifier. If you would like a hyphen
between the prefix and the data item name, be sure to include it as part of the prefix. (See
Examples of Generated Code later in this section for an example of data items generated
with prefixes.) When a prefix is assigned to a data item name, those data items can be
referred to uniquely in a COBOL program without using the COBOL OF clause.