.LM 8;RM 72;CE 3 FUNNELWEB Vn 4.40 UTILITIES --------------------------- .FI Utility files of various origins are included on the FUNNELWEB distribution disk(s). Files LGEN/S (for generating templates for XB programs like LOAD) and LDSR/S for use with LowLoad from Vn 4.0 are not included as not a single comment has been received concerning their existence or use, but are still available on request. This file contains notes on the following programs .CE 10 1 CF/CG 2 CP 3 FSAVE 4 LDFW 5 UL 6 CT8K/O 7 LH 8 XB4THLD (1) Configuration CF ~~~ ~~~~~~~~~~~~~ ~~ CF/CG is used to customize LOAD, UTIL1/FW and various User List files to your preference in the run-time setup of FUNNELWEB. The program makes extensive use of windowed displays and context sensitive help screens. The editing process is tree structured and is easy to follow along to any particular item. Help screens are often available with a press of "?" . You save system configuration details for re-use in data files of which SYSCON is an example. CF loads as an Option 2 program file from FUNNELWEB, which is used as a source of default data but the program in memory is NOT altered. Remember to use Install before exit and RELOAD to check your handiwork as the FUNNELWEB in memory is NOT altered in the configuration process. (2) c-Compiler interface CP ~~~ ~~~~~~~~~~~~~~~~~~~~ ~~ Clint Pulley's Vn 4.0 c99 compiler files C99C/D/E may be loaded directly as Option 3 program files. File CP brings user convenience in working with c99 closer to FUNNELWEB standards. Instead of loading c99 directly, load CP as a Option 3 program file, and it will then load C99C/D/E from the same disk drive. The return from c99 reloads FW from either the set pathname or the E/A side boot drive and preserves the mailbox filename. If no filename was initially present, the c99 source code filename is installed. See also FWDOC/SCLL for details of ScriptLoad which will be found very handy in assembling and/or loading the collection of Object files which usually make up a c99 program. (3) Save utility FSAVE ~~~ ~~~~~~~~~~~~ ~~~~~ The E/A SAVE utility loads as absolute code in low memory. FUNNELWEB is compatible with SAVE, but does take up its own 6K share of high memory, so the FSAVE utility has been prepared to allow SAVEing of object files loaded by FUNNELWEB, including into low memory. Refer to the E/A manual for general information. FSAVE loads as absolute code overlaying the FUNNELWEB (UL) system area. The start and first executable instruction in your own code should be DEFed with SFIRST and the last address DEFed by SLAST. Select entry point SAVE and enter the filename to which your program is to be SAVEd in E/A compatible memory image format. If the Loader has placed files so that SFIRST is in hi-mem and SLAST is in low memory, FSAVE will SAVE high memory from SFIRST to the FFAHM indicated by the Loader at UTLTAB+2 and then proceed to SAVE low memory from >2676 (above the E/A utilities) to the FFALM. The utilities are not included so that the files will remain compatible with FUNNELWEB if reloaded under a different module. When used with Low-Loaded (Opt 6) files, FSAVE saves its first module from low-mem from SFIRST to the top of lo-mem, nominally >3FFA (at UTLTAB+4), and then from hi-mem from >A000 to SLAST. If SFIRST and SLAST both point to the same segment the SAVE is normal. The MBSAVE entry adjusts the hi-mem start to >A050 above the Mailbox. Use E/A SAVE for addresses in the >6000 to >8000 cartridge space. The MEMSAV entry point allows direct entry of hex address limits for the memory block to be SAVEd. The second entry is the address of the last word (inclusive) to be saved. MEMSAV ignores SFIRST and SLAST but these must have been DEFed, perhaps by a dummy object file, for correct LOAD/RUN operation. FSAVE indicates the actual length of the memory block saved in each file in the second word of the header block, to a maximum of >1FFA in each file. The TI E/A SAVE utility, amongst its other little foibles, adds a further 6 bytes to this count, but the program file loader in the E/A module believes the byte count in the header. In normal usage the extra 6 bytes, falsely indicated by E/A SAVE, as read in from VDP to CPU RAM do not cause any problems. FSAVE files will of course not cause any problems unless perhaps a loader incompatible with E/A is used. File FWSAVE for cassette or long file saves has been removed from the package as no comments were ever received concerning its use. A revised version which works with Vn 4.3x exists and is available on request. (4) Basic loader LDFW ~~~ ~~~~~~~~~~~~ ~~~~ LDFW is an auxiliary load program in the form of an autostarting relocatable object file which may be executed from E/A, Minimem Basics by CALL LOAD(".."), Myarc XBII by CALL LR(".."), E/A Load & Run, or most other object file loaders such as come with Myarc or Corcomp disk controllers. It may be kept in Minimem cartridge RAM if you follow the MM instructions for forcing it to load there. The RUN name is LDFW. It offers choice of several pathnames or entry of floppy disk numbers. The information supplied by the user to LDFW is used only to locate the FW/UTIL1 file and does not reconfigure this file in any way. Incidentally, CALL LOAD will not work from E/A or MiniMem Basic if you have a Horizon style RAMdisk in your system with LOAD configured as a call name. (5) User List UL ~~~ ~~~~~~~~~ ~~ Writing in of the 8 user selectable options is done with the CF/CG installer program. If a hard pathname load is chosen CONFIG will remind you that only the file-name or further pathname should be entered. There is no entry corresponding to "9 0" which looks for a cartridge ROM header at >6000 and "9" executes the first program listed there and "0" the second. This may be handy for owners of Vn 2.2 consoles who have disk controllers that will load FUNNELWEB. Remember that UL is a normally executing Option 2 Program file and different UL files can be chained by specifying them in a UL type of file. UL is coded to be fully position independent. Just remember to avoid file name clashes. File D1 is a UL type file collecting various disk utilities together for Opt 3. (6) Cartridge RAM loader CT8K/O ~~~ ~~~~~~~~~~~~~~~~~~~~ ~~~~~~ Object file CT8K/O is used to store FUNNELWEB in >6000 - >8000 cartridge RAM, if present, so that it comes up as a selection after the title screen (not on V2.2 consoles or in the presence of Myarc 128k OS). The code produced is ROMable. Load FUNNELWEB, make sure the character set of your choice is loaded, and then load CT8K/O as a Utility Load / Run option. FUNNELWEB is loaded into hi-mem on selection as for FW. (7) Assembly line locator LH ~~~ ~~~~~~~~~~~~~~~~~~~~~ ~~ LINEHUNTER is one of our working tools now made available for FUNNELWEB users, though it could well stand comparison with many commercial programs on its own. If you write substantial assembly programs you will be aware of the problems in tracking down assembly errors through multiple Copy files. Printing of List files is fine, but impractical for the home computer user. It is a dual-mode program which will also execute outside the FUNNELWEB environment. Give LINEHUNTER the name of your master source file and a line number and it will locate and display the line itself, and the line number in, and the name of the file in which it is located. It will conduct a similar search for a source code label if one is entered instead of a number. If is pressed string search is enabled in the Operand field of valid assembler source lines, for tracking down where labels are used. The search starts automatically when 4 digits of line number or 6 characters of label have been entered, or else with the key. Pressing resumes the search process and terminates the search. Exit from the program is by the key. Fastest searching is done when all copy directives are located in a separate short file, as LINEHUNTER does not have to examine each line in COPY files for further COPY directives. (8) XB FORTH Loader XB4THLD ~~~ ~~~~~~~~~~~~~~~ ~~~~~~~ This program allows the standard TI FORTH disk to be loaded by TI XB. It works only with the XB and E/A modules, and its primary use would be from the XB User List. Հ