1 12/12/91  dial_out request:  wait
 2 
 3 Syntax:  !wait {STR} {-control_args}
 4 
 5 Syntax as an active request:  [wait {STR} {-control_args}]
 6 
 7 Function:
 8 Causes dial_out to wait until a specified string is sent from the
 9 foreign system.  As an active request, wait will return all characters
10 sent from the foreign system, including the string specified, since
11 the last characters processed by dial_out.
12 
13 
14 Arguments:
15 STR
16    the string that must be sent from the foreign system.  If omitted,
17    dial_out will wait until any characters are sent from the foreign
18    system unless -nl is supplied.
19 
20 
21 Control arguments:
22 -inhibit_error, -ihe
23    specifies that dial_out should not abort after a timeout has
24    occured. This control argument requires that a timeout interval
25    greater than zero also be specified (See the '-timeout' ctl arg).
26    This control argument is most useful when wait is used as an active
27    request.
28 -nl
29    specifies that dial_out should wait for an occurence of the
30    specified string that ends in a new line (octal 12).
31 -nnl
32    undoes -nl.
33 -no_inhibit_error, -nihe
34    Specifies that timeouts should result in an abort.  This is the
35    default.
36 
37 
38 -no_timeout, -ntm
39    specifies no time out.  This is the default.
40 -timeout N, -tm N
41    specifies the maximum time, in seconds, that can elapse between
42    transmissions of characters from the foreign system before dial_out
43    is to assume that the transmission is complete and that the wait
44    should terminate.
45 
46 
47 Notes:
48   This request is intended for dial_out exec_coms that attempt to enter
49 a conversation with a foreign system.  As such, it allows for some
50 degree of synchronization with the foreign system.
51 
52   Within dial_out exec_coms, when used as an active request, wait will
53 return all characters sent since the last wait request or active
54 request.  When not in an exec_com, wait returns all characters sent
55 since the last characters printed by normal processing.
56 
57   The other suggested use is:
58      'e fo FILE; wait STR; e ro'
59 which allows for receipt of a foreign file where the user does not
60 watch the transmission (as in the dial_out file_output request) but
61 instead specifies a string that marks the end of transmission.