CHQHLA0 XXDP+ HELP TEXT FILE (HELP.TXT) 9-JAN-79 ------------------------------- 1.0 XXDP+ MONITOR ------------------ 1.1 XXDP+ MONITOR COMMANDS: --------------------------- R FILENAME ADDR LOADS AND STARTS PROGRAM AT SPECIFIED ADDRESS (ADDRESS DEFAULTS TO XFR ADDRESS OF PROGRAM) L FILENAME LOAD PROGRAM S ADDR START PROGRAM AT SPECIFIED ADDRESS (ADDRESS DEFAULSTS TO XFR ADDRESS OF PROGRAM) C FILENAME/QV EXECUTES CHAIN FILE (/QV GIVES OPTIONAL QUICK VERIFY MODE) D/L/F DIRECTORY (OPTIONALLY ON PRINTER(/L) OR IN SHORT FORM (/F)) F SET CONSOLE FILL COUNT E UNIT # ENABLE ALTERNATE SYSTEM DEVICE H/L HELP FILE (OPTIONALLY ON PRINTER (/L)) NOTE: THE XXDP+ MONITOR CAN RUN EITHER THE OLD OR THE NEW XXDP UTILITIES, BUT THE OLD XXDP MONITOR CANNOT RUN THE NEW UTILITIES. THE NEW MONITOR IS A 2K PROGRAM (UNLIKE THE OLD XXDP MONITOR, WHICH WAS A 1.5K PROGRAM). HOWEVER, ALL OLD DIAGNOSTICS ARE STILL SUPPORTED, REGARDLESS OF SIZE (SEE 3.7). 1.2 BOOT TIME QUESTIONS: ------------------------- THE MONITOR WILL ASK YOU AT BOOT TIME WHETHER YOU HAVE 50 HZ AND WHETHER YOU HAVE AN LSI. THIS IS INFORMATION THAT IT CANNOT AUTOSIZE FOR AND WHICH IT MUST PASS ON TO CERTAIN NEW TYPES OF DIAGNOSTICS. BOTH QUESTIONS DEFAULT TO "NO" IF YOU TYPE A . THE MONITOR ALSO ASKS THE DATE AT BOOT TIME. YOU CAN TAKE THE DEFAULT OF 1-JAN-70 BY TYPING . NOTE: XXDP+ UTILITIES USE THE DATE SUPPLIED TO THE MONITOR AT BOOT TIME. 1.3 ENABLE COMMAND: ------------------- THE "ENABLE" COMMAND HAS BEEN UPGRADED TO HANDLE ANY DEVICE (FORMERLY HANDLED JUST CASSETTES). IF YOU ARE BOOTED FROM ONE DRIVE AND WANT THE MONITOR TO BEHAVE AS IF IT HAD BEEN BOOTED FROM ANOTHER, JUST TYPE "E UNIT#" (E.G., "E 2" FOR DRIVE #2). 1.4 DIRECTORY UTILITY --------------------- THE SPECIAL UTILITY HUDI??.SYS IS AUTOLOADED BY THE MONITOR WHEN THE "D" COMMAND IS ISSUED BY THE OPER- ATOR. IT PERFORMS THE DIRECOTRY FUNCTION AND OVERLAYS THE CONTENTS OF MEMORY (EXCEPT THE MONITOR). 2.0 XXDP+ UTILITIES -------------------- 2.1 XXDP+ UPD1 UTILITY COMMANDS: ------------------------ CLR CLEAR MEMORY XFR SET TRANSFER ADDRESS MOD ADDR MODIFY CORE LOAD DEV:FILENAME LOAD PROGRAM DUMP DEV:FILENAME DUMP PROGRAM CORE DISPLAY CORE LIMITS FOR DUMP HICORE ADDR SET HICORE LIMIT FOR DUMP LOCORE ADDR SET LOCORE LIMIT FOR DUMP DEL DEV:FILENAME DELETE PROGRAM BOOT DEV: BOOT DEVICE NOTE: THE UPD1 UTILITY SUPPORTS ALL STANDARD XXDP DEVICES, BUT ONLY THE ABOVE COMMAND SET (FOR EXAMPLE, NOTE THAT THE "PIP" AND "START" COMMANDS ARE NO LONGER AVAILABLE. UPD1 NEEDS TO BE USED ONLY IN CASES WHERE THERE IS NOT SUFFICIENT MEMORY TO TO ALLOW THE LOAD/MOD/DUMP OPERATION ON A BINARY FILE. OTHERWISE, UPD2 MAY BE USED. IT IS A 4K PROGRAM AND IT EXECUTES IN LOW CORE (WHERE IT LOADS). IT DESTROYS THE MONITOR IMAGE IN HIGH CORE (IT USES THAT AREA AS A BUFFER). THEREFORE YOU MUST REBOOT THE MONITOR WHEN FINISHED. THE LOAD DEVICE MUST REMAIN ONLINE THROUGHOUT EXECUTION, SINCE UPD1 USES RETRIEVABLE DEVICE DRIVERS FROM THAT MEDIUM AS IT EXECUTES. 2.2 XXDP+ UPD2 UTILITY COMMANDS: --------------------------------- CLR CLEAR MEMORY ZERO DEV: ZERO DEVICE SAVM DEV: SAVE MONITOR TO DISK SAVE DEV:FILENAME SAVE MONITOR TO TAPE XFR SET TRANSFER ADDRESS LOAD DEV:FILENAME LOAD PROGRAM DUMP DEV:FILENAME DUMP PROGRAM CORE DISPLAY CORE LIMITS FOR DUMP HICORE ADDR SET HICORE LIMIT FOR DUMP LOCORE ADDR SET LOCORE LIMIT FOR DUMP DIR DEV:FILENAME DIRECTORY (OPTIONALLY FOR A PARTICULAR FILE) PATCH DEV:FILENAME PATCH DISK FILE ASG PHDEV:=LOGDEV: ASSIGN LOGICAL NAME READ DEV:FILENAME READ FILE FOR VALIDITY PIP DEV:FILENAME=DEV:FILENAME/F TRANSFER FILE (THE /F SWITCH (FOR "FAST") CAUSES UPD2 TO WRITE FILES TO TAPE WITHOUT CHECKING TO SEE WHETHER THEY ARE ALREADY PRESENT, THUS POTENTIALLY DUPLICATING THE NAME) EOT DEV: WRITE END OF TAPE MARK DEL DEV:FILENAME DELETE FILE REN DEV:FILENAME=DEV:FILENAME RENAME FILE DO FILENAME EXECUTE COMMAND FILE (IT MUST BE ON SYSTEM DEVICE AND IT MUST NOT CONTAIN "EXIT" CMD) DRIVER DEV: LOAD R/W DRIVER INTO CORE BOOT DEV: BOOT SYSTEM PRINT DEV:FILENAME PRINT FILE (ON LPT) TYPE DEV:FILENAME TYPE FILE (ON TTY) MOD ADDR MODIFY CORE COPY DEV:=DEV: COPY VOLUME (NEED LIKE DEVICES) EXIT RETURN CONTROL TO MONITOR NOTE: THE UPD2 UTILITY SUPPORTS ALL STANDARD XXDP DEVICES, BUT THE "START" COMMAND IS NO LONGER SUPPORTED (NECESSARY TO USE MONITOR FOR THAT). IT IS A 6K PROGRAM THAT EXECUTES IN LOW CORE (WHERE IT LOADS) AND MAKES CALLS TO THE MONITOR AS IT EXECUTES. THE EXIT COMMAND RETURNS CONTROL TO THE MONITOR . UPD2 USES RETRIEVABLE I/O DRIVERS FROM THE SYTEM DEVICE AS IT EXECUTES, THEREFORE THAT DEVICE MUST REMAIN ONLINE DURING ITS EXECUTION. 2.3 PIP/FILE RULES: -------------------- HERE'S WHAT HAPPENS WHEN YOU DO A "PIP" OR A "FILE" BETWEEN DISKS OR TAPES, AND THE FILE BEING TRANSFERRED IS ALREADY PRESENT ON THE OUTPUT DEVICE ("D" AND "T" STAND FOR DISK AND TAPE): SINGLE FILE MODE WILD CARD MODE ---------------- -------------- FILE D: SAYS "DELETE OLD" D: AUTODELETES T: SAYS "DELETE OLD" T: AUTODELETES PIP D: SAYS "DELETE OLD" D: AUTODELETES T: SAYS "DELETE OLD" T: AUTODELETES FILEF D: SAYS "DELETE OLD" D: AUTODELETES T: DUPLICATES THE NAME T: DUPLICATES THE NAME PIP/F D: SAYS "DELETE OLD" D: AUTODELETES T: DUPLICATES THE NAME T: DUPLICATES THE NAME NOTE: THE REASON THAT THE "FAST MODE COMMANDS" (THE "FILEF" COMMAND AND THE "PIP" COMMAND WITH THE "/F" SWITCH) CREATE DUPLICATE NAME ON TAPE IS THAT THE OUTPUT TAPE IS NOT REWOUND TO SEARCH FOR THE PRESENCE OF A FILE WITH THE SAME NAME AS THAT OF THE SPECIFIED OUTPUT FILE. THE "FILE" AND "FILEF" COMMANDS, ALTHOUGH STILL SUPPORTED, HAVE BEEN OFFICIALLY REPLACED BY THE "PIP" AND "PIP/F", WHICH ARE FUNCTIONALLY IDENTICAL (ALTHOUGH NOT SYN- TACTICALLY IDENTICAL: THE "PIP" NEEDS OUTPUT FILENAME, WHICH THE "FILE" DOESN'T TAKE). 2.4 XXDP+ XTECO UTILITY COMMANDS: ----------------------------------- DIR DEV:FILENAME DIRECTORY (OPTIONALLY OF SPECIFIC FILE) PRINT DEV:FILENAME PRINT FILE (ON LPT) TYPE DEV:FILENAME TYPE FILE (ON TTY) EDIT DEV:FILENAME=DEV:FILENAME EDIT ASCII FILE TECO DEV:FILENAME EDIT SINGLE FILE IN PLACE TEXT DEV:FILENAME CREATE NEW TEXT FILE C MOVE POINTER BY CHARACTERS L MOVE POINTER BY LINES J MOVE POINTER TO START OF TEXT IN MEMORY ZJ MOVE POINTER TO END OF TEXT IN MEMORY S SEARCH FOR CHARACTER SEQUENCE N SEARCH TO END OF FILE FOR SEQUENCE T TYPE LINES OF TEXT D DELETE CHARACTERS K DELETE LINES OF TEXT I INSERT TEXT A APPEND MORE TEXT FROM FILE INTO MEMORY TERMINATE A COMMAND TERMINATE LAST COMMAND AND EXECUTE ANY COMMAND ^C RETURN TO COMMAND MODE ^U RESTART COMMAND SEQUENCE RUBOUT IGNORE LAST CHARACTER ^Z TERMINATE INPUT MODE EXIT RETURN CONTROL TO MONITOR 2.5 ZEROING A SYSTEM DEVICE: ---------------------------- IF YOU ATTEMPT TO ZERO THE SYSTEM LOAD DEVICE, THE UTILITY PROGRAM WILL WARN YOU TO LOAD ANOTHER DEVICE DRIVER THIS WARNING IS GIVEN BECAUSE DEVICE DRVIERS RESIDE AS SYS FILES ON THE SYSTEM DEVICE. BEFORE YOU ZERO THE SYSTEM DEVICE, YOU MUST HAVE TWO DEVICE DRIVERS IN MEMORY: ONE FOR THE SYSTEM DEVICE AND ONE FOR THE DEVICE YOU WILL USE TO REBUILD THE SYSTEM DEVICE. THE ZERO COMMAND PROVIDES THE FIRST DRIVER. THE "DRIVER" COMMAND CAN BE USED TO OBTAIN THE SECOND DRIVER. IF BOTH DEVICES ARE OF THE SAME TYPE, THEN ONLY ONE DRIVER IS NEEDED. 3.0 MISCELLANEOUS OPERATIONS: ----------------------------- 3.1 NON-STANDARD CSR: ---------------------- IF YOUR SYSTEM DEVICE HAS A NON-STANDARD CSR, PATCH LOCATION 20 OF THE MONITOR AND LOCATION 24 OF THE READ/WRITE DRIVER TO THE CORRECT VALUE. IN PATCHING THE MONITOR, IT IS NECESSARY TO PATCH THE ".SYS" FILE AND THEN TO DO A "SAVM" TO THE DISK. 3.2 CHAINING UTILITIES: ------------------------- THE MONITOR CHAIN COMMAND CAN BE USED TO EXECUTE THE UPD2 UTILITY AS FOLLOWS. LET THE CHAIN FILE CONTAIN THE COMMAND "R UPD2". AFTER THIS, PLACE WHATEVER UPD2 COMMANDS YOU WISH TO HAVE EXECUTED. AT THE END OF THESE, PUT THE UPD2 COMMAND "EXIT". YOU MAY THEN FOLLOW WITH ANY OTHER LEGAL MONITOR COMMANDS. THE MONITOR WILL ONLY CHAIN FILES WHICH END WITH THE EXTENSION "BIC", SO IT IS NECESSARY TO COPY OR RENAME YOUR "UPD2.BIN" TO UPD2.BIC" BEFORE CHAINING. 3.3 HOW TO MERGE XXDP+ SOFTWARE ONTO YOUR DISK : ------------------------------------------------ A) BOOT FROM OLD XXDP PACK B) RUN OLD UPD2 C) FILE OLDEV:=NEWDEV:*.SYS C) FILE OLDEV:=NEWDEV:*.SYS (THIS BRINGS ACROSS THE NEW MONITORS AND THE NEW DRIVERS AND THE DIRECTORY UTILITY HUDI??.SYS WHICH IS AUTOMATICALLY INVOKED BY THE MONITOR ON A "D" COMMAND) D) FILE OLDEV:=NEWDEV:*.BIN (THIS BRINGS ACROSS THE NEW UPD2, UPD1, XTECO, AND DXCL UTILITIES) E) FILE OLDEV:=NEWDEV:HELP.TXT (BRINGS ACROSS THIS FILE) F) LOAD NEWDEV:HMXX??.SYS (THIS IS THE NEW MONITOR FOR YOUR SYSTEM DEVICE: THE "XX" IS THE DEVICE MNEMONIC, AS EXPLAINED BELOW) G) SAVM OLDEV: (PUTS NEW MONITOR IMAGE IN BOOT AREA OF OLD PACK) H) YOU ARE STILL RUNNING THE OLD UPD2: NOW BOOT YOUR DEVICE AND YOU'LL BE RUNNING THE NEW MONITOR. 3.4 HOW TO MERGE YOUR XXDP TAPE ONTO AN XXDP+ TAPE: --------------------------------------------------- A) BOOT FROM NEW TAPE B) RUN NEW UPD2 C) DELETE OLDEV:THDP.SAV D) DELETE OLDEV:TMDP.SAV E) DELETE OLDEV:UPD1.BIN F) DELETE OLDEV:UPD2.BIN G) DELETE OLDEV:XTECO.BIN H) FILEF NEWDEV:=OLDEV:*.* 3.6 HOW TO BUILD XXDP+ DISK FROM SCRATCH: ----------------------------------------- A) ZERO THE DISK B) LOAD MONITOR FOR THAT DISK TYPE C) DO A "SAVM" TO THAT DISK D) TRANSFER ALL DESIRED FILES TO THAT DISK 3.6 HOW TO BUILD XXDP+ TAPE FROM SCRATCH: ----------------------------------------- A) ZERO THE TAPE B) LOAD MM MONITOR C) DO A "SAVE" OF THE MM MONITOR TO THE TAPE (EXT = "SAV") D) LOAD THE MT MONITOR E) DO A "SAVE" OF THE MT MONITOR TO THE TAPE (EXT = "SAV") F) TRANSFER DESIRED FILES TO THE TAPE 3.7 LOADING AN "OVERSIZE" DIAGNOTIC: ------------------------------------- THE XXDP+ MONITOR IS A 2K PROGRAM (XXDP WAS 1.5K). THE LOWER .5K IS "EXPENDABLE" AND IS RESTORED BY THE REST OF THE MONITOR WHEN IT IS FOUND TO BE MISSING (BY CHECKSUM). IT IS POSSIBLE TO RUN A 14.5K DIAGNOSTIC ON A 16K MACHINE. SUCH A DIAGNOSTIC, HOWEVER, SHOULD NOT BE LOADED AND STARTED BY TWO SEPARATE COMMANDS LOAD/START. THIS IS BECAUSE THE TTY I/O ROUTINES ARE IN THE LOWER .5K OF THE MONITOR AND IF THE DIAGNOSTIC OVERLAYS THAT AREA YOU WON'T BE ABLE TO TALK TO THE KEYBOARD. THEREFORE IF THE MONITOR DETECTS THAT YOU HAVE ISSUED THE "LOAD" COMMAND FOR SUCH A FILE, IT WILL TYPE THE MESSAGE "CONTINUE LOAD THEREBY DISABLING KEYBOARD?" IF YOU ANSWER "YES", IT WILL COMPLETE THE LOAD, BUT YOU WILL HAVE TO START THE DIAGNOSTIC VIA CONSOLE SWITCHES. IF YOU ANSWER "NO", THE MONITOR RETURNS TO COMMAND MODE, AND YOU MAY ISSUE A "RUN" COMMAND FOR THAT DIAGNOSTIC (WITH AN OPTIONAL STARTING ADDRESS) AND YOU WON'T BE AFFECTED BY THE LOWER .5K BEING TEMPORARILY OVERLAID. 4.0 XXDP+ NAMING CONVENTIONS ----------------------------- 4.1 XXDP+ MONITOR AND DEVICE DRIVER NAMING CONVENTIONS: ------------------------------------------------------- DEVICE MONITOR DRIVER DEVICES MNEMONIC FILE FILE SUPPORTED ------- ------- ------ ----------- CT HMCT??.SYS HDCT??.SYS TA11/TU60 DB HMDB??.SYS HDDB??.SYS RP04/5/6 DD HMDD??.SYS HDDD??.SYS DL11/TU58 DK HMDK??.SYS HDDK??.SYS RK11/RK05 DL HMDL??.SYS HDDL??.SYS RL11/RL01 DM HMDM??.SYS HDDM??.SYS RK611/RK06/7 DP HMDP??.SYS HDDP??.SYS RP11/RP02/3 DR HMDR??.SYS HDDR??.SYS RM02/3 DS HMDS??.SYS HDDS??.SYS RS03/4 DT HMDT??.SYS HDDT??.SYS TC11 DECTAPE DX HMDX??.SYS HDDX??.SYS RX11/RX01 DY HMDY??.SYS HDDY??.SYS RX211/RX02 MM HMMM??.SYS HDMM??.SYS TMO2/TMO3 TAPES MT HMMT??.SYS HDMT??.SYS TM11 TAPES KB HDKB??.SYS PPT RDR (LOW SP) PT HDPT??.SYS PPT PCH (LOW SP) PR HDPR??.SYS PPT RDR (HIGH SP) PP HDPR??.SYS PPT PCH (HIGH SP) NOTE: THE DEVICE MNEMONICS ARE UNCHANGED FROM PREVIOUS XXDP, BUT ALL OTHER NAMES ARE NOW DERIVED FROM THESE MNEMONICS. ALL MONITORS START WITH "HM" AND ALL DRVIERS START WITH "HD". THE ?? IN EACH FILE IS THE REV/PATCH LEVEL. FILES WITH THE EXTENSION ".SYS" ARE BINARY FILES THAT CANNOT BE DIRECTLY EXECUTED BY THE OPERATOR. TAPE MONITORS MUST BE GIVEN THE EXTENSION ".SAV" WHEN PLACED AT THE START OF A MAGTAPE FOR BOOTING, AND ".SYS" WHEN RESIDING IN THE NORMAL FILE AREA ON EITHER TAPE OR DISK. 4.2 XXDP+ UTILITY NAMING CONVENTIONS: --------------------------------------- THE FILE NAMES OF THE XXDP+ UTILITIES ARE AS FOLLOWS: UPD1.BIN UPDATE UTILITY #1 UPD2.BIN UPDATE UTILITY #2 XTECO.BIN TEXT EDITOR DXCL.BIN DEC/X11 CONFIGURATOR LINKER END OF HELP.TXT