Exchange/SNA Manual

RECEIVE Command
Exchange/SNA Commands
3–36 104700 Tandem Computers Incorporated
If you specify FORMS ON, vertical forms-control information is written to the
receive file. If the receive file is a spooler location or a process, the vertical
forms-control information is translated to the appropriate CONTROL and
SETMODE procedure calls. If the receive file is any type of file that does not
accept CONTROL and SETMODE procedure calls for vertical forms-control,
such as a disk file, the vertical forms-control information is translated to two-
byte BSC vertical forms-control escape sequences, which are written to the
receive file at the beginning of each record. Table 3-3 lists the escape
sequences and the corresponding vertical forms-control information.
If you specify FORMS OFF, no vertical forms-control information is written to
the receive file. If the receive file is a spooler location or a printer, the data is
printed single spaced.
If the receive file is an EDIT-format file, no vertical forms-control information
is written to the file regardless of whether you specify FORMS ON or FORMS
OFF.
If you omit this parameter, the default value is FORMS ON.
TRANSL[ATE] { ON | OF[F] }
specifies whether the data received from the host is translated from EBCDIC
to ASCII before the data is written to the receive file. This parameter controls
the translation of both transparent data and nontransparent data.
If you specify TRANSLATE ON, the data is translated from EBCDIC to ASCII
before being written to the receive file. Use this specification to receive data
from the host that is coded in EBCDIC (assuming you want ASCII data in the
receive file).
If you specify TRANSLATE OFF, the data is not translated from EBCDIC to
ASCII before being written to the receive file. The data is written to the
receive file exactly as received. Use this specification to receive data from the
host that is not coded in EBCDIC.
If you omit this parameter, the data is translated from EBCDIC to ASCII
(TRANSLATE ON).
RE[CSIZE] size
specifies the size of the records to be written to the receive file. The allowed
range is from 1 to 255 bytes.
If you specify a record size, the records are written to the receive file as fixed-
length records of the specified length. If the records received from the host are
larger than the specified record size, the records are truncated. If the records
are smaller than the specified record size, the records are padded with blanks
to the specified length. If FORMS ON is specified and vertical forms-control
escape sequences are written to the receive file, you must allow two bytes in
each record for the escape sequences. For example, if you want 80 bytes of
data and FORMS ON is specified, you must set the RECSIZE parameter to 82.