


                    UtilityWorks (tm) Launcher
              A Powerful Apple IIGS Program Selector

                 (c) 1988,1989 by George R. Wilde
                       24402 Broadwell Ave.
                      Harbor City, CA  90710
                          (213) 325-4456



     The UtilityWorks Launcher (a companion program to 
UtilityWorks) is a powerful Apple IIGS Program Selector which 
gives the user the capability of launching any program from either 
a standard file selection dialog box or from an easily configured 
menu presented in a window on the Desktop. Up to 10 launch 
selection menus of 40 entries each can be quickly configured using 
a standard file selection dialog box (just point and click on the 
programs to be launched). The UtilityWorks Launcher permits 
launching of P16 programs under GS/OS much faster than the Finder 
or P8 launchers. Launching of P8 programs is also very rapid, but 
return to the Launcher does take some time when using GS/OS 
versions prior to System Disk 5.0 because GS/OS must be reloaded 
with these earlier versions.

     The UtilityWorks Launcher gives the user total control over 
slots (internal slots or slot cards), system speed (TransWarp, 
fast, or normal), and text, background, border, and desktop 
colors. Each of the ten possible launch selection menus can have 
its own defined set of slots, speed, and colors to be set upon 
activation of that menu. Each menu can also have its own defined 
set of slots, speed, and colors to be set upon shutdown (ie; 
switch to another menu, return to the calling program, or GS/OS 
shutdown). Moreover each of the 40 possible launch entries on every 
menu can have its own slots, speed, or colors to be set upon 
launch of that program. The menu's set of slots, speed, and colors 
(ie; activation settings) are restored upon exiting the called 
program and returning to the UtilityWorks Launcher. Unlike other 
slot switch programs, slot restoration occurs for both P8 and P16 
programs. Setup of slots, speed, and colors is also easy, 
involving only pointing and clicking the mouse. Changing colors 
can be useful in executing some programs that appear better in 
colors other than your control panel defaults. Changing speeds can 
be useful for some games. Changing slots is essential for 
executing programs that are designed for use with slot cards.

     The UtilityWorks Launcher is Shareware. You are entitled to 
try this program for ten days without charge. After that time 
period you must pay the $10 Shareware fee as discussed in the 
Shareware section of this document. Upon payment of the Shareware 
fee you will receive the Password to remove the Shareware Alert 
which appears when the Launcher is first executed. As a registered 
Shareware owner you will also be informed of any major upgrades to 
the program which may occur in the future.

     The UtilityWorks Launcher includes the following 
capabilities:

        a) Ability to launch any S16, SYS, EXE, BAS, BIN, or TXT
           (EXEC) file. (The latter three types must be capable of
           being run from BASIC. Only some EXE files can be
           properly executed).

        b) Ability to switch slots (GS internal slots or slot 
           cards), speed, and colors, as well as certain modem and 
           printer parameters and color/monochrome display upon
           program launching and return to defaults at program 
           completion. 

        c) Ability to set default slot configurations, speed,
           colors, monochrome/color display, and certain modem and 
           printer parameters independent of the control panel and 
           return to a predefined set of these parameters upon
           exiting from the Launcher.

        d) Ability to boot any bootable drive. 

        e) Ability to autostart a given program whenever the disk
           is booted, and return to the UtilityWorks Launcher 
           upon program completion.

        f) Ability to easily configure any Launcher Menu Screen.

        g) Ability to set a screen blackout timer to blackout the
           monitor's screen after a period of nonuse, to avoid
           permanently damaging the screen when non-changing
           bright images are displayed for prolonged periods of 
           time

        h) Ability to limit general access to only selected menus
           and program features. This will prevent inexperienced 
           users such as children or students from accessing 
           programs that could potentially destroy a hard disk. 

        i) Ability to easily insert, edit, delete, and rearrange
           menu entries. Ability to create Boot Buttons to boot
           any desired slot, Menu Buttons to select any desired
           menu, and Purge Buttons to purge memory. Ability to 
           view all current settings of any menu entry. Ability to
           delete or copy entire menu screens.

        j) Ability to purge all purgeable Apple IIGS memory,       
           including ability to purge memory immediately prior to
           launch of an applications program.

        k) Ability to pass startup paths to programs being 
           launched. This provides a capability for now having
           separate UtilityWorks Launcher menu buttons to 
           directly launch different IBM programs with the PC 
           Transporter.

        l) Ability to control the TransWarp GS speed and IRQ
           setting with any menu entry.

        m) Compatibility with all previously constructed menus
           generated with earlier versions of the Launcher.


     I have attempted to choose those features which I felt to be 
most valuable. The UtilityWorks Launcher design and associated 
menu file design are very open ended, permitting easy addition of 
new capabilities in the future. I would greatly appreciate your 
comments and suggestions. Please E-Mail your response to me on 
AmeriCa online, CompuServe or GEnie. My IDs are:

                 America Online   GRWILDE
                 CIS              72776,504
                 GEnie            GWILDE

This version 1.6 of the UtilityWorks Launcher incorporates many 
user suggestions. For instance, use of hot keys 0-9 and tab key 
for menu selection, ability to purge upon launch, ability to set 
startup slot, and significantly improved menu editing (ie; showing 
previous menu settings when editing) are all the result of user 
suggestions. Additionally this version includes the ability to set 
Desktop colors upon launch of S16 programs, ExpressLoad and other 
speedup enhancements when used with System Disk 5.0.

     The following paragraphs describe the capabilities 
implemented in the UtilityWorks Launcher and discuss how to best 
use these capabilities.



               Installing the UtilityWorks Launcher



     The UtilityWorks Launcher is an S16 program which must run 
