1 CDDL 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 2 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. 3 /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. 3 /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. 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 /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. 3 /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 /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. 3 /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. 3 /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. 2 /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 path-name Specifies a record definition to be recompiled. You can use the full or the relative path name. 3 Qualifiers 4 /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. 4 /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. 4 /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. 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. 4 /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. 4 /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. 4 /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.