HP System Dictionary/XL COBOL Definition Extractor (32257-90001)

2- 17
update-option Through this option, you can enter the entity/relationship definitions involving the copy
library and the key file into System Dictionary. When UPDATE-DICT = ON, and a new
copy library is created, the COPYLIB entity definition and the KSAMFILE entity defini-
tion are created from the copy library and key file name, respectively. Then the COPYLIB
key KSAMFILE relationship is created with the entity definitions. Note that in order cre-
ate these definitions, the dictionary must be opened in either shared-update or exclusive-
update open mode and the STATUS parameter of the DEFINE command must be TEST.
SDCDE issues an error message if you create a copy library when the UPDATE-DICT pa-
rameter is set to ON and the dictionary is not open or open in the wrong mode. When this
happens SDCDE creates the copy library, but does not update the dictionary. You can set
the UPDATE-DICT parameter without opening a copy library. Theinitial default for this
parameter is OFF.
open-mode When generating COBOL source, if the module name you specify already exists in the
copy library, you can either have the new source replace the lines that already exist in the
module or you can have the new source appended to the end of the old lines. Specify RE-
PLACE if you want to replace an existing module in the copy library. Because of KSAM,
the REPLACE option does not delete copylib records, it flags them as deleted. Therefore
it is possible to hit an end of file in the copy library even when REPLACE = ON. Specify
APPEND if you want to append to an existing module in the copy library. You can set the
OPEN-MODE parameter without opening a copy library. The initial default for this pa-
rameter is APPEND.
Example
The following example creates a new copy library.
>COPYLIB NAME=CL1001
>> KEY-FILE=CL1001K
>> UPDATE-DICT=OFF
>> OPEN-MODE=REPLACE.
New copy library created
>
DEFINE Command
The DEFINE command opens the System Dictionary. You must open the dictionary before you can
generate COBOL source with the GENERATE command. You can generate COBOL source code with the
STANDARDS-PARM command without opening the dictionary. When opening the dictionary for the first
time, the scope-name and scope-password are required.
Syntax
DEFINE [;DICTIONARY = dictionary-filename]
[;SCOPE = scope-name]
[;PASSWORD = [scope-password]]
[;DOMAIN = [domain-name]]
[;VERSION = [version-name]]
[;STATUS = version-status]
[;OPEN-MODE = open-mode]
[;NAME-MODE = name-mode]