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

1  –  parameters

  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.

2  –  privileges

   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.

3  –  qualifiers

3.1    /AUDIT

  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.

3.2    /RECORD

  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.

3.3    /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.

3.4    /TEMPLATE

  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.

3.5    /TYPE

  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.