1 12/20/86 delete_domain, dld
 2 
 3 Syntax:  dld {domain1 {...domainN} {-control_args}
 4 
 5 
 6 Function:  This request deletes the specified domains from a MRDS data
 7 base.  The domains may be referenced or unreferenced.
 8 
 9 
10 Arguments:
11 domaini
12    are the domains to be deleted.
13 
14 
15 Control arguments:
16 -all, -a
17    deletes all domains defined in the MRDS data base.  This control
18    argument is inconsistent with -check.
19 -brief, -bf
20    suppresses the trace display.  (Default) The last occurrence of
21    -brief and -long on the command line takes effect.  This argument is
22    inconsistent with -check.
23 
24 
25 -check, -ck
26    prevents the deletion of any domains selected during the execution
27    of this command, and instead, traces all implied operations upon the
28    data base and displays them on the terminal.  This trace consists of
29    a statement for each domain that is referenced, listing the domain
30    that is to be deleted, a list of attributes that are based upon the
31    domain, and a list of all relations that are to be modified.
32    Inconsistent with -brief or -long.
33 -force, -fc
34    prevents the query from being issued for domains which are
35    referenced in the MRDS data base.  (Default is to issue a separate
36    query for each referenced domain.)
37 -inhibit_error, -ihe
38    prevents error messages from being issued to the terminal.  (Default
39    is to issue error messages.)
40 
41 
42 -long, -lg
43    displays the same output as -check; however, the specified domains
44    are deleted.  The last occurrence of -brief and -long on the command
45    line takes effect.  This control argument is inconsistent with
46    -check.
47 -no_force, -nfc
48    overrides the -force control argument.  The last occurrence of
49    -force and -no_force on the command line takes effect.  (Default)
50 -no_inhibit_error, -nihe
51    overrides the action of -inhibit_error.  (Default)
52 -unreferenced, -unref
53    deletes only unreferenced domains.  This control argument is
54    inconsistent with -check and -all.
55 
56 
57 Notes:  If the domain is referenced in attributes, which are themselves
58 referenced in relations, ripple effects take place.  When the domains
59 are actually deleted, all attributes based upon them are also deleted.
60 This will cause the relations that use the deleted attributes to be
61 reformatted.
62 
63 
64 Specifying either -all or -unreferenced and a list of domain names on
65 the request line is flagged as an inconsistent error.
66 
67 
68 A query is issued for each referenced domain that is to be deleted to
69 ensure against catastrophic data loss.  The query is of the form:
70 
71      Domain clock_value is used in attributes "clock_value",
72      "start_date", "stop_date", and "current_date" which are referenced
73      in relations "permanent_employees" and "temporary_employees".  Do
74      you wish to delete it?