Dictionary/3000 Reference Manual (32244-90001)

236 Chapter7
The Dictionary DICTCDE Utility
The DICTCDE Main Prompt
Enter Y to generate a field number table for each form in the forms file. The field number
tables are useful in calls to some of the VPLUS intrinsics, such as VSETERROR. The
tables provide the field numbers for each field in the form. Each field in the form is
represented by a data item in the table. The data items are COMP variables initialized to
the field number. (See the Examples of Generated Code later in this section for examples of
the field number tables.) Enter N or press [[RETURN]] in response to this prompt if you do
not want field number tables generated for the forms.
The data items defined as numeric VPLUS fields in the Dictionary only appear as ASCII
fields in the VPLUS buffer. Because of this, DICTCDE asks whether these fields are to be
defined as PIC 9 or PIC X when the code is generated:
Define numeric fields as PIC 9 or PIC X (9/X)>
Enter X to define every numeric field in the forms file as ASCII alphanumeric (PICTURE
CLAUSE PIC X). Enter 9 or press [[RETURN]] to define every numeric field as ASCII
numeric only (PICTURE CLAUSE PIC 9). If field edits have been defined for the numeric
fields in the forms file, it may be more appropriate to define the numeric fields as PIC 9.
However, if you choose to define the numeric fields as PIC 9, the forms must only allow
numeric data to be entered in those fields.
DICTCDE will then begin the generation process. The generated code is echoed to the
terminal as it is written to the copylib module.
If the source code generated for the forms is to be written to different copylib modules,
enter N or press [[RETURN]] in response to Define all forms in one module (N/Y)>.
DICTCDE will then issue the following prompts:
Copylib module for forms file name constant>
Enter the copylib module to which you are directing the source code for the forms file
name. DICTCDE will echo the code generated for the forms file name to the terminal as it
is written to the copylib module. If [[RETURN]] is pressed in response to this prompt, this
code will not be generated and the next prompts will be issued.
The next two prompts apply to all the forms in the forms file to be generated. These are the
same prompts issued when the entire forms file is to be defined in one copylib module.
Define field number tables (N/Y)>
Enter Y to generate field number tables for each form to be generated. Enter N or press
[[RETURN]] if you do not want to generate field number tables.
Define numeric fields as PIC 9 or PIC X (9/X)>
Enter X to define every numeric field in every form generated as PIC X. Enter 9 or press
[[RETURN]] to define every field as PIC 9. (Remember, if 9 is entered in response to this
prompt, the forms must only allow numeric data to be entered in those fields.) DICTCDE
then begins prompting for copylib modules for each of the forms in the forms file.
Copylib module for formname >
Enter the copylib module for the form specified by DICTCDE in formname. If [[RETURN]]
is pressed in response to this prompt, the source code for this form will not be generated.
(The field number tables will not be generated for that form either.) Once [[RETURN]] has
been pressed in response to the copylib module for a form, that form is skipped (code can
not be generated for that form) and DICTCDE will then prompt for the copylib module for