1 09/10/85 message_status, msgst
 2 
 3 
 4 Syntax as a command: msgst {mbx_specification} {-control_arg}
 5 
 6 
 7 Syntax as an active function: [msgst {mbx_specification}]
 8 
 9 
10 Function: prints information about mailboxes on which messages are
11 being accepted.
12 
13 
14 Arguments:
15 mbx_specification
16    specifies the mailbox on which messages are to be accepted.  If not
17    given, the user's default mailbox (>udd>Project>Person>Person.mbx)
18    is used.
19 
20 
21 Control arguments:
22 -all, -a
23    prints information for all mailboxes on which the user is accepting
24    or deferring messages.
25 
26 
27 List of mbx specifications:
28 -log
29    specifies the user's logbox and is equivalent to
30       -mailbox >udd>Project_id>Person_id>Person_id.sv.mbx
31 -mailbox path, -mbx path
32    specifies the pathname of a mailbox.  The suffix .mbx is added if
33    necessary.
34 -save path, -sv path
35    specifies the pathname of a savebox.  The suffix .sv.mbx is added if
36    necessary.
37 
38 
39 -user STR
40    specifies either a user's default mailbox or an entry in the system
41    mail table.
42 STR
43    is any noncontrol argument and is first interpreted as -mailbox STR;
44    if no mailbox is found, STR is then interpreted as -save STR; if no
45    savebox is found, it is interpreted as -user STR.
46 
47 
48 Notes on use as an active function:
49 When used as an active function, message_status returns the command
50 string which may be used to set the message acceptance state on the
51 specified mailbox to the current state.  Thus multiple acceptance
52 states may be pushed and popped using the value segment like so:
53 
54    value_set old_state ||[msgst] -push
55    dm
56    value_set old_state ||[msgst] -push
57    am -call "ec message_handler"
58    [value_get old_state -pop]
59    [value_get old_state -pop]