You use the VAX Common Data Dictionary Data Definition Language Utility
(CDDL) to compile source files and place record definitions in a DMU
dictionary.
CDDL command qualifiers allow you to create default access control
lists, to record the creation of record definitions in history list
entries, to list source text and diagnostic messages in a listing file,
to specify a default directory in which to store new record
definitions, to replace an existing DMU record definition, and to
create a new version of a DMU record definition.
Command Syntax:
CDDL [qualifiers] file-specification
1 – file-specification
Names the CDDL source file you want to compile. Each source file contains one or more DMU record definitions. The file specification is a standard OpenVMS file specification. The default file type is .DDL, but the CDDL compiler also recognizes the file type .CDDL.
2 – Qualifiers
/RECOMPILE
Syntax:
CDDL/RECOMPILE [qualifiers] path-name [, path-name]...
The CDDL/RECOMPILE command enables you to recompile DMU record
definitions from the source text stored in the dictionary. This
command is useful if you have modified a DMU record definition that is
the template record for COPY field descriptions. You can use
CDDL/RECOMPILE to recompile those record definitions that copy the
modified template record.
2.1 /ACL
Syntax:
/[NO]ACL
Use /ACL to create the default access control list for each record
definition in the source file. Use /NOACL to prevent creation of any
access control lists. /ACL is the default.
If you use /VERSION, /ACL propagates the access control list from the
previous highest version of the dictionary object to the new version.
/NOACL with /VERSION prevents this propagation. You cannot use
/[NO]ACL with /REPLACE.
2.2 /AUDIT
Syntax:
/AUDIT [= (quoted-string [, quoted-string]...)]
/AUDIT=file-specification
/NOAUDIT
Use /AUDIT to create a history list entry auditing the creation of each
record definition. /NOAUDIT is the default.
You can include explanatory text in the history list entries in either
of two ways. Either enclose a series of strings in double quotation
marks, or specify a file whose contents are to be included in the
history list entry.
With /NOAUDIT, no new history list entries are created.
2.3 /COPY_LIST
Syntax:
/[NO]COPY_LIST
Use /COPY_LIST with /LISTING to expand in the listing file all template
records included in a record description. CDDL extracts all template
records and inserts the corresponding CDDL source in the output listing
file. In the listing, CDDL inserts a "T" in the first character of
each line that is part of an expanded template record. You cannot
specify /NOLISTING and /COPY_LIST.
/NOCOPY_LIST is the default.
2.4 /LISTING
Syntax:
/LISTING [=file-specification]
/NOLISTING
Use /LISTING to write an output file containing the source definition
and CDDL messages. The file specification is a standard OpenVMS file
specification, and the default file type is .LIS. /NOLISTING prevents
creation of the listing file.
/LISTING is the default.
2.5 /PATH
Syntax:
/PATH = path-name
Use /PATH to name a default directory from which to trace the path
names in the CDDL source files. The CDDL uses your normal CDD$DEFAULT
directory if you do not specify /PATH.
2.6 /REPLACE
Syntax:
/[NO]REPLACE
Use /REPLACE to delete an existing DMU record definition and insert a
new definition in its place. Access control lists remain unchanged, as
do history lists, unless you specify /AUDIT to create entries recording
the replacement.
/NOREPLACE is the default. If you try to compile a source file for an
existing DMU record definition without specifying /REPLACE or /VERSION,
the CDDL aborts the compilation and issues an error message.
You cannot specify /VERSION or /[NO]ACL with /REPLACE.
2.7 /VERSION
Syntax:
/[NO]VERSION
Use /VERSION to create an additional version of an existing DMU record.
If the path name in the CDDL source file specifies an absolute version
number, the new version has that version number. Otherwise the newly
created record has a new version number one higher than the previous
highest.
/NOVERSION is the default. Use /NOVERSION to prevent creation of an
additional version of a record that already exists.
If you specify /NOACL, the newly created record does not have an access
control list. If you do not specify /NOACL, the new record has the
same access control list as the previous highest version. If there is
no previous version and you use /ACL, the new version has the default
ACL for dictionary objects.
The newly created record has the same history list as the previous
highest version. Use /AUDIT to add an entry to this history list
describing the creation of the new version. Use /NOAUDIT to leave the
history list unchanged.
2.8 /V2
Syntax:
/V2
The /V2 qualifier causes the compiler to use the CDD V2.0 defaults for
the signs of the fixed point numbers. With this qualifier, BYTE, WORD,
and LONGWORD datatypes are unsigned by default, but QUADWORD and
OCTAWORD datatypes are signed.
If you do not specify the /V2 qualifier, all the fixed point datatypes
are unsigned by default.
3 /RECOMPILE
Syntax:
CDDL/RECOMPILE [qualifiers] path-name [, path-name]...
The CDDL/RECOMPILE command enables you to recompile DMU record
definitions from the source text stored in the dictionary. This
command is useful if you have modified a DMU record definition that is
the template record for COPY field descriptions. You can use
CDDL/RECOMPILE to recompile those record definitions that copy the
modified template record.
3.1 – path-name
Specifies a record definition to be recompiled. You can use the full or the relative path name.
3.2 – Qualifiers
3.2.1 /ACL
Syntax:
/[NO]ACL
In the CDDL/RECOMPILE command, you can use /ACL with /VERSION to copy
the ACL from the previous highest version of the object into the newly
created version. Use /NOACL to prevent creation of any access control
list for the new object.
You can only use /[NO]ACL with /VERSION. Otherwise, the new DMU record
description has the same access control list as the record it replaced.
/ACL is the default.
3.2.2 /AUDIT
Syntax:
/AUDIT [= (quoted-string [, quoted-string]...)]
/AUDIT=file-specification
/NOAUDIT
Use /AUDIT to create a history list entry auditing the creation of each
record definition.
You can include explanatory text in the history list entries in either
of two ways. Either enclose a series of strings in double quotation
marks, or specify a file whose contents are to be included in the
history list entry.
/NOAUDIT is the default. With /NOAUDIT, no new history list entries
are created.
3.2.3 /COPY_LIST
Syntax:
/[NO]COPY_LIST
Use /COPY_LIST with /LISTING to expand in the listing file all template
records included in a record description. CDDL extracts all template
records and inserts the corresponding CDDL source in the output listing
file. In the listing, CDDL inserts a "T" in the first character of
each line that is part of an expanded template record. You cannot
specify /NOLISTING and /COPY_LIST.
/NOCOPY_LIST is the default.
3.2.4 /LISTING
Syntax:
/LISTING [=file-specification]
/NOLISTING
Use /LISTING to write an output file containing the source definition
and CDDL messages. The file specification is a standard OpenVMS file
specification, and the default file type is .LIS. /LISTING is the
default.
/NOLISTING prevents creation of the listing file.
3.2.5 /PATH
Syntax:
/PATH = path-name
Use /PATH to name a default directory from which to trace the path
names in the CDDL source files. The CDDL uses your normal CDD$DEFAULT
directory if you do not specify /PATH.
3.2.6 /VERSION
Syntax:
/[NO]VERSION
Use /VERSION to compile an existing record definition, creating an
additional version of it. CDDL/RECOMPILE/VERSION compiles the record
you specify but does not replace it. Instead, it creates an additional
version of the record definition with version number one greater than
the previous highest.
/NOVERSION is the default. Use /NOVERSION to replace the recompiled
version of the record with the newly compiled version.
3.2.7 /V2
Syntax:
/V2
The /V2 qualifier causes the compiler to use the CDD V2.0 defaults for
the signs of the fixed point numbers. With this qualifier, BYTE, WORD,
and LONGWORD datatypes are unsigned by default, but QUADWORD and
OCTAWORD datatypes are signed.
If you do not specify the /V2 qualifier, all the fixed point datatypes
are unsigned by default.