NORMAL

permits the receipt of only the 95 printing ASCII characters and the codes Control-M (return), Control-J (line feed), Control-I (tab), Control-P (backspace), Control G (bell), Control-Shift-K (escape), and Delete.

The following characters are unaffected by RECEIVE: Control-C, Control-O, Control-Q, Control-S, and Control-T.

All other characters are discarded on input.

ASCII

permits the receipt of all ASCII codes except a null.

BYTE

receives all 8-bit numeric codes (including a null).

ECHO

causes received characters to be sent back to the sending terminal.  This clause is not recommended for use because such characters reflected back to the originator may cause device problems.  BYTE mode is cannot be ECHOed.

TO dest1

specifies where the terminal responses are to be stored.  It may be a character data field defined without an OCCURS clause, or a binary integer or bit data field optionally defined with a single dimension OCCURS clause.  A subscript may not be specified on dest1; data objects input are stored at the beginning of a character field from left to right, and are stored in the rightmost 7 (or 8 if BYTE mode) bits of a binary integer or bit data element.  A bit element size must be at least 7 bits.  BYTE mode may not be used for input to a character field.

WAIT ae1

specifies the maximum time that RECEIVE will input from the terminal line.  The expiration of the wait time, which is partitioned into 34 millisecond segments, completes the execution of the statement.  Thus, with judicious use of the WAIT clause, an application can be assured of not hanging due to an insufficient amount of data input.  The default time is machine infinity (i.e., RECEIVE will wait until some other terminating condition occurs, such as fulfillment of the specified number of data objects input).  The wait time can be a single number or a fraction such as .25 or 1./4.

COUNT TO dest2

specifies where the count of the number of data objects input is to be placed.  The value in dest2 can easily be used with various string functions to delimit the received data; it also ideally serves as an upper loop limit for examining data received to a binary integer or bit single-dimensional array.  Note that if no data was received, due to the expiration of a WAIT time, the value will be zero.  Thus, it is best to always use a COUNT TO clause with a WAIT clause.

MAX ae2

specifies the maximum number of integer ae2 data objects that will be accepted and placed into dest1.  The default number of objects is one of the following:

The declared length of a character field.  Such a character field cannot be defined with an OCCURS clause.  Only as many characters will be stored in the field as were received, which is again why a COUNT TO clause should always be used.

One object is stored per binary I data word occurrence.  Each object received will be placed in the rightmost 7 (or 8 if BYTE mode) bits of each machine word.

One object is stored per bit element.  A bit element size must be at least 7 bits.

RESPONSE

TERMINAL TYPE

Operating level:

61

Level 1 - VT100 family

62, 63

Level 3 - VT300 family

Response

Terminal Type

ESC [ ? 1; 2 c

VT100 DA

ESC [ ? 1; 0 c

VT101 DA

ESC [ ? 6 c

VT102 DA

ESC [ ? 12; 7; 1; 10; 102 c

VT125 DA

ESC [ ? 7 c

VT131 DA

CSI ? 62; 1; 2; 6; 7; 8; 9 c

VT220 DA

CSI ? 62; 1; 2; 3; 4; 6; 7; 8; 9 c [

VT240 DA