Home of the original IBM PC emulator for browsers.
[PCjs Machine "ibm5170"]
Waiting for machine "ibm5170" to load....
LICENSE AGREEMENT AND DISCLAIMER THIS SOFTWARE IS BEING PROVIDED SOLELY "AS IS" AND WITHOUT WARRANTY OF ANY KIND EITHER EXPRESSED OR IMPLIED INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS OF PURPOSE. The author hereby disclaims any and all responsibility for any damages resulting from the use or mis-use of this software. In any event, the author's liability shall be limited to the originial software license purchase price. SHAREWARE VERSION This software is being distributed as "shareware". You are allowed to use the software for a trial period of 30 days. To use this software beyond the trial period requires the purchase of a license to use the software. Such license can only be purchased by sending a check or money order for $25 to: EFD Systems 304 Smokerise Circle SE Marietta, GA 30067 CIS:72627,3026 You may distribute this software to others for similiar use under these terms: 1) No fee may be charged in connection with distribution other than a nominal $5 fee to cover the cost of materials and postage. It must be clearly stated that any such fees do not constitute a license fee for use of the software. 2) The software is distributed in it's entirety as originally released including this documentation file. 3) The software may not be distributed in connection with or incorporated into any other software, product or information being distributed, sold or offered for sale. REGISTERED VERSION Licensed users are allowed to use a single copy of the software on a single machine. Copies of the software can be made for backup purposes only. Any other use, distribution or reproduction of this software is prohibited. The software may not be distributed in connection with or incorporated into any other software, product or information being distributed, sold or offered for sale without the expressed written permission of the author.
RUN.DOC IconDOS is basically a graphical front-end to a batch file, RUN.BAT. The batch file does all of the real work of actually running a DOS command set corresponding to the selected icon and returning control back to the IconDOS menu front-end once it is finished. RUN.BAT has the following basic, generic structure: @echo off <--- Turns echo off so commands don't display goto %1 <--- sends control to the label matching the first parameter specified when RUN.BAT was started. :label1 (DOS commands) <--- User supplied DOS commands corresponding to the goto done command string: RUN label1 :label2 (DOS commands) <--- User supplied DOS commands for cmd string: RUN label2 goto done <--- Simply jumps over the remaining command sets and . goes straight to the cleanup area below . . <--- (add more labels/command sets as needed here, one per . icon) :labeln (DOS commands) goto done :done <--- cleanup label CD\menu <--- return to IconDOS directory in case it was changed above ICONDOS mymenu <--- return control back to IconDOS and 'mymenu' Appropriate command strings must be assigned to the icons in order to interface with RUN.BAT. These command strings should be similiar to the following: Icon Generic Icon Command String Specific Examples _______________________________________________________________________________ 1 RUN label1 RUN WP 2 RUN label2 RUN 123 3 RUN label3 RUN DBASE . . . . . . . . . RUN.BAT is initially configured to operate as a demo which simply displays a message identifying the selected icon where (DOS commands) are shown above. ALTERNATE SETUP If you feel that the above is too complex for your taste, there is nothing to prevent you from setting you a single, individual batch file for each icon. The name of the batch file would be entered as the icon's command string. The last step in any batch file should be to return control to IconDOS. This alternate approach is perfectly valid but it is more wasteful of disk space due to the way a hard drive works. Every disk file is stored as a chain of clusters. A cluster is simply a fixed minimum unit of storage set by the hard drive manufacturer. Clusters are most often 4K in size; however, 2K clusters are also used. Partial clusters are NEVER allocated; therefore, a batch file that is 400 bytes in size requires 1 full cluster for storage which wastes 3696 bytes out of a 4K cluster. This may not seem like much but it adds up quickly. Creating a menu with only ten icons using this approach would waste 36K of disk space. Using a single batch file containing multiple named command sets, as described above, is the more efficient, preferred approach.
SETUP.DOC IconDOS is graphical icon-based menu system for DOS. Once configured, programs can be launched by clicking on an icon. IconDOS is configured using DOS batch files. IconDOS can be thought of as providing a graphical front end to a batch file. There are 2 options available for creating the batch file: OPTION 1: Build a batch file for each icon. The name of the batch file becomes the command string for the icon. Use IconEDIT to actually attach the command string to the icon. The batch file must return control back to IconDOS after running your software. Otherwise, you will be left standing at the DOS prompt. OPTION 2: Use a single batch file to run all the software for all the icons in the menu. This option is less wasteful of disk space. The provided example menu, DEMO.MNU, illustrates this approach. In the example, RUN.BAT executes all commands. Each icon in DEMO.MNU calls RUN.BAT and passes a parameter. RUN.BAT uses the parameter to decide which commands need to be executed. See DEMO.MNU, RUN.BAT and RUN.DOC for details.
Volume in drive A has no label Directory of A:\ PAPER ICN 22755 7-31-93 12:25p ICONDOS EXE 35058 6-22-93 8:21p LICENSE DOC 2164 5-11-93 5:10p ICONEDIT EXE 38526 5-23-93 12:59p DEMO MNU 6660 6-06-93 12:25a SUBDEMO MNU 2220 1-12-93 9:57p WHATS NEW 1085 6-30-93 2:58p ORDER FRM 936 6-15-93 1:45a BOOK EXE 15950 1-29-93 3:05a ICON LBR 62160 8-06-93 6:43p ICONDOS DOC 18510 6-21-93 11:23a README 1ST 3710 6-06-93 2:30p FILE_ID DIZ 398 6-15-93 1:45a GAME PZL 16512 6-29-93 7:59p INSTALL BAT 355 4-21-93 11:22p ICONNUM EXE 6426 1-20-93 1:21p ICONEDIT DOC 14019 6-13-93 11:29a RUN DOC 3230 6-30-93 3:13p RUN BAT 2671 6-21-93 11:20a SETUP DOC 1127 6-30-93 3:09p GO BAT 38 6-21-93 3:07p SHOW EXE 2040 9-12-88 10:48a 22 file(s) 256550 bytes 52224 bytes free