Trailing-Edge
-
PDP-10 Archives
-
bb-k345a-sb
-
sosug.mem
There is 1 other file named sosug.mem in the archive. Click here to see a list.
SOS
(an advanced line-oriented text editor)
User's Guide
This document reflects version 12 of the software.
The information in this document is subject to change without notice
and should not be construed as a comitment by Digital Equipment
Corporation. Digital Equipment Corporation assumes no responsibility
for and errors that may appear in this document.
The software described in this document is furnished under a license
and may be used or copied only in accordance with the terms of such
license.
Digital Equipment Corporation assumes no responsibility for the use or
reliability of its software on equipment that is not supplied by
DIGITAL.
Copyright (C) 1971,1979 by Digital Equipment Corporation
The following are trademarks of Digital Equipment Corporation:
DIGITAL DECsystem-10 MASSBUS
DEC DECtape OMNIBUS
PDP DIBOL OS/8
DECUS EDUSYSTEM PHA
UNIBUS FLIP CHIP RSTS
COMPUTER LABS FOCAL RSX
COMTEX INDAC TYPESET-8
DDT LAB-8 TYPESET-10
DECCOMM DECsystem-20 TYPESET-11
Page 2
CONTENTS
Page
INTRODUCTION TO SOS 5
TYPOGRAPHIC CONVENTIONS 5
COMMAND FORMAT NOTATION 6
PART I SOS SIMPLIFIED
CHAPTER 1 INPUT MODE 7
1.1 ACCESSING SOS 7
1.2 STORING THE FILE: THE END COMMAND - "E" 8
1.3 CORRECTING ERRORS 8
CHAPTER 2 EDIT MODE 10
2.1 ENTERING EDIT MODE 10
2.2 INDICATING LINE NUMBERS 10
2.3 EDIT MODE COMMANDS 11
2.3.1 The Delete Command - "D" 11
2.3.2 The Insert Command - "I" 11
2.3.3 The Replace Command - "R" 12
2.3.4 The Print Command - "P" 12
2.3.5 The Find Command - "F" 12
2.3.6 The Alter Command (Intraline Edit Mode) - "A" 13
2.3.7 The Substitute Command - "S" 15
2.3.8 The Copy Command - "C" 16
2.3.9 The Transfer Command - "T" 16
2.3.10 The Number Command - "N" 16
2.3.11 The Quit Command (Delete the Entire Edit) - "Q" 17
2.3.12 The End Command (Extension) - "E" 17
2.3.13 The Save World Command - "W" 17
2.3.14 The Go Command - "G" 18
CHAPTER 3 READ-ONLY MODE 19
PART II SOS ADVANCED
CHAPTER 4 FILES 20
4.1 BACKUP AND TEMPORARY FILES 20
4.2 STANDARD TEXT FILES 21
CHAPTER 5 LINE NUMBERS, PAGES 22
CHAPTER 6 EDIT MODE COMMANDS 23
6.1 THE MARK COMMAND - "M" 23
6.2 THE DELETE COMMAND -"D" 24
6.3 THE INSERT COMMAND - "I" 25
6.4 THE REPLACE COMMAND - "R" 27
6.5 THE PRINT COMMAND - "P" 27
Page 3
6.6 THE LIST COMMAND - "L" 29
6.7 THE FIND COMMAND - "F" 29
6.8 THE ALTER COMMAND (INTRALINE EDIT MODE) - "A" 31
6.9 THE EXTEND COMMAND - "X" 35
6.10 THE SUBSTITUTE COMMAND - "S" 36
6.11 THE COPY COMMAND - "C" 38
6.12 THE TRANSFER COMMAND - "T" 39
6.13 THE JOIN COMMAND - "J" 40
6.14 THE NUMBER COMMAND - "N" 40
6.15 THE JUSTIFY COMMAND - "JU" 41
6.16 THE JUSTIFY LEFT COMMAND - "JL" 43
6.17 THE JUSTIFY RIGHT COMMAND - "JR" 43
6.18 THE JUSTIFY CENTER COMMAND - "JC" 43
6.19 THE JUSTIFY WORD COMMAND - "JW" 43
6.20 THE SET COMMAND - "_" 44
6.21 THE GIVE INFORMATION COMMAND - "=" 44
6.22 LINE CONTENTS SPECIFICATION - ALL COMMANDS 45
6.23 THE QUIT COMMAND - "Q" 47
6.24 THE END COMMAND - "E" 47
6.25 THE SAVE WORLD COMMAND - "W" 49
6.26 THE GO COMMAND - "G" 49
CHAPTER 7 READ-ONLY MODE 49
CHAPTER 8 INDIRECT COMMANDS 50
CHAPTER 9 UPPER AND LOWER CASE REPRESENTATION 50
9.1 C128 AND C64 MODES 50
9.2 UPPER AND LOWER CASE 51
9.3 COMBINING MODES AND CASES 51
9.4 MODEL 37 TELETYPE: 37 MODE 53
9.5 ASCERTAINING MODE AND CASE: THE GIVE
INFORMATION COMMAND 53
9.6 SPECIAL CONSIDERATIONS: FIND AND
SUBSTITUTE COMMANDS 54
9.7 SPECIAL "MATCHING" CHARACTERS: FIND AND
SUBSTITUTE COMMANDS 54
APPENDIX A: ERROR MESSAGES 57
APPENDIX B: SUMMARY OF COMMANDS 59
APPENDIX C: DEFAULT VALUES 62
APPENDIX D: ASCII CHARACTER TABLE 63
Page 4
INTRODUCTION TO SOS
SOS is a line-oriented text editor that operates only on sequenced
files. SOS provides the following features:
1. Simple, but powerful, commands. Each command usually
consists of a single-lettered "verb," followed by a number
or range of numbers indicating the line(s) on which the
command is to perform.
2. An "indirect command" file. The user can put a
frequently-used sequence of commands into a file. When the
file is called, SOS will then perform the commands.
3. The full ASCII character set, including lower-case
characters.
4. A search facility. This enables the user to search through
a file with strings of text instead of line numbers.
5. Text-justifying commands.
This manual is divided into two parts: Simplified uses of common
editing commands are presented in Part I, which should be read in its
entirety before any text-editing is attempted. Part II, on the other
hand, describes every command in greater detail, emphasizing more
sophisticated usage. Most of this advanced material is unnecessary
for ordinary editing problems; there are instances, however, in which
these commands can be quite useful.
TYPOGRAPHIC CONVENTIONS
The following typographic conventions are used throughout the SOS
Manual.
* In an example, text which is underscored represents
information typed by the user. Text which is not
underscored is produced by SOS or the DECsystem-10 Monitor.
* The (CR) notation appearing after most lines in the examples
represents the carriage return key (RETURN) on the teletype
keyboard. The DECsystem-10 supplies a linefeed with each
carriage return.
* The (LF) notation represents the linefeed key (LINEFEED) on
the teletype keyboard.
* The (FF) notation indicates a formfeed obtained by
depressing CTRL-L (see "^character" below).
* $ is used to indicate the ALTMODE key. Note that SOS only
Page 5
prints the $ without the circle.
* ^character within a circle represents the control (CTRL) key
and an alphabetic character - e.g., ^U . Note that SOS
does not print the circle. To obtain the control character,
depress the specified alphabetic while holding down the CTRL
key. The DECsystem-10 will print an up-arrow and the
specified character to indicate that it has received a
control character.
* A vertical bar represents the condition "or" - e.g.,
LMAR RMAR means either the left or right margin.
COMMAND FORMAT NOTATION
The following notation is used in SOS command formats:
* Command names appear in capital letters; arguments in lower
case.
* There are no spaces between SOS commands names and
arguments.
* Angle brackets <> enclosing lower-case letters indicate a
string of text consisting of any characters on the teletype
(as long as these characters satisfy the specified
conditions) - e.g., <range> or <filename>.
* Brackets [] indicate an option which may be used or omitted
as desired.
-SOS- Page 6
PART I
SOS SIMPLIFIED
CHAPTER 1
INPUT MODE
1.1 ACCESSING SOS
The user can call SOS by typing the following command to the monitor:
.R SOS(CR)
or
.SOS(CR)
SOS then will request the name of a file by printing "FILE="; the
user-supplied name is typed on the same line as this request.
FILE=<filename>(CR) FILE:
<filename> consists of a 1-6 character alphanumeric "name" (required),
which may be followed by a period and a 1-3 character extension
(optional).
Alternatively, the user may type the filename directly on the command
line and omit the initial conversation with SOS:
.SOS <filename>(CR) .SOS-<filename>
The following examples are all equivalent ways to call SOS:
.SOS(CR)
FILE=EXAMPL(CR)
or
.R SOS(CR)
FILE=EXAMPL(CR)
or
.SOS EXAMPL(CR)
Note that ".R SOS EXAMPL(CR)" is illegal.
If there is no disk file with the supplied name, SOS will indicate
that it is prepared to accept input beginning with line 100 by
printing
-SOS- Page 7
FILE NOT FOUND-INPUT. INPUT:
00100
After printing the line number, SOS waits for the user to type a
string of text followed by (CR); SOS then prints the next line
number, incrementing by 100 each time. When there are no more lines
to input, the ALTMODE or ESCAPE key (appreviated $ ) should be used
after the next line number is printed. The printing of sequence
numbers is terminated, and the user is at the SOS command level as
indicated by the asterisk in the left margin.
.SOS EXAMPL(CR)
FILE NOT FOUND-INPUT
00100 THIS IS LINE 1.(CR)
00200 THIS IS LINE 2.(CR)
00300 $
*
1.2 STORING THE FILE: THE END COMMAND - "E"
Instead of editing immediately after the file is created, the user may
want to store the file on the disk. To do so, he uses the End command
as follows:
*E(CR)
The file will be stored under the name assigned to it when SOS was
called. SOS then returns the user to monitor mode by printing
EXIT
The E command is also used at the end of an editing session (see
Section 2.3.12); if the End command is not used, the unedited copy of
the file will be retained, and the edited copy will be lost.
1.3 CORRECTING ERRORS
Typographical errors can be corrected in an input line, provided they
are noticed before (CR) is typed.
1. RUBOUT. To delete individual chatacters, Rubout should be
depressed once for every character being deleted, back to and
including the error. The deleted characters are enclosed in
single backslaches ("\"):
00100 THIS IS TI\I\HE FIRST LINE
In the above example, the user typed RUBOUT once after he typed
the "I" of "TI". "\I" is printed to indicate that SOS deleted
the "I". The next character typed in (other than another
RUBOUT) is accompanied by the second backslash - "\H".
-SOS- Page 8
2. CTRL-U. To delete the entire input line, strike U while
holding down the CTRL key - ^U . SOS will perform a carriage
return/linefeed, but will not print a new line number; instead
it will wait for input which will be associated with the last
number.
00100 THIS IS TEH ^U
THIS IS LINE 1.(CR)
00200
-SOS- Page 9
CHAPTER 2
EDIT MODE
2.1 ENTERING EDIT MODE
There are two ways to enter edit mode. During the input sequence, if
an existing file is specified, SOS will recognize the filename, print
an asterisk, and wait for user commands. Any editing, then, is
performed on the named file.
.R SOS(CR)
FILE=<filename>(CR)
EDIT.
*
or
.SOS <filename>(CR)
EDIT.
*
To complete the editing of a new file, on the other hand, the user
should strike the ALTMODE key ( $ ) at the end of the input sequence;
this places him at the SOS command level. He can either store the
file for subsequent editing by using the E command, or else he can
utilize any of the editing commands listed below and in Part II.
.SOS EXAMPL(CR)
FILE NOT FOUND-INPUT
00100 THIS IS LINE 1.(CR)
00200 THIS IS LINE 2.(CR)
00600 $
*
2.2 INDICATING LINE NUMBERS
SOS recognizes certain abbreviations which can be employed in commands
requiring line numbers. The Print command is used in the following
examples to illustrate these abbreviations:
1. A colon between two numbers is used to indicate a range of
lines between, and including, the two endpoints.
*P100:200(CR) Print lines 100 through 200
inclusive.
2. A period is used to represent the current line, as determined
by the last command which actually specified a line.
-SOS- Page 10
*P0:(CR) Print line 0 through the current
line.
3. An asterisk represents the last line of the file.
*P0:*(CR) Print all the lines of the file.
*P.:*(CR) Print the current line through the
last line of the file.
2.3 EDIT MODE COMMANDS
2.3.1 The Delete Command - "D"
The D command corrects an error by deleting an entire line or lines.
*D200(CR) Delete line 200.
*D100:200(CR) Delete lines 100 through 200
inclusive.
2.3.2 The Insert Command - "I"
The I command is used to indicate that new lines will be inserted,
beginning at the stated sequence number. The line increment is 100 by
default, unless specifically changed.
*I200(CR) Accept input lines beginning at
line 200, with the default
increment of 100.
The increment is changed as follows:
*I200,50(CR) Accept input lines beginning with
line 200, using the increment of
50. The default increment for
subsequent I commands is 50.
If there already is a line with the specified sequence number, SOS
will determine a different line number for the insert by adding the
line number specified in the command to the current increment. If a
line exists between the line specified by the command and the next
line determined by the increment (e.g., "*I200,50(CR)" and line 210
exists), SOS will choose a line number halfway between these two lines
(i.e., line 205). If any subsequent line being inserted already
exists, or if an existing line in the file falls between two lines
determined by the Insert command, then the insertion process will
terminate and the user will return to SOS command level. The sequence
of line numbers may be terminated at any time using the ALTMODE key,
-SOS- Page 11
which will return the user to command level.
00200 THIS IS INSERTED.
00250 $
*
2.3.3 The Replace Command - "R"
The Replace command is a combination of the Delete and Insert
commands.
*R200(CR) Delete line 200 and accept input
beginning at that line.
*R200:300,50(CR) Delete lines 200 through 300
inclusive, and accept input to be
inserted in lines 200 through 300,
with an increment of 50.
SOS responds with the number of the first line to be replaced.
2.3.4 The Print Command - "P"
The Print command tells SOS to print specified lines on the user's
teletype.
*P(CR) Print all the lines of the file.
*P200(CR) Print line 200.
*P100:200(CR) Print lines 100 through 200
inclusive.
*P0:*(CR) Print all the lines of the file.
*P.:*(CR) Print the current line through the
last line of the file.
If SOS is ready to accept a command, striking (LF) will cause the next
line of the file to be printed, while striking $ will cause the
previous line to be printed.
2.3.5 The Find Command - "F"
SOS can locate an arbitrary text string within a file without having
the line number specified:
*F<text> $ (CR) Search for the first occurrence of
the given string of text starting
-SOS- Page 12
with the current line.
Note that immediately after the file is opened for editing, the
"current" line is the beginning of the file.
It is also possible to search through a range of line numbers for the
first occurrence of a given text string:
*F<text> $ 100:350(CR) Search for the first occurrence of
the string of text in lines 100
through 350 inclusive.
If the specified text is located, the line and line number where it
first occurred will be printed. If the specified text does not exist
within the given (or implied) range, SOS will indicate that the search
has failed and return the user to command level:
%SEARCH FAILS
*
Giving another F command with no arguments will continue the search in
the stated range and cause SOS to print the next occurrence of the
given text string (line number and content). If there is no other
occurrence, SOS will print %SEARCH FAILS and return to command level.
For example,
*FOLD $ 100:500(CR) Search for the first occurrence
00150 THIS IS AN OLD LINE. of OLD in lines 100 through 500
*F(CR) Search for the next occurrence
0200 THERE WAS AN OLD MAN. of OLD after line 150 and
through line 500.
2.3.6 The Alter Command (Intraline Edit Mode) - "A"
It is possible to change or alter the line with the Alter command.
*A200(CR) Alter line 200.
The A command places the user in a special intraline editing mode
which has its own commands (described below). In this mode, the
commands themselves will not appear on a full-duplex teletype,
although any accompanying user-supplied text will.
The intraline edit mode maintains a pointer within the line indicating
the next character in the line that the next command will affect.
1. Moving the Pointer (Space Bar and Rubout)
To advance the pointer one position to the right, strike the space
bar once. The character that is passed over is printed on the
teletype. If the pointer is already at the extreme right of the
line, this command is ignored.
-SOS- Page 13
To move the pointer to the left, use RUBOUT once for each
character being passed over. (Note that this does not delete
anything as it would in input mode.) The character(s) passed over
are printed between single baskslashes (\XX\). (The second
baskslash is printed when the next non-RUBOUT command is given).
If the pointer is already at the extreme left of the line, a
carriage return/linefeed is automatically done. The line number
will be reprinted, and the pointer will again point to the
beginning of the line.
2. The "D" Command (Delete)
To delete the character pointed to, type "D" once for each
character being deleted. The deleted character(s) will be printed
within double backslashes (\\X\\). (The second double backslash
is printed when the next non-D command is given.) The pointer then
will point to the right of the last character deleted. If this
command is preceded by a number, only the last three deleted
characters will be printed and enclosed in double backslashes.
The command is ignored if the pointer is at the extreme right of
the line.
3. The "I" Command (Insert)
To insert text immediately before the character indicated by the
pointer, use the I command as follows:
I<text> $
Only the inserted text is printed on the teletype. The pointer
then will be at the character to the right of the inserted
material.
4. Terminating Intraline Editing: (CR) and the Quit Command
When no more editing is necessary, the user should strike (CR).
This causes that portion of the line to the right of the pointer
to be printed and ends the intraline edit mode. SOS then returns
to command level.
The Q command terminates intraline editing mode without making any
of the indicated intraline changes. SOS then returns to command
level.
5. ^U (RESTART)
To reedit a line, type U while holding down the CTRL key - ^U .
The line will be restored to its origional state, and intraline
editing can be resumed as soon as the line number is reprinted.
This is equivalent to typing a Q command during intraline edit
mode and then issuing an Alter command followed by a period (after
the SOS command asterisk):
<line>Q
*A.(CR)
-SOS- Page 14
6. The "S" Command (Skip)
The S command will move the pointer to the right until the next
occurrence of a specified character:
S<character>
Every character passed over will be printed. The current
character is automatically passed over and is not compared to the
character specified in the command.
If the character does not occur in the remainder of the line, the
pointer will move to the extreme right.
The following example illustrates intraline edit mode and pointer
movement. Remember that user commands are not printed on the
full-duplex teletype when this mode is utilized.
*A200(CR)
SX D IW $ (CR) User Input
00200LET\\X\\W=A+B+C SOS Printout
The user wants to alter line 200 ("LET X=A+B+C"). The pointer is
at the first character of the line ("L). After "SX" is typed, the
pointer skips to "X", and SOS then prints "LET" on the teletype.
To delete the "X", the user issues a D command. SOS then prints
"\\X", and moves the pointer to the charater which follows the
deleted character (that is, to the "="). Typing "IW $ " completes
the deletion process by printing another "\\"; "W" is inserted to
the left of the pointer and printed on the teletype. (CR) causes
the rest of the line to be printed and returns the user to command
level.
2.3.7 The Substitute Command - "S"
Sometimes the same string of text occurs frequently in a file, and it
would be time-consuming for the user to perform intraline editing in
every line that the string is found. SOS provides a command that
allows the user to substitute one string of text for another with some
range in the file:
*S<oldtext> $ <newtext> $ 100:350(CR) Substitute the <newtext> for
the <oldtext> in the range
specified.
NOTE
If no range is included in the command,
substitution will be only done for one
line.
-SOS- Page 15
2.3.8 The Copy Command - "C"
To duplicated some line or group of lines within a file, use the Copy
command. This command acts like an Insert command; the line(s)
specified are copied but not printed on the teletype.
*C200,100(CR) Copy the contents of line 100 into
a new line numbered 200.
*C1000,100:500,50(CR) Copy a portion of the file (lines
100 through 500) into a new
location beginning with line 1000.
As each line is copied, the
increment between lines will be 50.
If a specified increment is too large for the specified range, an
error message ("%OUT OF ORDER" OR "%WRAP AROUND") will be printed, and
SOS automatically will indicate that it has chosen a smaller increment
by typing
INC1=<number>
If SOS cannot choose a small enough increment, it will use the given
increment and copy as many lines a possible into the available space.
As a result, only part of the text will be copied and an "%OUT OF
ORDER" error message will be given. To finish copying the rest of the
specified range, edit mode must be terminated with an End command.
During the next editing session, the file must be resequenced and then
the copy can be completed.
2.3.9 The Transfer Command - "T"
The Transfer command moves a set of lines from one part of a file to
another. It is similar to the Copy command, but it also deletes the
original range immediately after the transfer is completed.
*T1000,100:500,50(CR) Copy lines 100 through 500 into the
location beginning with line 1000,
using the increment 50; then
delete lines 100 through 500.
2.3.10 The Number Command - "N"
The Number command alters the numbers of currently existing lines; it
should be used if an "%OUT OF ORDER" or a "%WRAP AROUND" error message
occurs.
*N50,100:500,1000(CR) Renumber lines 100 through 500,
starting at line 1000, with the
increment of 50.
-SOS- Page 16
*N50,100:500(CR) Renumber lines 100 througu 500,
starting at line 50, with an
increment of 50.
*N100(CR) or Resequence the entire file starting
at line 100 with an increment of
100.
*N(CR)
2.3.11 The Quit Command (Delete the Entire Edit) - "Q"
Should the user realize that the current editing session is worthless,
the Quit command will return him to the monitor without saving the
edited version of the file:
*Q(CR) No longer ture.
SOS will indicate the exit as follows:
EXIT
The original file (if there was one) is still intact after the Quit
command.
2.3.12 The End Command (Extension) - "E"
To differentiate an edited file from the origional, the new version
may be filed separately under a different name by using the End
command and the new filename.
*E<filename>(CR)
This leaves the original file under its original name. SOS then
returns the user to the monitor.
EXIT
2.3.13 The Save World Command - "W"
The Save World command is the same as the E command except that it
leaves the user in command mode rather than returning him to the
monitor. This is used to save the current version of the file in case
the system crashes, and should be done every fifteen minutes while the
user is in edit mode. If the system does crash, the user will lose
only the editing that was done since the last W command was issued.
It is also possible to use a new name for the edited version with the
W command (just as in the extension of the E command). The new name
-SOS- Page 17
only has to be given once, an any subsequent W commands will recall
the new filename.
*W(CR)
or
*W<filename>(CR)
2.3.14 The Go Command - "G"
The G command is used after the user issues a program execution
command such as EXECUTE, LOAD, COMPILE, etc., and then edits a file.
A filename that has been given to SOS is saved, so that calling SOS
(".SOS(CR)") again with no filename will immediately put the user in
edit mode for the last file specified.
Once editing is completed, the G command will write the file onto the
disk (like the E command) and will cause the previous program
execution command to be repeated.
The following debugging sequence illustrates G command usage:
.SOS EXAMPL.CBL(CR) SOS assumes input mode and is ready
FILE NOT FOUND - INPUT. to accept lines of text beginning
00100 with line 100 (SOS also "remembers"
. the name EXAMPL.CBL).
.
.
nnnnn $ End input and give command to user.
*E(CR) The E command will save the input
EXIT under the filename EXAMPL.CBL.
.EXECUTE EXAMPL.CBL(CR) The user issues the Monitor command
. "EXECUTE EXAMPL.CBL".
.
. The program did not execute
. correctly; the user must edit the
. source file.
.
.SOS(CR) SOS "remembers" EXAMPL.CBL, because
EDIT. it was the last filename used, and,
* therefore, assumes edit mode.
.
.
.
*G(CR) The user performs some editing in
. the program. The G command will
. save the file
. as E did and will begin
. compilation, loading, and execution
. of EXAMPL.CBL.
.
-SOS- Page 18
.
.
.SOS(CR) More execution problems.
EDIT. Edit EXAMPL.CBL again.
*
.
.
.
*G(CR) EXECUTE again.
.
.
.
3.0 READ-ONLY MODE
SOS allows the user to access his file in a "read-only" mode if
"/READONLY" (or "/REA") is included in the input sequence.
.SOS(CR)
FILE=<filename>/READONLY(CR)
or
.SOS<filename>/READONLY(CR)
This mode permits the user to find information in his file, but does
not allow him to perform any editing.
-SOS- Page 19
PART II
SOS ADVANCED
4.0 FILES
4.1 BACKUP AND TEMPORARY FILES
Consider the following situation. After a file is created, it is
stored on the disk under a specified name such as PROG.FOR (See
Section 1.1).
When the user is editing this file and gives an End, Save World, or Go
command, a backup file (in this case, PROG.BAK) is created. This
backup file contains the origonal version of PROG.FOR, while the newly
edited version will be stored under PROG.FOR.
If the E, W, or G command specifies a filename, no backup file is
created. The orininal copy of the file is still named PROG.FOR; the
edited version will have the new filename as its name.
During the editing process, SOS successively copies a file. In input
mode, if lines are inserted in the correct sequence order, the file
can be written out as needed with no wraparound to the start of the
file. If material is inserted out of order, however, it may be
necessary to wrap around. SOS does this by copying the file over from
the beginning of the file to the location specified in the command.
With subsequent commands, SOS will recopy additional portions of the
file.
When editing an already-existing file, SOS is careful not to make
changes in the old version until the new version is complete. Then
wraparound is required, three files may exist simultaneously: the
original; a partially-edited copy which contains the entire file with
all changes up to the last wrap around ("TMP" file - see below); and
a partial copy of that file up to the current position ("TEM" file).
SOS is always writing this partial copy into a file called
"nnnSOS.TEM" (where "nnn" is the user's job number). If recopying is
necessary, SOS will rename the file "nnnSOS.TMP" and use it as input.
At any time during an edit, SOS will read either the user's original
file or the "nnnSOS.TMP" file. Thus, if an "nnnSOS.TMP" file exists,
it is complete up to the last time SOS had to recopy the partial edit.
When an "E", "G", or "W" command is given, SOS will finish copying the
edit into the "nnnSOS.TEM" file and rename it either the name
specified in the "E", "G", or "W" command, or the original name given
when editing began.
During an edit, SOS prints "EXIT" and returns the user to the monitor
whenever one of the following error messages occurs:
-SOS- Page 20
Error message Explanation
%NO DISK AVAILABLE The disk which the user requested
is not available.
%TEMPORARY EDIT FILE IN USE The file name which SOS assigns to
the temporary file is already being
used. This situation should not
occur. If it does, the user should
issure the Monitor command "DEL
*.TMP,*.TEM(CR)" to delete all
temporary files.
%DEVICE OUTPUT ERROR Output error - no recovery will be
attempted.
%DEVICE INPUT ERROR Input error - no revovery will be
attempted.
%INTERNAL CONFUSION SOS has just encountered an
or internal conflict - a systems
%ILLEGAL UUO programmer will be needed.
Although "EXIT" is called and the edit is lost, the original file is
not harmed. If a Save World command had been given prior to any of
these errors, however, the original file would contain all editing
changes performed before the W command was issued.
If the error message, "%ILLEGAL LINE FORMAT" occurs during an edit,
the user probably had a line with a carriage return but no linefeed or
vice versa. Issuing a Replace command will correct the situation.
4.2 STANDARD TEXT FILES
SOS utilizes a Standard Text File, containing Standard Text Lines and
Standard Page Marks. Standard Text Line format is a line number
composed of a string of five seven-bit ASCII digits, left-justified in
a single word with a 1 in bit 35. This line number is followed by a
TAB and the text (147 or fewer ASCII characters, not including the
carriage return/linefeed). Each disk file word is left-justified and
consists of five ASCII characters and a 0 in bit 35. The first
character which follows the line number is a TAB and the last two
characters are (CR)(LF). The characters NULL and DELETE may not
appear in the text. If necessary, the last disk file word for the
line is filled with NULLs to make a complete word.
A Standard Page Mark is a word containing 5 ASCII spaces,
left-justified in a word with a 1 in bit 35, followed by a word
containing the characters (CR),(CR),(FF),NULL,NULL, with a 0 in bit
35. Standard Page Mark usage is discussed in Chapters 5 and 6.
Lines are never broken across physical disk block boundaries, and all
unused words in a disk block are 0.
-SOS- Page 21
If the specified file was created by using an editor that does not
assign line numbers, SOS will assign a number to each line as it reads
the file, beginning with 100 and incrementing by 100.
5.0 LINE NUMBERS, PAGES
Throughout Part I, it was assumed that a file was entirely contained
in one continuous group. This is a feasible way to structure a file;
however, when a file is large, it is advantageous to divide it into
pages. For every command that includes a line number specification,
there is also a page qualification. Thus, a single line (<line>) may
be specified by both the line number and page number as follows:
<line number>/<page number>
The line number must be in the range 0 to 99999; the first page is 1,
and there is essentially no upper limit. A range has the form
<line number>/<page number>:<line number>/<page number>
A range includes all text up to and including the endpoints.
Instead of a number, the symbol "." may be used to denote either the
current line or the current page, depending on whether it appears
before or after the "/". Therefore, "100/." means line number 100 on
the current page and "./2" means the line on page which has the same
number as the current line number. The current line and page are
determined by the last command which was executed (or, generally, by
the last line on which an operation was performed and the page on
which that line appears).
The symbol "*" may be used to specify the last line on the page, but
it may not specify the last page.
Line and page specifications may be further abbreviated as follows:
Abbreviated Specification Full Specification
100 100/.
100:500 100/.:500/.
100/2:500 100/2:500/2
/2 0/2:*/2
/2:/5 0/2:*/5
0/1:. 0/1:./1
Addition and subtraction can also be used in line and page
specifications. While the arithmetic is straight forward for pages,
it is not for lines because of varying increments and prior editing
-SOS- Page 22
changes. A count either goes forward ro backward from the indicated
line to include the number of lines specified. Another form of the
range specification extends the ability to use the counting technique.
The starting line is specified in one of the above ways and is
followed by an "!" and the number of lines desired.
Line specifications using arithmetic cannot cross page boundaries,
except those with the "!" which may cross page boundaries if
necessary.
Special Specification Equivalent Specification
100+2 the second line after line 100
100!3 line 100 and the two subsequent lines
/5-3 /2 or page 2
/.+2 the second page after the current page
/.-1 the previous page
.-1:.+1 three lines, including the current line
*+2 *
0-5 0
*!2 */.:0+1/.+1
last line on current page and first line on
next page
6.0 EDIT MODE COMMANDS
6.1 THE MARK COMMAND - "M"
The M command will insert a page mark into the text, immediately
before the line specified. Note that page mark 1 is always assumed
when input is begun.
*M<line number>/<page number>(CR)
If the line that is specified does not exist, the page mark will be
inserted immediately after the line with the next lower number on that
page. If the line specified is the first on that page, the new page
mark will be placed immediately after the already-existing page mark;
therefore, the page that already existed will not have any
accompanying text. If the page specified in the M command does not
exist, the error message "%NO SUCH PAGE" will be printed and no page
mark will be inserted. Note that the page mark always precedes the
-SOS- Page 23
related text.
Inserting a page mark causes renumbering of all subsequent pages. The
current line is set to zero; the current page is considered the one
just created. When the user is inserting text, the command
*M99999(CR)
will place a page mark at the end of the current work, and the next
insertion will go on the next page.
6.2 THE DELETE COMMAND - "D"
The Delete command will delete all the lines of a specified range:
*D<range>(CR)
If there are no lines in the specified range, SOS will respond with
the error message "%NO SUCH LINES(S)".
Lines in a range are specified in the usual manner; exceptions are
noted below:
1. The Delete command does not allow a page specification for the
second line number of a range. All deletions extend,
therefore, over one page only, even if the "!" is used.
*D100/2:200/3(CR) This is an illegal command; SOS
will respond with an appropriate
error message.
2. The Delete command will delete a page mark, not the contents of
the given page:
*D/5(CR) Delete page mark 5 (not the
contents of page 5)
The numbers of the succeeding page marks are decreased by one.
Deleting a page mark may result in the creation of a page with
line numbers that are out of sequence. If so, SOS will print
the message "%OUT OF ORDER". In such a case, it is necessary
to renumber the page immediately.
Page mark 1, or any page mark which does not exist, may not be
deleted. If deletion is attempted, the error message "%NO SUCH PAGE"
will be printed.
All lines on a page may be deleted as follows:
*D/:99999(CR) Delete all lines on page 2.
The current line and page will be set to the last line deleted on the
-SOS- Page 24
specified page.
6.3 THE INSERT COMMAND - "I"
The Insert command, which is used to insert new lines into a fie,
accepts a single line specifier (line number/page number) as its first
argument and begins inserting at that line. The Insert command may
also be used to change the current default increment between lines, in
which case the increment is preceded by a comma.
*I[<line>][,<increment>](CR)
or
*I[<line>][;<increment>](CR)
Thus,
*I100/2,50(CR) Insert lines starting with line 100
on page 2 and set the current
increment to 50.
*I100/2;50(CR) Insert lines starting with line 100
on page 2. Use the increment of
50. NOTE: The semi-colon
indicates that 50 is a temporary
increment to be used only while
this command is in effect. The
current increment will remain
unchanged and will be used again
for the next command.
*I100/2(CR) Insert lines starting with line 100
on page 2 using the current
increment (since no increment is
specified). NOTE: At the
beginning of edit mode, the current
increment is 100.
After a specified line is actually inserted, SOS will add that line
number to the correct increment to obtain the number of the next line
to be inserted.
If there already is a line with the same number as the specified line
number, the line number of the existing line is added to the correct
increment and insertion begins there. If there already is a line
located between the two line numbers (or at the second line number),
SOS will select a line number that is halfway between the indicated
line number and the next line in the file. For the next insertions,
if a line already exists at the location determined by the increment,
or if it is necessary to pass over a line which already exists, then
insertion mode will terminate and the user will be returned to command
level.
-SOS- Page 25
In the following example, lines 100 and 200 already exist; the
current increment is 100:
*I100(CR)
00150 THIS IS A LINE(CR) SOS selects line 150 to begin
insertion.
The user is returned to command
level since line 200 already exists
and must be passed over (200 is
between 150 and 250).
If a line insertion is terminated with an $ , the text preceding the
$ is inserted, and the user is returned to command mode. If nothing
has been inserted and $ is used, an empty line will not be inserted,
although the user will be returned to command level.
The current line number and page become the last line actually
inserted, not the empty line terminated with $ . In addition, after
$ is typed, SOS will remember the line number and page of the next
line to be inserted; these will be used if the I command is given
later with no argument. The increment will be the same as the
increment used in the most recent complete command, including those
commands with the temporary (";") construction.
*I100;100(CR)
00100 THIS IS LINE 1.(CR)
00200 THIS IS LINE 2.(CR)
00300 $
*P100(CR)
00100 THIS IS LINE 1.
*I(CR)
00300 THIS IS LINE 3.(CR)
00400 .
.
.
If a page which does not exist is specified, SOS will respond with
"%NO SUCH PAGE".
If an attempt is made to insert a line which contains more than 147
characters (not including the return/linefeed at the end), SOS will
print "%LINE TOO LONG". The line will not be inserted, and SOS will
return to command mode.
If the next line to be inserted has a line number greater than 99999,
insertion will terminate and the user will be in command mode.
An increment of zero will result in the error message "%ILLEGAL
COMMAND".
-SOS- Page 26
6.4 THE REPLACE COMMAND - "R"
The Replace command is the same as the Delete command followed by the
Insert command. Replace accepts a range specifier and an optional
increment, which can be either temporary (";") or an actual (",")
update of the current increment.
*R<range>[;<increment>](CR)
or
*R<range>[,<increment>](CR)
The deletion is performed on the specified range, and insertion begins
with the first line indicated by that range. If the first line is not
stated explicitly, the line number of the first line deleted will be
used as the starting point for insertion.
*R/2,50(CR) Replace all lines on page 2 and
insert new lines, beginning with
the first line deleted, using an
increment of 50.
Although the Delete command will delete a page mark and not the
contents of that page, the Replace command will delete all of the
lines on the specified page and then allow insertion.
*D/2(CR) Delete page mark 2
*R/2(CR) Delete all the lines on page 2
Insertion may be terminated by depressing $ after SOS has printed
the next line number. As in the Insert command, if $ is used after
some of the text has been typed, that text will be inserted and
command mode will be reinstated.
6.5 THE PRINT COMMAND - "P"
The Print command will print out the lines specified in a range,
including the line numbers.
*P[<range>][,<options>](CR)
If the range includes the boundary between two pages, "PAGE N" also
will be printed to indicate the position of the page mark.
*P100/1:100/2
00100 THIS IS A LINE
00200 THIS IS A LINE
.
.
.
PAGE 2
00100 THIS IS A LINE
-SOS- Page 27
The second argument, if given, consists of one or more of the
following options, separated by commas.
<Option> Explanation
N Number pages Print page numbers at the bottom of
the page.
Suppress line #s Don't print line numbers and page
numbers and suppress the asterisk
indicating that SOS is ready for
the next command.
E Eject Eject at bottom of a page.
W Wait At the bottom, wait for a line.
F Final Copy Equivalent to S, E, and W options
combined.
The "bottom of the page" is determined by a page mark or an exceeded
length (the default is 55 lines).
"Wait for a line" means that SOS will wait at the bottom of each page
while the user types an additional line, followed by a carriage
return, or a return only (if no line is added). Typing a "G" only
will suppress the wait option in the remainder of the printout.
Typing a "Q" only will stop the printout and return the user to
command mode. Typing ^O will suppress a printout in progress.
Since SOS is still moving the output to a buffer area, typing another
^O will resume the printout at some later point in the output. If
all output has been passed to the buffer area, the user is returned to
command level.
Common abbreviations used with Print are as follows:
*P(CR) Print 16 lines, beginning with the
current position; the same as
"*P.!16(CR).
*(LF) Print the next line of the file.
* $ Print the previous line of the
file.
*P/.(CR) Print all the lines of the current
page; the same as "P0:*/.(CR)".
The current line number and page are determined by the last line
actually printed.
If there are no lines in the specified range, SOS will print the error
message, "%NO SUCH LINE(S)".
-SOS- Page 28
6.6 THE LIST COMMAND - "L"
It is also possible to have the file, or a part of it, printed out on
the line printer:
*L[<range>][,S](CR)
If no range is specified, the entire file will be listed. The "S"
option for suppressing line numbers and headings is the same as the S
option used in the Print command. In this case, however, the asterisk
will not be suppressed, and SOS will indicate that it is ready for the
next command.
As with Print, the List command determines the current line number and
page by the last line printed. Line printer output will have suitable
page headings of the top of each page. These include the name of the
file, the time and date of the printing, and the page given in the
form "M-N". "M" is the actual SOS page on which this text can be
found; "N" denotes the Nth page of line printer output comprising
page M.
6.7 THE FIND COMMAND - "F"
The Find command is used to locate a given string of text within a
stated range (note that the options are discussed separately below).
*F[[<string>] $ [<range>][,<options>]](CR)
SOS will find the first occurrence of the string in the range and
print the line containing that string. If the range includes more
than one page and if the string is found on a page other than the
first one of the range, SOS will print "PAGE N" before the line number
to indicate on which page the line is located. If the string does not
occur in the specified range, SOS will print "%SEARCH FAILS".
To find the first occurrence of a given text on a specific page,
simply precede the page number with a "/" as follows:
*FLINE $ /2(CR) Find and print out the first line
on page 2 containing "LINE".
To locate the same string specified in the last Find command, only use
the range argument.
*F $ /3(CR) Find and print out the first line
on page 3 containing "LINE" (from
the previous Find command).
If no previous Find command was issued, SOS will print "%NO STRING
GIVEN" since no string had been specified.
If the range is omitted, then SOS will begin its search at the line
following the current line and continue through the end of the file.
-SOS- Page 29
*FALWAYS $ (CR) Find the first occurrence of
"ALWAYS" beginning with the line
following the current line through
the end of the file.
To indicate a range beginning with the next line through a specified
location, it is necessary only to specify the second half of the
range.
*FALWAYS $ :/5(CR) Find the first occurrence of
"ALWAYS" in the range from the next
line through the end of page 5
(assuming the current position is
before page 5).
Note that if this particular range specification were used in any
other command (except Substitute), SOS would print the message
"%ILLEGAL COMMAND".
When the Find command is given repeatedly, it is not necessary to
specify the text and range when referring to the same text and range
given in the last complete Find command.
*F(CR) Continue to find the text
(specified previously). The search
begins with the line after the last
line that was found; the end of
the range is the endpoint specified
in the last complete Find command.
*F $ (CR) Continue to find the text
(specified previously) through the
end of the file (since no range had
been specified).
The current line will be set to the last one found. If the error
message "%SEARCH FAILS" is printed, the string cannot be located in
the remaining portion of the range. In this instance the value of the
current location will be unchanged.
If is possible to use an extended form of the Find command to find up
to six strings of text. The carriage return separates the text
strings:
*F<string1>(CR) Search for any occurrence of any of
<string2>(CR) the strings (totalling fewer than
. 200 characters) in the range
. specified.
.
<stringn> $ <range>(CR)
OPTIONS
-SOS- Page 30
The complete Find command format including options, is as follows:
*F[[<string>] $ [<range>][,A ,N][,E][,<number>]](CR)
options
Find command options are defined below:
A Enter intraline edit mode automatically when the
string is found. This moves the intraline pointer
to the first character of the string. If
intraline editing is complete and "*F(CR)" is
issued, the A option will still be in effect.
(This is the same for the N and E options
discussed below).
N Find just the line numbers of the locations of a
given string. N follows the range specification
and cannot be used with the A option. N will
still be in effect if an "*F(CR)" is issued.
E Do not treat upper and lower case letters as being
equivalent. E follows the range, or A or N if
either is present. E will still be in effect if
an "*F(CR)" is issued.
<number> "<number>" specifies the number of lines to be
found - 99999 usually will find them all. This
option can be used instead of repeating "*F(CR)"
until the string no longer can be found within the
range specified in the first complete Find
command.
6.8 THE ALTER COMMAND (INTRALINE EDIT MODE) - "A"
The Alter command (referred to by the Find command) is used to make
changes within a line without having to retype the line. The Alter
command accepts a range specifier indicating those lines to be atered.
*A<range>(CR)
For each of the lines in the range, SOS prints the line number, and
then enters a special intraline edit mode which has its own commands.
A pointer, maintained within the line, points to the next character in
the line that will be affected by the next command. The special
intraline edit commands do not appear on the user's teletype. Thus,
the line shown on the teletype at the end of the intraline edit is
exactly the same as it is in the file (except for the backslashes and
the characters between them). Any command in this mode may be
preceded by a number which will cause the command to be repeated for
that number of characters. The line number of the next line in the
range will be typed out automatically as soon as intraline editing is
completed on the present line.
-SOS- Page 31
The current line is determined by the last line edited.
If there are no lines in the specified range, SOS will print the error
message "%NO SUCH LINE(S)"
INTRALINE COMMANDS
SPACE This will advance the pointer one position to the
right. The character that is passed over is printed
on the teletype. If the pointer is already at the
extreme right of the line, this command is ignored.
RUBOUT This moves the pointer one character to the left.
This does not delete anything as it would ordinarily
in input mode. The characters moved over are
printed between single backslashes (\XXX\). If the
pointer is already at the extreme left of the line,
a (CR)(LF) is automatically performed. The line
number will be reprinted, and the pointer will again
point to the beginning of the line.
C<character> This causes SOS to accept the next character from
the teletype. The character pointed to will be
replaced by the new character, and the pointer will
be moved one character to the right. The character
accepted from the teletype is printed on the line in
place of the one that is deleted. If the pointer is
at the extreme right of the line, the command is
ignored. During this command, any RUBOUT that is
used will be ignored. (LF),(CR), and $ will abort
the remainder of the command.
D This will delete the character pointed to. The
character(s) deleted will be surrounded by double
backslashes (\\XXX\\). The pointer will point to
the right of the last character deleted. If the
command is preceded by a number, only the last three
characters that were deleted will be printed and
enclosed in double backslashes. The command is
ignored if the pointer is at the extreme right of
the line.
I<string> $ This will insert the given string into the line
immediately before the chracter to which the pointer
points. The pointer remains pointing to the
character to the right of the inserted string. The
characters being inserted are typed out on the
teletype.
If RUBOUT is typed before the $ , the last
character that is inserted will be deleted. If more
RUBOUTs are typed than characters inserted, the
characters to the left of the insert are deleted.
-SOS- Page 32
The characters deleted are surrounded by single
backslashes. If enough characters are inserted to
make the line exceed 147 characters, the message
"%LINE TOO LONG" is printed, and SOS will return the
user to command mode without performing any of the
alterations specified for that line.
If a (CR) is typed before the $ , the insert will
be terminated; intraline edit will terminate as in
the (CR) command.
If a (LF) is typed before the $ , a (CR)(LF) is
inserted at that point. This creates a new line
consisting of any subsequently inserted characters
and the rest of the old line to the right of the
pointer. The number of the new line is determined
as follows:
1. If the I command is preceded by a number, this
number acts like a temporary increment and is
added to the current line number to obtain the
new line number.
2. If the I command is not preceded by a number,
then the new line number is determined by adding
the current increment to the current line
number. The new line is inserted at this number
unless it would be out of order.
3. If the new line would be out of order in (2)
above, the new line number will be halfway
between the current line number and the next
line number. If the next line number is only
one more than the current line number, an "%OUT
OF ORDER" error message will be printed. SOS
will retype the line number and the contents of
the line to the left of the pointer. It is then
possible to insert more characters.
If no errors occur while making the new line, the
pointer will be left pointing to the first character
of the new line, and the current line will be set to
the new line just created.
(CR) If there is no more editing to be done, that portion
of the line to the right of the pointer will be
printed out; intraline editing is completed for
that line and command returns to the user, unless
there are more lines in the Alter command range to
be edited.
E This has the same effect as the (CR) key, except
that the rest of the line is not printed on the
teletype.
-SOS- Page 33
Q The Quit command terminates intraline editing
without making any changes in the line presently
being altered. SOS returns to command mode.
^U This restarts intraline editing on the same line.
The line will be restored to its original state, and
intraline editing can be started as soon as the line
number is reprinted.
S<character> The Skip command will accept one character from the
user's teletype (without printing it) and will move
the pointer to the right until the next occurrence
of that character. Every character passed over will
be printed. The character that is currently being
pointed to also will be printed without being
compared to the character specified in the command.
If the character does not occur in the rest of the
line, the pointer will be moved to the extreme right
of the line.
K<character> The Kill command is the same as the Skip command
except that it deletes all the characters passed
over instead of printing them. If there are no
other occurrences of the specified character in a
line, the command will be ignored (rather than the
remainder of the line being deleted). As with the D
command, the last 3 characters deleted are printed
between double backslashes if a number precedes K.
R The Replace command is the same as a Delete command
followed by an Insert (even if a number is included
before R).
L The Line command prints the remainder of the line to
the right of the pointer, performs a (CR)(LF),
prints the number of the line, and continues the
intraline editing with the pointer pointing to the
first character of the line.
P This prints the remainder of the line to the right
of the pointer, performs a (CR)(LF), prints the line
number, and moves the pointer to the right; the
characters passed over are printed until the pointer
reaches the same position it had before the command
was issued.
J This Justify command inserts a (CR)(LF) where the
pointer is currently pointing, and concatenates the
portion of the line to the right of the pointer onto
the beginning of the next line. The current line
number is set to the new line number.
The error message "%LINE TOO LONG" will be given if
the new line that is created contains more than 147
characters. The error message "%NO NEXT LINE" will
-SOS- Page 34
be printed if this line is the last one on the page.
Either of these two errors will cause the J command
to be ignored; the line number and the portion of
the line to the left of the pointer will be typed
out again.
W The Word command moves the pointer to the right,
passes over blanks and tabs, then over the first
"word" encountered, and then over subsequent blanks
and tabs (until the next word). Everything that is
passes over is printed.
A "word" is defined as any collection of letters,
numbers, and the separators ".", "%", and "$". The
other separators which delimit a word will cause the
scan to stop after the word and subsequent blanks
and tabs are passed over. (See also Section 6.20 to
set separators.)
X<string> $ The X command moves the pointer over blanks and
tabs, deleting them as it moves, and then deletes
the next "word" and the following blanks and tabs.
After the deletion, a string of text is inserted to
replace the word and subsequent blanks which were
deleted.
Any other character, used as a command, will be ignored in intraline
edit mode.
6.9 THE EXTEND COMMAND - "X"
The Extend command is another way to enter intraline edit mode.
*X<range>(CR)
With this command, however, the pointer is moved immediately to the
extreme right of the line, the characters passed over are printed on
the teletype, and the user is in the intraline insert mode. The
desired text is then typed in followed by (CR).
<text>(CR)
If a (LF) is typed instead of a (CR), a return, linefeed occurs at
that point. This creates a new line consisting of anything that is
subsequently typed in, since the user is still in insert mode. The
number of the new line is determined by the methods described in
Section 6.8. Note that a (CR) must be used eventually to end the
insertion, unless the sequence of line numbers does not permit another
line. In this case, the user will be returned to SOS command level.
If an $ is typed before the (CR), the user may then issue any of the
intraline edit mode commands.
-SOS- Page 35
<text> $ (CR)
The following form of the command will suppress the type-out of the
original line:
*X<range>,S(CR)
Only the characters that the user types for the insertion will be
printed on the teletype.
6.10 THE SUBSTITUTE COMMAND - "S"
The Substitute command will substitute "newstring" for all occurrences
of "oldstring" in the specified range and print every line in which a
substitution has been made. (Note that the options are discussed
separately below.)
*S[<oldstring> $ <newstring>] $ [<range>][<options>](CR)
If the first line with a substitution is not on the first page
specified in the range, or if a subsequent line with a substitution is
not on the same page as a previous line, "PAGE N" will be printed
before the appropriate line.
To substitute the same strings specified in the last S command, omit
the strings and one $ from the command:
*SOLD $ NEW $ 100/1:100/2(CR) Substitute "NEW" for all
occurrences of "OLD" in the
specified range.
*S $ /3(CR) Change "OLD" to "NEW" (as specified
previously) on page 3.
If the strings are omitted and no previous S command had been given,
SOS will print the error message "%NO STRING GIVEN".
If the entire range is omitted, SOS will assume a range from the line
after the current line through the end of the file. If the first part
of the range is omitted, it is assumed to be the line after the
current line. The current line is set to the last line in which a
substitution took place. If a substitution did not occur, the value
of the current line will not be updated.
It is also possible to perform several substitutions at one time. All
text to be located and changed is specified first, followed by an $
and all the text to be substituted, followed by the range.
The form of this command is:
S<oldstring1>(CR)
<oldstring2>(CR)
.
-SOS- Page 36
.
.
<oldstringn> $ <newstring1>(CR)
<newstring2>(CR)
.
.
.
<newstringn> $ <range>(CR)
If there are fewer "newstrings" than "oldstrings," the last
"newstring" is substituted for the extra "oldstrings." Up to six
oldstring and six newstrings (containing 200 characters in all) may be
used; if either is exceeded, one of the following error messages may
appear: "%TOO MANY STRINGS" or "%STRING TOO LONG".
OPTIONS
The complete Substitute command format, including options, is as
follows:
*S[<oldstring> $ <newstring>] $ [<range>][,D ,N][,E][,<number>](CR)
<options>
Substitute command options are defined below:
D By specifying this option, the user can look at each line
after the substitutions have been made in order th "decide"
if he prefers the new line or the old one. After each line
is printed, SOS will wait for the user to type one of the
following characters:
RUBOUT The indicated substitutions will not be made; the old
version of the line will be retained. SOS will then print
the next line and, when found, will wait for another "D"
command character.
E SOS will return immediately to command mode without
performing the substitutions.
G SOS will use the modified line to replace the original line;
Decide mode will be halted and further substitutions will be
made automatically.
A SOS will enter intraline edit mode with the substititions
already made; the user then can issue one of the following:
^U Restore the original line.
(CR) Leave intraline edit mode and continue substitution.
Q Abort the entire process by retuning SOS to command
mode.
-SOS- Page 37
Any other character (e.g., a space or a (CR)) will automatically cause
the new line to replace the old line and substitution to continue.
N This option will suppress the printing of those lines in
which a substitution has been made.
E This option will cause upper and lower case letters to be
treated as non-identical in the "old" string. This should
come after D or N, if either is present, or after the
range. See Chapter 9.
<number> "<number>" specifies the number of lines of a given string
to be substituted - 99999 usually will include them all.
6.11 THE COPY COMMAND - "C"
The Copy command will insert a copy of existing text at a given
location. Its format is:
*C<destination line number>,<source range>[,<inc1>[,<inc2>]](CR)
The Copy command acts as if an Insert command had been done for a
given location, and then as if all of the lines specified by the
source range had been typed in, using the specified increment between
destination line numbers. If the increment is too large, SOS will
print "%OUT OF ORDER" or "%WRAP AROUND", and then choose a smaller
increment, which is indicated as follows:
INC1=<number>
If, for some reason, SOS cannot choose a small enough increment, it
will print
INC1=ORDER or INC1=WAR
The specified increment will be used, and SOS will copy as many lines
as possible into the available space.
Since all the text to be copied must be contained in core at one time,
copying large blocks of text may result in the error message
"%INSUFFICIENT CORE AVAILABLE". The only solution is to copy several
smaller blocks of text.
If the source lines contain page marks, the renumbering of lines at
the destination using the first increment will cease when the first
page mark is reached; then all lines between the first and last page
marks will be inserted with orininal numbers. Lines after the last
page mark will be inserted with the orininal numbers, unless a second
increment (<inc2>) for the destination line numbers is specified in
the command.
If the second increment is too large, SOS will print one of the
following error messages: "%OUT OF ORDER" or "%WRAP AROUND".
-SOS- Page 38
If the second increment is not specified and renumbering is not done,
SOS will print "%OUT OF ORDER".
In both cases, SOS will try to use a different increment, as indicated
by
INC2=<number>
If SOS cannot find a suitable increment, it will print
INC2=ORDER
SOS then will use the specified increment (or the original line
numbers if a second increment had not been stated in the command), and
will insert as many lines as possible into the remaining available
space.
The Copy command will enable the user to copy lines from a file other
than the one presently being edited. If the line numbers of this
other file are unknown, then the user will first type:
*C<destination line number>_<source filename>/S(CR)
This will cause SOS to respond with an asterisk (*). "/S" places the
indicated source file in read-only mode. The desired lines are found
by using the Print, List, or Find commands. After the lines have been
found, type
*E(CR)
SOS will reply
SOURCE LINES=
At this point, the rest of the Copy command should be typed.
<source range>[,<inc1>[,<inc2>]](CR)
The current line will be set to the last line copied.
6.12 THE TRANSFER COMMAND - "T"
The Transfer command moves a set of lines from one location in a file
to another.
*T<destination line number>,<source range>[,<inc1>[,<inc2>]](CR)
The Transfer command is the same as a Copy command followed by a
Delete command. With the Transfer command (unlike the Copy command) -
1. The source range must be in the file currently being edited.
2. The error message "%ILLEGAL TRANSFER DESTINATION" will be
-SOS- Page 39
printed when the destination is inside the source range, as in
*T100/3,/2:/5(CR)
If an "%OUT OF ORDER" error message is printed because of the removal
of a page mark, SOS then will reinsert one page mark and print "PAGE
MARK INSERTED TO PREVENT ORDER ERROR".
If the specified destination is on a page which does not exist, SOS
will insert the text at the end of the file and print "TEXT INSERTED
AT END OF FILE". SOS also will insert a page mark to prevent an "%OUT
OF ORDER" error message.
Note that <inc2> must be used if line numbers other than the orininal
are desired for the last page.
6.13 THE JOIN COMMAND - "J"
The Join command joins two consecutive lines by deleting the carriage
return/linefeed sequence at the end of one line and the line number
and TAB of the next line.
*J<line>(CR)
<line> is the first of the pair of lines to be joined. The line
number of the new line that is created will be the same as this first
line.
If there are no errors, the current line is the line that is created.
The lines will not be joined if SOS prints the error message "%LINE
TOO LONG".
If the line specified as the argument is the last line on the page,
SOS will give the error message "$NO NEXT LINE".
6.14 THE NUMBER COMMAND - "N"
After an "%OUT OF ORDER" message (or at any other time), it is
possible to renumber the file, or portions of it, by using the Number
command:
*N<increment>[,<range>[,<starting number>]](CR)
The first argument is the increment to be used in the renumbered file.
The first line that is renumbered is given this number, unless the
third argument is specified. Each succeeding line will be given a
number that is the sum of the increment and the previously assigned
line number.
If renumbering crosses a page mark, the first line on the new page
-SOS- Page 40
will be given the "starting number" - i.e., either the third argument
or the first argument (if the third is omitted). For example,
BEFORE RENUMBERING:
PAGE 2 115 126 137 150
PAGE 3 900 911 952 999
*N10,/2:/3(CR)
AFTER RENUMBERING:
PAGE 2 10 20 30 40
PAGE 3 10 20 30 40
If the second argument is absent (indicating the range to be
renumbered), the entire file will be renumbered. If there are no
lines in the specified range, SOS will print the error message "%NO
SUCH LINE(S)".
The Number command is useful in renumbering a page before the page
mark is deleted in order to avoid an "%OUT OF ORDER" error message.
If the user deletes the page mark before renumbering, he should issue
the Number command with the "/." range specification, the desired
increment, and starting point, if desired.
*N10,/.(CR) Renumber the current page with an
increment and starting point of 10.
After renumbering, the current number and page will be set to the
number of the last renumbered line. An increment of 0 will result in
the error message "%ILLEGAL COMMAND". If the spedified increment is
so large that it causes some line numbers to be greater than 99999,
the high-order digits of these line numbers will be dropped. SOS will
then print the error message "%WRAP AROUND" along with the page on
which the problem occurred. The page will be out of order and should
be renumbered with a smaller increment.
6.15 THE JUSTIFY COMMAND - "JU"
The JUstify command justifies the text in a specified range by
ignoring all line numbers, returns, and linefeeds:
*JU<range>(CR)
Line numbers, returns, linefeeds, and blanks are then inserted so that
the line length is the difference between the right (RMAR) and left
(LMAR) margins plus one:
RMAR-LMAR+1=line length
-SOS- Page 41
Inserting any additional characters will result in unjustified text.
Note that the default values of "RMAR" and "LMAR" are 69 and 1
respectively.
If the right margin is less than the left, SOS will print "%MARGIN
ERROR".
In this case, use the Set command to reset either or both margins.
SOS inserts extra blanks between words, starting from the left or
right on alternate lines, to make the line length "RMAR-LMAR+1".
A word is anything between blanks. (The end of the original line is
considered a blank.) A word that ends with ".", "?", or "!" may be
followed by two blanks; otherwise, only one blank is allowed, and all
other blanks will be ignored.
SOS inserts blanks at the beginning of the new line equivalent to the
value of the left margin minus 1. The new line number is the same as
the number derived by the Number command:
*N<increment>,<range>(CR)
A page mark automatically will be inserted if the next line number
exceeds the maximum line number (MAXLN) whose default is 99999. If
this occurs, the user will be informed.
Paragraphing will cause exceptions to the above procedures. The end
of a paragraph is indicated by one of the following conditions:
1. Tab in the first character position
2. Blank line
3. Page mark
4. Beginning or end of specified range
When one of these conditions is encountered, the line that immediately
precedes the end of the paragraph is not expanded (unless it is the
beginning of the range). The line, however, is placed at the LMAR,
with leading blanks inserted if necessary.
If the paragraph begins with a tab (8 spaces, entered during Insert
mode by CTRL-TAB), the tab is merely inserted into the text.
Otherwise, the paragraph will begin with the paragraph margin (PMAR)
whose default is 1, rather than the LMAR.
-SOS- Page 42
6.16 THE JUSTIFY LEFT COMMAND - "JL"*
The Justify Left command removes leading blanks from lines of a range
and inserts LMAR-1 blanks to move the lines to the left margin.
*JL<range>(CR)
The first line of a paragraph is treated as in the JUstify command.
No chopping, filling, or renumbering, however, is done.
6.17 THE JUSTIFY RIGHT COMMAND - "JR"*
It is also possible to right justify a range of text:
*JR<range>(CR)
Enough blanks are inserted at the beginning of the line so that the
right end of the line is at the right margin. If any tabs are
present, the required blanks are inserted to the right of the
rightmost tab in the line.
6.18 THE JUSTIFY CENTER COMMAND - "JC"*
The Justify Center command centers the lines of a range between the
left and right margins:
*JC<range>(CR)
JC is like the JR command, except that only half as many blanks are
inserted to make the line centered between LMAR and RMAR.
6.19 THE JUSTIFY WORD COMMAND - "JW"
The Justify Word command, like the JUstify command (Section 6.15),
justifies a line of text. In this case, SOS includes as many words as
possible between LMAR and RMAR without adding blanks or hyphenating.
The text, therefore, appears as typewritten text without a justified
right margin.
The format of the JW command is as follows:
*JW<range>(CR)
---------------
*WARNING: After a line that exceeds RMAR-LMAR+1, SOS will print the
error message "%LINE TOO LONG". The text, when printed, may not be as
expected; the margins should be reset and the command should be
reissued.
-SOS- Page 43
6.20 THE SET COMMAND - "_"
The Set command sets (or changes) parameters in SOS:
*_<parameter>[=<number>](CR)
For example, after SOS has been used for a while, the user may want
shorter forms of error messages. By typing
*_EXPERT(CR)
all error messages will be abbreviated to five characters or less (see
Appendix A). This is reversed by typing
*_NOVICE(CR)
Note that SOS begins in _NOVICE mode.
For the intraline edit mode W and X commands, the per cent sign,
dollar sign, and period are considered part of the word. The use
these as separators or delimiters, type
*_SEPARATOR(CR)
This is reversed by typing "*_NONSEPARATOR(CR)", the default condition
when SOS begain edit mode.
The parameters used in the family of Justify commands (LMAR, RMAR,
PMAR, MAXLN), the increment parameter (INC), and the LENGTH parameter
(Print option) may be assigned new values as follows:
*_LMAR=5(CR) *_MAXLN=1000(CR)
*_RMAR=65(CR) *_INC=50(CR)
*_PMAR=10(CR) *_LENGTH=60(CR)
The newly-assigned values are only valid while editing the current
file.
It is possible to change the name of the resultant edited file
*_NAME=<filename>(CR)
6.21 THE GIVE INFORMATION COMMAND - "="
Any time the user is in command mode, he may request the value of a
parameter by using the Give Information command:
*=<parameter>(CR)
Possible Give parameters are:
-SOS- Page 44
*=INC(CR) Print the current increment.
*=.(CR) Print <current line number>/<current page>.
*=LMAR(CR) Print the current value for the left margin.
*=PMAR(CR) Print the current value used for paragraph identation.
*=RMAR(CR) Print the current value for the right margin.
*=MAXLN(CR) Print the maximum line number allowed in the JU
command.
*=BIG(CR) Print the page number of the largest page in the file.
*=ERROR(CR) Print the last error message - in the long form, even
if "_EXPERT" is in effect.
*=STRING(CR) Print the string used by the Find and Substitute
commands:
SEARCH:
<Find command string(s)>
SUBSTITUTE:
<Substitute command newstring(s)>
FOR:
<Substitute command oldstring(s)>
*=CASE(CR) Print whether SEPARATOR (or other words described in
Chapter 9) has been set.
*=NAME(CR) Print the name of the resultant output file.
*=LENGTH(CR) Print the length used for determining the end of the
page in the Print command options.
6.22 LINE CONTENTS SPECIFICATION - ALL COMMANDS
In SOS it is possible to address lines by content, rather than line
numbers. This is done by replacing each <line number> field of any
command with
$ <string> $ (CR)
The rest of the orininal command string continues on the next line.
This may be another " $ <string> $ (CR)" or (CR) alone which
terminates the entire command. For example, to print everything
between a line containing "ONE" and a line containing "TWO", type the
command
*P $ ONE $ (CR)
: $ TWO $ (CR)
(CR)
-SOS- Page 45
*
Note that three carriage returns are required: one for each string of
text and one for terminating the Print command.
If the string between two $ s is null, then the string last used in
this context will be used again. (Strings from the Find and
Substitute commands do NOT qualify.) Normally, the search begins with
the current position and contunues through the end of the file. A
range, however, may be specified as follows:
$ [<string>] $ [<range>][,D ,N][,E][,<number>](CR)
<range> may be specified as a group of line numbers, or the line
contents specification described above may be substituted. In the
latter case, <range> provides the outer boundaries for the search.
<range> may be nested a maximum of three times.
*P $ C $ (CR) Print all the lines between, and
: $ B $ $ D $ (CR) including, the first occurrence of
: $ G $ (CR) C and the first occurrence of B.
(CR) Only use that portion of text
between the first occurrences of D
and G.
Where the sample text is:
00300 B _current line
00400 C
00500 D
00600 B Search through this area
00700 C for lines C and B.
00800 A Print these 3 lines
00900 B
01000 G
Adding either the ",D" or ",N" option will cause the entire line
(",D") or the line number (",N") of the first occurrence of the text
to be printed. SOS then will print an *. If the user types RUBOUT at
this point, SOS will search for the next line containing the text and
then print the line or line number. Typing any other character will
terminate the search for the particular text.
The ",E" option specifies that upper and lower case characters are not
equivalent (see Chapter 9).
<number> indicates a number of times the string occurs. SOS will skip
to the last occurrence of this specification and use that line as the
starting point for its search.
*P $ 1 $ ,D,3(CR) SOS would print all the lines between,
: $ 4 $ (CR) and including, the first occurrence of
(CR) 1 and the first occurrence of 4;
however, 3 in the number field indicates
that SOS should use the third occurrence
-SOS- Page 46
of 1 as its starting point.
Where the sample text is:
1
2
1
2
1 _starting point
2
3
4
1
2
NOTE:
RUBOUT, when used with the ",D" or ",N"
option, may only be repeated "number-1"
times.
6.23 THE QUIT COMMAND - "Q"
Should the user realize that his editing is useless, he may return to
the monitor without saving the edited version of the file by using the
Quit command:
*Q(CR)
SOS will respond by returning him to the monitor.
EXIT
WARNING: CTRL-C (^C) should never be used to return to the monitor
while SOS is operating since unnecessary temporary files will be
saved. Use the Quit command.
6.24 THE END COMMAND - "E"
The End command is used to terminate the current edit.
*E[<filename>](CR)
If a filename is not specified, the original copy of the file being
edited will be renamed to <filename>.BAK; then the newly edited
version will be stored under the original filename.
If a name is specified, it will be assenged to the edited version. If
the user specifies a filename which already exists, SOS will ask "FILE
ALREADY EXISTS! DELETE?(Y OR N)" and wait on the same line for a
response:
-SOS- Page 47
Y - Delete old file and substitute new file
N - Do not delete old file
If "N", SOS will respond with "FILE=" and wait for a new name to be
typed; this will be assigned to the edited file.
If "Y" and if the old file cannot be deleted (such as .BAK files), SOS
will respond "FILE WRITE PROTECTED. TRY ANOTHER NAME". An asterisk
will appear on the next line.
When SOS is finished, it will return the user to the monitor:
EXIT
Instead of using the End command to specify the filename under which
the edited version will be stored, the user, when beginning the
editing session, may specify the new filename as follows:
.SOS<new filename>=<old filename>(CR)
SOS will enter edit mode for <old filename>. "*E(CR)" at the end of
the editing will then cause the edited version to be stored under <new
filename>. The user may also add "/READONLY" or "/REA" to the
command; this will put the <old filename> in read-only mode. Thus,
the file named <old filename> will not be overwritten.
6.25 THE SAVE WORLD COMMAND - "W"
The Save World command
*W[<filename>](CR)
is similar to the End command except that parameters set by the Set
command are not returned to their standard settings (i.e., they remain
as they were before the command), and the user is returned to command
mode rather than to the monitor. This is useful for saving the
current version of the file in case the system crashes, and should be
done every fifteen minutes while in edit mode. Then, if the the
system does crash, only the editing done since the last W command was
issued will be lost.
If a filename is used with this command, the edited version will be
saved under that name. If the W command is issued again during the
save editing session and no filename is specified, then the current
version is saved with the name last given in a previous W command.
If the system crashes and a W command had not be issued recently, the
user may be able to recover his editing by typing the Monitor command
.RENAME<filename not in use>=nnnSOS.TMP(CR)
(where "nnn" is the user's job number).
-SOS- Page 48
This will attach the user to a temporary file which may be the one
that SOS was using before the system died. It is then necessary to
enter edit mode with the new filename. If this is not the correct
file, delete it and try again using another temporary file (e.g.,
nnnSOS.TEM). A system Directory command may be issued to see if there
are any temporary files.
6.26 THE GO COMMAND - "G"
It is possible to edit a program source file with SOS and then to
issue a Monitor command (EXECUTE, LOAD, COMPILE, etc.). SOS can be
reentered after the EXECUTE, LOAD, or COMPILE is done and can
determine the name of the last file edited; thus, typing
.SOS(CR)
next will put the user immediately into edit mode in the last file
specified. Then, once the first DECsystem-10 Monitor command has been
given, and SOS has been entered a second time the Go command (instead
of End) will write the file onto the disk, exit from SOS, and cause
the previous Monitor command to be repeated.
*G(CR)
A filename may also be specified with a Go command:
*G[<filename>](CR)
This simply renames the edited version; the name will be saved for
the next Go command. Thus, a G command alone will store a file under
a previously-specified name; a G command which includes a filename
will store the file under that new name.
7.0 READ-ONLY MODE
As indicated earlier, once a file is created it may be called by SOS
in read-only mode by the addition of "/READONLY" or "/REA" when the
file is named in the initial conversation with SOS:
.SOS(CR)
FILE=EXAMPL/READONLY(CR)
or
.SOS EXAMPL/READONLY(CR)
The user will not be allowed to perform any editing in the named file
(i.e., "EXAMPL").
In read-only mode, only the following commands may be used: Print,
Find, End, Go and List.
-SOS- Page 49
8.0 INDIRECT COMMANDS
If a particular sequence of commands is used frequently, it is
possible to insert these commands in a file. Then SOS can be
instructed to read commands from the file, rather than from the
teletype keyboard. The command
*@<filename>(CR)
will do this, provided the list of commands is found in the named
file. When SOS sees this command, it will begin taking its commands
from the file. Only the following will be printed out on the user's
teletype:
1. Error messages
2. Printout from the P command
3. Items found by the F command
4. Substitutions made by the S command
5. Lines altered by the A command
If the user includes the Substitite command with the Decide option in
his file, he must type in the decision character when the Substitute
command is executed (see Section 6.10).
When SOS has executed the last command in the "indirect command" file,
the user will be reutrned to command mode.
When the user is inserting commands into the file, he may have to
enter such characters as $ or a (CR) without the (LF) (see Chapter 9
on SOS character sets).
9.0 UPPER AND LOWER CASE REPRESENTATION
9.1 C128 AND C64 MODES
Model 33 and 35 teletypes employ only upper-case letters and some
special symbols, totaling 64 characters in all. SOS is capable,
however, of using the full ASCII 128-character set. Since edit mode
assumes the 64-character set, it is necessary to specify "C128" mode
in order to represent lower-case letters and the additional ASCII
symbols. This C128 mode is indicated in a Set command:
*_C128(CR)
In C128 mode, a ? preceding any teletype character will give it an
equivalent meaning as indicated in Appendix D ("SOS representation").
-SOS- Page 50
From Appendix D it is obvious that upper-case letters are input the
same in both C64 and C128 modes, except for the ?. In C128 mode, a
single ? has no meaning whatsoever; it is necessary, therefore, to
type ?? in this mode to represent a single ?.
To return to C64 mode, again use a Set command:
*_C64(CR)
In C64 mode, only the characters on the teletype may be input. A
single ? will be echoed during input. In a line printed as the
result of a Print or Find command, however, a double ? will appear.
9.2 UPPER AND LOWER CASES
SOS initially assumes that all characters are upper case. Thus, in
C128 mode it is necessary to precede any character considered lower
case with a ?. The user, then, can intersperse the two cases in his
text in this manner to obtain all alphabetic characters.
When the text primarily is composed of lower-case letters, it is
easier to assume that all characters are lower case. Then, a special
configuration (i.e., the ?) will indicate upper case. The Set command
is used to indicate the dominance of lower case.
*_LOWER(CR)
To represent upper-case characters, precede each with a ?. To revert
back to the original upper-case mode, type
*_UPPER(CR)
9.3 COMBINING MODES AND CASES
The following examples illustrate how SOS modes and cases can be
combined:
Text Explanation
*I1000
01000 IS THIS A LINE? Inserted in C64 UPPER.
*P.
01000 IS THIS A LINE?? Printed in C64 UPPER.
*_LOWER
*P.
01000 ?I?S ?T?H?I?S ?A ?L?I?N?E?? Printed in C64 LOWER.
*_C128
*_UPPER
*P.
01000 IS THIS A LINE?? Printed in C128 UPPER.
-SOS- Page 51
*_LOWER
*P.
01000 ?I?S ?T?H?I?S ?A ?L?I?N?E?? Printed in C128 LOWER.
*I100
00100 WHO ARE YOU? Inserted in C64 LOWER.
*_UPPER
*P.
00100 ?W?H?O ?A?R?E ?Y?O?U?? Printed in C64 UPPER.
*_LOWER
P.
00100 WHO ARE YOU?? Printed in C64 LOWER.
*_C128
*_UPPER
*P.
00100 ?W?H?O ?A?R?E ?Y?O?U?? Printed in C128 UPPER.
*_LOWER
*P.
00100 WHO ARE YOU?? Printed in C128 LOWER.
I2000
02000 IS N?<Q?? Inserted in C128 UPPER.
*P.
02000 IS N?<Q?? Printed in C128 UPPER.
*_LOWER
*P.
02000 ?I?S ?N?<?Q?? Printed in C128 LOWER.
*_C64
*_UPPER
*P.
02000 IS N?<Q?? Printed in C64 UPPER.
*_LOWER
*P.
02000 ?I?S ?N?<?Q?? Printed in C64 LOWER.
*i3000
03000 is this the end?? Inserted in C128 LOWER.
*_UPPER
*P.
03000 ?I?S ?T?H?I?S ?T?H?E ?E?N?D?? Printed in C128 UPPER.
*_LOWER
*P.
03000 IS THIS THE END?? Printed in C128 LOWER.
*_C64
*_UPPER
*P.
03000 ?I?S ?T?H?I?S ?T?H?E ?E?N?D?? Printed in C64 UPPER.
*_LOWER
*P.
03000 IS THIS THE END?? Printed in C64 LOWER.
-SOS- Page 52
9.4 MODEL 37 TELETYPE: 37 MODE
The Model 37 teletype has the full ASCII 128-character set; it can,
therefore, input these characters directly to SOS. To type lower-case
letters on terminals such as the Model 37, it is necessary to issue
the system command
.TTY LC(CR) or >SET TTY LC(CR)
Then, to allow SOS to output lower-case characters to this teletype,
the user types
*_M37(CR)
This is reversed by another Set command ("*_M33(CR)") which will
essentially make the Model 37 teletype act as if it were either a
Model 33 or 35 - i.e., 2-character equivalents must be used as
described in Section 9.1.
9.5 ASCERTAINING MODE AND CASE: THE GIVE INFORMATION COMMAND
If there is any doubt as to which case and mode are employed, issue a
"Give information" command.
*=CASE(CR)
For C64 mode, SOS will print
C64 UPPER
or
C64 LOWER
For C128 mode, SOS will print
UPPER
or
LOWER
For C64 mode on a Model 37 teletype, SOS will print
MODEL 37 C64 UPPER
or
MODEL 37 C64 LOWER
For C128 mode on a Model 37 teletype, SOS will print
MODEL 37 UPPER
-SOS- Page 53
or
MODEL 37 LOWER
9.6 SPECIAL CONSIDERATIONS: FIND AND SUBSTITUTE COMMANDS
For a Find command<string>, upper and lower-case characters will be
considered the same unless the E option is used. For the Substitute
command, upper and lower-case will be considered equivalent in
<oldstring> only.
9.7 SPECIAL "MATCHING" CHARACTERS: FIND AND SUBSTITUTE COMMANDS
If C128 mode has been specified or if a Model 37 teletype is used,
there are a few special characters which "match" some other character
in the Find and Substitute command<strings>.
Representation* Explanation
?: Matches a SEPARATOR which is any character
other than a letter, a number, a ".", a "%",
or a "$". See Section 6.20 on Separators.
?/ Matches any character.
?% The subsequent character matches any
character which it would not normally match.
A?%BC will be matched by AAC, ACC, ADC, etc.,
but not by ABC (or abc unless the "E" option
is specified with Find or Substitute).
Combinations of the above 3 codes include:
?%?: Matches any letter, number, etc. -
i.e., not a SEPARATOR.
?%?/ Matches only the beginning or end of a
line. For example, ?%?/OLD finds only those
occurrences of "OLD" at the beginning of a
line.
?7 Quotes the next character. When used with
another special character, ?7 will find that
character and not its match:
?7?% Searches for the actual occurrence of
---------------
*Line 1: 2-character representation
Line 2: Stanford representation
-SOS- Page 54
?%.
?7?7 Searches for ?7.
?%?7?% Matches any character except ?%.
?) Indicates "any number of" the particular
character that follows it. For example,
A?)BC Matches AC, ABC, ABBC, etc. In case of
ambiguity, the shortest string is found. For
the above example, A?)BC will find AC rather
than ABC.
?)?%?7?% Matches any number of characters
which are not ?%'s.
Two other special characters may be used in the <newstring> of the
Substitute command when one of the special constructions discussed
above has been specified in <oldstring>.:
?* Specifies that a match which occurs by using
one of the above special constructions is to
be used for a later substitution.
?*1?* A stand-in for whatever was actually
matched first by a special construction.
?*2?* is for the second match, etc.
For example, suppose all occurrences of OLD
are to be replaces by NEW, but COLD, FOLD,
etc., also exist in the file. OLD can be
given for the oldstring, but how can the
SEPARATORs be replaced? The "?*"
construction is used as follows:
*S?:OLD?: $ ?*1?*NEW?*2?* $ <range>(CR)
?" In more complicated specifications, ?" will
replace successive recurrences of the ?*
construction when they appear in the same
order that they were matched.
For example, as the file is scanned for the
<oldstring>, the matches with the special
constructions are actually numbered and
stored on the disk. (The first is 1, etc.)
Then, when the <newstring> is being
substituted, these numbered matches can be
named for use with ?*1?*, ?*2?*, etc. - if
they occur in order, ?" can be substituted
for ?*<number>?*.
The constructions make it possible to isolate unknown portions of text
by manipulating what comes immediately before and after. NOTE:
-SOS- Page 55
Certain strings which can be formed with the above characters are
illegal and will produce the message "%ILLEGAL SEARCH STRING".
Since the strings are not checked when the command is issued, the
message will only be given when an attempt is made to match the
special construction. If ?%?), or ?7 is not followed by another
character, or if ?% is followed by ?), SOS will print "%ILLEGAL SEARCH
STRING".
Because some of these special searches invlove recursion or require
the use of table space inside SOS, it is possible to get the error
message, "%SEARCH STRING TOO COMPLEX". If this occurs, try a simpler
string.
Example 1
Exchange two arguments of a function:
function (A,B) => function (B,A)
where A and B may be any string not including the left or right
parenthesis or a comma.
*Sfunction(?)?/,?)?/) $ function(?*2?*,?*1?*) $ <range>(CR)
Example 2
Change all READ (3,#)list to READ (5,#) list
*SREAD?)?%(3, $ READ?"(5, $ <range>(CR)
NOTE: This will not match "READ(4,#) A(3,5)" but will match
"READ(3,".
-SOS- Page 56
APPENDIX A
ERROR MESSAGES
EXPERT NOVICE
DDE %DEVICE OUTPUT ERROR
DIE %DEVICE INPUT ERROR
DNA %DISK NOT AVAILABLE
FNF %FILE NOT FOUND
ICN %INTERNAL CONFUSION
ILC %ILLEGAL COMMAND
ILFMT %ILLEGAL LINE FORMAT
ILR %ILLEGAL REPLACEMENT ON INSERT
ILUUO %ILLEGAL UUO
IRS %ILLEGAL REPLACEMENT STRING
ISS %ILLEGAL SEARCH STRING
ITD %ILLEGAL TRANSFER DESTINATION
LTL %LINE TOO LONG
NEC %INSUFFICIENT CORE AVAILABLE
NLN %NO SUCH LINE(S)
NNN %NO NEXT LINE
NSG %NO STRING GIVEN
NSP %NO SUCH PAGE
ORDER %OUT OF ORDER
STC %STRING TOO COMPLEX
STL %STRING TOO LONG
UNA %DEVICE NOT AVAILABLE
TMS %TOO MANY STRINGS
WAR %WRAP AROUNG
-SOS- Page 57
SRF %SEARCH FAILS
CMERR %INDIRECT READ ERROR
CMEND %INDIRECT END-OF-FILE
MAR %MARGIN ERROR
-SOS- Page 58
APPENDIX B
SUMMARY OF COMMANDS
ALTER
*A<range>(CR)
Next Character - SPACE
Last Character - RUBOUT
Change - C<character>
Delete - D
Insert - I<string> $
End Alter Mode - (CR)
End Alter Mode - E (without printout)
Quit - Q
Start Over - ^U
Skip - S<character>
Kill - K<character>
Replace - R
Line - L
Print - P
Justify - J
Word - W
Delete Word and Insert Text - X<string> $
COPY
*C<destination line number>,<source range>[,<inc1>[<inc2>]](CR)
*C<destination line number>_<source filename>/S(CR)
DELETE
*D<range>(CR)
END
*E[<filename>](CR)
EXTEND
*X<range>[,S](CR)
<text>[ $ (LF)](CR)
FIND
*F[[<string>] $ [<range>][,A ,N][,E][,<number>]](CR)
GIVE
*=INC BIG CASE ERROR STRING . LMAR PMAR RMAR MAXLN LENGTH NAME(CR)
GO
-SOS- Page 59
*G[<filename>](CR)
INSERT
*I<line>[,<increment>](CR)
or
*I<line>[;<increment>](CR)
JOIN
*J<line>(CR)
JUSTIFY
*JU<range>(CR)
JUSTIFY CENTER
*JC<range>(CR)
JUSTIFY LEFT
*JL<range>(CR)
JUSTIFY RIGHT
*JR<range>(CR)
JUSTIFY WORD
*JW<range>(CR)
LINE CONTENTS SPECIFICATION - ALL COMMANDS
line number field =
$ <string> $ (CR)
LIST
*L[<range>][,S](CR)
MARK
*M<line number>/<page number>(CR)
NUMBER
*N<increment>[,<range>[,<starting number>]](CR)
PRINT
*P[<range>][,<options>](CR)
QUIT
-SOS- Page 60
*Q(CR)
REPLACE
*R<range>[,<increment>](CR)
or
*R<range>[;<increment>](CR)
SAVE WORLD
*W[<filename>](CR)
SET
*_<parameter>(CR)
parameter =
UPPER/LOWER
M33/M37
C64/C128
NOVICE/EXPERT
NONSEPARATOR/SEPARATOR
*_<parameter>=<number>(CR)
parameter =
INC LMAR PMAR RMAR MAXLN LENGTH
*_NAME=<filename>(CR)
SUBSTITUTE
*S[<oldstring> $ <newstring>] $ [<range>][,D ,N][,E][,<number>](CR)
TRANSFER
*T<destination line number>,<source range>[,<inc1>[,<inc2>]](CR)
-SOS- Page 61
APPENDIX C
DEFAULT VALUES
If certain <parameter>s are not assigned values by the Set command,
they will assume a default value:
INC=100
LMAR=1
PMAR=1
RMAR=69
MAXLN=99999
LENGTH=55
Also, the following <parameter>s are "modes" in which SOS begins:
UPPER,M33,C64,NOVICE,NONSEPARATOR
These can be reversed by using the Set command with the following
<parameter>s:
LOWER,M37,C128,EXPERT,SEPARATOR
-SOS- Page 62
APPENDIX D
ASCII CHARACTER TABLE
0 1 2 3 4 5 6 7
NUL SOH STX ETX EOT ENQ ACK BEL A
00 B
?! ?" ?# ?$ ?% ?& ?' C
BS HT LF VT FF CR SO SI
01 TAB
?(
DLE DC1 DC2 DC3 DC4 NAK SYN ETB
02
?+ ?, ?- ?. ?/ ?0 ?1 ?2
CAN EM SS ESC FS GS RS VS
03
?9 ?6 ?4 ?= ?< ?> ?7 ?8
04 SP ! " # $ % & '
05 ( ) * + , - . /
06 0 1 2 3 4 5 6 7
07 8 9 : ; < = > ?
??
10 @ A B C D E F G
11 H I J K L M N O
12 P Q R S T U V W
13 X Y Z [ \ ] ^ _
14 a b c d e f g
?@ ?A ?B ?C ?D ?E ?F ?G
15 h i j k l m n o
?H ?I ?J ?K ?L ?M ?N ?O
16 p q r s t u v w
?P ?Q ?R ?S ?T ?U ?V ?W
ESC DEL
17 x y z RUB
?X ?Y ?Z ?[ ?: ?] ?3
A 128-character code
-SOS- Page 63
B Stanford character
C 2-character equivalent