Data Definition Language (DDL) Reference Manual (G06.24+)

DDL Compiler Commands
Data Definition Language (DDL) Reference Manual—426798-002
9-50
DICTN Command
dict-subvol-name
identifies the dictionary subvolume; dict-subvol-name is a subvolume name in
this form:
[\node-name.][$volume-name.][subvolume-name]
If dict-subvol-name is omitted, DDL uses the current system and the current
volume and subvolume. If node-name is omitted, DDL uses the current system; if
volume-name is omitted, DDL uses the current volume; and if subvolume-name
is omitted, DDL uses the current subvolume.
!
purges all existing dictionary files in the specified subvolume and creates a new
dictionary. DDL creates the new files using the extent sizes, MAXEXTENTS value,
security, and ownership associated with the purged dictionary. For example, if user
Y uses the DICT! command on a dictionary that belongs to user X, the resulting
dictionary still belongs to user X, still has the same number of extents in each file,
and still has the same security as the original dictionary; any other file
characteristics are those that might be expected from the creation of a completely
new dictionary by user Y. (User Y must have purge access to the original files to be
able to use the purge option; otherwise, DDL does not execute the DICT!
command.)
If no dictionary is in the specified subvolume, DDL ignores the exclamation point.
If the dictionary is audited or was created by an older DDL version, DDL deletes
the dictionary and re-creates it as a nonaudited dictionary, provided the dictionary
is not part of a Pathmaker catalog. DDL issues a warning message if it cannot re-
create the dictionary as a nonaudited dictionary.
When used on an audited dictionary created for a Pathmaker application, this
command purges only DDL files; it does not purge Pathmaker objects. If the
dictionary is part of an older version of the Pathmaker catalog, DDL cannot purge
any objects from the dictionary.
DICTN Command Guidelines
The following points are guidelines for using the DICTN command:
•
The DDL dictionary consists of 14 files with predefined file names. For this reason,
any given subvolume can contain only one dictionary.
•
If the specified subvolume does not exist, DDL creates and opens the dictionary on
the new subvolume.
•
If the subvolume exists but does not contain a dictionary, DDL creates and opens a
dictionary on the specified subvolume.