1 10/17/84  have_mail
 2 
 3 Syntax as a command:  have_mail mbx_specification {-control_args}
 4 
 5 
 6 Syntax as an active function:
 7    [have_mail {mbx_specification} {-control_args}]
 8 
 9 
10 Function: returns "true" if there is mail in the specified mailbox.
11 
12 
13 Arguments:
14 mbx_specification
15    specifies the mailbox to be examined.  If not given, your default
16    mailbox (>udd>Project_id>Person_id>Person_id.mbx) is used.
17 
18 
19 List of mbx specifications:
20 -log
21    specifies the user's logbox and is equivalent to
22       -mailbox >udd>Project_id>Person_id>Person_id.sv.mbx
23 -mailbox path, -mbx path
24    specifies the pathname of a mailbox.  The suffix mbx is added if
25    necessary.
26 -save path, -sv path
27    specifies the pathname of a savebox.  The suffix sv.mbx is added if
28    necessary.
29 
30 
31 -user STR
32    specifies either a user's default mailbox or an entry in the system
33    mail table (see "Notes on mailbox selection by user" below).
34 STR
35    is any noncontrol argument and is first interpreted as -mailbox STR.
36    If no mailbox is found, it is then interpreted as -save.  If no
37    savebox is found, it is then interpreted as -user STR.
38 
39 
40 Control arguments:
41 -interactive_messages, -im
42    returns "true" if there are any interactive messages in the mailbox.
43    (Default)
44 -mail, -ml
45    returns "true" if there is any mail in the mailbox.  (Default)
46 -no_interactive_messages, -nim
47    returns "true" only if there is mail in the mailbox, ignoring
48    whether there are any interactive messages present.
49 -no_mail, -nml
50    returns "true" only if there are interactive messages in the
51    mailbox, ignoring whether there is any mail in the mailbox.
52 
53 
54 Notes on mailbox selection by user: The user's default mailbox is
55 specified in the form Person_id.Project_id.  For an entry in the mail
56 table, STR is usually in the form of Person_id (the mail table is fully
57 described in the Extended Mail System User's Guide, CH23).
58 
59 
60 If STR contains one period and no white space, it is interpreted as a
61 User_id that specifies the user's default mailbox; otherwise, it is
62 interpreted as the name of an entry in the mail table.  For example,
63    -user Smith.SiteSA
64 is interpreted as a User_id that identifies a default mailbox.  On the
65 other hand,
66    -user "John M. Morton"
67    -user J.C.Meade
68    -user Meade
69 are all interpreted as the names of entries in the mail table:  the
70 first because it contains white space; the second because it contains
71 more than one period; the third because it contains no period.
72 
73 
74 When interpreted as a User_id, the STR cannot contain any angle
75 brackets (<>) and must have the form Person_id.Project_id, where
76 "Person_id" cannot exceed 28 characters and "Project_id" 32 characters.
77 In this case, "-user STR" is equivalent to the mbx_specification
78 -mailbox >udd>Project_id>Person_id>Person_id.mbx.
79 
80 When interpreted as the name of a mail table entry, STR cannot contain
81 any commas, colons, semicolons, backslashes (\), parentheses, angle
82 brackets, braces ({}), quotes, commercial at-signs (@), or white space
83 other than spaces.  The query of the mail table is performed in a
84 case-insensitive manner.  Use the display_mailing_address command to
85 determine the actual address corresponding to the STR.  The address in
86 the mail table must identify a mailbox.
87 
88 
89 Access required: If you give either -no_interactive_messages or
90 -no_mail, you must have rs extended access to the mailbox; otherwise,
91 you only need s extended access.