READ

closing_the_file

 By default, the file is closed after reading, and a subsequent READ
 command of the same file will start reading at the first record.

 If the \CONTINUE qualifier is used, the file will not be closed after
 reading, so that the next READ of the same file will begin reading at
 the next record.

 If the \CLOSE qualifier is used, the file will be closed first and then
 reopened before reading, so the READ will begin at the first record.

MESSAGES

 By default, informational messages are displayed on the terminal
 monitor. If the \NOMESSAGES, or \-MESSAGES, qualifier is used, these
 messages will not be displayed.

vectors

 Syntax: READ file{\line_range} x1{\c1} { x2{\c2} ... } 
         READ\FORMAT file{\line_range} (frmt) x1 { x2 ... } 
         READ\UNFORMATTED file{\line_range} (frmt) x1 { x2 ... } 
 Qualifiers: \ASCII, \UNFORMATTED, \FORMAT, \CONTINUE, \CLOSE, \APPEND
             \ERRSTOP, \ERRSKIP, \ERRFILL, \OVERLAY, \EXTEND, \MESSAGES
 Defaults: \ASCII, \-FORMAT, \-CONTINUE, \-CLOSE, \-APPEND, \ERRSTOP
           \-OVERLAY, \EXTEND, \MESSAGES, cI = I

 By default, vectors are read from columns of numbers in an ASCII file.
 The file is read by records, using free format, and the cI_th column is
 placed into vector xI, cI defaults to I. Every record is read, from
 record 1 to the end of file. If xI exists, it will be destroyed and a
 new xI vector created.

Additional Information on:

scalars

 Syntax: READ\SCALARS file{\n} s1{\c1} { s2{\c2} ... } 
         READ\SCALARS\FORMAT file{\n} (frmt) s1 { s2 ... } 
         READ\SCALARS\UNFORMATTED file{\n} (frmt) s1 { s2 ... } 
 Qualifiers: \ASCII, \UNFORMATTED, \FORMAT, \CONTINUE, \CLOSE
             \ERRSTOP, \ERRFILL, \MESSAGES
 Defaults: \ASCII, \-FORMAT, \-CONTINUE, \-CLOSE, \ERRSTOP, \MESSAGES

 By default, the first record is read from an ASCII file, and, if no errors
 are encountered on the read, the I_th number is placed into scalar sI. New
 scalar variables are created. By default, no scalars will be made if an
 invalid field is encountered on the read. 

Additional Information on:

matrix

 Syntax:
  READ\MATRIX file{\n} matrix nr { nc }
  READ\MATRIX\-FLIPPED file{\n} matrix nc { nr }
  READ\MATRIX\FORMAT file{\n} (frmt) matrix nr { nc }
  READ\MATRIX\FORMAT\-FLIPPED file{\n} (frmt) matrix nc { nr }
  READ\MATRIX\UNFORMATTED file{\n} (frmt) matrix nr { nc }
  READ\MATRIX\UNFORMATTED\-FLIPPED file{\n} (frmt) matrix nc { nr }
 Qualifiers: \FLIPPED, \ASCII, \UNFORMATTED, \FORMAT, \CONTINUE, \CLOSE,
             \MESSAGES
 Defaults: \FLIPPED, \ASCII, \-FORMAT, \-CONTINUE, \-CLOSE, \MESSAGES

 A two dimensional array is read, by records, from an ASCII file.  By
 default, free format is used, and data is taken from the first record.
 The first dimension, nr (nc), must be entered exactly.  A new matrix
 variable will be made with nr rows and nc columns.  If the second
 dimension, nc (nr), is not known, do not enter a value for it, and the
 read will continue until the end of file.  No matrix will be made if an
 error is encountered on the read.

Additional Information on:

text

 Syntax: READ\TEXT file{\line_range} txtvar
         READ\TEXT\FORMAT file{\line_range} (frmt) txtvar
         READ\TEXT\UNFORMATTED file{\line_range} (frmt) txtvar
 Qualifiers: \ASCII, \UNFORMATTED, \FORMAT, \CONTINUE, \CLOSE, \MESSAGES
 Defaults: \ASCII, \-FORMAT, \-CONTINUE, \-CLOSE, \MESSAGES

 By default, this command reads ASCII file records as lines of text. The
 maximum line length that can be read is 255 characters. If only one line
 of text is read, a new scalar text variable will be made. If multiple lines
 are read, a new array text variable will be made. By default, the first
 record is read.

Additional Information on: