MPE/iX Commands Reference Manual (32650-90877)

380 Chapter10
Command List VIII
Commands PASCAL thru PURGEUSER
outfile
Specifies a destination other than $STDLIST for
filename
.If
filename
has
embedded carriage-control characters (CCTL), PRINT inserts a blank in
place of the CCTL in the
outfile
. New files are created TEMP. File
equations are ignored unless an asterisk (*) precedes
outfile
, indicating
a backreference. You must use a file equation to overwrite a permanent
file.
You must use the ;SAVE option in the file equation to overwrite a
permanent file.
If
outfile
is not interactive with the user's $STDIN file, the PAGE
parameter is ignored. (Refer to the FRELATE intrinsic for additional
information on "interactive pair" of files.)
To redirect output to the line printer (DEV=LP), you could use the following
commands:
FILE PRT;DEV=LP;CCTL
PRINT MYFILE;OUT=*PRT
Specifies the record number of the first file record to be displayed. An
m
is
relative to 1. If
m
is a negative number, it specifies a record location
relative to the end-of-file, that is, -5 indicates the fifth record from the
end-of-file. Zero is an invalid specification. Default is the first record of the
file.
For byte-stream files, the first line (or "record") corresponds to the bytes
from the beginning of the file to the first newline character, the second line
contains bytes between the first newline character and the second newline
character, and so on.
n
Specifies the last record of the file to be displayed. An
n
is relative to 1. If
n
is a negative number, it specifies a location relative to the end-of-file, that
is, -5 indicates the fifth record from the end-of-file. Zero is an invalid
specification. Default is the last record of the file.
NOTE
For byte stream files, you cannot display one or more records by specifying a
negative number with the keywords START= or END=. If you try to do so, the
result will be unpredictable because the end-of-file for byte stream files is the
total byte count of the file, and not the number of the last record.
p
Specifies the number of lines to be displayed before a page break occurs.
Default is 23 lines for interactive users and 0 (continuous) for
non-interactive users (that is, in a job). Specifying 0 for
p
suppresses page
breaks in the output and produces continuous output from the beginning
to the end of the file.
If
filename
contains more than
p
records and you are working
interactively, the command displays
p
lines and then prompts you for a
reply indicating whether or not more output is desired, as follows:
(NEXT/EOF) CONTINUE?
NEXT is the next record number to be printed, and EOF is the end-of-file