.if micro .subtitle $$OPER Running
.page
.else micro
.CHAPTER RT11/TSX OPERATING PROCEDURES
.endif micro
.index Operation
.hl 1 INITIATING RUNOFF
.ifnot small
.br;RUNOFF can be initiated by any standard means.  The _.SAV image file
must be present to run the program.  Also, sufficient memory space must be
available to accomodate RUNOFF code and data.  If the program will not load
and run, it must be relinked to overlay parts of the program from disk.
If the program loads and runs but will not process input files, there
may not be sufficient dynamic memory (memory that is used by RUNOFF to
temporarily store indices, footnotes, substitutions, etc_.).  If this is
the case, then the program must be relinked to make more memory available
for temporary storage.  If this fails, then the program is probably too
large to run on your system.
.endif small
 RUNOFF can be started by typing
.nofill
.s.c ;RUN DEV:RUNOFF_.SAV
.s.c ;or
.s.c ;@COMMND_.COM
.fill
.s;where DEV: is the device on which the RUNOFF_.SAV file is found, and
COMMND_.COM is a command file that initiates RUNOFF and might or might not
contain file specification information.
.br
.hl 1 COMMAND STRING
.index COMMAND STRING
.if micro
.s
.endif micro
.br;The program will prompt you for a
command string. The command string specifies the names of the input
and output files and any options that you might select at run time.
The standard command string (for further information look at the
_.CSIGEN macro in the Programmer's Reference Manual) should be
entered in the following form:
.skip
.nofill
.c ;output-file,toc-file=input-file,input-file,,,,input-file/options
.skip
.fill
where output-file is the document to be produced by RUNOFF, toc-file is
a table of contents file that can be edited before it is reprocessed by
RUNOFF to produce a table of contents, and input-file is a file containing
text and RUNOFF commands to control the format of the output-file
and the toc-file.  
.ifnot small
Up to six input-files can be concatenated to produce
a single document file.  Each input file is processed sequentially and
no parameters are reset between files.
This feature allows control files for different printers to be
processed prior to the text.
Users should construct a control file for each printer with the
appropriate escape sequence definitions and printer specific RUNOFF
commands such as _.PAPER SIZE.
Thus, no file editing will be required to print documents on
two printers or terminals that have different capabilities.
Also, control files can be built to
set parameters for different types of documents (for example: business
letters, technical documentation, or a masters thesis).
For example:
.skip
.c ;DK:THESIS,DK:THESIS=DK:SPIN,DK:CONTRL,DK:THESIS
.skip
where SPIN will define escape sequences for a
NEC Spinwriter printer and set the paper size, and CONTRL will contain
RUNOFF commands to format the document in the customary thesis form.
.skip
The toc-file can be omitted if no table of contents is desired.
The available options can be printed on the user's terminal by entering
only a /I in response to the CSI prompt.
The user can exit from the program back to the operating system
by typing a /X.
.endif small
.br.hl 2 FILE SPECIFICATIONS
.index File Specifications
.if micro
.s
.endif micro
.br;A valid file specification has the form:
.nofill
.skip
.c ;DEV:FILNAM.EXT
.skip
.fill
.ifnot small
DEV: must be a legal device code.
The default device code is DK:, where DK: can be assigned to any
device on the system.  The output-file, toc-file, and input-files
can be on different devices.
FILNAM can be any 1 to 6 character alphanumeric string and EXT can
be any 1 to 3 character alphanumeric string.  FILNAM and EXT must be
separated by a period.  The default EXT's are RNO for the input-files,
DOC for the output-file, and RNT for the table of contents file.
If you use the default EXT's, only the FILNAM need be specified.
The table of contents file must be processed by RUNOFF as an input-file
to produce a table of contents (or DOC file).
.skip
.note Editing RUNOFF Input and Output
The DOC file can be edited prior to printing using any standard RT11
text editor.
The RNT file can be edited to change the contents or format of the
table of contents to be produced by RUNOFF.
.skip
Due to the manner in which RUNOFF processes text files (line by
line), no single input line can be more than 512 characters long.
A line is defined as text terminated by a carriage return and a
line feed.
A line might consist of several sentences or part of a single sentence.
It is good practice (to facilitate future editing) to enter only single
sentences separated by a carriage return and a line feed.
Sentences longer than one screen width can contain as many carriage return
- line feed combinations as necessary.
.en
.endif small
.test page 30
.br.hl 2 OPTIONS
.index Options
.index SWITCHES
The command string can have one or more switch options associated with it.
.ifnot small
A switch option consists of a / and a single ASCII character.
Some switch options can be followed by
a colon and a decimal number or an ASCII character.
Any decimal number can be preceded by a + or - sign, and must be
followed by a period.
.skip
.endif small
The valid switch options are:
.skip
.nofill
.ts +10,+10,+10
/P:l:h	Output only the indicated page range.
.ifnot small
	l = lowest page to print
	h = highest page to print
	This option should be used in conjunction with the
	/A and /C options for chapter oriented text.
.skip
.endif small
/C:l:h	Output only the indicated chapter range.
.ifnot small.skip
.endif small
/A:l:h	Output only the indicated appendix range.
.ifnot small.skip
.endif small
.index Case
/G	Force all text to be output in uppercase.
/G:N	Allow all text to be output as it is input.
.ifnot small.skip
.endif small
.index Formfeeds
/F	Use the standard ascii formfeed character.
/F:n	Simulate the formfeed character with multiple linefeeds.
.ifnot small
	n = paper length
.skip
.endif small
.index Hyphenation
/H	Hyphenate output.
/H:N	Do not hyphenate output.
.ifnot small
	Note: This switch overrides .ENABLE HYPHENATION.
.skip
.endif small
.index Right Shift
/R:n	Right shift output n spaces.
.ifnot small
	Useful for output that is to be bound.
.skip
.endif small
.index Page Size
/S:h:w	Set hardware page size.
.ifnot small
	h = height of page
	w = width of page
.skip
.endif small
.index Underlining
/U:B	Underline with underline character and backspace.
/U:L	Underline with underline character and line overprint.
/U:S	Underline with hyphen on next line.
/U:N	Do not underline text.
.ifnot small
	Note: This command overrides the enable underline command.
.skip
.endif small
/W	Wait for carriage return between pages.
/W:N	Do not wait for carriage return.
.ifnot small.skip
.endif small
/I	Print available switch options on terminal.
.ifnot small.skip
.endif small
/E	Output even pages.
/E:N	Do not output even pages.
.ifnot small.skip
.endif small
/O	Output odd pages.
/O:N	Do not output odd pages.
.ifnot small.skip
.endif small
/X	Exit program and return to operating system.
.ifnot small.skip
.endif small
/2	Perform 2 passes.
/2:N	Perform 1 pass.
.ifnot small.skip
.endif small
/M	Output warning messages.
/M:N	Suppress warning messages.
.ifnot small.skip
.endif small
.index Defaults
.s
Default values are: /G:N/F/H/R:0./S:$DEFPAGL$.:$DEFPAGW$.
.no space;/U:L/W:N/E/O/M/2:N (print all)
.fill