1 12/20/86  display_data_model, ddm, dmdm
  2 
  3 Syntax:  ddm {-control_args}
  4 
  5 
  6 Function:  Displays the model definition of a MRDS data base, including
  7 domain, attribute, and relation information.
  8 
  9 
 10 Control arguments:
 11 -attribute {modifier}, -attr {modifier}
 12    displays attribute information.  The modifier may be name(s) or
 13    -unreferenced (-unref).  If name(s) is supplied, information for the
 14    attribute name(s) is displayed.  If -unreferenced is supplied,
 15    attribute information about all unreferenced attributes is
 16    displayed.  If no modifier is supplied, attribute information about
 17    all attributes is displayed.
 18 -brief, -bf
 19    specifies that the brief format be displayed.  This argument is
 20    incompatible with -names.
 21 
 22 
 23 -cmdb
 24    specifies that the output be in the same format as an input source
 25    text for create_mrds_db.  If the -output_file control argument is
 26    included in the invocation, then the segment can be used to create
 27    another data base with the same definitions.  Only the -brief,
 28    -long, and -output_file control arguments can be used with this
 29    control argument.
 30 
 31 
 32 -crossref {type}, -xref {type}
 33    displays an information cross-reference.  The type may be domain
 34    (dom), attribute (attr), or all.  If the type is domain, each domain
 35    is listed with a list of attributes in which the domain is
 36    referenced.  If the type is attribute, each attribute is listed with
 37    a list of relations in which the attribute is referenced.  If the
 38    type is all, both domain and attribute cross-references are
 39    displayed.  (Default is "all".)  See the examples below which show
 40    the information displayed.
 41 
 42 
 43 -domain {modifier}, -dom {modifier}
 44    displays domain information.  The modifier may be name(s) or
 45    -unreferenced (-unref).  If name(s) is supplied, information for the
 46    domain name(s) is displayed.  If -unreferenced is supplied, domain
 47    information about all unreferenced domains is displayed.  If no
 48    modifier is supplied, domain information about all domains is
 49    displayed.
 50 -header, -he
 51    displays data base header information.
 52 -history, -hist
 53    displays restructuring history information.  If the data base is
 54    restructured more then once, the history entries are displayed in
 55    reverse chronological order.
 56 
 57 
 58 -index names, -ix names
 59    displays information about indexed relations for the relation names
 60    supplied.  If no names are supplied, then information about all
 61    indexed relations is displayed.
 62 -long, -lg
 63    specifies that the long format be displayed.  This argument is
 64    incompatible with -names.
 65 -names, -nm
 66    displays the format of domains, attributes, relations, and indexed
 67    relations as a list of the names.  This argument is incompatible
 68    with -brief or -long.
 69 -no_header, -nhe
 70    prevents display of the header information.  (Default)
 71 -no_output_file, -nof
 72    writes the output to the terminal.  (Default)
 73 
 74 
 75 -output_file path, -of path
 76    writes the output to path, rather than to the terminal.
 77 -relation names, -rel names
 78    displays relation information for the relation names supplied.  If
 79    no names are supplied, the relation information about all relations
 80    is displayed.
 81 -temp_dir path
 82    specifies that the directory indicated by path be used for temporary
 83    storage.
 84 
 85 
 86 Notes:  If no control arguments are supplied, the default relation
 87 information is displayed.
 88 
 89 
 90 Examples:
 91 If the data base "little" is created from the source:
 92 
 93      domain:  code fixed bin, address char(20);
 94      relation:  zip(code* address);
 95 
 96  the results would be as follows:
 97 
 98       display_data_model -long
 99       DATA MODEL FOR DATA BASE  >udd>Demo>dbmt>db7>jg>little.db
100 
101       Version:                4
102       Created by:          User.Multics.a
103       Created on:          05/14/80  1042.9 mst Wed
104 
105       Total Domains:          2
106       Total Attributes:       2
107       Total Relations:        1
108 
109       RELATION NAME:   zip
110 
111       Number attributes:         2
112       Key length (bits):        36
113       Data Length (bits):      216
114 
115          ATTRIBUTES:
116 
117             Name:       code
118             Type:       Key
119             Offset:     0 (bits)
120             Length:     36 (bits)
121             Domain_info:
122                   name: code
123                   dcl:  real fixed binary (17,0) aligned
124 
125             Name:       address
126             Type:       Data
127             Offset:     36 (bits)
128             Length:     180 (bits)
129             Domain_info:
130                   name: address
131                   dcl:  character (20) nonvarying unaligned
132 
133 
134 
135       display_data_model -cmdb -long
136         .
137         .
138         .
139 
140        /* Created from   >udd>Demo>dbmt>db7>User>little.db
141                           06/14/82  1251.3 mst Wed      */
142 
143       domain:
144                 address
145                      character (20) nonvarying unaligned,
146                 code
147                      real fixed binary (17,0) aligned;
148 
149       relation:
150                 zip                  (code* address);