1 12/20/86  ready_db, rdb
 2 
 3 Syntax:  rdb {db_path} {-control_args}
 4 
 5 
 6 Function:  Readies a data base to be restructured.
 7 
 8 
 9 Arguments:
10 db_path
11    Relative or absolute path to the data base to be restructured.  The
12    db suffix is assumed if it is not supplied.
13 
14 
15 Control arguments:
16 -force, -fc
17    specifies that the data base be created if it does not already exist
18    without querying the user.
19 -no_force, -nfc
20    overrides the -force control argument.  (Default) The last
21    occurrence of -force and -no_force on the command line takes effect.
22 -pathname db_path, -pn db_path
23    specifies the path for the data base to be restructured.  The last
24    path supplied is the readied one.
25 -quiesce_wait_time N, -qwt N
26    specifies the number of seconds to wait for all open users to close
27    the data base.  (Default is 0)
28 
29 
30 -relation_type type {modes}, -rt type {modes}
31    specifies the type of relation to create if the data base does not
32    already exist.  The supported types are vfile_ and
33    data_management_file (dmf) (see Notes below).  The mode argument is
34    only valid for dmf-type relations, and the supported modes are any
35    combination of protection, concurrency, or rollback separated by
36    commas.  Any mode may be preceded with a not sign (^) to negate it.
37 
38 
39 Notes:  DBAs are the only persons who can ready a data base for
40 restructuring.
41 
42 
43 The data base should not be readied if there are any open users Once
44 the data base is readied, it can be opened by the process that has
45 readied it.
46 
47 
48 The db_path argument cannot refer to a submodel or a data base earlier
49 than Version 4.
50 
51 
52 This request can be run only against a consistent data base.  If the
53 data base is inconsistent, the user is queried to see if he/she wishes
54 to execute the "undo request" and make the data base consistent.  After
55 executing the undo request, the data base can be readied.  If the undo
56 request fails, the user is returned to rmdb request level (i.e., the
57 data base is not readied).
58 
59 
60 When this request is used to create a new data base, and the
61 -relation_type argument is not specified, the data base is created with
62 the default relation type of vfile_.
63 
64 
65 Only one data base can be readied at any given time.