1 09/21/82  read_mail request:  first, f
 2 
 3 Syntax:  f {-control_arg}
 4 
 5 
 6 Syntax as an active request:  [f {-control_arg}]
 7 
 8 
 9 Function:  prints the message number of the first message of the
10 specified type; as an active request, returns the message number.
11 
12 
13 Control arguments:
14 -include_deleted, -idl
15    prints or returns one.  (Ie: the number of the first message in the
16    mailbox whether or not it has been deleted.)
17 -only_deleted, -odl
18    prints or returns the message number of the first deleted message.
19 -only_non_deleted, -ondl
20    prints or returns the message number of the first non-deleted
21    message in the mailbox.  (Default)
22 
23 
24 Notes:
25 If there are no messages of the specified type, the active request will
26 return the value zero.