1 01/24/82  Standard subsystem request:  execute, e
 2 
 3 Syntax:  e LINE
 4 
 5 
 6 Syntax as an active request:  [e LINE]
 7 
 8 
 9 Function:  executes the supplied line as a Multics command line.  As an
10 active request, evaluates a Multics active string and returns the
11 result to the subsystem request processor.
12 
13 
14 Arguments:
15 LINE
16    is the Multics command line to be executed or the Multics active
17    string to be evaluated.  It need not be enclosed in quotes.
18 
19 
20 Notes:
21 The recommended method to execute a Multics command line from within
22 a subsystem is the ".." escape sequence.  The execute request is
23 intended as a means of passing information from the subsystem to the
24 Multics command processor.
25 
26 All (), [], and "'s in the given line are processed by the subsystem
27 request processor and not the Multics command processor.  This fact
28 permits the passing of the values of subsystem active requests to
29 Multics commands when using the execute request or, when using the
30 execute active request, to Multics active functions for further
31 manipulation before returning the values to the subsystem request
32 processor for use within a request line.
33 
34 
35 Examples:
36 The read_mail request line:
37    e mbla [mailbox]
38 can be used to list the ACL of the mailbox being read by the current
39 invocation of read_mail.
40 
41 The read_mail request line:
42    write all [e strip_entry [mailbox]]
43 may be used to to write the ASCII representation of all messages in the
44 mailbox into a segment in the working directory whose entry name is the
45 same as that of the mailbox with the "mbx" suffix changed to "mail".