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