Dictionary/3000 Reference Manual (32244-90001)

246 Chapter7
The Dictionary DICTCDE Utility
The DICTCDE Main Prompt
generated. Using aliases as COBOL identifiers identifies the child entities by the names
that are known by the parent entities. Regardless of whether the primary names or aliases
are used as the COBOL identifiers, the constants used for passing data set and search item
names to IMAGE will be generated using the aliases (if the aliases have been defined in
the Dictionary).
If [[RETURN]] is pressed in response to this prompt, DICTCDE will continue to the next
option:
Qualify data sets and forms with their parent files (N/Y)>
Enter Y to use the parent file as a prefix in the COBOL identifier generated for the data
sets or forms. When generating code for a database or forms file, DICTCDE allows you to
qualify the related IMAGE data sets or VPLUS forms by the name of the parent file.
DICTCDE will use the parent file name as a prefix in the COBOL identifier generated for
the related data sets or forms. This will help you to differentiate between data sets and
forms with common names. DICTCDE will also qualify single data sets or forms by their
parent file name, if the parent file was specified, when the data set or form was extracted
from the Dictionary. (The parent file was entered in parenthesis next to the file name in
response to the File name prompt.)
Note that if the prefixes, file name and suffixes in the COBOL identifier total more than 30
characters, DICTCDE will truncate the COBOL identifier to the allowable 30 characters.
DICTCDE will truncate the suffix first, then the prefix, so that the identifier does not
exceed 30 characters.
Enter N if you do not wish to add the parent file name as a prefix in the COBOL identifiers
generated for data sets and VPLUS forms. If [[RETURN]] is pressed in response to this
prompt, DICTCDE will continue to the next option:
Use edit mask for PICTURE clause (Y/N)>
Enter Y to generate display fields for the elements defined with edit masks in the
Dictionary. DICTCDE will convert the edit mask in the Dictionary to a COBOL PICTURE
clause. When code is generated for elements with edit masks, the storage length is
computed from the size of the edit mask, not from the storage length information in the
Dictionary. However, the storage length is changed when the code is generated. For
entities which contain child elements with edit masks, the record layout for the parent
entity is also changed. Therefore, the byte offsets for the elements with edit masks must be
defined in the Dictionary according to the edit mask size, not by the data storage
requirements, if you wish to use this option. (For more information on the code generated
for edit masks, see Edit Masks discussed under Examples of Generated Code later in this
section.)
Enter N to ignore any edit masks defined for the elements. The PICTURE clause for an
element will then be generated from the data type and storage length defined in the
Dictionary.
If [[RETURN]] is pressed in response to this prompt, DICTCDE will continue to the next
option:
Prompt for record data item prefixes (Y/N)>
Enter N to suppress the prompts asking for prefixes for the record data items. Enter Y to
have the prompts issued for data item prefixes wherever DICTCDE normally issues them.