Utility commands ================ J.G.Harston - jgh@mdfs.net 70 Camm Street, Walkley, Sheffield S6 3TR Most of these utilities have an embedded version number or date in them at the end of them. If you *DUMP them, you can check the version to see if it's newer than a version you already have. *Echo Display a string v0.01 ---------------------------------------------------------------------------- *Echo displays a string after transforming it with GSTrans, as with *Key. *Keys () List function keys v1.00 ---------------------------------------------------------------------------- *Keys lists function key definitions. If a is given, then just that specified key definition is listed. The listing is given in a format suitable for executing as *commands. *KeyLoad Load function keys v1.01 ---------------------------------------------------------------------------- *KeyLoad loads a file of function key definitions. *KeyLoad is an alias for *Obey and simply executes the *commands in the saved file. *KeySave Save function keys v1.00 ---------------------------------------------------------------------------- *KeySave saves all the function key definition to the specified file, in a format suitable for reloading with *KeyLoad, *Obey or *Exec. *lp Print formatted file v1.13 ---------------------------------------------------------------------------- A machine code version of the 'Printer' program, and so easier to use. The command is created using 'MakeLp' and can be configured for different printers. The supplied LP command is configured for the Star LC-10/LC-1001. *lpS (-) Display formatted file v1.09 ---------------------------------------------------------------------------- This command is similar to *lp, but displays to the screen. Bold, italic, superscript, subscript, double width and underline effects are displayed. MakeLP Create *lp command v1.13 ---------------------------------------------------------------------------- Creates the *lp command. *MDump (-) |+ Dump memory v1.05 ---------------------------------------------------------------------------- Displays an area of memory in a similar way to *Dump. If the - parameter is given it specifies the number of columns to display. If it is not given, the dump lists in 16 columns in MODE 0 and 3, and 8 columns in other MODEs. The address can specify various sections of memory in a similar way to *SAVE. FFFFmmmm I/O memory at &0000-&FFFF FFFEmmmm screen memory at &3000-&7FFF FFFDmmmm shadow memory at &3000-&7FFF FFxRmmmm sideways ROM R at &8000-&BFFF FF8xmmmm workspace RAM at &8000-&9FFF and &C000-&DFFF FFCxmmmm MOS without I/O at &C000-&FFFF <>FFmmmmmm Language memory *Obey Obey commands v1.01 ---------------------------------------------------------------------------- *Obey executes a file of *commands. It is similar to *Exec but does not echo the contents to the screen. The lines in the text file must be no longer than 100 characters. Any error closes and terminates the Obey sequence. Note that *Obey is not nestable. *PrintTo () Print to a file v1.00 ---------------------------------------------------------------------------- Redirects printing to a user printer driver that spools to the specified file. *PrintTo with no parameter closes any open print file and switches to the previously selected printer. The PrintTo printer driver is printer 5. When output starts, the PrintTo driver is selected. Printer output can be redirected with *FX 5, and redirected to the PrintTo driver with *FX 5,5. *Reset () Reset computer 0.10 ---------------------------------------------------------------------------- Resets the computer almost as though the Break key was pressed. The optional parameter is the OSBYTE 253 value for the type of reset to cause, defaulting to 0: 0 = Soft reset (Break) 1 = PowerOn reset (Power On) 2 = Hard reset (Ctrl-Break) *Reset works with BBC MOS 1 and 2, Master MOS 3, 4 and 5 and the Electron. *Show () Show key definition v1.01 ---------------------------------------------------------------------------- *Show lists function key definitions. If no is given, then all 16 key definitions are listed. The listing is given in a format suitable for executing as *commands. *XLoad () Load to paged RAM v0.10 ---------------------------------------------------------------------------- This loads a file into paged RAM accessed via JIM at &FD00-&FDFF. If is supplied the file is loaded to the specified paged RAM address, otherwise the file's own load address is used. *XSave |+ ( ()) v0.10 ---------------------------------------------------------------------------- This saves data from paged RAM accessed via JIM. The address parameters are parsed the same as for the normal *SAVE command. Addresses in paged RAM are XXYYZZNN where NN is the offset within a 256-byte page and XXYYZZ is the page selected by writing to the JIM paging registers at &FCFD=XX, &FCFE=YY and &FCFF=ZZ.