Dictionary/3000 Reference Manual (32244-90001)

Chapter 7 239
The Dictionary DICTCDE Utility
The DICTCDE Main Prompt
(Therefore, this prompt is not issued for MPER files.)
DICTCDE then issues the next prompt:
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 also pressed in response to this prompt, no record
layout for the file will be generated.
If 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 which is discussed 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 file is
generated without a prefix assigned to the data items. The code is echoed to the terminal
as it is written to the copylib module. DICTCDE then returns to the main prompt.
KSAM Files. If the specified file is a KSAM file, DICTCDE will issue the following
message and prompts:
File filename is a KSAM file.
DICTCDE allows you to use KSAM files in two ways. First, you may use the KSAM
support provided by COBOL II. To do so, you would generate the SELECT statement and
FILE SECTION, but you would not generate the record layout in WORKING STORAGE.
Second, you may use the intrinsics supplied by KSAM for use by COBOL. To do this, you
would generate the record layout in WORKING STORAGE to serve as a data buffer
parameter to the KSAM intrinsics, but you would not generate the SELECT statement or
the FILE SECTION entry.
The next prompts issued by DICTCDE allow you to choose what COBOL program sections
are to be defined for the file. DICTCDE allows you to generate source code for the
ENVIRONMENT DIVISION and the DATA DIVISION of a COBOL program as it did for
an MPE file.
Copylib module for SELECT statement>
Enter the copylib module for the code generated for the SELECT statement. The SELECT
statement identifies the file to be used in a COBOL program and is part of the
ENVIRONMENT DIVISION for the program. When a copylib module is entered in
response to this prompt, DICTCDE will then prompt for the copylib module for the next
program section. If [[RETURN]] is pressed in response to this prompt, no SELECT
statement will be generated and DICTCDE will continue to the next prompt.
Copylib module for FILE SECTION entry>