.LM 8;RM 72;CE 3 FUNNELWEB Vn 4.40 LOAD INFORMATION ---------------------------------- .FI (1) First Things First ~~~ ~~~~~~~~~~~~~~~~~~ Before doing anything else, make a working copy from the distribution package. You may need to unarchive varying amounts of it, depending on the particular form of the package you have. Keep the original safe as a master copy for backup and for passing on. All files may be un-archived and/or copied in the normal way. Copy the frequently used short system files on to the working floppy disk first to speed access in use. The usual format for distribution is as DSSD, in archived form, or DSDD unarchived. If you are re-archiving it is recommended that each group of files be copied to a clean disk and archived as "all files" on the disk. If you have only SSSD disk drives, and do not wish to use the E/A functions, then QD, QF, C1, UL, LOAD, ED/EE, FO/FP, DR/DS should be included, with loader utilities EA, SL, LL etc as required by your Menu and User Lists. SSSD users will find it convenient to have different partial system disks for various purposes. (2) Loading FUNNELWEB ~~~ ~~~~~~~~~~~~~~~~~ The FW file loads from E/A 5 and may be renamed UTIL1 for easy loading as DSK1.UTIL1 from E/A if RUN PROGRAM FILE is selected and pressed with no file-name. Under name FW it gives a easy CALL and/or auto-boot file with the Miami UG ROS for Horizon style RAMdisks. The Utility option of TI-Writer also provides auto-load of DSK1.UTIL1. The file can be loaded under any name if desired. When FW executes it loads a character set equivalent to that in C2. It can be configured by CF/CG to go directly to either DISKREVIEW or User List UL unless it finds the held down in which case it goes directly to FW. If you are loading from a Horizon RAMdisk with Vn 8.1x ROS, having DR as a CALL name will give a particularly rapid load (and if DR so set up, then this one will be auto-loaded rather than the DR on the boot disk). DR also has its own display of the Central Menu. When FW loads directly to the Central Menu it starts with a FAIRWARE advice screen, which will time out if no key is pressed. The space bar will hold the screen in place until released. as or will bring up and hold a second screen. With XB and Myarc XB-II just auto-load DSK1.LOAD. LOAD is a hybrid of Extended Basic and machine code and must only be edited by means of the CF/CG utility program, which is largely self-prompting in use, and has many built-in help screens. Direct editing must NOT be attempted. Use a disk manager to transfer LOAD from disk to disk (it can be reSAVEd unedited with TI XB but NOT with Myarc XBII). Object file LDFW auto-runs from any compressed object file loader. CT8K/O is a utility which installs FUNNELWEB in devices that provide 8K RAM in the cartridge space. (3) Hard Disk Operation ~~~ ~~~~~~~~~~~~~~~~~~~ LOAD/FW may be configured to operate with a pathname of form WDS1.FWB. from a subdirectory on the WDS1 hard disk containing all the centrel menu (2-letter name) utility files. This will free the HFDC file DSK1 emulation for use with various programs such as disk directory routines that use sector access. The utility disk default name is now treated as a pathname also. Other pathnames for RAMdisk access are also configurable. If a Horizon style autoloader is not available, place copies of the configured LOAD and FW (as UTIL1) in the DSK1. directory on the hard disk or else on a Horizon to allow easy loading from XB, EA or TW modules. (4) Boot Disk Tracking ~~~ ~~~~~~~~~~~~~~~~~~ FUNNELWEB either from XB or as FW (under any name in form DSKn.yyy), with hard pathname configured OFF, locates the drive number "n" used to load it, and writes this as the system drive number. This means that the FUNNELWEB disk may be used from any drive if booted from that drive. From loaders which first ask the user for drive numbers, the ones supplied are used. (5) Source Disk Specification ~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~ LOAD/FW has an escape hatch which disables boot tracking and allows the system drive or pathname to be specified directly. This is mostly intended for Horizon style RAMdisks when direct CALL access to FW or LOAD is used, particularly in auto-booting, or when separate source disks are specified for TI-Writer and E/A system utility files, as may be done in systems where a single SSSD or DSSD capacity is insufficient. CF/CG allows setting of these drive numbers as a single character "n" in the form DSKn. for each source disk. Forms such as RD. or WDS1. may be handled via the hard disk pathname option and this overrides the other choices. The secondary system drive number is for the E/A side of the Central Menu. If separate disks are specified, FUNNELWEB looks for the system files in the appropriate drive first before checking the other one. Character files C1 and C2 (formerly CHARA1/2) are the only system files which must reside in the particular drive. With this exception the system files can reside on either disk but fastest loading occurs when they are correctly partitioned. The drive numbers may be edited from the Central Menu screen after as also the character filenames. (6) XB Selection screens ~~~ ~~~~~~~~~~~~~~~~~~~~ After auto-loading from XB a title screen appears while QD is loaded. The title screen will time out if no key is pressed first, to a screen with 18 choices, 9 by number and 9 by letter. The first 3 are preset internal paths and the remaining 15 are configurable. The first two choices, TI-Writer and Edit/Assm each lead to the Central Menu screen with the corresponding mode set. When these paths are taken the XB environment is destroyed and cannot be restored except by rebooting XB, which takes just 3 easy keystrokes, or from DiskReview which can restart TI XB. (7) XB User's List Selection ~~~ ~~~~~~~~~~~~~~~~~~~~~~~~ The remaining 15 entries have names which are entered in the LOAD program by CF/CG. On selection of one of these 15 user list items FUNNELWEB loads the program configured into that option. This may be an assembly program, XB RUN of another XB program, or just return to the XB command mode. LOAD may be reRUN from the command line to allow recovery fron XB RUN errors without complete reload from disk. This path should work with any dialect of XB. Some entries have been predefined by way of convenience and example. At this stage the set of XB INIT utilities is still available for either XB programs or for assembly program files (options 1 or 2). These have been augmented by a DSRLNK (BLWP vector at >24F4 with function as defined in the TI-Forth source code), and a GPLLNK (BLWP vector at >24F8). (8) Universal key functions ~~~ ~~~~~~~~~~~~~~~~~~~~~~~ (i) Screen colors On almost any screen which invites selection by number, pressing 0 (zero) will cause the screen colors to cycle through through the 10 configured color choices. (ii) Quick Directory The AID key, , will call up from file QD a paged (by single B/N or keys) disk directory routine with some of the functions of that used for SD in the Editor. A very similar function exists within the Formatter and Assembler using file QF instead. File QD must be on the FUNNELWEB boot disk, and is an Option 2 program file. The QD file will be reloaded if necessary from AID. Pressing the will cause the filename indicated by the cursor to be written to the mailbox as workfile name if a Display file, as the program default if a program file, and to the object default if a D/F file. Any file may be deleted. QD indicates file lengths on 80-Tk disks as though they were on normal 40-Tk disks. (iii) QUIT The system QUIT key is enabled at all times when keyboard entry is called for by FUNNELWEB itself. Each utility determines its own response to QUIT. (iv) BACK// In FUNNELWEB itself may be used instead of (BACK) as the key just as in the Editor, and usually substitutes for (PROC'D). Under some error conditions these alternatives may not be available. From the Central Menu screen brings up a Y/N choice to Quit. This is the recommended exit from FUNNELWEB if the machine is not to be switched off immediately as it resolves any pending workfile name transfer to the mailbox. If response is not "Y" and , a Reset screen is entered. The character set filenames may be edited, the system print device changed, and the system drive numbers revised if the hard pathname is not enabled. (9) Central Menu Screen ~~~ ~~~~~~~~~~~~~~~~~~~ The prime focus of the program are the Central Menu screens which offer 8 choices on the TI-Writer entry (hit the space bar if necessary). .CE 9 1 TEXT EDIT 2 FORMATTER 3 DISK UTILS 4 DM-1000 5 ARCHIVER 6 ,, 7 DSKU 8 USER LIST The normal TI-Writer Editor is loaded from this screen. Entries 4-7 are completely configurable, and may be any assembly program (with a two letter filename) that FUNNELWEB will handle, including Script-load files. Automatic search on both primary and secondary disks occurs only for program files. USER LIST files are of Opt 2 type, and allow a tree of choices as big as your disk system will allow. Each presents a third screen of user entered options. See FWDOC/SCLL for a fuller discussion of User Lists and Multi Lists, and also the CF/CG instructions in FWDOC/UTIL. Choice #3 is set up with a List file D1 as example, grouping a collection disk-related utilities. UTIL1/FW may be configured so that the User List boots up first. This allows application disks to be made up without the FUNNELWEB machinery being immediately apparent. A second menu screen comes up from other loaders or may be toggled with the first screen by hitting the space bar. This screen contains the programmer's workbench. .CE 9 1 PROGRAM ED 2 ASSEMBLER 3 LOADERS 4 c-COMPILER 5 DISKHACKER 6 LINEHUNTER 7 .. 8 DISKREVIEW As with the other screen, Options 4-7 are completely configurable. As issued Option 4 loads the c99 REL4 compiler if the appropriate files are on your working disk. Option 6 LINEHUNTER is a search utility to help assembly programmers use the FUNNELWEB system (see FWDOC/UTIL). Option 3 enables the program loading screen (see FWDOC/EASM). The Editor is TI-Writer modified for source code editing. If dual system drives are specified it is not necessary to repeat ED/EE on the secondary disk if the extra loader delay can be tolerated. See FWDOC/EASM for E/A details. The Option 8 entry DISKREVIEW loads or re-enters a new powerful directory, filereader, sector editor, and loader utility DR which has both 40 and 80 column forms. This is described in FWDOC/DR40 & 41 or FWDOC/DR80 & 81 & 82. Հ