under ProDOS 16 or GS/OS. The UtilityWorks Launcher (file 
UWGS.LAUNCHER) can be run out of any  directory; however it does 
depend upon a configuration file, boot file, and several menu 
files which the Launcher Setup routine writes to the SYSTEM 
directory of your boot disk. The companion UtilityWorks Program 
also reads from and writes to this same configuration file if you 
elect to save your default configurations selected from the 
Options menu of that program. You must make sure your boot disk is 
not write protected and has adequate space for these files if you 
want to save any configuration or menu information, or boot a 
disk.  Placing UWGS.LAUNCHER in the /*/SYSTEM subdirectory (boot 
disk SYSTEM subdirectory) and renaming it START will cause the 
UtilityWorks Launcher to be automatically executed when the system 
is booted. This is the preferred configuration to achieve maximum 
performance from the UtilityWorks Launcher. Any existing START 
program should be renamed to some other name (eg; START.OLD) prior 
to renaming UWGS.LAUNCHER to START. The companion UtilityWorks 
program can be used to copy and rename UWGS.LAUNCHER.

     Upon loading, the UtilityWorks Launcher will load the 
required RAM based tools and begin execution. A Shareware message 
will appear the first time the Launcher is run following a Boot, 
unless a Password has been entered. The Password can be obtained 
by paying the $10 Shareware fee. Just press Continue to begin 
Launcher execution. This initial load at boot time is appreciably 
shorter when using GS/OS version 3.0 (System Disk 5.0) and up than 
with older versions of the operating system, since these older 
versions do not take advantage of the ExpressLoad format of this 
UtilityWorks Launcher file. The UtilityWorks Launcher is currently 
compatible with System Disks 3.2 and all versions of GS/OS. (It is 
also probably compatible with System Disk 3.1, but has not been 
tested with that System Disk).

     As always make sure you install UtilityWorks Launcher on a 
backup copy of your System Disk or another disk.


                UtilityWorks Launcher Capabilities



     This section describes the capabilities of the UtilityWorks 
Launcher. When the UtilityWorks Launcher initialization is 
completed, the program will automatically display a Launcher 
window (a modeless dialog box) containing the currently active set 
of up to 40 menu entries (only active menu entries will be 
displayed). If this is the first time the UtilityWorks Launcher 
has been executed, the menu setup routine will be entered, and all 
40 menu entries will be blank. The Launch item in the File menu on 
the menu bar can now be used to launch any program, however it is 
recommended that the Launcher menus be configured for maximum ease 
of use. To configure the Launcher menus simply follow the 
instructions outlined below. When all desired menu entries have 
been configured in the Setup window, save the menu (click the Save 
menu button), and then click the Open Launcher entry in the File 
menu on the menu bar to activate the Launcher window. While in the 
Launcher window, clicking any menu button will launch the 
indicated program if it is in an active drive. To readily 
distinguish between the Launcher window  and the Launcher Setup 
window, different background colors have been used. The Launcher 
window background color is the light blue of the standard Desktop. 
The Launcher Setup window background color is yellow, orange, red, 
purple, or gray depending on Setup mode. Any active NDAs can be 
selected from the desktop or from the Launcher/Launcher Setup 
windows without leaving the UtilityWorks Launcher. If for some 
reason you want to close the Launcher or Launcher Setup window, 
you can click on the standard close window box in the upper left 
hand corner of the window's title bar, or you can use the Close 
item in the File menu on the menu bar.This will put you on an 
empty Desktop. From the Desktop (or from either window) you can go 
the Launcher or the Launcher Setup windows by clicking the 
corresponding menu item in the File menu on the menu bar. You can 
leave the UtilityWorks Launcher and return to the calling program 
(if any) by clicking the Quit menu item in the File menu.  
Clicking the Shutdown menu item in the File menu will exit to a 
shutdown/reboot condition, and will not return to the calling 
program. When operating under GS/OS, the Shutdown menu item (but 
not the Quit menu item) performs a true GS/OS Shutdown. All 3.5" 
disks are also ejected on Shutdown when operating under System 
Disk 5.0.

     The menu bar contains five pull-down menus, each containing 
several items as delineated below. Each individual menu bar item 
will be discussed in the following paragraphs. Also indicated in 
brackets are the keys that may be pressed to activate the menu 
item in lieu of clicking the mouse on the menu item. (OA stands 
for the open-apple key). When using the keys make certain you hold 
the indicated keys down until the desired action begins. Quickly 
depressing and releasing the keys will usually result in no action 
being taken.

         1. Apple Icon
            - About UtilityWorks Launcher...
            - Any NDAs you have loaded

         2. File
            - Open Launcher...       [OA-L]
            - Open Setup...          [OA-E]
            - Close                  [OA-W]
            - Enable Access...
            - Launch...
            - Boot...
            - Shutdown
            - Quit                   [OA-Q]

         3. Edit
            - Undo                   [OA-Z]
            - Cut                    [OA-X]
            - Copy                   [OA-C]
            - Paste                  [OA-V]
            - Clear
            - Insert Mode
            - Edit Mode
            - Delete Mode
            - Arrange Mode
            - Customize Mode
            - Show Mode

         4. Menus
            - Menu 0 (or menu name)  ([0] - if menu 0 exists)
            - Menu 1 (or menu name)  ([1] - if menu 1 exists)
            - Menu 2 (or menu name)  ([2] - if menu 2 exists)
            - Menu 3 (or menu name)  ([3] - if menu 3 exists)
            - Menu 4 (or menu name)  ([4] - if menu 4 exists)
            - Menu 5 (or menu name)  ([5] - if menu 5 exists)
            - Menu 6 (or menu name)  ([6] - if menu 6 exists)
            - Menu 7 (or menu name)  ([7] - if menu 7 exists)
            - Menu 8 (or menu name)  ([8] - if menu 8 exists)
            - Menu 9 (or menu name)  ([9] - if menu 9 exists)
            - Save...           (or Show Startup)     [OA-S]
            - Setup Shutdown... (or Show Shutdown)
            - Save As...
            - Remove...

         5. Goodies
            - Options...
            - Purge
            - Password (if not previously correctly entered)

         The current date and time are displayed at the right hand 
corner of the menu bar. The date and time update are suspended 
while you are in any modal dialog box making selections.


1. Apple Icon

1.1 About UtilityWorks Launcher...

     This item presents a single dialog box describing the 
UtilityWorks Launcher program, including Shareware, trademark and 
copyright notices. Click OK to exit.


2. File

2.1 Open Launcher...

     Opens the Launcher window (if you are not already in it) as 
discussed in the Using the Launcher section below. If the Launcher 
is already open, this item is dimmed.


2.2 Open Setup...

     Opens the Launcher Setup window (if you are not already in 
it) as discussed in the Using the Launcher Setup section below. If 
the Launcher Setup is already open, or if access control is in 
effect, this item is dimmed.


2.3 Close

     Closes the Launcher or Launcher Setup window, or any open NDA 
window if it is the top window. If all windows are already closed, 
this item is dimmed.


2.4 Enable Access...

     Provides the capability of entering a user defined password 
(previously established in the Options item of the Goodies menu, 
as explained below) to enable access to all Launcher features if 
access has previously been restricted. If access is already 
enabled, this item is dimmed.


2.5 Launch...

     This item can directly launch any S16, SYS, EXE, BAS, BIN, or 
TXT (EXEC) program from any directory or disk. I/O Redirection is 
supported with System Disk 5.0 when launching S16 programs (see 
discussion below). Select the program to be launched using the 
standard file selection dialog. This dialog presents those 
programs that can be launched as darkened entries. EXE, BAS, BIN, 
and TXT files will also be darkened (depending upon the default 
options you select in the Options item of the Goodies menu). 
Please note that all binary files can not be executed from BASIC. 
Many are Picture files or other types of files that cannot readily 
be recognized as a non-launchable program. Make certain the 
program you choose can be run before selecting it for launch. The 
same statements are also true for TXT files, but even more so.  
Since BASIC EXEC files look like any other TXT file, they are not 
easily recognized by the Launcher. Since most EXEC files are very 
short, the Launcher will default to selection of only those TXT 
files with a length of one block. Longer TXT files will be shown 
as dimmed entries in the file selection menu, although you can 
change the default to darken all TXT files if you wish. It is best 
to follow Apple's suggestion of adding the suffix ".EXEC" to your 
EXEC files to easily distinguish them from other TXT files. A 
sample EXEC file (ROM.CDAS.EXEC) is included with this program to 
demonstrate the powerful capability of these types of files (which 
incidentally can't be launched by the Finder). ROM.CDAS.EXEC will 
install two CDAs and return to the UtilityWorks Launcher. It 
enters the monitor (CALL -151), outputs the character "#", Quits 
the monitor, and exits BASIC (BYE). 
     You can also optionally select to undim EXE files for launch. 
Many EXE files are nothing else than S16 programs in disguise, and 
can be easily launched. Other EXE files (really the majority of 
EXE files) depend on having a shell (such as APW or ORCA) present, 
and cannot satisfactorily run without one. The UtilityWorks 
Launcher does not provide a shell environment (it releases all 
memory when it launches a program). As a result EXE programs that 
depend on a shell cannot be launched successfully (they will 
probably immediately return to the Launcher).
     If access control is in effect this item is dimmed.


2.6 Boot...

     This item will bring up a dialog box that allows you to boot 
any slot from 1 to 7, excluding 3. You can boot any bootable disk 
contained in drive 1 of the selected slot, or you can boot a RAM 
slot card that has been properly formatted. This feature permits 
running non-ProDOS disks and copy protected disks. If the desired 
disk is a ProDOS disk it is better to use the Launch... item and 
select the desired program. This latter process is much faster and 
permits the UtilityWorks Launcher to regain control upon exit from 
the launched program. When another slot is booted, the 
UtilityWorks Launcher cannot regain control when that program 
terminates. You must reboot manually. You can run from RAM or ROM 
disks by selecting an appropriate program on the RAM or ROM disk, 
or by selecting the PRODOS file on the RAM or ROM disk to soft 
start the disk. (The latter technique is virtually identical to 
booting the disk - you won't be returned to the UtilityWorks 
Launcher upon quitting the application).


2.7 Shutdown

     This item functions the same as the above Quit item when used 
with ProDOS 16. When used with GS/OS, however, the Shutdown item  
will perform a true GS/OS shutdown. When shutdown has been 
accomplished, a dialog box will be displayed telling you it is 
safe to turn off your computer. Press Return if you want to reboot 
the computer. It is important with GS/OS to use the Shutdown 
feature to prevent inadvertent destruction of disk files. Many 
GS/OS programs such as UtilityWorks take advantage of the GS/OS 
session capabilities when copying files. Using the Shutdown 
feature ensures all disk operations have been completed before 
your computer is turned off.


2.8 Quit

     This item exits the UtilityWorks Launcher and returns control 
to ProDOS or the previous program selector. It does not perform a 
GS/OS shutdown. Use the above Shutdown item to accomplish a GS/OS 
shutdown.


3.0 Edit

3.1 Undo

     Used only by New Desk Accessories (NDA's). This and the 
following NDA items will become undimmed whenever an NDA is in the 
top window.


3.2 Cut

     Used only by NDA's.


3.3 Copy

     Used only by NDA's.


3.4 Paste

     Used only by NDA's.


3.5 Clear

     Used only by NDA's.

3.6 Insert Mode (Yellow Background)

     This is the default Launcher Setup mode if a previous menu 
does not exist for editing. It should be used to enter any new 
entries into a blank menu, or to completely erase and replace any 
previous menu entries. This item sets up the Launcher menus for 
use by the Launcher routine. The menu names presented in the Setup 
window are the same as will appear the next time the Launcher is 
used with this menu.
     You have the capability of preselecting up to 40 programs on 
each menu screen. You also have the capability of selecting up to 
10 menus (menus 0 - 9). This gives the capability of launching up 
to 400 preselected programs. To install a preselected program, 
just click the mouse on the menu button you wish to use for that 
program. You will be presented with a file selection dialog box 
similar to the box appearing with the Launch item described above. 
You can choose to preselect any program that appears in any 
directory or on any disk merely by double clicking on that program 
in the file selection dialog box, or by selecting the program and 
pressing the open button. This action will record the program's 
pathname for later use. (You never actually have to enter any 
filename or pathname information yourself - the Launcher 
automatically does it for you). You are then presented with a 
dialog box to name the program. This is the program's name that 
will appear in your menu. Any characters (up to 15) can be used 
for this name, or you can select the default (the program's file 
name). You are also presented with this same name dialog box if 
you clicked cancel while in the file selection dialog box. This 
latter feature gives you the capability of inserting headers or 
other information on individual menu buttons. Such buttons will 
not result in launching of a program when clicked from the 
Launcher, but can be used to change slots, speed, colors, or modem 
and printer parameters. (For instance before booting another disk 
with the Boot item, although a custom button can be established 
(see customize discussion below) to both change the slots and 
speed as well as boot a specific slot). Several examples of this 
use of the menu entries are contained in the sample UWGS.MENU.9 
file included with the UtilityWorks Launcher. These examples can 
be viewed and studied using the Show Mode described below.
     When entering program names, the name dialog box also allows 
you to choose whether the UtilityWorks Launcher should be 
restarted from memory or reloaded from disk upon normal 
termination of the program being launched, or whether memory 
should be purged upon launch. Except for troublesome programs (see 
the following discussions of this subject), the Restart on Return 
option should be selected for best performance, although the 
performance difference with System Disk 5.0 is not that great. 
Just click the box to insert a checkmark for selection of this 
option. If you have any problems in successfully launching and 
returning from any program, do not select this feature for that 
program. (Please note that the problem may have occurred in the 
previously launched program and not the program currently being 
launched.) For very troublesome programs or programs having 
significant memory requirements choose the purge upon launch 
option. This option will provide the maximum amount of memory for 
the program being launched and will result in the UtilityWorks 
Launcher being reloaded from disk upon termination of the program 
being launched.
     If you do not want to change slots, speed, colors, or modem 
or printer parameters, then click the Okay button to establish the 
menu entry. Clicking the Cancel button will effectively cancel 
this menu entry. If instead you press the Set Slots Button, you 
will be presented with a Slot/Speed selection dialog box. You have 
three choices for any slot (internal, slot card (Your Card), or 
default) and three choices for speed (fast (2.6 MHz), normal (1.0 
MHz), and default). If you have a TransWarp GS card you are 
presented additional choices for Transwarp GS speed settings. The 
UtilityWorks Launcher reads the possible TransWarp GS speed 
settings, and lets you choose up to two additional speed settings 
beyond the 1.0 MHz and 2.6 MHz settings which appear with any 
Apple IIGS. You are also given the choice of whether or not to 
disable IRQ (box checked) with the TransWarp GS.  The TransWarp GS 
speed settings work in conjunction with the Apple IIGS speed 
settings as discussed in the Applied Engineering TransWarp GS 
manual. The use of IRQ is also fully discussed in the TransWarp GS 
manual. Maximum TransWarp GS performance is obtained with IRQ 
disabled, but many programs (including numerous sound programs) 
will not work properly if IRQ is disabled. The UtilityWorks 
Launcher will automatically enable IRQ unless you expressly 
disable it. Even though TransWarp GS speed and IRQ settings are 
changed, the TransWarp GS control panel is not changed. Therefore, 
the default TransWarp GS control panel settings will be restored 
whenever the system is booted or the TransWarp GS control panel is 
entered.
     With the default selection, the current slot or speed setting  
will not be altered when this button is pressed in the Launcher 
(this is the default if you don't expressly ask for a specific 
setting, except in the Edit Mode discussed below). Setting any 
slot or the speed to any other value will result in that value 
being set the next time the program is launched. You are also 
given the choice of clearing the Power-up byte. The default 
setting is to not clear the Power-up byte. See the slot change 
discussions below on use of this byte. BE CAUTIOUS!! CHANGING 
SLOTS and clearing the Power-up byte, UNLIKE CHANGING SPEED OR 
COLORS, CAN BE DANGEROUS. SEE THE SLOT CHANGE DISCUSSION BELOW 
BEFORE ATTEMPTING TO DO IT. 
     If you now select Set Colors you will be presented with a 
dialog to allow you to change the text, background (or Desktop for 
S16 programs), and border colors. Text colors typically have no 
effect with most S16 programs because these programs normally 
control their own colors. Only the border and Desktop colors will 
normally have an effect with most S16 programs. For text, 
background, and border colors, you are presented with 17 choices; 
default (ie; do nothing) and 16 specific colors as follows:

     1. Black       5. Dark Green   9. Brown        13.Green
     2. Deep Red    6. Dark Gray    10.Orange       14.Yellow
     3. Dark Blue   7. Medium Blue  11.Light Gray   15.Aquamarine
     4. Purple      8. Light Blue   12.Pink         16.White

For Desktop colors (S16 programs only) you are presented with a 
different set of 16 colors as follows:

     1. Black       5. Deep Red     9. Dark Green   13.Light Gray
     2. Dark Blue   6. Purple       10.Aquamarine   14.Light Blue
     3. Chartreuse  7. Orange       11.Medium Green 15.Yellow
     4. Dark Gray   8. Pink         12.Light Green  16.White

Select whatever colors you desire and they will be invoked the 
next time the program is launched. The program prevents you from 
choosing the same text and background color (you couldn't see 
anything if you did). If you do this the program automatically 
switches one of the colors, so the two colors will be different. 
Whenever you select a new Desktop color, that color remains in 
effect for all S16 programs until you either select a new Desktop 
color or Quit the UtilityWorks Launcher which reestablishes the 
default light blue Desktop color. The UtilityWorks Launcher 
Desktop (but not the Launcher or Setup windows) will also be 
changed to the prevailing Desktop color upon return from the 
program being launched.
     The program also gives you the choice of selecting a color or 
monochrome display mode. This is most useful for P8 programs that 
use the high-resolution or double high-resolution graphics modes 
to display text information. This situation will normally create 
such extensive color fringing on the Apple IIGS that the text is 
almost unreadable. Using the monochrome display mode will result 
in very sharp and clear text for those programs that use the 
high-resolution and double high-resolution graphics modes to 
display text.
     You are now given a choice to Set Modem, which allows you to 
change selected modem parameters in the control panel. The 
parameters that can be changed are as follows: 

     Delete First LF after CR   Yes  No  or default
     Add LF after CR            Yes  No  or default
     Buffering                  Yes  No  or default
     DCD Handshake              Yes  No  or Default
     DSR/DTR Handshake          Yes  No  or default
     XON/XOFF Handshake         Yes  No  or default
     Baud                       300   1200   2400   
                                9600 19200  or default

As before the default settings do nothing. You are now given a 
choice to Set Printer, which allows you to change the same control 
panel parameters for the printer. Note that many programs directly 
initialize and set up the serial I/O ports by themselves, ignoring 
the control panel settings. These programs will not benefit from 
this control panel change capability. Other programs, such as 
America Online, require non-standard control panel settings to 
operate correctly. These settings are incompatible with several 
other programs that use the modem and printer ports. The above 
Modem/Printer Port Setup capability can be used to effectively 
manage the control panel configuration for these programs.
     You are now given a choice of setting the Startup Slot. 
Possible settings are default (no change) and Scan, Slots 1 - 7, 
RAM Disk, and ROM Disk. Selecting a Startup Slot will result in 
that selection being set in the Apple IIGS control panel, which 
will result in that slot being booted in the next power up or Open 
Apple-Control-Reset boot.
     If you are launching a P8 SYS file you are now given a choice 
to enter a startup pathname. This feature has mainly been included 
to allow setting up menu entries to directly launch any desired 
IBM program when using the PC Transporter. See the discussion 
below on proper use of this option. This capability can also be 
used to set the Startup path of any SYS program which follows 
Apple's Startup protocol. For instance it may be used with the 
Beagle Compiler to launch compiled Basic programs. Just set the 
launcher to launch the appropriate compiler system program (eg; 
COMPILER.SYSTEM or AUX.SLOT.SYSTEM) and enter the partial or full 
pathname of the program to be run by the compiler system program 
as the Startup entry (eg; /HARD1/PROGRAMS/SUPER.COMPARE.C). This 
feature actually writes the new startup path to the startup area 
of the program being launched; therefore, the SYS program cannot 
be write protected or write disabled. If it is, the SYS program 
will be launched with the startup area unchanged. You can clear a 
previously set startup path entry by entering a startup pathname 
of a single asterisk (*). Do this, for instance, to allow 
AEPC.SYSTEM to go to the MSDOS prompt and not launch any IBM 
program. Provision has been made to enter up to the full 64 
characters supported by the Apple protocol. Because of the 
multiple uses of this information, no syntax checking is performed 
- so make sure you enter it correctly. If you don't, clear it next 
time with the * option or reenter the data again. The Launcher 
will not let you write to any areas other than the startup area of 
the program being launched. Please note that any startup path you 
specify must be at least 2 characters long and no more than 64 
characters long. If you desire to specify a file name consisting 
of a single character as the startup path, use its full pathname 
rather than its file name (eg; use /HARD1/A instead of A as the 
startup path).
     Set up as many entries as you want in your menu. When you 
have completed a given menu press the save button. This will 
permanently save your menu choices in a file written to the SYSTEM 
directory of your boot disk. A single file will be written for 
each menu screen (named UWGS.MENU.0-9 depending on the menu screen 
selected). A separate configuration file (UWGS.CONFIG) is also 
written to the SYSTEM directory. This file contains the menu names 
and other information used by the program. If you do not save a 
menu it will only remain in memory until the next program is 
launched or the Launcher is exited. Whenever you save the menu, 
you are asked to provide a name for the menu. This permits you to 
give a brief title to assist you in menu management. You will also 
be presented with the options of setting the slots and speed, 
setting the text, background, and border colors, setting the modem 
and printer parameters, and setting the Startup Slot for this 
menu. These will be invoked the next time the menu is activated.  
Each menu file saved will be from one to several blocks in length 
depending on the number of menu entries, the length of the program 
pathnames, and the special slot settings used.
     Please note that when selecting a previously used menu button 
to reconfigure in the Insert Mode, you must reenter any desired 
slot, speed, color, modem and printer information, since the 
previous information was erased at the time you pressed the 
button. If you aren't using slot, speed, color, modem, or printer 
settings, don't worry about the above considerations.
     You must press the Save... or Save As... menu item described 
below to save any changes made in this mode or the following Edit, 
Delete, and Arrange modes. If you forget to save a menu entry, you 
will be reminded prior to returning to the Launcher, getting a new 
menu entry, or quitting - situations in which your new or changed 
menu entries would otherwise be lost. This reminder dialog will 
also ask for a menu name if it has not previously been entered.


3.7 Edit Mode (Orange Background)

    This is the default Launcher Setup mode if a previous menu 
exists. This mode is very similar to the Insert Mode except that 
previous menu entries are not erased, and are displayed as the 
default settings in all dialogs. For any unused entry, this mode 
is identical to the Insert Mode. The Edit Mode permits changing 
the menu name or program pathname without changing the previously 
selected slot, speed, color, modem and printer parameter settings. 
In the Edit Mode, pressing Okay in the Set Names dialog box will 
install the new name and program pathname, but retain the previous 
slot, speed, color, modem, and printer information. This avoids 
the necessity of having to reenter the slot, speed, color, modem, 
and printer information unless you desire to make changes to any 
of this information. If you enter any slot, speed, color, or modem 
and printer parameter settings, previous settings will be 
displayed, and only those new selections you make will actually be 
changed. You can easily verify your entries by using the Show Mode 
described below or by cycling through all of the possible dialogs 
for the current menu entry.


3.8 Delete Mode  (Red Background)

     Clicking on any menu entry while in the Delete Mode will 
completely remove that entry (ie; make it appear as a blank 
entry). If you make a mistake and delete the wrong entry, DO NOT 
press Save. Merely reselect the menu from the Menus menu to 
restore the previously saved information.


3.9 Arrange Mode (Purple Background)

     This mode permits rearranging your menu entries on the screen 
to suit your preferences. When used in combination with the delete 
mode, you can achieve any desired layout. The Arrange Mode 
utilizes two clicks of the mouse to interchange any two entries. 
The first click will highlight (place a green outline inside) your 
first desired menu entry. The second click will select your second 
desired menu entry and initiate the interchange of the two 
entries. You can interchange between either blank or previously 
established menu entries. No information is destroyed in this 
mode. Menu entries are just moved about on the screen.

3.10 Customize Mode (Green Background)

     This mode permits you to add custom buttons to any of your 
menu screens that will allow you to boot a specific slot, select a 
specific menu, or purge memory when that button is depressed while 
in the Launcher mode. Just depress the button you desire to 
customize and select the desired action (Select Menu, Boot Slot, 
or Purge Memory). If you press Select Menu you are asked what menu 
you want selected when the button is depressed. The name of this 
menu becomes the button name. If you select Boot Slot you are 
asked what slot you want to boot when the button is depressed. You 
are also given the opportunity of entering a name for this button 
and specifying the various slot, speed, and color settings, and 
modem and printer parameters that will be set immediately before 
the requested slot is booted. If you select Purge Memory the 
button is set to Purge Memory when it is depressed in the Launcher 
mode. (See the discussion on purging memory below).


3.11 Show Mode (Gray Background)

     This mode permits you to view the contents of any menu entry 
you press. All previously entered information will be displayed, 
including:

          o Menu title
          o Full program pathname  / Startup pathname (if any)
          o Launcher restart status / Purge upon Launch
          o Basic Launcher utilization
          o Display mode
          o Slot settings (if any) (default settings appear as     
                 blank entries)
          o Speed setting, including TransWarp GS settings (if
                 any)
          o Text, Background (or Desktop), and Border color
                 settings (if any)
          o Clear Power-up Byte setting (if set)
          o Modem and printer parameter settings (if any)
          o Startup Slot

The show mode can easily and quickly be used to verify the 
contents of any menu entry. It can also be used to view the sample 
menu file provided with this program.
     In the Show Mode, the Save... and Setup Shutdown... menu 
items of the Menus menu are changed to Show Startup and Show 
Shutdown, respectively. Choosing these menu items will display the 
values of the current menu's Startup and Shutdown settings using 
the same dialog as described above.

     The current mode is indicated by a check mark in the Edit 
menu, by an indication in the window title bar, and by the 
screen's background color. All mode menu items are dimmed unless 
the Launcher is in menu setup.


4. Menus

4.1 Menu 0 - 9 (replaced by current name, if any)

     The first 10 entries in this menu indicate the available 
program menu screens. Previously saved menus will be indicated by 
the menu names that were entered when the menu was saved. 
Otherwise a generic "Menu n" name will be used. In the Launch 
mode, all entries are dimmed unless the indicated menu has been 
previously saved. The currently selected menu is indicated by a 
check mark beside its name, as well as by the name appearing in 
the menu window's title bar. To select another menu, merely click 
on the desired menu item. In menu setup, clicking on a menu item 
that was not previously saved allows you to bring in a new blank 
menu screen to begin menu setup in the Insert Mode.
     Menus can be selected in one of three ways; (1) use of the 
menu items in the Menus menu described in the previous paragraph, 
(2) use of a customized menu button described previously, and (3) 
use of hot keys. The latter two methods can only be used in the 
Launcher Mode. Pressing keys 0 through 9 will select the 
corresponding menu if it exists and is not the current menu. 
Pressing the tab key will select the next higher menu that exists. 
Pressing the Open Apple-tab keys will select the next lower menu 
that exists.
     There will be a slight delay (indicated by the wait cursor) 
when the new menu is selected. The actual delay depends on the 
number of menu entries and whether or not there are shutdown 
settings for the current menu and startup settings for the new 
menu.


4.2 Save...

     This item allows the user to save the current menu selections 
to the current menu number. After selecting the Save... item, the 
user is presented with a dialog box to enter the current menu 
name. This is the menu name that will appear both in the menus 
menu on the menu bar as well as in the menu screen title bar. 
Press Cancel to cancel the save. Press Okay to save the menu 
screen. Press Set Slots to set up the menu's startup slots, speed, 
color, or modem and printer parameters. These settings are 
performed using the same selection dialogs as used for setting up 
the individual menu entries, as described above. The menu is saved 
after entering the desired slot, speed, color, or modem and 
printer parameter settings. 
     When using the Save... menu item to overwrite a previous menu 
screen, pressing Okay in the Set Name dialog box will install the 
new name. If in the Edit Mode, the previous slot, speed, color, 
modem, printer, and Startup Slot information will be retained. 
This avoids the necessity of having to reenter the slot, speed, 
color, modem, printer, and Startup Slot information every time the 
menu is saved unless you want to change it. In all other modes the 
previous slot, speed, color, modem, printer, and Startup Slot  
information will be erased. With the Save... menu item, the Okay 
or Set Slots buttons must be pressed in the Set Name dialog box 
for the menu to actually be saved. 
     This menu item is dimmed unless the Launcher is in Menu 
Setup. In the Show Mode this item is replaced by the Show Startup 
item as discussed above.


4.3 Setup Shutdown

     This item permits you to enter the slot, speed, color, modem, 
printer, and Startup Slot information that will be set upon normal 
UtilityWorks Launcher Quit or Shutdown, or when changing menus. 
This information is associated with each menu and will be retained 
with the saved menu data. As with the Save... actions, previous 
settings will only be retained if in the Edit Mode.
     This menu item is dimmed unless the Launcher is in Menu 
Setup. In the Show Mode this item is replaced by the Show Shutdown 
item as discussed above.


4.4 Save As...

     This item is identical to the Save item described above, 
except that the current menu screen can be saved to any menu 
number, not just the current menu number. In combination with the 
Remove... item  described below, the Save As... can be used to 
rearrange the order of menu entries in the Menus menu. It can also 
be used to replicate existing menu screens, or to use an existing 
menu screen as the starting point for a new menu screen. After 
selecting the Save As... item, the user is presented with a dialog 
asking him to select the menu number he desires the current menu 
screen to be saved under. If there is any previously saved menu 
screen present under this number, it will be destroyed. As with 
the Save... item discussed above, the user is then presented with
a Set Name dialog box, as well as dialog boxes to set the menu's 
slots, speed, color, and modem and printer parameters if so 
desired. Previous settings are only retained in the Edit Mode.
     This menu item is dimmed unless the Launcher is in Menu 
Setup. 


4.5 Remove...

     This item removes a previously saved menu screen. The user is 
presented with the list of available menu screens that are 
candidates for removal. The current menu screen cannot be 
selected. If you desire to remove the current menu screen, first 
change to a different menu screen, and then use Remove... to 
remove the desired screen.
     This menu item is dimmed unless the Launcher is in Menu 
Setup.


5. Goodies

5.1 Options...

     This item allows the user to enter and save certain default 
settings for the UtilityWorks Launcher. You can choose the types 
of files that you will be permitted to select for launch, or you 
can select the defaults (all BIN and only short TXT files). BAS 
files are automatically selected. If you want to be able to select 
(or deselect) BIN, short TXT, all TXT, or EXE files simply press 
the corresponding check box. An X in the box indicates the item is 
selected. The program will only allow you to select one or the 
other (or neither) of the short TXT and all TXT buttons. Use of 
the Autostart and Blackout Timer options is discussed below, as is 
the Access Password. Press the SAVE button to permanently record 
your defaults so you don't have to reenter the defaults every time 
you use the program. If you have copied the UtilityWorks Launcher 
onto several different disks, you should save the defaults on each 
of these disks.


5.2 Purge

     This item will purge all Apple IIGS memory that has been 
declared as purgeable. A dialog informs the user of the amount of 
memory that has actually been purged. The Purge item permits the 
user to maximize the amount of memory that is available for use by 
the next application to be launched. Purge can also be set in any 
Launch Button to be executed just before launch of the next 
application (after all of the windows have been closed and most of 
the tools have been shut down). If your amount of Apple II GS 
memory is marginal for the next application to be launched, select 
Purge on Launch (in the next application's menu entry). This will 
result in as much memory as possible being allocated for use by 
the next application. Making the Launcher not restartable 
(automatically done if you select Purge on Launch -see discussion 
on restartability below) will minimize memory fragmentation, and 
provide the maximum amount of contiguous memory for use by the 
next application. Purge also unloads and purges the UtilityWorks 
Launcher's own dynamic segments to create maximum space in memory.


5.3 Password...

     This item presents a dialog for entry of the Shareware 
password for use by registered owners of the UtilityWorks 
Launcher. You will be given a password after you pay your 
Shareware fee. Simply enter the password you have been given and 
press Okay. Entering and saving the correct password will prevent 
the Shareware Alert dialog box from appearing the next time you 
boot your computer and run the UtilityWorks Launcher. The 
Password... item in the Goodies menu will disappear after the 
password has been correctly entered. If you press Okay to exit the 
Password dialog box (even if you do not correctly enter the 
password), you will be presented with the Set Defaults dialog box 
described above under the Options item. To save your password, 
press the Save button in the Set Defaults dialog box.






                        Using the Launcher


     The Launcher routine uses previously constructed menus 
generated from the Launcher Setup routine discussed above. Just 
click on any indicated program to launch that program. The 
Launcher checks to see that the requested program is present in an 
active device prior to launching it. If nothing happens when you 
click on a previously established menu entry, it means that that 
program is not present in an active disk drive, or the pathname or 
filename of the desired program has been changed from that which 
existed when the menu entry was first created. After completion of 
execution of the selected program (assuming a normal completion), 
the operating system will automatically return to the Launcher 
menu for selection of the next program to be run. If the Launcher 
Setup has not already been performed, it is desirable to do it 
before proceeding, although the Launch... item can be used without 
further setup. If the separate UtilityWorks Program 
(UTILITYWORKS.GS) is present in the SYSTEM directory of your Boot 
disk, and if no other menu entry has been previously installed as 
the upper right menu entry, the Launcher will automatically 
install UtilityWorks in this menu position. You can change this 
automatic installation to any other desired menu entry using the 
Setup routine. UtilityWorks is installed with the Launcher 
restartable from memory. Change this to non-restartable if your 
Apple IIGS memory is tight.

     The UtilityWorks Launcher, working in conjunction with the 
UtilityWorks Set Prefix capability, supports I/O Redirection with 
System Disk 5.0. A complete discussion of this capability is 
contained in the UtilityWorks documentation. The Standard In, 
Standard Out, and Error output prefixes set by UtilityWorks will 
be passed by the UtilityWorks Launcher to any S16 program it 
launches.

     The UtilityWorks Launcher should work satisfactorily with all 
P8 and P16 programs which follow the Apple Quit protocol, and all 
P16 programs which utilize the Apple II GS Memory Manager in 
accordance with Apple's guidelines. Some early P16 programs and 
some very old P8 programs do not follow these standards. These 
programs can still be launched, but they probably will not return 
to the UtilityWorks Launcher upon exit. With certain BASIC 
programs you will be presented with a "]" prompt at conclusion. 
Just type "BYE" to return to the UtilityWorks Launcher. 
Incidentally to launch a BAS, BIN, or TXT file you must have the 
files BASIC.SYSTEM and BASIC.LAUNCHER in the root directory of 
your boot disk.

     The UtilityWorks Launcher has been coded to be restartable 
from memory (see programming notes below), and can request the 
Operating System to restart it (ie; not reload it) upon 
termination of the program being launched. This technique can 
significantly improve performance when using operating systems 
prior to System Disk 5.0. Unfortunately, restartability will not 
successfully work when launching some programs. Despite problems 
with a few programs, for the vast majority of P16 programs, 
restartability offers a significant performance enhancement. The 
UtilityWorks Launcher lets you have it either way. With the 
Launch... button, the UtilityWorks Launcher will always be 
reloaded from disk upon termination of the program being launched. 
This gives slightly slower performance, but should work with all 
programs following the Apple Quit protocol. With the menus (and 
the Autostart feature), the Launcher Setup routine gives you the 
choice of whether to implement the restart feature. With your 
troublesome programs (and especially the Finder) don't use the 
Restart feature. With very troublesome programs use Purge Upon 
Launch. With most other P16 programs, choose the Restart feature 
for best performance. Menus constructed with earlier versions of 
the UtilityWorks Launcher will not use the Purge feature unless 
you reenter (using Edit Mode or Insert Mode) the setup 
information.





                        Program Autostart


     Checking the Autostart box in the defaults dialog box will 
force the UtilityWorks Launcher to automatically launch the first 
(upper left) entry on your currently active menu screen the next 
time the disk is booted. This feature can be very useful if you 
have disks where you normally want to boot into a given program, 
but still want to return to a powerful program selector upon exit 
from that program. Upon normal exit from the automatically 
launched program you will return to the UtilityWorks Launcher, 
where you can now select any other program for execution. You can 
use any of the 10 possible menus for Autostart merely by using the 
Menus menu to select that menu prior to the next disk boot.  Just 
remember that unless you deselect the autostart button (and SAVE 
the defaults) or have a null entry as your first program on the 
active menu, the UtilityWorks Launcher will automatically launch 
the first menu entry every time the disk is booted. The 
UtilityWorks Launcher communicates with itself every time it is 
run by using the Apple IIGS Toolbox's Message Center. If it finds 
a previous message to itself it knows that this is not a fresh 
boot. In this manner the Launcher can release all of its memory 
and still retain information about the boot state.



                      Screen Blackout Timer


     The Default Dialog Box also permits you to select a time 
interval for shutting down the monitor's screen, to prevent 
burning an image into the screen after long periods of time where 
the screen image remains constant. This timer only works while you 
are actually in the Launcher (it does not work with applications 
you launch). With this option, if you do leave your computer on 
while in the Launcher for an extended period of time with no 
activity, such as going to lunch, the computer's screen will be 
blanked when this timer expires. The timer can have any value from 
1 minute to 60 minutes. Any larger value is interpreted as 0. The 
default is also 0, which means that the timer is inactive. I have 
found a value of about 10 minutes is ideal for me. To restore the 
screen merely press the mouse button or any key. 




                          Access Control


     Version 1.3 and later of the UtilityWorks Launcher includes a 
capability to restrict access to certain of the program's features 
in order to prevent unauthorized users, such as children or 
students, from launching programs, such as utilities, which could 
potentially damage or destroy the contents of a hard disk if not 
properly used. 

     Access control is not normally activated. To activate this 
feature, click the mouse on the Access Password rectangle of the 
Defaults dialog box (or press the tab key to get to this entry) 
and enter whatever password you desire (the password is case 
sensitive). Append an asterisk (*) to the end of the password. The 
asterisk is NOT later entered with the password. It is used 
strictly to prevent inadvertent implementation of access control. 
Press SAVE to save the access password and implement access 
control the next time the UtilityWorks Launcher is executed. To 
disable access control at a later time, an authorized user may 
enter a single asterisk (with no other characters) in the Access 
Password rectangle, and save the entry. This will erase the 
previous password and return the program to normal operation. 

     With access control enabled, unauthorized users (ie; those 
users who do not know the password) can only access the first 5 
menus (menus 0-4). Several items within the menus in the menu bar 
will also be dimmed as discussed above and hot keys 5-9 will be 
inactive. The 5 menus that are accessible to all users should have 
only "safe" programs installed on them. Unauthorized users will 
only be able to launch these programs. The dimmed and disabled 
entries will prevent unauthorized users from setting up menus with 
any other entries, or directly launching any program other than 
those you have previously set up on one of the five menus. You can 
rearrange the existing menu screen numbers as described in the 
above Save As... and Remove... item discussions to choose which 
menus are to be the first 5. UtilityWorks will not be 
automatically installed in the first 5 menus if access control is 
in effect. However, it may have previously been automatically 
installed and saved. In this latter case you may want to delete 
UtilityWorks to prevent unauthorized access.

     An authorized user can gain access to the "hidden" features 
at any time by entering his previously selected access password at 
the Enable Access item in the Files menu. After the Enable Access 
password has been correctly entered, the Open Setup... menu item 
will immediately become undimmed and may be selected. Unlimited 
access will remain in force until the next time the program is 
executed or a program is launched, unless the single asterisk is 
entered and saved in the Defaults dialog box, in which case 
unlimited access becomes permanent. While access control is in 
effect you must reenter the access password following launch of 
any program to regain access to the restricted features.

     The access control is designed to provide only very limited 
protection with inexperienced users such as children or students 
that are not computer experts. An experienced computer user can 
easily defeat this protection. In fact if you forget the password 
you entered, you can easily see what it is just by viewing or 
printing the UWGS.CONFIG file. Your password is the last visible 
entry in this TXT file. Alternatively you can delete this file to 
restore normal program operation. (You must reenter the defaults 
if you delete UWGS.CONFIG).




                          Changing Slots



     Changing Slots while the Apple II GS is executing is 
potentially dangerous and must be done with great care. Follow the 
following instructions to do it properly. To minimize problems, it 
is best to group all of your menu entries involving slot changes 
on a single menu screen, and have all other menu screens use the 
defaults for slot changes. If something gets messed up, the 
program will probably crash or you will get an operating system 
error. Reboot the computer and check the control panel settings, 
making any necessary changes. If you need to make slot changes 
reboot again. In severe cases you may need to turn the computer 
power off and then back on to correct the problem. In no case will 
any permanent damage be done to your computer hardware, but it 
sure can be annoying if the computer crashes.

     The UtilityWorks Launcher sets slots by changing both the 
Battery Backup RAM and the corresponding Soft Switches to the 
appropriate values. If the Clear Power-up Byte option is selected 
in the Set Slots dialog box, the Power-up byte in the Keyboard 
Microprocessor RAM will also be reset. Earlier versions of this 
program cleared the Power-up byte somewhat differently. Clearing 
the Power-up byte is unnecessary unless you want to remove the 
/RAM5 disk the next time you boot (normally this can only be done 
by turning off power). The current implementation gives the user 
the option of whether to clear this byte or not. The actual 
clearing of the Power-up byte is deferred until the Shutdown menu 
item is selected. If any program is launched in the interim, the 
Power-up Byte will not be cleared.

     If you follow the process outlined below, the UtilityWorks 
Launcher will force all control panel settings to be initiated 
immediately. You never have to wait until the next boot or the 
next time the power is turned off. As mentioned above, switching 
slots must be done with care. Consider what each slot is used for 
(internally and externally (slot cards)) before you initiate the 
change. Remember that internal slot 3 supports the 80 column 
firmware needed by many programs (eg; you won't see the 
UtilityWorks Launcher's Launching... message if slot card 3 is 
selected). Internal slot 4 supports the mouse required by many 
programs including the UtilityWorks Launcher. That doesn't mean 
you can't use the UtilityWorks Launcher to change slot 3 and slot 
4 (I do), you just have to do it carefully. Slot RAM cards pose 
special problems. The Apple II GS does not like to switch out RAM 
cards, including /RAM5 (slot5, drive2), for fear of loosing data, 
and will not normally implement such a requested control panel 
change until the computer is actually turned off. With battery 
backed up RAM cards this, of course, is not a problem. The 
UtilityWorks Launcher can effect instantaneous change from slot 
RAM or /RAM5 (slot 5/drive 2) to disk or another slot card if 
properly set up as described below. This procedure works with 
GS/OS, but has not been tested with previous ProDOS 16 versions. 
Also it probably will not work in slot 6 unless you have new or 
updated Apple 3.5 in. drives that correct the daisychain interface 
card problem, which caused occasional anomalies with Apple 5 1/4 
in. drives. Until I had my interface cards replaced (a free Apple 
update) I could not get any slot change program to work with my 
RAMFACTOR card.

     It is probably easiest to explain the use of slot change by 
example. The following is my slot card setup:

       Slot                         Card

         1.               free
         2.               Apple Super Serial Card (for those Comm
                          programs still requiring it)
         3.               Applied Visions FutureSound card
         4.               Applied Engineering PC Transporter
         5.               AST VisionPlus card
         6.               Applied Engineering RamFactor card
         7.               Apple SCSI card

In addition to a hard disk in slot 7, I also have two 3.5 in. 
drives and an Applied Engineering ROM card in slot 5, and two 5 
1/4 in. drives in slot 6, as well as drives supporting the PC 
Transporter in slot 4. As you can see I have a fairly full 
computer, and many programs on my hard disk require slot changes 
to work. From my experience it is best to set up your control 
panel to Apple slot defaults and let the UtilityWorks Launcher 
handle the slot switches. It is necessary that slot 6 be set 
internal (Disk Port) at power-up and booted in that configuration, 
or the slot change will not properly be made when going back and 
forth between the RamFactor and the 5 1/4 in. drives. Slot 5 
should also be set internal (Smart Port) if you are using the 
/RAM5 (slot5, drive2).

     For any menu screen having slot change selections, make sure 
you set all of the slots that you intend to change with individual 
menu entries to the appropriate menu startup settings (as selected 
during the Save Menu dialog sequence). By this process, the 
Startup slot settings will automatically be set (previous values 
restored) as each launched program returns to the UtilityWorks 
Launcher. These settings for the most part should be set to 
internal (except slot 7), although I have my slot 6 set to slot 
card (external) because several programs won't work properly 
without the RAM disk so set. Make absolutely certain that slots 3 
and 4 are set to internal (not slot card) if you intend to change 
them. You should now set all relevant entries in the Menu Shutdown 
settings (chosen by the Setup Shutdown menu item). I have all of 
my Shutdown slots set to internal except slot 7. This will be the 
setting that prevails on the next boot or power up, or when the 
Launcher is switched to another menu set. Next, for each menu 
entry requiring a slot card, select only that slot as external 
(slot card), keeping all other slots at default. Now as you launch 
the individual programs, the appropriate slots will be instantly 
changed and properly restored upon return to the UtilityWorks 
Launcher. This above procedure has worked very reliably for me 
with my configuration. Significant slot changes can occasionally 
cause problems for GS/OS when the UtilityWorks Launcher shuts down 
and returns to a P8 program selector, especially if the exiting 
slot setup is different from the entry slot setup.  However, if 
you have UtilityWorks Launcher established as your START program 
you should not experience these problems.

     If you are using the  /RAM5 (slot5, drive2), you may want to 
select the Clear Power-up Byte option whenever you switch to 
another slot 5  device (Your Card). This Clear Power-up Byte 
option will totally remove the /RAM5 at the next boot. If you do 
not use the Clear Power-up Byte option, you can retain the 
contents of /RAM5, even after switching to another slot 5 device, 
until the computer is powered down. Simply have the /RAM5 
specified at the time you boot your computer. Use the select slots 
dialog box to select external slot 5 (ie; slot card) for the 
program you want to execute that uses this slot card (mine is the 
AST VisionPlus card). When this program is launched, the Launcher 
will switch slots and zero the minimum and maximum RAM sizes in 
the control panel (the RAM downsizing only occurs when you switch 
slot 5 from internal to external). Upon return to the UtilityWorks 
Launcher, the original internal slot 5 setting will be restored, 
but the RAM settings will remain at zero. However, you can still 
access the data in /RAM 5 as though the RAM settings were never 
set to zero. This is because these particular settings normally do 
not take effect until the computer is powered down. If you follow 
the above steps but Clear the Power-up Byte, any existing data in 
/RAM5 will be lost when you reboot your computer. This is an easy 
way of getting extra memory for some large programs that don't 
need /RAM5, without having to turn your computer off then back on 
again to remove /RAM5, although you do need to reboot your 
computer with an Open Apple-Control-Reset Boot to have this 
technique work. You can verify that the Clear Power-up Byte option 
has been properly set up by viewing the menu entry in the Show 
Mode.

     You can construct a dummy menu entry to clear the Power-up 
Byte. One way of doing this is to set up a menu entry with no 
program selected which switches slot 5 from internal to slot card 
(external) with the Clear Power-up Byte selected. By setting the 
Shutdown slot selections to switch back to slot 5 internal, you 
can press the menu entry followed by the Shutdown button to clear 
the Power-up Byte. This will instantaneously switch slot 5 from 
internal to external, set the flag to clear the Power-up Byte, 
zero the minimum and maximum RAM settings in the Control Panel, 
switch slot 5 back to internal, and shut down the operating system 
with the Power-up Byte cleared. With GS/OS present, GS/OS is 
instructed to clear the Power-up Byte. If ProDOS 16 is present, 
the Launcher itself will clear the Power-up Byte. When the 
computer is now rebooted, the Power-up Byte will be cleared, and 
/RAM5 will no longer be present. An example of this technique is 
shown in the sample menu file.



          Launching IBM Programs with the PC Transporter


     The UtilityWorks Launcher includes a provision to launch any 
IBM program if you have a PC Transporter and the associated 
Applied Engineering software. Your AUTOEXEC.BAT file must be set 
up to include AE's launcher.exe file. My AUTOEXEC.BAT file is as 
follows. Adapt yours to suit your needs.

prompt $e[40;36m$e[1m$
echo off
prompt Applied Engineering PC Transporter, on $d at $t$_$p$g
cls
path=e:\;e:\pcdos;e:\aepc;e:\pctools;e:\norton
keyb us 437 \pcdos\keyboard.sys
ver
aplclock
launcher.exe

You will also need a BAT file in the root directory for each 
program being launched. For instance my BAT file for Lotus 123 is:

LOTUS.BAT

cd e:\lotus
lotus
cd\


My MSDOS hard drive is drive e: - yours may be c:. 
My Lotus 123 program is in a directory called lotus.

Setting up the IBM side is the hard part. To set up the Launcher 
to launch Lotus 123 I merely select the AEPC.SYSTEM file as the 
program to launch, set slot 6 to external (assuming your PC 
Transporter is in slot 6), and enter a startup path of LOTUS.   
That's it!

                        Programming Notes


     The UtilityWorks Launcher consists of several segments within 
its S16 file. To maximize performance, less frequently used 
features of the program (mainly menu setup and Password entry 
dialog boxes) are contained in a dynamic segment that is only 
loaded as needed. This is why you will experience a slight delay 
when you first use one of these features. The System Loader must 
retrieve the dynamic segment from disk. Subsequent use of these 
features will be much faster because the dynamic segment is 
already in memory. Normal program launching options do not require 
this dynamic segment. The UtilityWorks Launcher S16 file is in 
ExpressLoad format for best performance in loading under System 
Disk 5.0. It will also load under previous GS/OS and ProDOS 16 
versions, but the performance will not be nearly as good.

     The UtilityWorks Launcher has also been designed to be 
restartable from memory. Any time a program is launched, the 
UtilityWorks Launcher can request the Operating System (ProDOS 16 
or GS/OS) to retain its code segments in memory if the Operating 
System does not need the memory space for running the program 
being launched. This results in significant performance 
improvement when running smaller P16 programs (depending of course 
on the amount of memory available in your computer), since the 
System Loader does not have to reload any of the UtilityWorks 
Launcher's code segments. The System Loader does always reload the 
Launcher's ~globals segment, and the Launcher itself reinitializes 
its ARRAYS segment from the configuration and menu files. The 
performance enhancement is not as great with P8 programs because 
ProDOS 16 or GS/OS must be reloaded following termination of the 
P8 program on all operating systems prior to System Disk 5.0. 

     Version 1.6 of the UtilityWorks Launcher also incorporates 
two QuickDraw speedup enhancements (hardware shadowing and fast 
port) to improve performance.



                            SHAREWARE


The UtilityWorks Launcher is a Shareware program. You may use this 
program without charge for the first 10 days. After this initial 
evaluation period, a $10 fee must be paid to George R. Wilde for 
continued use of the UtilityWorks Launcher. The companion 
UtilityWorks program is likewise a Shareware program, and is 
available for a $20 fee. The combined fee for both programs is $25 
(previous purchasers of either program may deduct $5 from the 
Shareware fee for purchase of the other program).

The $10 Shareware fee for the UtilityWorks Launcher should be sent 
to:

                          George R. Wilde
                          24402 Broadwell Ave.
                          Harbor City, CA 90710

Upon receipt of the UtilityWorks Launcher Shareware fee, users 
will be provided with a Password to remove the initial Shareware 
Alert Dialog Box. Passwords will be provided by US mail (or by 
electronic mail on America Online, Compuserve, Delphi, GEnie, or 
MCI mail if you provide your electronic mailbox address with your 
payment).

Please distribute this program to your associates, User's Groups, 
and other networks, but don't distribute the Password and don't 
distribute it commercially. Remember it is Shareware, and each 
user is required to pay a Shareware fee following the initial 
evaluation period. When distributing this program please make sure 
you include this documentation file to assist new users in 
correctly utilizing the UtilityWorks Launcher's many features.

Future updates to this program will be available on America 
Online, Compuserve, and GEnie. Registered owners will be informed 
when major new capabilities are released. If registered owners are 
unable to conveniently access these updates, the latest versions 
of UtilityWorks and the UtilityWorks Launcher (both will be 
provided on a single disk) may be obtained directly from the 
author upon payment of $5 to cover the cost of the disk, mailer, 
postage, and the Apple GS/OS license fee.





                            COPYRIGHTS



The UtilityWorks Launcher is Copyright (C) 1988, 1989 by George R. 
Wilde. All rights reserved.

Copyright (C) 1987 TML Systems, Inc.
Certain portions of this software are copyrighted by TML Systems, 
Inc.

ProDOS Copyright (C) 1983-1988 by Apple Computer, Inc.

GS/OS Copyright (C) 1988-1989 by Apple Computer, Inc.




                     SOFTWARE LICENSE NOTICE



     The software/documentation described herein is furnished 
under a nonexclusive license and may be used only in accordance 
with the terms of the license. Any unauthorized duplication or use 
of the UtilityWorks Launcher software and or documentation, in 
whole or in part, in print, or in any other storage and retrieval 
system is forbidden, without the prior written permission of the 
author. This product is intended for your personal use and may not 
be distributed commercially without the express written permission 
of the author.




                       WARRANTY DISCLAIMER



The author, George R. Wilde, makes no representations or 
warranties with respect to the contents of the UtilityWorks 
Launcher and its associated documentation, and disclaims any 
liability or responsibility to the purchaser or any other person 
or entity with respect to liability, loss, or damage caused or 
alleged to be caused directly or indirectly by this software. 
Furthermore, the author reserves the right to revise this product, 
and to make changes from time to time in the content hereof, 
without obligation to notify any person of such revisions or 
changes.




                            TRADEMARKS



     UtilityWorks is a trademark of George R. Wilde.

     Apple, AppleWorks, Applelink, Apple IIGS, IIGS, Finder,
     GS/OS, ImageWriter, and ProDOS are registered trademarks of  
     Apple Computer, Inc.

     PC Transporter, TransWarp GS, and RamFactor are trademarks of
     Applied Engineering, Inc.

     FutureSound is a trademark of Applied Visions, Inc.

     VisionPlus is a trademark of AST, Inc.


