HP 3000 Manuals HP 3000 Manuals
OPTIONS Command
The OPTIONS command alters values of the options that directly affect the
source generation process. The options remain in effect in the current
session until you override them with another OPTIONS command or until you
reset them with the RESET command.
Syntax
OPTIONS [;ALIAS = alias-type]
[;EDIT-MASK = mask-option]
[;QUALIFY = qualify-option]
[;ELEM-QUALIFY = elem-qual-type]
[;CONSTANTS = constants-option]
[;SELECT-FILE = select-file-option]
[;COMMON-STORE = common-store-option]
[;SECONDARY-REC = secondary-rec-option]
[;ECHO = echo-option]
[;COMMENT = comment-option]
{.}
Parameters
alias-type Specifies a keyword that the System Dictionary uses to
select an alias attribute that SDCDE checks during the
source generation process. The following keywords are
available:
NONE SDCDE uses the entity name.
COBOL SDCDE checks the cobol-alias attribute.
IMAGE SDCDE checks the image-alias attribute.
STANDARD SDCDE checks the standard-alias
attribute.
VPLUS SDCDE checks the vplus-alias attribute.
The initial default is NONE. When you select a keyword
other than NONE, SDCDE checks the corresponding
attribute and if it is non-blank, uses its value in
place of the entity name. For example, if you specify
ALIAS = COBOL, SDCDE checks the cobol-alias attribute
and if it is not blank, uses its attribute value in
place of the entity name. Refer to Chapter 4, "Source
Generation" , for details on how SDCDE generates
aliases.
mask-option Specifies how the edit mask of the PICTURE clause is
generated for elements. You can specify ON or OFF. If
you specify EDIT-MASK = ON, SDCDE uses the edit-mask
attribute to generate the PICTURE clause. If you
specify EDIT-MASK = OFF, SDCDE uses the element-type,
byte-length, decimal, and display-length attributes to
generate the edit mask of the PICTURE clause. Note the
following about the edit-mask attribute:
If you use the edit-mask attribute, all
other attributes pertaining to the
PICTURE clause are ignored. However,
if the data type (whether numeric or
alphanumeric) cannot be determined from
the edit-mask attribute alone, the
element-type attribute is used to
determine it.
If the edit-mask attribute is blank or
non-existent, the PICTURE clause for
that element is generated as if
EDIT-MASK = OFF.
The element's data length and display
length are both determined from the
edit-mask. Hence, the byte-offset
attribute should be consistent with the
edit-mask, not the byte-length or
display-length attributes.
The edit-mask attribute can either be
in the COBOL edit mask format or the
Dictionary/3000 edit mask format.
If the edit-mask contains inconsistent
or erroneous data, a warning message is
issued and the edit-mask is not used.
Instead, the edit mask is generated as
if EDIT-MASK = OFF.
See Appendix C for the mapping of the edit-mask
attribute to the COBOL edit mask and the computation of
the edit mask from the element-type, byte-length,
display-length and decimal attributes.
qualify-option Allows qualification of all non-element names with their
parent names. You can specify ON or OFF. If you specify
QUALIFY = ON, all non-element entity names are qualified
with the parent name. If the combined name is longer
than 61 characters, SDCDE truncates the name. If you
specify QUALIFY = OFF, the parent name qualification is
suppressed. The default is OFF.
elem-qual-type Specifies prompting for element prefixes or suffixes.
The following options are available:
PREFIX During the source generation process,
SDCDE asks for element prefixes.
SUFFIX During the source generation process,
SDCDE asks for element suffixes.
NONE During the source generation process,
no prompts for element qualification
are issued.
The default is PREFIX.
constants- Allows constants related to an entity to be generated.
option For an IMAGE-DATABASE entity type, the constants
generated include the database name, database passwords,
data set names, and their search items. For a FORMSFILE
entity type, the constants generated include the forms
file name, forms file lockword, head form name, all form
names, and each form's field number table. You can
specify ON or OFF. If you specify CONSTANTS = ON,
constants are generated. If you specify CONSTANTS =
OFF, constants are not generated. The default is ON.
select-file- Allows prompting for SELECT and FILE section module
option names when generating COBOL source code for FILE and
KSAMFILE entity types. You can specify ON or OFF. If
you specify SELECT-FILE = ON, SDCDE prompts you for
SELECT and FILE section module names during the source
generation process of the FILE and KSAMFILE entity
types. If you specify SELECT-FILE = OFF, COBOL source
is generated only into the WORKING-STORAGE SECTION and
not into the FILE or SELECT sections. The default is
ON.
common-store- Allows all records and forms contained in one entity to
option use the same memory area. This is useful if space
conservation is an important issue for your program.
You can specify ON or OFF. If you specify COMMON-STORE =
ON, you can have all the records or forms contained in
one IMAGE-DATABASE or FORMSFILE use the same memory
area. SDCDE does this by generating REDEFINES clause.
For example, suppose you have a database DB that
contains data sets DS-1 and DS-2. If COMMON-STORE = ON,
the following COBOL source is generated:
01 DS-1-DATA.
...
01 DS-2-DATA REDEFINES DS-1-DATA.
...
If you specify COMMON-STORE = OFF, then different
records and forms occupy different memory areas. For
example, suppose again that you have a database DB that
contains data sets DS-1 and DS-2. If COMMON-STORE =
OFF, the following COBOL source is generated:
01 DS-1-DATA.
...
01 DS-2-DATA.
...
The default is OFF.
secondary- Allows COBOL source generation for secondary records as
rec-option well as primary records. Entities like IMAGE-DATASET,
FILE, and KSAMFILE can have more than one record
contained in them. Only one should be designated as the
primary record, and the rest secondary. If you specify
SECONDARY-REC = ON, SDCDE generates the primary record
first and then the secondary records are generated with
the REDEFINES clause. If you specify SECONDARY-REC =
OFF, SDCDE generates only the primary record definition.
The default is OFF.
echo-option Allows suppression of the echoing of the generated
source into $STDLIST. You can specify ON or OFF. If you
specify ECHO = ON, the generated source is echoed in
$STDLIST. If you specify ECHO = OFF, the generated
source is not echoed. The default is ON.
comment- option Allows the COBOL source that is generated to be preceded
by comments that describe the entity. You can specify
ON or OFF. If you specify COMMENT = ON, the generated
COBOL source is preceded by comments that describe the
entity. If an element is generated, only the original
element is commented. If any entity other than elements
are generated, all entities contained in that entity are
commented, except for elements. For example, if an
IMAGE-DATABASE entity is generated, the database, data
sets, and records are all commented, but not the
elements. If you specify COMMENT = OFF, the generated
COBOL source is not preceded by comments. The default
is OFF. See Chapter 5 for the list of attributes that
are included as comments for each entity type.