Trailing-Edge
-
PDP-10 Archives
-
BB-J724A-SM_1980
-
sources/d60spd.rno
There are 2 other files named d60spd.rno in the archive. Click here to see a list.
.SD 60
.LOWER CASE
.FLAG CAPITALIZE
.TS 5,10,15,20,25,30,40,45,50,55,60,65,70,75
.CHAPTER ^^INTRODUCTION\\
<D60SPD IS A <DEC<SYSTEM-10 PROGRAM TO MEASURE <DN60 PERFORMANCE.
^THE FOLLOWING FUNCTIONS ARE AVAILABLE:
.LS
.LE;^LINE WIDTH
.LE;^BUFFER SIZE
.LE;^BEGINNING ADDRESS OF THE BUFFER IN RELATION TO A
PAGE BOUNDRY
.LE;^NUMBER OF BYTES PER BUFFER
.LE;^CARRIAGE CONTROL CHARACTER
.LE;^CHARACTER RANGE WHEN DOING OUTPUT USING THE INTERNAL
RIPPLE PATTERN CHARACTER GENERATOR
.LE;^USE OF INTERNAL CHARACTER GENERATOR OR A DISK FILE FOR OUTPUT
.LE;^DESTINATION OF THE INPUT DATA - WHETHER TO A DEVICE OR THE
BIT BUCKET
.ELS
.CHAPTER COMMANDS
<D60SPD USES A VERB TYPE COMMAND DECODER AND DISPATCHES TO THE
APPROPRIATE ROUTINE TO PERFORM THE COMMAND. ^PARAMETERS WHICH MUST
BE SET BEFORE ISSUING COMMANDS TO THE <DN60 INCLUDE THE <DN60
NUMBER, (OR <DL10 PORT NUMBER), LINE NUMBER, AND THE DEVICE NUMBER.
^ONCE ANY ONE OF THESE IS SET IT REMAINS SET UNLESS CHANGED BY A
COMMAND, SO THEREFORE ONCE THEY ARE SET IT WILL NOT BE NECESSARY
TO INCLUDE THESE IN ANY COMMANDS, UNLESS A CHANGE IS DESIRED.
^THE FOLLOWING IS A LIST OF AVAILABLE COMMANDS:
.LM +15;.SKIP 1
.INDENT -10;<ABORT ABORT INPUT AND/OR OUTPUT
.INDENT -10;<AUTO EXECUTE <D60SPD COMMANDS FROM A FILE
.INDENT -10;<DDT ENTER <DDT IF IT IS LOADED
.INDENT -10;<EOF SEND A <EOF IF DOING OUTPUT
.INDENT -10;<EXIT EXIT <D60SPD
.INDENT -10;<HELP TYPE <D60SPD.HLP
.INDENT -10;<INPUT RECEIVE INPUT FROM THE <DN60
.INDENT -10;<NOTYPE IGNORE ANY TYPEAHEAD DURING RUNTIME
.INDENT -10;<OUTPUT OUTPUT TO THE <DN60
.INDENT -10;<PARAM PRINT OUT THE <CAL11. PARAMETER BLOCK
.INDENT -10;<RESTART RESTART <D60SPD
.INDENT -10;<SET PERFORM SETUP AND ISSUE COMMANDS
.INDENT -10;<STATUS READ <DN60, LINE, AND DEVICE STATUS
.INDENT -10;<TYPEAH ALLOW TYPEAHEAD DURING RUNTIME
.INDENT -10;<WHAT PRINT PORT NUMBER, LINE NUMBER, AND DEVICE NUMBER
.LM -15;.SKIP 1
.CHAPTER SET COMMANDS
^THE <SET COMMAND IS USED TO ISSUE COMMANDS TO THE <DN60 AND TO
PROVIDE <D60SPD WITH THE ^PORT, ^LINE, AND ^DEVICE NUMBERS. ^THE
FOLLOWING <SET COMMANDS ARE AVAILABLE:
.UPPER CASE
.LS
.LE;SET PORT
.LE;SET LINE
.LE;SET DEVICE
.LE;SET SIMULATE
.LE;SET SUPPORT
.ELS
.LOWER CASE
.HL 1 SET PORT COMMAND
FORM##^^SET PORT:\O/LINE:\D/DEVICE:\\D
.SK 1
^THE <SET <PORT COMMAND IS USED TO TELL <D60SPD WHICH <DL10 PORT OR <DTE NUMBER, LINE,
AND DEVICE IT WILL BE COMMUNICATING WITH. ^THE SWITCHES, </LINE AND
</DEVICE ARE OPTIONAL. ^THE RANGE OF PORT NUMBERS ARE 0-7 FOR A <DL10 AND 10-13 FOR
A <DTE20.
.SKIP 1
.LM +5
EXAMPLES:
.SKIP 1
.UPPER CASE
SET PORT:1
.BR
SET PORT:1/LINE:2
.BR
SET PORT:13/LINE:5
.BR
SET PORT:7/LINE:1/DEVICE:1
.LM -5
.LOWER CASE
.HL 1 SET LINE COMMAND
FORM##^^SET LINE:\D/CMD:\D/\\OPTIONAL <CMD SWITCHES
.SK 1
^THE <SET <LINE COMMAND IS USED TO TELL <D60SPD WHICH LINE NUMBER
IT WILL BE COMMUNICATING WITH AND IF THE OPTIONAL SWITCH </CMD:<D
IS INCLUDED, THAT COMMAND WILL BE ISSUED TO THE <DN60. ^THE PORT
NUMBER MUST BE SET PRIOR TO ISSUING THIS COMMAND.
.SKIP 1
.LM +15
.INDENT -10
<CMD 0 ^ILLEGAL COMMAND
.INDENT -5
1* ^ENABLE THE LINE
.BREAK
</TERMINAL:<D 0 = UNKNOWN
.BREAK
1 = <IBM 3780
.BREAK
2 = <IBM 2780
.BREAK
3 = <HASP multileaving
.break
</FLAGS:<D 1 = SIMULATE
.BREAK
2 = PRIMARY
.INDENT -5
2 ^SET <DTR
.INDENT -5
3 ^ABORT ALL DATA TRANSFERS AND HANG UP
.INDENT -5
4 ^DISABLE THE LINE
.INDENT -5
5* ^SET CLEAR TO SEND DELAY
.BREAK
</CSD:<D NUMBER OF JIFFIES TO DELAY
.INDENT -5
6* ^SET THE NUMBER OF BYTES IN THE SILO WARNING AREA
.BREAK
/<SILWAR:D NUMBER OF BYTES OF SILO WARNING AREA
.SKIP 1
.INDENT -5;* INDICATES ADDITIONAL SWITCHES ASSOCIATED WITH /<CMD
.LM -15
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
SET LINE:1
.BREAK
SET LINE:1/CMD:2
.BREAK
SET LINE/CMD:2
.BREAK
SET LINE/CMD:1/TERMINAL:1/FLAGS:1
.BREAK
SET LINE/CMD:5/CSD:3
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 SET DEVICE COMMAND
FORM##^^SET DEVICE:\D/CMD:\\D/OPTIONAL <CMD SWITCHES
.SKIP 1
^THE <SET <DEVICE COMMAND IS USED TO TELL <D60SPD WHICH DEVICE NUMBER
IT WILL BE COMMUNICATING WITH AND IF THE OPTIONAL SWITCH </CMD:<D IS
INCLUDED, THAT COMMAND WILL BE ISSUED TO THE <DN60. ^THE PORT AND
LINE NUMBERS MUST BE SET PRIOR TO ISSUING THIS COMMAND.
.SKIP 1
.LM +15
.INDENT -10
<CMD 0 ^ILLEGAL COMMAND
.INDENT -5
1* ^SET CHARACTERISTICS
.BREAK
/<DEVTYP:<D 0 = UNKNOWN
.BREAK
1 = console input
.BREAK
2 = console output
.BREAK
3 = card reader
.break
4 = line printer
.break
5 = card punch
.INDENT -5
2* ^SET NUMBER OF RECORDS PER TRANSMISSION BLOCK
.BREAK
</RECORDS:<D
.INDENT -5
3 ^DUMP OUTPUT BUFFERS
.BREAK
.INDENT -5
4 ^CLEAR INPUT PERMISSION WAS REQUESTED
.INDENT -5
5 ^RESERVED
.INDENT -5
6 ^SET "INTERPRET CARRIAGE CONTROL ON INPUT" ( BE A PRINTER )
.INDENT -5
7 ^CLEAR "INTERPRET CARRIAGE CONTROL ON INPUT"
.INDENT -5
8 ^SET "INTERPRET CARRIAGE CONTROL ON OUTPUT"
.INDENT -5
9 ^CLEAR "INTERPRET CARRIAGE CONTROL ON OUTPUT"
.INDENT -5
10 ^SET "OUTPUT TRANSPARENT <BSC"
.INDENT -5
11 ^CLEAR "OUTPUT TRANSPARENCY"
.INDENT -5
12* ^SPECIFY OUTPUT COMPONENT SELECTION
.BREAK
</COMPCD:<D 1 = PRINTER
.BREAK
2 = PUNCH
.INDENT -5
13 ^DON'T DO OUTPUT COMPONENT SELECTION
.INDENT -5
14* ^SET PRINTER LINE COUNTER
.BREAK
</PLC:<D
.INDENT -5
15 ^DISABLE PRINTER LINE COUNTER OVERFLOW
.INDENT -5
16* ^SET MAX TRANSMISSION BLOCK SIZE
.BREAK
</BUFSIZ:<D
.INDENT -5
17 ^DO SPACE COMPRESSION ON OUTPUT
.INDENT -5
18 ^DON'T DO SPACE COMPRESSION ON OUTPUT
.INDENT -5
19 ^USE OLD PROTOCOL
.INDENT -5
20 ^DON'T USE OLD PROTOCOL
.INDENT -5
21 ^REQUEST OUTPUT PERMISSION
.INDENT -5
22 ^GRANT INPUT PERMISSION
.INDENT -5
23 ^SIGNAL OUTPUT <EOF
.INDENT -5
24 ^CLEAR OUTPUT <EOF COMPLETE
.INDENT -5
25 ^SIGNAL OUTPUT ABORT
.INDENT -5
26 ^CLEAR OUTPUT ABORT COMPLETE
.INDENT -5
27 ^CLEAR INPUT <EOF COMPLETE
.INDENT -5
28 ^SIGNAL INPUT ABORT
.INDENT -5
29 ^CLEAR INPUT ABORT COMPLETE
.SKIP 1
.INDENT -5;* INDICATES ADDITIONAL SWITCHES ASSOCIATED WITH /<CMD
.LM -15;.SKIP 1
.LM +5
EXAMPLES:
.SKIP 1;.UPPER CASE
SET DEVICE:3
.BREAK
SET DEVICE:2/CMD:25
.BREAK
SET DEVICE/CMD:25
.BREAK
SET DEVICE:1/CMD:16/BUFSIZ:512
.LM -5;.LOWER CASE;.SKIP 1
.HL 1 SET SIMULATE COMMAND
FORM##^^SET SIMULATE/PORT:\O/LINE:\D/DEVICE:\\D/2780 OR /3780
.SKIP 1
^THE <SET <SIMULATE COMMAND IS USED TO DEFINE A PARTICULAR PORT, LINE,
AND DEVICE TO BE A 2780 OR 3780 IN <SIMULATE MODE. ^THE DEFAULT IS
3780 IF THE /2780 OR /3780 SWITCH IS NOT INCLUDED.
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
SET SIMULATE/PORT:1/LINE:2/DEVICE:1/3780
.BREAK
SET SIMULATE
.BREAK
SET SIMULATE/2780
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 SET SUPPORT COMMAND
FORM##^^SET SUPPORT/PORT:\O/LINE:\D/DEVICE:\\D/2780 OR /3780
.SKIP 1
^THE <SET <SUPPORT COMMAND IS USED TO DEFINE A PARTICULAR PORT, LINE,
AND DEVICE TO BE A 2780 OR 3780 IN <SUPPORT MODE. ^THE DEFAULT IS
3780 IF THE /2780 OR /3780 SWITCH IS NOT INCLUDED.
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
SET SUPPORT/PORT:1/LINE:2/DEVICE:1/3780
.BREAK
SET SUPPORT
.BREAK
SET SUPPORT/2780
.LM -5;.SKIP 1;.LOWER CASE
.CHAPTER STATUS COMMANDS
^THE <STATUS COMMAND IS USED TO READ <DN60, LINE, OR DEVICE STATUS.
^THE FOLLOWING <STATUS COMMANDS ARE AVAILABLE:
.LS;.UPPER CASE
.LE;STATUS DN60 or PORT
.LE;STATUS LINE
.LE;STATUS DEVICE
.LE;STATUS ALL
.ELS;.LOWER CASE
.HL 1 STATUS DN60 or PORT
FORM##^^STATUS DN60:\\PN OR ^^PORT:\\PN
.SKIP 1
^THE <STATUS <DN60 OR <PORT COMMAND IS USED TO READ THE <DN60 STATUS. ^THE <DN60
OR PORT NUMBER MUST BE SET PRIOR TO ISSUING THIS COMMAND OR SET BY
INCLUDING THE <DN60 NUMBER.
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
STATUS DN60:1
.BREAK
STATUS DN60
.BREAK
STATUS PORT:11
.BREAK
STATUS PORT
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 STATUS LINE
FORM##^^STATUS LINE:\\LN</PORT:<PN\\
.SKIP 1
^THE <STATUS <LINE COMMAND IS USED TO READ THE LINE STATUS. ^THE
PORT NUMBER MUST BE SET PRIOR TO ISSUING THIS COMMAND OR SET BY
USING THE /<PORT SWITCH.
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
STATUS LINE:1
.BREAK
STATUS LINE
.BREAK
STATUS LINE:2/PORT:1
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 STATUS DEVICE
FORM##<STATUS <DEVICE:<DN</LINE:<LN/<PORT:<PN
.SKIP 1
^THE <STATUS <DEVICE COMMAND IS USED TO READ DEVICE STATUS. ^THE
PORT AND LINE NUMBERS MUST BE SET PRIOR TO ISSUING THIS COMMAND
OR SET BY USING THE </LINE AND/OR </PORT SWITCHES.
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
STATUS DEVICE:1
.BREAK
STATUS DEVICE
.BREAK
STATUS DEVICE:1/LINE:2
.BREAK
STATUS DEVICE:2/LINE:1/PORT:7
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 STATUS ALL
FORM##<STATUS <ALL/PORT:<PN/<LINE:<LN/<DEVICE:<DN
.SKIP 1
^THE <STATUS <ALL COMMAND IS USED TO READ THE <DN60, LINE, AND
DEVICE STATUS. ^THE PORT, LINE, AND DEVICE NUMBERS MUST BE
SET PRIOR TO ISSUING THIS COMMAND OR SET BY USING THE /<PORT,
/<LINE, AND/OR </DEVICE SWITCHES.
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
STATUS ALL
.BREAK
STATUS ALL/PORT:1/LINE:2/DEVICE:1
.LM -5;.SKIP 1;.LOWER CASE
.CHAPTER INPUT AND OUTPUT COMMANDS
^THE <INPUT AND <OUTPUT COMMANDS ARE USED TO READ AND WRITE DATA,
AND TO PROVIDE PERFORMANCE FIGURES IF SUCH IS DESIRED. ^MANY OPTIONS
ARE AVAILABLE AND CAN BE SPECIFIED IN THE FORM OF SWITCHES TO
THE COMMAND AS DESCRIBED BELOW.
.SKIP 1
FORM###<INPUT <DEV:FILENAME.EXT[<P,PN]/SWITCHES
.SKIP 1
FORM##<OUTPUT <DEV:FILENAME.EXT[<P,PN]/SWITCHES
.HL 1 SWITCHES
.LM +15
.INDENT -10;</PORT:<O ^USED TO SET THE <DL10 PORT NUMBER IF NOT PREVIOUSLY SET.
.INDENT -10;</LINE:<D ^USED TO SET THE LINE NUMBER IF NOT PREVIOUSLY SET.
.INDENT -10;</DEVICE:<D ^USED TO SET THE DEVICE NUMBER IF NOT PREVIOUSLY SET.
.INDENT -10;</BUFSIZ:<D ^SIZE OF THE <PDP-10 DATA BUFFER IN WORDS. ^THE
DEFAULT IS DETERMINED BY THE NUMBER OF BYTES (</NUMBYT)
.INDENT -10;</BYTPOS:<D ^THE POSITION OF THE FIRST BYTE IN THE DATA BUFFER.
.INDENT -10;</BYTWRD:<D ^THE NUMBER OF BYTES PER WORD IN THE
DATA BUFFER. ^THE DEFAULT IS 5 WHICH IS 7 BIT BYTES.
.BREAK
3 12 BIT BYTES
.BREAK
4 8 BIT BYTES
.BREAK
5 7 BIT BYTES
.BREAK
6 6 BIT BYTES
.INDENT -10;</CCC:<O ^THE CARRIAGE CONTROL CHARACTER TO BE
INSERTED AFTER THE CARRIAGE RETURN WHEN USING THE INTERNAL CHARACTER
GENERATOR. ^THE DEFAULT IS 12 WHICH IS A LINE FEED.
.INDENT -10;</DEVTYP:<D 0 = UNKNOWN, 1 = PRINTER, 2 = PUNCH
3 = READER. ^THE DEFAULT IS 0.
.INDENT -10;</FCHAR:<O ^THE FIRST CHARACTER IN THE RIPPLE PATTERN WHEN
USING THE INTERNAL CHARACTER GENERATOR FOR OUTPUT. ^THE DEFAULT IS 40.
.INDENT -10;</LCHAR:<O ^THE LAST CHARACTER IN THE RIPPLE PATTERN WHEN
USING THE INTERNAL CHARACTER GENERATOR FOR OUTPUT.
^THE DEFAULT IS 176.
.INDENT -10;</NUMBYT:<D ^THE NUMBER OF BYTES TO USE IN THE BUFFER.
^THE DEFAULT IS 4000.
.INDENT -10;</NUMCHR:<D ^THE NUMBER OF CHARACTERS TO TRANSMIT BEFORE
SENDING AN <EOF.
.INDENT -10;</OFFSET:<D ^THE WORD IN THE DATA BUFFER WHERE DATA TRANSFERS
BEGIN, OR THE WORD USED WHEN CALCULATING THE THE FIRST BYTE POSITION.
.INDENT -10;</TIME:<D ^THE TIME IN SECONDS BETWEEN STATISTIC REPORTS.
^THE DEFAULT IS 10 SECONDS. ^A TIME OF 0 SPECIFIES NO STATISTIC REPORTS
ARE TO BE MADE.
.INDENT -10;</WIDTH:<D ^THE WIDTH OF A LINE WHEN USING THE INTERNAL
CHARACTER GENERATOR. ^THE DEFAULT IS 132.
.LM -15
.HL 1 FILE SPECIFICATION
^ON OUTPUT IF THE FILE SPECIFICATION IS NOT INCLUDED THE OUTPUT IS GENERATED
USING AN INTERNAL CHARACTER GENERATOR THAT GENERATES OUTPUT IN THE
FORM OF A RIPPLE PATTERN.
.LM +5;.SKIP 1
EXAMPLE:
.SKIP 1;.UPPER CASE
ABCD
.BREAK
BCDE
.BREAK
CDAB
.BREAK
DABC
.LM -5;.SKIP 1;.LOWER CASE
^ON INPUT IF THE FILE SPECIFICATION IS NOT INCLUDED THE INPUT IS
PLACED IN A "BIT-BUCKET".
.SKIP 1
^IF PART OF THE FILE SPECIFICATION IS MISSING IT
IS GIVEN A DEFAULT AS SHOWN BELOW:
.SKIP 1
.LM +5
.UPPER CASE
INPUT OUTPUT
.SKIP 1
DEV: DSK DSK
.BREAK
FILENAME INPUT OUTPUT
.BREAK
EXTENSION IN JOB
.BREAK
P,PN OWN OWN
.LM -5;.LOWER CASE
.HL 1 STATISTIC REPORTS
^THE FOLLOWING IS A DESCRIPTION OF THE STATISTIC REPORT THAT IS
GENERATED:
.LM +15;.SKIP 1
.INDENT -10;^TIME ^TIME SINCE LAST REPORT
.INDENT -10;^LINES/MIN ^LINES PER MINUTE
.INDENT -10;^CHARS/SEC ^CHARACTERS PER SECOND
.INDENT -10;^CHARS ^CHARACTERS INPUT/OUTPUT SINCE THE LAST REPORT
.INDENT -10;^BUFTRY ^DATA BUFFERS ATTEMPTED
.INDENT -10;^BUFDLY ^DATA BUFFERS DELAYED
.INDENT -10;^BUFCOM ^DATA BUFFERS COMPLETED
.INDENT -10;<C11E4 ^NUMBER OF <CAL11. UUO ERROR 4'S (UUO IN USE)
.LM -15
.HL 1 EXAMPLES
.LM +5;.UPPER CASE
INPUT
.BREAK
INPUT /PORT:2/LINE:1/DEVICE:1
.BREAK
INPUT DSKB:IN.FIL[226,1100]/TIME:59
.SKIP 1
OUTPUT /PORT:2/LINE:1/DEVICE:1
.BREAK
OUTPUT
.BREAK
OUTPUT DSKC:OUT.FIL/PORT:2/LINE:1/DEVICE:1
.BREAK
OUTPUT /FCHAR:101/LCHAR:105/WIDTH:5/NUMBYT:100
.BREAK
OUTPUT /NUMCHR:40000
.LM -5;.SKIP 1;.LOWER CASE
.CHAPTER THE OTHER COMMANDS
.HL 1 ABORT COMMAND
.INDENT 5;FORM##^^ABORT/PORT:\P\N/LINE:\L\N/DEVICE:\D\N/INPUT \\AND/OR ^^/OUTPUT/WAIT \\OR^^ /NOWAIT\\
.SKIP 1
^THE <ABORT COMMAND IS USED TO ISSUE ^INPUT AND/OR ^OUTPUT ABORT
COMMANDS TO THE <DN60, AND OPTIONALLY WAIT FOR THE ABORT SEQUENCE
TO COMPLETE BY USING THE </WAIT SWITCH. ^THE PORT, LINE, AND DEVICE
NUMBERS MUST BE SET PRIOR TO ISSUING THE <ABORT COMMAND OR THEY
CAN BE SET BY USING THE </PORT, </LINE, AND </DEVICE SWITCHES.
^THE DEFAULT IS BOTH </INPUT AND </OUTPUT AND </NOWAIT.
.LM +5;.SK 1
EXAMPLES:
.SKIP 1;.UPPER CASE
ABORT/INPUT/OUTPUT
.BREAK
ABORT/INPUT/OUTPUT/WAIT
.BREAK
ABORT/INPUT/OUTPUT/NOWAIT
.BREAK
ABORT/WAIT
.BREAK
ABORT/NOWAIT/PORT:2/LINE:3/DEVICE:1
.LM -5;.LOWER CASE
.HL 1 AUTO COMMAND
^THE <AUTO COMMAND IS USED TO EXECUTE A SEQUENCE OF <D60SPD COMMANDS
CONTAINED IN A <DSK FILE. ^THE DEFAULT FILENAME IS <D60SPD.ATO.
.LM +5;.SKIP 1
EXAMPLES:
.SKIP 1;.UPPER CASE
AUTO
.BR
AUTO DSKE:CMD.FIL[123,456]
.BR
AUTO DSKZ:D60.ATO[234,5670,ONE,TWO,THREE,FOUR,FIVE]
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 DDT COMMAND
^THE <DDT COMMAND IS USED TO ENTER <DDT IF <DDT WAS LOADED
WITH <D60SPD. ^IF THIS COMMAND IS GIVEN AND <DDT WAS NOT
LOADED, A WARNING MESSAGE WILL BE GIVEN. ^ONCE IN <DDT
IF <GOBACK$G OR ^^POPJ#P,$X\\ IS GIVEN <D60SPD WILL RESUME.
.LM +5;.SKIP 1
EXAMPLE:
.SKIP 1;.UPPER CASE
DDT
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 EOF COMMAND
^THE <EOF COMMAND IS USED TO SEND AN <EOF WHILE DOING OUTPUT. ^IF THIS
COMMAND IS GIVEN AT ANOTHER TIME IT IS IGNORED.
.LM +5;.SKIP 1
EXAMPLE:
.SKIP 1;.UPPER CASE
EOF
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 NOTYPEAHEAD COMMAND
^THE <NOTYPEAHEAD COMMAND IS USED TO IGNORE COMMANDS GIVEN DURING
RUNTIME. ^ONCE THIS COMMAND IS GIVEN THE ONLY WAY TO REVERSE IT
IS WITH THE <TYPEAHEAD COMMAND WHEN IN THE IDLE LOOP. ^IF
<NOTYPEAHEAD IS SET IT IS ADVISED TO USE THE </NUMCHR SWITCH
WITH THE <OUTPUT COMMAND AS THE <EOF COMMAND WOULD BE IGNORED
AND THE ONLY WAY TO TERMINATE OUTPUT WOULD BE TO CONTROL-^C
<D60SPD.
.LM +5;.SKIP 1
EXAMPLE:
.SKIP 1;.UPPER CASE
NOTYPEAHEAD
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 EXIT COMMAND
^THE <EXIT COMMAND IS USED TO RETURN TO MONITOR MODE FROM <D60SPD.
.LM +5;.SKIP 1
EXAMPLE:
.SKIP 1;.UPPER CASE
EXIT
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 PARAM COMMAND
^THE <PARAM COMMAND IS USED TO TYPE OUT THE CONTENTS OF THE
<CAL11. <UUO PARAMETER BLOCK.
.LM +5;.SKIP 1
EXAMPLE:
.SKIP 1;.UPPER CASE
PARAM
.LM -5;.SKIP 1;.LOWER CASE
.HL 1 RESTART COMMAND
^THE <RESTART COMMAND IS USED TO RESTART <D60SPD. ^THIS
WOULD BE THE EQUIVALENT OF DOING:
.SKIP 1;.I 5;_^<C
.I 5;_^<C
.I 5;^<START
.SKIP 1
.I 5;EXAMPLE:
.SK 1;.I 5;<RESTART
.SK 1
.HL 1 TYPEAHEAD COMMAND
^THE <TYPEAHEAD COMMAND IS USED TO ENABLE <D60SPD TO ACCEPT
TYPEAHEAD DURING RUNTIME. ^THIS COMMAND IS THE REVERSE OF
THE <NOTYPEAHEAD COMMAND BUT ONCE <NOTYPEAHEAD IS SET
<D60SPD MUST BE IN THE IDLE LOOP BEFORE IT WILL ACCEPT THE
<TYPEAHEAD COMMAND.
.SKIP 1;.I 5;EXAMPLE:
.SKIP 1;.I 5;<TYPEAHEAD
.SKIP 1
.HL 1 WHAT COMMAND
^THE <WHAT COMMAND IS USED TO DISPLAY THE CURRENTLY SELECTED
<PORT, <LINE, AND <DEVICE NUMBERS.
.SKIP 1;.I 5;EXAMPLE:
.SKIP 1;.I 5;<WHAT
.SKIP 1
.CHAPTER INTERNAL PROGRAM OVERVIEW
<D60SPD USES A VERB TYPE COMMAND DECODER. ^THE COMMAND IS
READ AND CHECKED FOR EXACTNESS AND UNIQUENESS AND DISPATCHES
TO THE APPROPRIATE ROUTINE TO FURTHER PROCESS THE COMMAND. ^THE
<SET AND <STATUS COMMANDS WILL FURTHER DISPATCH TO ANOTHER ROUTINE
BASED UPON THE FUNCTION THEY ARE TO PERFORM. ^DURING <INPUT OR <OUTPUT,
CHECKS ARE MADE TO SEE IF A COMMAND MAY BE PENDING AND IF SO IT WILL
BE EXECUTED, AND THE <INPUT OR <OUTPUT OPERATION WILL BE CONTINUED,
(UNLESS OR COURSE THE COMMAND WAS <ABORT, <DDT, <EXIT, OR <RESTART). ^THIS ALLOWS
ONE TO EXAMINE STATUS OR ISSUE COMMANDS WHILE RUNNING WITHOUT
THE NEED FOR AN ADDITIONAL JOB.
^A SIMPLE FLOW DIAGRAM IS SHOWN BELOW.
.PAGE
.LT
START -> OPER -> ABORT --- ABTCOM -------------------->!
^ DDT ----- DDTCOM -- ENTER DDT !
^ EOF ----- EOFCOM -------------------->!
^ EXIT ---- EXTCOM -------------------->!
^ HELP ---- HLPCOM -------------------->!
^ NOTYPE -- NOTCOM -------------------->!
^ PARAM --- PRMCOM -------------------->!
^ RESTART - RSTCOM -- GOTO START !
^ TYPEAH -- TYPCOM -------------------->!
^ WHAT ---- WHTCOM -------------------->!
^ STATUS -- STSCOM -- DN60 -- D60STS -->!
^ -- PORT -- D60STS -->!
^ -- LINE --- LINSTS ->!
^ -- DEVICE - DEVSTS ->!
^ SET ----- SETCOM -- LINE --- SETLIN ->!
^ -- DEVICE - SETDEV ->!
^ -- SIMULA - SETSIM ->!
^ -- SUPPOR - SETSUP ->!
^ INPUT --- INCOM --- IOCOM ----------->!
^ OUTPUT -- OUTCOM -- IOCOM ----------->!
^ !
^ AUTO ---- OPER ---- EXECUTE CMD -->! !
^ ! ^ ! !
^ ! ^ ! !
^ ! --------------------------------V !
^ ! !
^ V V
^<--------------------------------------------
.EL
.CHAPTER COMMAND AND SWITCH TABLES
^ALL COMMAND AND SWITCH NAMES ARE CONTAINED IN TABLES WITH
THE CORRESPONDING ADDRESS TABLE IMMEDIATELY FOLLOWING THE SIXBIT
NAME TABLE. ^THESE TABLES ARE ALL BUILT BY DEFINING A <NAMES MACRO
WHICH CONTAINS THE COMMANDS OR SWITCHES, AN ADDRESS AND A
VALUE TO INDICATE WHETHER TO DISPATCH OR TO STORE A VALUE FROM
A SWITCH. ^CALLING THE <BUILD MACRO AFTER DEFINING THE <NAMES MACRO
WILL BUILD THE NAMES TABLE AND THE ADDRESS TABLE.
.HL 1 NAMES MACRO
.INDENT 5;FORMAT:
.LM +5;.SKIP 1
.UPPER CASE
DEFINE NAMES,_<
.BREAK
SWT NAME,ADDRESS,CODE,DEFAULT VALUE
.BREAK
_>
.SKIP 1;.LOWER CASE
WHERE:
.SKIP 1
.LM +15
.SKIP 1
.INDENT -10;<SWT IS THE MACRO NAME USED BY THE <BUILD MACRO
.INDENT -10;<NAME IS THE SWITCH OR COMMAND NAME
.INDENT -10;<ADDRESS IS THE ADDRESS TO DISPATCH TO OR STORE A VALUE IN
.INDENT -10;<CODE IS A NUMBER THAT INFORMS WHAT ACTION THE
COMMAND DECODER IS TO PERFORM
.LM +5
.SKIP 1
.INDENT -5;0 CHECK SWITCH HAS A COLON BEFORE DISPATCHING
TO <ADDRESS
.INDENT -5;1 STORE <SIXBIT ARG IN <ADDRESS
.INDENT -5;2 STORE <DECIMAL ARG IN <ADDRESS
.INDENT -5;3 STORE <OCTAL ARG IN <ADDRESS
.INDENT -5;4 DISPATCH TO <ADDRESS WITHOUT CHECKING FOR
A COLON
.INDENT -5;5 STORE <SIXBIT ARG IN <T1 AND DISPATCH
TO <ADDRESS
.INDENT -5;6 STORE <DECIMAL ARG IN <T1 AND DISPATCH
TO <ADDRESS
.INDENT -5;7 STORE <OCTAL ARG IN <T1 AND DISPATCH
TO <ADDRESS
.INDENT -5;1^X PRINT A <CRLF WHEN DOING THE AUTO FILE AND
THE VALUE FOR ^X IS 0-7 AS ABOVE
.LM -5;.SKIP 1
.INDENT -10;<DEFVAL IS THE DEFAULT VALUE THAT WILL BE FILLED INTO
<ADDRESS IF THE <CODE IS 1-3. (^THIS IS ONLY USED IN THE
<INPUT/OUTPUT ROUTINE.
.LM -15;.SKIP 1
.LM -5
.LM +5
EXAMPLE:
.SKIP 1
^DEFINE <NAMES,_<
.SK 1;.I 5;^^SWT###HELP,HLP,4\\
.I 5;^^SWT###BUFSIZ,SIZE,2\\
.SKIP 1;_>;^END DEFINE <NAMES
.LM -5;.SKIP 1
.HL 1 BUILD MACRO
^THE <BUILD MACRO IS CALLED IMMEDIATELY FOLLOWING THE DEFINITION
OF THE <NAMES MACRO TO BUILD THE SIXBIT TABLE OF NAMES, THE
ADDRESS TABLE, AND THE OPTIONAL DEFAULT VALUE TABLE.
.SKIP 1
.LM +5
FORMAT:
.SKIP 1;^^BUILD###(PREFIX,NAME,DISPATCH,DEFAULT)\\
.SKIP 1
.LM +5
WHERE:
.SKIP 1
<PREFIX IS THE PREFIX ATTACHED TO:
.SKIP 1
.LM +10
.I -10;<TAB FOR THE TABLE OF SIXBIT NAMES
.I -10;<DSP FOR THE ADDRESS TABLE
.I -10;<DEF FOR THE DEFAULT VALUE TABLE
.LM -10;.SK 1
AND THE SUFFIX ATTACHED TO .<NM WHICH WILL BE THE SYMBOL
WHICH REPRESENTS THE LENGTH OF THE TABLE OF NAMES.
.SK 1
<NAME IF NON-BLANK WILL GENERATE THE TABLE OF NAMES
.BREAK
<DISPATCH IF NON-BLANK WILL GENERATE THE ADDRESS TABLE
.BREAK
<DEFAULT IF NON-BLANK WILL GENERATE THE DEFAULT VALUE TABLE
.LM -5
.LM -5
.LM +5
.SK 1
EXAMPLE:
.SK 1
^^BUILD###(CMD,NAM,DSP,DEF)
.LM -5