1 05/15/80  mrds_call, mrc
 2 
 3 Syntax:  mrc function_name {args}
 4 
 5 
 6 Function:  Provides a command level interface to the Multics Relational Data
 7 Store (MRDS) Data Sublanguage, which is a subroutine interface dsl_ with
 8 several entry points.
 9 
10 
11 Arguments:
12 function_name
13    this is the name of one of the dsl_ entry points, or one of the two
14    mrds_call functions list_dbs or set_modes.  The dsl entry points available
15    are close, declare, define_temp_rel, delete, dl_scope, dl_scope_all,
16    get_population, get_scope, modify, open, retrieve, set_scope, set_scope_all,
17    and store.
18 args
19    these are the individual arguments required by a particular dsl_ entry
20    point, such as database index and relation name for store, or pathname and
21    open mode for open.  See the particular dsl_ entry point help file for
22    details.
23 
24 
25 Notes:  None of the dsl_ functions require the inclusion of the error code
26 argument, as this will be reported via com_err_ if non-zero.
27 
28 The argument order is the same as for the corresponding dsl_ entry point.
29 
30 For entries that take a selection expression, it can be given in quotes, or the
31 last argument can be -segment, -sm path to take the selection expression from a
32 segment.
33 
34 Scope modes are encoded to the characters n, r, a(or s), d, m, and u.  Opening
35 modes are encoded to the characters r, u, er, and eu.
36 
37 Retrieve is a special case, the number of values to be retrieved must be given
38 before the database index argument.  In addition, if the last argument is -all,
39 successive -another calls will be made, to retrieve all data statisfying the
40 conditions.
41 
42 The funtion close will accept a database index, or -all.
43 
44 The function list_dbs takes no arguments.
45 
46 The funtion set_modes takes the arguments list/no_list, and long_err/short_err
47 to control the amount of output from mrds_call.
48 
49 
50 Examples:
51 mrds_call open dept_store eu
52 
53 The open data base is:
54 1         >udd>m>jg>dr>dept_store
55           exclusive_update
56 
57 mrds_call store 1 emp 1 1 1 1 1 1
58 
59 mrds_call retrieve 6 1 "-range (e emp) -select e" -all
60 
61 The values are:
62 
63 1
64           1
65 1
66           1
67              1.00
68              1.00
69 
70 (END)
71 
72 mrds_call close -all