Dictionary/3000 Reference Manual (32244-90001)

240 Chapter7
The Dictionary DICTCDE Utility
The DICTCDE Main Prompt
Enter the copylib module for the code generated for the FILE SECTION entry. The FILE
SECTION defines the file to be used in the program and is part of the DATA DIVISION for
a program. The record layout for the file (the source code for the data items in the file) is
also defined in this section. However, you may choose to generate the record layout for the
file in WORKING-STORAGE, instead of in the FILE SECTION. If a copylib module is
entered for the FILE SECTION, but you choose to generate the record layout for the file in
WORKING-STORAGE, the FD statement would be generated as a single, 01-level
definition. This definition is generated to serve as a buffer for READs and WRITEs to the
file. If a copylib module is not entered for the FILE SECTION, the record definition for the
file may still be generated in WORKING-STORAGE.
If [[RETURN]] is pressed in response to this prompt, no FILE SECTION entry will be
generated and DICTCDE will continue to prompt for the copylib module for the next
program section.
Copylib module for WORKING-STORAGE record>
Enter the copylib module for the WORKING-STORAGE record. The
WORKING-STORAGE record will contain the record layout for the file. If a copylib module
was entered in response to the prompt for the FILE SECTION entry and [[RETURN]] is
pressed in response to this prompt, the record layout of the file will be defined in the FILE
SECTION. If no copylib module was entered in response to the prompt for the FILE
SECTION entry, and [[RETURN]] is pressed in response to this prompt, no record layout
for the file will be generated.
When a copylib module is defined for the WORKING-STORAGE record for a KSAM file,
the following prompt is also issued by DICTCDE:
Include KSAM FILETABLE parameter (N/Y)>
Enter Y to generate the KSAM FILETABLE parameter for this file. The KSAM
FILETABLE parameter is useful if you use the intrinsics provided by KSAM for COBOL,
rather than the KSAM support provided by COBOL II.
When the copylib modules have been defined for either the FILE SECTION or for
WORKING-STORAGE, DICTCDE prompts for the following:
Prefix for data items in filename >
Enter the prefix to be used in the COBOL identifier for each data item in the file. The
prefix can be 8 characters maximum and must begin with a letter to be a valid COBOL
identifier. This prefix can be used to uniquely identify the data items to the file. (See
Examples of Generated Code later in this section for an example of data items generated
with prefixes.)
If [[RETURN]] is pressed in response to this prompt, the source code for the KSAM file is
generated without a prefix assigned to the data items in the file. The code is echoed to the
terminal as it is written to the copylib module.
After the source code has been generated for the KSAM file, DICTCDE will return to the
main prompt.