Use the EXTRACT command to copy source text of dictionary objects from
the  CDD  into  a  file, or to create and insert into a file CDDL text
that describes existing CDD records.

Command Syntax:


     EXTRACT     [qualifiers]     path-name      [,      path-name]...
     file-specification

Additional information available:

parametersprivilegesqualifiers

 path-name

 Specifies the dictionary objects you want to extract.   You  can  use
 the  wildcards % and * in the path name.  If you are using a terminal
 of the VT200 family, you can use 8-bit characters in path names.

 Type "HELP specify path-name" for further information.

 file-specification

 Names the file into which  the  source  text  is  copied.   The  file
 specification  is a standard VMS file specification naming the output
 file.  The default file type is .LIS.  You must specify a file.

  o  You need PASS_THRU and SEE privileges on the dictionary directory
     or object to extract the source text.

  o  You need HISTORY privilege on the dictionary directory or  object
     to use the /AUDIT qualifier.

Additional information available:

/AUDIT/RECORD/SOURCE/TEMPLATE/TYPE

 Syntax:

     /AUDIT [= (quoted-string [, quoted-string]...)]
     /AUDIT=file-specification
     /NOAUDIT

 Use /AUDIT to create history list entries auditing the extraction  of
 each dictionary object.

 You can include explanatory text in history  list  entries  in  three
 ways:

  o  By specifying the /AUDIT qualifier.  If  you  include  no  quoted
     string or file-specification, DMU provides a default history list
     entry describing your operation.

  o  By including quoted  strings.   Enclose  each  quoted  string  in
     double  quotation  marks,  and  enclose  the series of strings in
     parentheses.  The parentheses are optional if  you  specify  only
     one quoted string.

  o  By specifying a file whose contents are to  be  included  in  the
     history  list  entry.   The  file specification is a standard VMS
     file specification, and the default file type is .DAT.   You  can
     include  no  more  than 64 input strings in a history list entry.
     DMU ignores any excess.

 With /NOAUDIT, no history list entries are created.  The  default  is
 /NOAUDIT.

 Syntax:


     /RECORD

 Use /RECORD to convert record descriptions into CDDL source text.

 If you specify this qualifier, DMU  creates  CDDL  source  text  that
 describes  any  CDD  records  you  specify.  You can use this text to
 recompile record descriptions, or see a CDDL description of a  record
 not originally created with CDDL.

 This qualifier has no effect on dictionary objects that are  not  CDD
 records.  The opposite of /RECORD is /SOURCE.

 Syntax:

     /SOURCE

 Use /SOURCE to copy the source text of dictionary  objects  into  the
 specified file.

 If you specify /SOURCE, DMU copies the source text of  the  specified
 dictionary  objects into the file.  If the dictionary object does not
 contain source text, DMU does not create it.   If  you  want  DMU  to
 create source text, use /RECORD instead of /SOURCE.

 You should not use /SOURCE with the /RECORD option.  If you  do,  DMU
 ignores /SOURCE.

 /SOURCE is the default.

 Syntax:

     /[NO]TEMPLATE

 Use /TEMPLATE to expand into CDDL source text any  fields  that  copy
 template records.

 If you specify /TEMPLATE, DMU extracts any template records that  the
 specified  CDD  records  copy.   DMU  places CDDL source text for the
 template records into the file before the CDD records that copy them.

 You must also specify /RECORD to specify /TEMPLATE.

 /NOTEMPLATE  copies  the  record  definition  without  including  the
 definitions  of  template  records  at  the  top of the listing.  The
 default is /NOTEMPLATE.

 Syntax:

     /TYPE = (type-specification [, type-specification]...)

 Use /TYPE to specify a particular type of  dictionary  object  to  be
 extracted.

 A type specification names a type, such as DTR$DOMAIN or  CDD$RECORD,
 to  be  extracted.   You can use the wildcard characters % and * in a
 type specification.  The parentheses are optional if you specify only
 one type.