& &HELP - NEW ENGLAND DISTRICT - FIELD SERVICE PDP-8 DIAGNOSTIC SYSTEM . . . Version 5 OS/8 V3D DECX8 Rev. E Restart Addr = 07600 Type: .R PROG - to run a system program .R PROG.DG - to run a diagnostic program .RUN RKB0:PROG.DG - to run a diagnostic from RKB0: .HELP - to type this text file .HELP INFO - for more info .HELP FILENAME - to type a HELP file on the terminal .HELP FILENAME-L - to print same on the printer .SET SYS INIT HELP - to print this text upon startup .SET SYS NO INIT - to boot without this text default Note: "PROG" / "FILENAME" refers to specific program or file &INFO PDP-8 FIELD SERVICE DIAGNOSTIC SYSTEM . . . Ver. 5 - released March 1981 by New England District Support - - For Diagnostic names, type ".HELP DEVICE", where "Device" is the option you want to reference, ie: try ".HELP RK05" and see what happens. For all the diagnostic names, type ".HELP DIAG" - Several System Programs such as "DIRECT","BUILD","FUTIL", as well as various utilities such as "RKUTIL" and "RKCOPY" have HELP files. To review these, type "HELP [Prog name]. - Before trying to run the program "BUILD.SV", please read the HELP files ! This procedure is advised for knowledgable users only ... be sure that you have ".SET SYS NO INIT" before using ! - PLEASE remember not to make packs for customer sites with the programs "RKCOPY" or "RKUTIL" ... use ".SU CUSPAC" ! ! - For more information, type "HELP MORE" &MORE STILL MOORE INFO ON THE SYSTEM ... - This is essentially an OS-8 system; all rules apply - There are several ".TX" documents on the "RKB0:" area that detail this system, OS-8 in general, and the DECX8 system exerciser. - To print a System Information Package on a line printer, type ".SU BOOK" - There are two (2) printer handlers available for the LA180 and LQP8. For further information on using the LQP printer under OS/8, type "HELP LQP". - Notice that "BASIC", and all supporting progams have been moved to "RKB0:" . To access BASIC or play any of the games, it is neccessary to boot to RKB0:. This is done by typing ".R RKBOOT/B" . Return to normal by typing ".R RKBOOT/0". Typing ".HELP" when booted onto RKB0: will display a menu of available games. - By the way, if you are not running from an RK05, the RKB0: features are unavailable. The RL01 version has "RL0B:", but it may not be booted. &DEV &DEVICE NO , NO, NO . . . by ".HELP DEVICE", we mean to substitute the name of the device you want the diagnostic name of for "DEVICE" ie: ".HELP RK05" ".HELP TM8E" ".HELP TC08" etc. Also, some system programs have help files, ie: ".HELP SVDUMP" &PROG &PROGNAME &[PROG] &[PROGNAME] OOPS ! YOU GOOFED ... by "HELP [prog]" we mean to substitute the name of the program you want help with. For example: .HELP RXREAD" types the help file for the Floppy Read Check progam on the terminal. &FILE &FILENAME Some people never listen!! The command "HELP FILENAME" is used to obtain help on a particular program. For example, to get help for the program "RKUTIL", type "HELP RKUTIL". &LQP &LPQ The letter quality printer used on many DEC word processing systems can be used as the default line printer. This can be used to allow the CCL "-L" option to HELP and DIRECT to output to the printer. To do this, type the OS/8 command ".SET HANDLER LPT=LQP". To switch back to the LA180 handler, type ".SET HANDLER LQP=LPT". &GAMES &FUN FUN and GAMES --------------- There are several Basic Games on the RKB0 surface of this disk. To play them, you must first boot to the "B" surface by: ".R RKBOOT/B" after you are on the "B" surface, type ".HELP GAMES" for more specific information. There are separate Games Floppys available for RX01 users. NOTE: to play "ADVENTURE", you must have 32K of memory ! &DECX &DECX8 DECX8 SYSTEM EXERCISER ------------------------ REFERENCE THE FILE "RKB0:DECX8.TX" FOR ADDITIONAL INFORMATION. ALSO, THERE ARE DOCUMENTS ON THE MICROFICHE LIBRARY FOR BUILDING AND INITIALIZING DECX8. &ALIGN &ALIGNX &ALIGNX.DG ALIGNX - RK05 ALIGNMENT UTILITY ----------------------------------- To run this utility, type: .R ALIGNX.DG for a full explaination of the utility and a step-by-step procedure for aligning an RK05, type: .LIST RKB0:ALIGN.TX &FLOP1 &FLOP2 &FLOP3 &FLOP4 &FLOPX8 &FLOP1.BI &FLOP2.BI &FLOP3.BI &FLOP4.BI &FLOPX8.BI BATCH STREAMS -------------- These batch streams are designed to provide an easy method of creating diagnostic floppies. They are: .SUB FLOP1 - creates floppy of VT78, 8A, & 8E diagnostics .SUB FLOP2 - creates floppy of RX01 & RK05 diagnostics .SUB FLOP3 - creates floppy of RL01 diagnostics .SUB FLOP4 - creates floppy of VT, LA, LP, cte. diagnostics .SUB FLOPX8 - creates a DECX8 floppy system &RXREAD RXREAD - RX01 Floppy read check utility ------ This program is used to read a RX01 floppy disk and check it for any errors. The error report consists of the following: - The track and sector number (in octal) of the bad sector - The RX01 error and status (RXES) register contents - The explanation of the RXES value (for example, if the error is a CRC error, it will say "CRC Error") - The RX Definitive error code, and its description. After an error, the program will ask if it is to re-write the bad sector. This question should be answered with "N" (no), unless the error was a CRC error. In this case, the sector can be re-written, which may (but may not) correct the error. In any case, the data is re-written with a good CRC. This may make at least part of a bad block usuable. &CONVRT CONVRT.SV SAVE FORMAT - BINARY FILE PUNCHER THIS PROGRAM PRODUCES AN ABSOLUTE BINARY FILE FROM AN OS/8 SAVE FILE. ONLY THOSE AREAS OF MEMORY SPECIFIED IN THE CORE CONTROL BLOCK ARE ACTUALLY PUNCHED. COMMAND DECODER RESPONSE IS: OUTPUT < INPUT, INPUT ..... DEFAULT INPUT EXTENSION IS ".SV", DEFAULT OUTPUT IS THE HIGH SPEED PAPER TAPE PUNCH. &FUTIL FUTIL.SV FUTIL IS AN OS-8 UTILITY PROGRAM THAT IS EXTREMELY USEFUL I F Y O U K N O W W H A T Y O U ' R E D O I N G -- ----- ------- ------- ----------- --------- IT IS EQUALLY AS DANGEROUS IF YOU DON'T !!!!! There are two (2) useful examples of FUTIL in the file "OS8.TX" on RKB0: There is also a rather lengthly file "FUTIL.TX" located on RKB0: &SDUMP &SVDUMP SVDUMP.SV THIS PROGRAM DUMPS THE CONTENTS OF A SAVE FILE IN OCTAL AS A LOADED CORE IMAGE. APPROPRIATE COMMAND DECODER RESPONSE IS "OUTPUT < INPUT1,INPUT2,..." DEFAULT OUTPUT IS LPT, DEFAULT INPUT EXTENSION IS .SV. DUMP FORMAT IS NORMALLY 20 (OCTAL) WORDS WIDE, ABOUT 105 COLUMNS. SPECIFYING A "/N" OPTION CHANGES THE FORMAT TO 10 WORDS WIDE, ALLOWING IT TO FIT ON A TTY. &QUIT QUIT.SV - Directory Backup Program By typing: ".QUIT" , you can backup your Directory to a file called "DIRECT.TS" on RKB0:. If the disk crashes, and the directory area is destroyed, it may be restored by booting to the "B" area of the disk, and using FUTIL to write this file back onto the "A" area as the new directory. PLEASE NOTE that this is for extreme cases only ! Read the section on Advanced Techniques on the file "DIAG.TX" on RKB0: before attempting this procedure. Periodic use of this program is an essential part of the housekeeping discipline that allows use of the Disk Recovery Techniques described on the file "DIAG.TX" &RKCOPY RKCOPY RK05 DISC COPY PROGRAM ------ ---------------------- This utility, written by Dick Murphy, copies and verifys RK05 packs between any drives. Since this is a sector by sector copy, it will copy any operating system . When called, the dialog is self explainatory. To run type: .R RKCOPY &RKUTIL RKUTIL RK05 UTILITY PROGRAM ------ --------------------- This utility has several handy options including a - Disk Copy Program that will copy & verify any 16 sector disk - Disk Read Program that will verify that a disk has no CRC errors - Disk Formatter Program to format new disks - Disk Confidence Test that runs data patterns on a suspect disk &HEADER HEADER.SV .R HEADER DEVICE NAME? SYS or SYS: or DSK or RKB1 or RXA1: etc. DEVICE LENGTH? 737 or 3248 or 494 or (incl. directory blocks) if the device contains a system area the following applies: SYSTEM ID? OS/8, OS/12, OS/78, DS/8, or PS/8 VERSION NO.? 3 or whatever RELEASE CODE? C or D or ...... if there is no system area the questions above are skipped LOGICAL DEVICE NAME? CHEM or BOB: or UWF or ?? (1-4 letters) VOLUME NO.? 1 or any number up to 4095; 0 = none DESCRIPTIVE LABEL? Here you may enter any identifying information (UPPER/lower case, as you wish) - up to 128 characters, including CR/LF. Terminate input with a CTRL/Z. Rubout and linefeed work in their normal OS/8 fashion.(^Z) &INUSE LOADING THE INUSE MACRO ----------------------- .R TECO *ERINUSE.TE$YHXIHK$MI$$ &WILD "WILD.TE" - Wildcard Macro ----------------------------- The Wildcard macro, with the new version of CCL, allows the use of "*" and "?" in otherwise illegal commands. ex: .MAC RKB0:" | BK SP Go to end of line * | UP | DELETE* | DELETE | CURSOR | DELETE Delete previous * | LINE* |CHARACTER| LAST | RIGHT* | |---------|---------|---------|---------| | "1" | "2" | "3" | "<" | ARGUMENTS | TOP | BOTTOM | START | CURSOR | | OF PAGE | OF PAGE | OF LINE | LEFT*| All starred (*) commands |---------|---------|---------|---------| Optionally take an argument | "0" | "." | "ENTER" | entered as [ESC] [digits] | DOWN LINE* | SEARCH* | SEARCH | | | |ARGUMENT*| ----------------------------------------- &WPFLOP WPFLOP User's Guide This document describes the operation of the word processing to OS/8 conversion program, WPFLOP. USAGE WPFLOP is used to transfer documents from word processing floppy disks to OS/8 media or from OS/8 media to word processing diskettes. The WPS floppy is accessed using the COS compatible floppy handlers included in this package. There are various modes of conversion which will be explained later. OPERATION WPS->OS/8 Before using WPFLOP to access a WPS floppy, one must know the number of the document which is to be read from the WPS floppy. For example, in the sample index below, the column labeled "Document number" is the number that WPFLOP uses to reference a document. -- DOCUMENT INDEX -- Drive: 3, Name: DOC3 , # of Docs: 3, Blocks left: 621 (of 627) ------------------------------------------------------------------------------ - Document Elapsed Time Number Name Created Modified Size Version Last Total ------------------------------------------------------------------------------ - 3 Floppy Index 12/7/79 NO/DA/TE 3 1 0:00 0:00 2 WPFLOP User's Guide 12/7/79 12/7/79 13:09 2 1 0:07 0:07 1 12/3/79 12/7/79 13:10 1 4 0:00 0:00 The document "WPFLOP User's Guide" (this file) is document number 3. This is the number that WPFLOP uses to access the file. Before running WPFLOP, the COS mode floppy handlers must be install ed in your OS/8 system. See the BUILD chapter in the OS/8 System Ref erence Manual for details on using BUILD. You can type ".HELP COSHAN" for further information on the handlers. This document assumes that the handlers have been installed with names of "RXB0:" for drive zero, and "RXB1:" for drive one. Another method for installing the BYTE mode handlers is via the SET HANDLER command. To enable BYTE mode, type ".SET HANDLER FLOP = BYTE" and to return to normal mode, ".SET HANDLER BYTE = FLOP". To copy the document "WPFLOP User's Guide" to a file on the OS/8 system device called WPFLOP.DC, use the following commands: .R WPFLOP *WPFLOP.DCOS/8 command syntax is as follows: *[dev:file.ex]WPS To transfer an OS/8 File to WPS, use the following syntax: *wdev:Foobar <#>4<> The form used is: Name space <#>doc#<> The n in the <> must be lower case, and the name must end with a space. &RTFLOP RT-11 Floppy Interchange Program Written by: Dick Murphy Digital Equipment Corporation Santa Clara, CA 95051 User's notes This program is used to manipulate RT-11 floppy disk file structures under OS/8. (RX01 ONLY, RX02 Not supported). The operations available allow most of the functions of OS/8 PIP to be simulated on the RT-11 disk. These functions include: 1. Creating a file on a RT-11 floppy 2. Copying a file from an RT-11 floppy to an OS/8 device (disk, dectape, TTY:, LPT:, etc.) 3. Deleting files from the RT-11 floppy 4. Listing the directory of the RT-11 floppy 5. ZEROing (INITing) the directory of a floppy to an empty state. The user interface is similar to the OS/8 command decoder. When the program desires file specifications, it prints an asterisk (*) and waits for input. The file specification line is very similar to OS/8's. A sample input line is detailed below: *RTFLOP.PAL$$ &SORT SORT.SV OS-8 File Sort Program ------- SORT: SORTS INFINATE NUMBER OF LINES IN ASSENDING OR DESENDING SEQUENCE ACCORDING TO ASCII CHARACTER SET, FAST! (TIME IN SECONDS TO SORT FILE OF N BLOCKS APROX= 3 + N/3 + N/10*(LOG10(N/10)) ). TO RUN: .R SORT * OUTPUT < ORDER, INFIL [,INFIL ...] WHERE: OUTPUT WILL CONTAIN SORTED FILE INFIL IS THE UNSORTED INPUT FILE ORDER SPECIFIES THE COLUMNS (IN DECIMAL, 1 IS LEFTMOST) TO BE SORTED; POSITIVE FOR ASSENDING, NEGATIVE FOR DECENDING; MAY USE FROM-TO: EG: "1-10,-12-19,11,-20,25-21" ERRORS: USER ERROR 2 SYS: I/O (HANDLER, FETCH, ETC) USER ERROR 3 INPUT DEVICE I/O USER ERROR 4 OUTPUT DEVICE I/O USER ERROR 5 BAD NUMBER IN ORDER FILE USER ERROR 6 NO INFIL USER ERROR 7 TO MANY NUMBERS IN ORDER FILE USER ERROR 8 NUMBER IN ORDER FILE TOO LARGE USER ERROR 9 LINE TOO LONG IN INFIL (128. CHAR MAX) OR A "^Y" IN INFIL &ASSIGN &DATE &DEASSIGN &GET &MEMORY &R &RUN &SAVE &START &SQUISH &UA &ZERO KEYBOARD MONITOR AN OTHER COMMANDS @CALLING COMMANDS: .ASSIGN DEV NAME /ASSIGN NAME TO DEVICE .DAY DD-MON-YY /ENTER DATE INTO SYSTEM .DEASSIGN /DEASSIGN LOGICAL DEVICE NAMES .GET DEV FILE.EX /LOAD CORE IMAGE .MEMORY N /SPECIFY HIGHEST MEMORY FIELD AVAILABLE .R FILE /EXECUTE FILE.SV FROM SYS .RUN DEV FILE.EX /EXECUTE FILE.EX FROM THE DEVICE .SAVE DEV FILE.EX /SAVE CORE IMAGE .SQUISH DEV: /COMPRESS FILE STORAGE ON DEVICE .START FNNNN /START EXECUTION .UA COMMAND /SAVE COMMAND(.UA EXECUTES IT) .ZERO DEV: /ZERO DEVICE'S DIRECTORY &OS-8 &OS8 &OS/8 &SYSTEM &SYS &CCL OS/8 MONITOR COMMANDS CMD PROG EXPL ASSIGN KBM ASSIGNS LOGICAL NAME BACKSP CAMP BACKSPACES DEV BASIC BASIC ENTERS BASIC SYSTEM BOOT BOOT BOOTSTRAPS TO DEV CCL CCL DISABLES CCL COMPARE SRCCOM COMPARES FILES COMPILE PAL8 COMPILES PROG F4/FORT BASIC RALF SABR COPY FOTP COPIES FILES CREATE EDIT OPENS FILE FOR EDITING CREF PAL8 ASSEMBLES AND CHAINS TO CREF CREF CREF'S LISTING DATE KBM/CCL SPECIFIES DATE DEAS CCL DEASSIGNS LOGICAL DEVICES DELETE FOTP DELETES FILES DIRECT DIRECT PRINTS DIRECTORIES DUPLIC RXCOPY COPIES RX DISKS EDIT EDIT EDITS FILE EOF CAMP WRITES END-OF-FILE EXECUTE PAL8 COMPILES AND EXECUTES F4/FORT BASIC RALF SABR ABSLDR LOADS AND EXECUTES LOAD(ER) GET KBM GETS CORE-IMAGE HELP HELP LIST'S HELP FILE LIST FOTP LISTS FILES LOAD ABSLDR LOADS FILES LOAD(ER) MAKE TECO MAKES NEW FILE FOR EDITING MAP BITMAP PRINTS BITMAP MEMORY CCL SPECIFIES MACHINE CORE SIZE MUNG TECO MUNGS FILE WITH TECO MACRO ODT KBM RUNS OCTAL DEBUGGER PAL PAL8 RUNS PAL8 PRINT LPTSPL RUNS 'LPTSPL' IF PRESENT PUNCH FOTP PUNCHES DATA R KBM RUNS PROGRAM FROM SYS: RENAME FOTP RENAMES FILES RESORC RESORC PRINTS RESOURCES OF SYSTEMS REWIND CAMP REWINDS DEV RUN KBM RUNS PROGRAM SAVE KBM SAVES CORE IMAGE SET SET ALTERS PARAMETERS SKIP CAMP SKIPS RECORDS SQUISH PIP SQUISHES DEV START KBM STARTS PROG SUBMIT BATCH STARTS BATCH JOB TECO TECO EDITS FILE TYPE FOTP TYPES FILES UA CCL REMEMBERS COMMAND UB CCL UC CCL UNLOAD CAMP UNLOADS DEV VERSION CCL TYPES VERSION # ZERO PIP ZEROES DEV @SWITCHES: -L OUTPUT TO LPT: -S OUTPUT TO TV: -T OUTPUT TO TTY: -P OUTPUT TO PTP: -D OUTPUT TO DUMP: -N OUTPUT TO NULL: -LS PRODUCE LISTING -NB NO BINARY YET -MP PRODUCE MAP -EXT SET DEFAULT EXTENSION @FEATURES: /X PASS SWITCH OPTION X TO PROGRAM (XYZ) PASS SWITCH OPTIONS TO PROGRAM [N] MAX OUTPUT SIZE =NNN PASS OCTAL NUMBER TO PROGRAM #NNN TAKE INTERNAL OCTAL FORM OF FILENAME @FILE REPLACE IN CMD LINE BY FILE'S CONTENTS $ COMPLEMENT DEFAULT ALTMODE SWITCH &ODT ODT @CALLING COMMANDS: .ODT @INTERNAL COMMANDS: NNNNN/ OPEN LOC / REOPEN LAST OPENED LOC NN DEPOSIT NN IN OPEN LOC, CLOSE LOC NN DEPOSIT NN IN OPEN LOC, CLOSE LOC, OPEN AND DISPLAY NEXT LOC NN;... DEPOSIT NN IN OPEN LOC, CLOSE AND OPEN NEXT LOC CLOSE PREVIOUSLY OPENED LOC CLOSE LOC, OPEN NEXT LOC N+ OPEN CUR LOC+N N- OPEN CUR LOC-N ^ CLOSE LOC, OPEN LOC ADDRESSED BY CONTENTS _ CLOSE LOC, OPEN POINTED TO BY CONTENTS NNG GO NNB ESTABLISH BREAKPOINT B REMOVE BREAKPOINT A OPEN AC L OPEN LINK C CONTINUE FROM BREAKPOINT NNC CONTINUE, ITERATE NN TIMES M OPEN SEARCH MASK OPEN LOWER SEARCH LIMIT OPEN UPPER SEARCH LIMIT NNW SEARCH CORE FOR NN MASKED BETWEEN LIMITS D OPEN DATA FIELD (0010=FIELD 1) F OPEN FIELD FOR ^, _, W (0010=FIELD 1) ^O SUPRESS PRINTING &ABSLDR ABSLDR.SV @CALLING COMMANDS: .LOAD DEV:BINFILE.BN,... .LOAD BINFILE.BN,... /FROM DSK @SWITCHES: /8 PROG DOESN'T USE BELOW 02000 /9 PROG DOESN'T USE BELOW 12000 /G GO /I CORE IMAGE FILE /P PROG DOESN'T DESTROY EXTENDED BATCH RESIDENT /R RESET /S MULTIPLE BINARIES/FILE /N FORCE LOADING TO FIELD N (N IS AN OCTAL DIGIT) =FNNNN SET STARTING ADDRESS &BATCH &SUBMIT BATCH.SV @CALLING COMMANDS: .SUBMIT SPOOLDEV: