PCjs Machines

Home of the original IBM PC emulator for browsers.


PC-SIG Diskette Library (Disk #3644)

[PCjs Machine "ibm5170"]

Waiting for machine "ibm5170" to load....



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.



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.
(DOS commands) <--- User supplied DOS commands corresponding to the
goto done           command string: RUN label1

(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)
(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

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.


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.



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:


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.


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.

Directory of PC-SIG Library Disk #3644

 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