HP 3000 Manuals HP 3000 Manuals
Generating IMAGE-DATASET Definitions
If you specify IMAGE-DATASET as the entity type in the GENERATE command,
SDCDE generates a COBOL record definition for the data set with the given
entity name. SDCDE prompts you for a module name:
Module name for IMAGE-DATASET data-set-name >
If you enter a [[RETURN]], SDCDE does not generate any code for this data
set and the GENERATE command will be complete. If you enter a module
name, SDCDE generates the source into the specified module in the
WORKING-STORAGE SECTION.
If you specify the ELEM-QUALIFY parameter of the OPTIONS command, SDCDE
responds with one of the following prompts, depending on the value you
specify:
Value Prompt
PREFIX Element prefix >
SUFFIX Element suffix >
NONE No prompt
SDCDE attaches the prefix or suffix characters to the elements contained
by the data sets. If you enter a [[RETURN]], SDCDE does not a attach
prefix or suffix.
When you complete the answers to these prompts, SDCDE starts the source
generation process. If you set the SECONDARY-REC parameter of the
OPTIONS command to ON, then SDCDE looks for all records related to the
data set, regardless of whether the record is primary or secondary. For
each such record found, SDCDE generates an 01 level definition with all
the elements with the 05 level number. If you set the SECONDARY-REC
parameter to OFF, SDCDE uses the data set name to generate the 01 level
definition with only the primary record contained in the data set. A
complete description of how SDCDE determines the primary record is
located in Chapter 5 of this manual.
If you set the CONSTANTS parameter of the OPTIONS command to ON, SDCDE
generates the data set name and the search item name as constants. The
constant values generated are taken from the image-alias attribute value
if one exists. If not, the primary name is used, regardless of the ALIAS
parameter value of the OPTIONS command. SDCDE obtains the data set
search item name through either the IMAGE-DATASET key ELEMENT
relationship or the five-way relationship, depending on whether the data
set is a master or detail data set. The five-way relationship consists
of IMAGE-DATASET, ELEMENT, ELEMENT, IMAGE-DATASET, and IMAGE-DATABASE
chains.
Example
In the following example, the data set name is CUSTOMER, ELEM-QUALIFY =
PREFIX, and CONSTANT = ON.
> GENERATE CUSTOMER; ENTITY-TYPE=IMAGE-DATASET.
Module name for IMAGE-DATASET CUSTOMER > CUSTMOD
Element prefix > [[RETURN]]
000100
000200 01 CUSTOMER-DATA
000300 05 ACCOUNT PIC S9(9) COMP.
000400 05 LAST-NAME PIC X(16).
000500 05 FIRST-NAME PIC X(10).
000600 05 MID-INITIAL PIC X(2).
000700 05 STREET-ADDRESS PIC X(26).
000800 05 CITY PIC X(12).
000900 05 STATE PIC X(2).
001000 05 ZIP PIC X(6).
001200 05 CREDIT-RATING PIC S9(9) COMP.
001300
001400 01 DS-CUSTOMER PIC X(9) VALUE "CUSTOMER ".
001500 01 DI-ACCOUNT PIC X(8) VALUE "ACCOUNT ".
001600