HELP for XXDP V2 HELP.TXT Rev: 6.0 ________________________________________________________________________________ LIST> -- The commands outlined here are for XXDP V2 only! LP: = line printer TT: = Console terminal SM: = Small monitor XM: = Extended monitor HELP is available on the following topics: BOOT BOOTSM CHAIN CLEAR COPY DATE DEFSM DEFXM DELETE DIRECTORY ENABLE HELP INFONBOOT INITIALIZE LOAD NOTES PRINT RENAME RUN SET START SMALLMON SWITCHES TYPE UPDAT V2.4 VERSION ________________________________________________________________________________ INFONBOOT> -- XXDP V2 can boot two monitors (XXDPSM or XXDPXM). The "SM" or Small monitor is for systems that are 28k or smaller in size, the "XM" or Extended monitor is for systems larger than 28k. The "SM" monitor works like the monitor of XXDP+ V1 and will run all programs written for V1. The "XM" monitor offers the new features advertised in XXDP V2. By default you will boot up the "XM" monitor provided the system has enough memory and memory management capability. Start-up file BOOT.CCC ----------------------- At boot time, a start-up file BOOT.CCC will be executed as a chain file. If this file does not exist, there will be no warning message, boot will continue and by default the "XM" monitor will be booted up. If the file exists, it must contain one of the two commands listed below. Only one of the two commands may be used at a time and it should be on the first line of the file with no leading spaces. If the file does not contain one of the two commands it will boot up the "XM" monitor. Note, if the system does not have more than 28K worth of memory or memory management capability the "SM" monitor will be booted up. SM - Boots the "SM" monitor. QUIET - Boots "XM" monitor in UFD mode. (SYSTEM.CCC must exist) ________________________________________________________________________________ SMALLMON> SMALL MONITOR (XXDPSM) ----------------------- The following are legal commands : (format of each command is shown) ------------------------------------------------------------- C - run a batch job (chain) C filename.CCC[/switches] ------------------------------------------------------------ D - list directory of load medium D[/L][/F] "/L" switch = on a LP: "/F" switch = in a short form. ------------------------------------------------------------- DAte - inspect or set the current system date. (For more information see "HELP DATE") ------------------------------------------------------------ E - enable alternative drive for system device E n where n is the new drive number ------------------------------------------------------------ H - type help information about XXDP V2 H[/L] "/L" = print on a LP: ------------------------------------------------------------ L - load a program L filename[.ext] Example: .L DIAG (load DIAG.BI?) .L ZDJCA2.NEW (load ZDJCA2.NEW) ------------------------------------------------------------ R - run a program R filename[.ext] [addr] ------------------------------------------------------------ S - start a program S [addr] ------------------------------------------------------------ VT - toggles the console terminal type between video and hard copy (The default terminal type is hard copy) ________________________________________________________________________________ EXTENDED_MON> EXTENDED MONITOR (XXDPXM) ------------------------- The following are legal commands : (format for each command is shown) (Letters shown in upper case are required to make a command unique) ________________________________________________________________________________ BOOT> Boot - directs monitor to boot another XXDP device Boot dev: ________________________________________________________________________________ BOOTSM> BOOTSm - directs monitor to boot up the small monitor. BOOTSM ________________________________________________________________________________ COPY> COpy - transfer files and maintenance operations COpy[/BOOT ] input-filespec output-filespec [/FILES ] [/DEVICE ] [/DELETE ] Examples: .COPY A.BIN DY0: (Copy A.BIN from system device to DY0:) .COPY/BOOT DM0: DM1: (Copy monitor from DM0: to DM1:) .COPY/FILES DL0: DL1: (Copy all files from DL0: to DL1:) .COPY/DEVICE DY0: DY1: (Copy device image from DY0: to DY1:) ________________________________________________________________________________ CHAIN> Chain - execute a batch, or chain file. The file must be a .CCC CHAIN filespec[/switches] ________________________________________________________________________________ CLEAR> CLear - Clears the SM and XM flags. When these flags are cleared they allow the monitor to check bit 12 of location 52 before running any program. If bit 12 is set the program will be run under the extended monitor. If bit 12 is not set then the program will be run under the small monitor. Note :- On boot up (by default) these flags are cleared and can be set by issuing the DEFSM or DEFXM command only. ________________________________________________________________________________ DATE> DATE - inspect or to set the current system date DATE dd-mmm-yy (Default dates are 01-JAN-84 for SM) ( 01-JAN-87 for XM) where dd = day (a decimal number from 1 to 31) mmm = month, first three characters yy = year (a decimal number from 83 to 99) Example (setting date): .DATE 18-MAY-83 Example (obtaining date): .DATE 18-MAY-83 ________________________________________________________________________________ DELETE> DElete - deletes the file(s) that are specified. DElete[/NOREWIND] filespec [/NONAMES ] Example: .DELETE DU0:ABC.BIN .DELETE/NONAMES DU0:ABC?.BIN (No file names will print) .DELETE/NOREWIND MU0:*.TXT (No tape rewind between files) ________________________________________________________________________________ DIRECTORY> Directory - list all files on a XXDP device. DIRECTORY[/PRINTER] [/FAST] where /PRINTER = print on LP: /FAST = show in short form ________________________________________________________________________________ ENABLE> Enable - enable alternative drive for system device E n where n is the new drive number ________________________________________________________________________________ HELP> Help - types HELP.TXT which contains help on XXDP V2 H[/PRINTER] Help = Displays topic list Help ? = Displays topic list Help * = Displays help on all Topics Help Topic = Displays help on that Topic Help To* = Displays help on all topics starting with the letters "To" Note : To exit help, simply type in EXit or a carriage return. ________________________________________________________________________________ INITIALIZE> INItialize - initialize device directory into XXDP format. INITIALIZE device: CAUTION: All data on device is lost! ________________________________________________________________________________ LOAD> Load - load a file into memory LOAD filespec Example: .LOAD ZKXCA0.BIC (load DIAG.BI?) NOTE: This command is used to load programs whose extensions are (.BIC, .BIN or .SYS) only. ________________________________________________________________________________ PRINT> Print - Print contents of files on the specified device on LP: PRINT[/NOREWIND] filespec Example: .PRINT DY0:SYSTEM.CCC .PRINT/NOREWIND MS1:*.TXT ________________________________________________________________________________ RENAME> REname - change the file specification of an existing file RENAME input-filespec output-filespec Example: .RENAME DX1:DIAG.OLD=DX1:DIAG.BIN ________________________________________________________________________________ RUN> Run - load and start a program that is stored on system device. RUN filespec [addr] Examples: .RUN UPD2 (load/start UPD2.BIN) .RUN SAMPLE.XXX (load/start SAMPLE.XXX) .RUN FXDIAG 204 (load/start FXDIAG.BI? at location 204) ________________________________________________________________________________ SET> Set - changes device characteristics and system parameters. SET [ device ]:condition [ item ] where "device" = device whose characteristics are modified. "item" = system parameter that needs to be modified. Examples: .SET TT:SCOPE (RUBOUT will delete characters - XM Default is SCOPE) .SET TT:NOSCOPE (RUBOUT will echo deleted characters - SM Default is NOSCOPE) .SET TT:QUIET (Prevent system from echoing lines from a chain file or from diagnostics that are running from a chain file) (Default = NOQUIET) ________________________________________________________________________________ DEFSM> DEFSm - Sets the SM flag. After issuing this command all programs will be run under the small monitor until the CLEAR command is issued. Bit 12 of location 52 will not be checked at all and by default any program(s) run after this command is issued will be run under SM. Note of caution :- If you plan to run only one program under SM and issue this command make sure you issue the "CLEAR" command after your program has completed running. Else by default every program will run under SM regardless of whether bit 12 was set or not. ________________________________________________________________________________ DEFXM> DEFXm - Sets the XM flag. After issuing this command all programs will be run under the extended monitor until the CLEAR command is issued. Bit 12 of location 52 will not be checked at all and by default any program(s) run after this command is issued will be run under XM. Note of caution :- If you plan to run only one program under XM and issue this command make sure you issue the "CLEAR" command after your program has completed running. Else by default every program will run under XM regardless of whether bit 12 was set or not. ________________________________________________________________________________ START> Start - start a file that has been loaded into memory via LOAD START [addr] A starting address may be entered ________________________________________________________________________________ TYPE> Type - prints the contents of a file on the terminal TYPE[/NOREWIND] filespec Example: .TYPE/NOREWIND *.TXT ________________________________________________________________________________ VERSION> Version - Prints information about the Extended monitor. Version ________________________________________________________________________________ V2.4> There are some major differences in V2.4 and all of the previously released versions of XXDP V2. The main difference is the way programs will be run from now on. In previous versions, programs were run under the same monitor that was displayed on boot up. i.e. if you booted the small monitor you ran all your programs under the small monitor. If you booted the extended monitor you ran all programs under the extended monitor. The problem with this was that you would have to reboot the other monitor if you had a program that ran on one and did not run on the other. In V2.4 (and following versions), this problem is solved, programs will be run after a check is made on bit 12 location 52 (after the program has been loaded) and if this bit is set the program will be run under the extended monitor. If this bit is not set, the program will run under the small monitor. Unlike the previous versions there will be no need to reboot. Bit 12 of location 52 should be set by using the "UPDAT" or "PATCH" utility. If UPDAT is used you might have to change the LOCORE of your program. Please sure the "CLR" command is issued before loading the program and changing the locore. Note : Look at the "DEFSM", "DEFXM" and the "CLEAR" commands in this help file if you are unable to set bit 12 by using the utilities. ________________________________________________________________________________ SWITCHES> Switches - are not applicable to all commands - these switches are not system defaults /PRINTER = print on LP: /NONAMES = No file names will be shown /NOREWIND = prevents tape rewinding between files ________________________________________________________________________________ UPDAT> UPDAT program -------------- This program uses the same commands as UPD2. Commands SAVM and SAVE are no longer supported. The following command has been added to build bootable media. It will work with tapes or disks. CREATE DY0: (will create a bootable DY from your system media) ________________________________________________________________________________ NOTES> CAUTION : Do NOT use XXDP+ V1 to write to XXDP V2 media. XXDP V2 may read or write to XXDP+ V1. NOTE : The monitor only sizes to 124k words. * For a detailed description of these commands see XXDP/DRS User Manual ________________________________________________________________________________