AMIGANTT Project Management Tool Version 4.02.00 Program Description June 1, 1992 AMIGANTT Table of Contents 1.0 Introduction 1.1 Purpose of the software 1.2 Features of AMIGANTT 1.3 Restrictions 1.4 Installing the software 2.0 Creating a Project 2.1 Main Screen 2.2 Menu Options 2.2.1 Project Menu 2.2.2 Window Menu 2.2.3 Task Menu 2.2.4 Print Menu 2.2.5 Sort Menu 2.2.6 Misc Menu 2.3 Adding the Project Header 2.4 Adding Tasks 2.4.1 Adding another project as a task 2.5 Modifying Tasks 2.6 Deleting Tasks 2.7 Moving Tasks 2.8 Saving the Project 3.0 Printing a Project 3.1 Printing the Screen 3.2 Printing the Project 3.2.1 Gantt Chart 3.2.2 Task List & Summary 3.2.3 Resource Summary 3.2.4 Resource Histogram 3.2.5 Pert Chart 4.0 Modifying Existing Projects 4.1 Opening the Project 4.2 Changing the Header Information 4.2.1 Conversion of Costs/Durations 5.0 ARexx Interface 6.0 Enhancements for version 4.02.00 of AmiGantt and known anomolies AMIGANTT -- Project Management Software 1.0 Introduction 1.1 Purpose of the software AmiGantt was designed to create a simple, interactive method of outlining the tasks required to complete a particular project, using the GANTT chart as the input format. There are other programs in the microcomputer world using a similar interface, but none that I could find for the Amiga, and none that had the range of project flexibility I thought a manager would need. Many project management systems systems tend to be rather 'batch' oriented and require a fair amount of task and resource planning before you ever get to the computer screen. The intent with AMIGANTT was to provide a simple, easy-to-use tool for tracking of tasks, their duration, and their resources. Because I'm most familiar with the top-down approach to project definition -- where the major tasks are broken down to finer and finer levels of description to very simple activities -- I decided to build the primary interface around a GANTT chart. In this way, the tasks already entered can be viewed at all times as subsequent levels of detail are added. AMIGANTT can run on any Amiga computer (500, 1000, 2000 or 3000) under Workbench 1.2 and above(!!). Version 4.02.00 of AmiGantt requires the ARP library (ver 39+) installed in the LIBS: directory before use. 1.2 Features of AmiGantt - utilizes a top-down approach to project definition, based on a GANTT chart interface - written to make maximum use of the Amiga, it utilizes an Intuition-based interface with drop-down menus and Amiga-key replacements to select functions. - displays the project in a multi-window mode with separate windows for the Gantt Chart, task information input, resource histogram display and Pert Chart display. All windows are displayed on a single, 8-colour screen to facilitate dragging them out of the way when required. - all open windows (eg Resource and Pert) are updated automatically as changes are made in the Gantt chart - AmiGantt is well behaved in the multi-processing mode and should have no problem working with other programs. - can be run from either Workbench, via the supplied icon, or directly from CLI. Users running the program from CLI can optionally provide the name of the input project file they wish to work on. AMIGANTT also optionaly creates icons for each project saved, which allows Workbench users to directly enter the project simply by double-clicking its icon. With version 3.00.00 and above, a menu selection is provided so the user may have AmiGantt generate or not generate icons for saved projects. - AmiGantt will notify the user of low-memory situations and provide a graceful exit. It uses a dynamic-memory allocation scheme so that only enough space is taken to hold the tasks defined for the project. As tasks are deleted from the project, AMIGANTT will free the memory allocated to them. - up to 500 tasks may be defined for any project and a project may contain other projects as tasks (e.g. sub-projects) - text-only entries may be defined to provide headings to help separate major tasks, or to provide additional description on the Gantt chart - Milestone tasks may be defined to identify reaching certain points in the project. Milestones can be tied to a particular date or dependant on other tasks. - the calendar and task fields may be scrolled separately to allow viewing of any part of the Gantt Chart - the project format may be displayed as daily, weekly or monthly with conversion routines between each format - sub-projects are also automatically converted - any task in the project (except headers) may be dependent (cannot start until the first is finished) on up to 10 other tasks - calculated dependencies are supported, so the user may define that a task begins 5 days after or 2 months before the end of another task. - can store planned and actual parameters of tasks (start date, end date duration) - up to 10 resources may be defined for each task - costs for each resource may be uniquely defined in each task - costs for each resource may defined as 'fixed' (do not change with the duration of the task) or 'variable' (change with with the duration of the task) - each resource may be assigned a 'usage percentage' which determines the amount of their total time is dedicated to that task - costs and resources are retained to aid in the adding of new tasks - task start dates may float based on other task dependencies or the project start date, or a start date may be specified - tasks may optionally have an 'ending date' attached which will become the latest end date for the task. This allows tasks to include a 'float' period if this end date is beyond the time needed for the task. - printouts available include - Screen image - Gantt Chart - Resource Histogram - Pert Chart - Resource Summary - Task Listing (Detail) - Task Summary - screens may also be saved as IFF files for processing in paint, CAD, or WP programs. - printouts may be aborted by pressing the ESC key at any time or by using the Stop Printing gadget on the Print Window - printouts for the Gantt Chart, Resource Histogram, and Pert Chart may be printed in Graphic bitmap mode or in text mode, depending on the characteristics of the printer. - using the Amiga Preferences program, graphics printouts may be printed horizontally or vertically. You may also select the layout of graphic printouts from the print window. - Graphic printouts may be sized to fit whatever portion is desired for display. - AmiGantt 4.02.00 supports two ARexx ports -- an input port to allow an ARexx macro to run AmiGantt and initiate many of the menu options; and an output port which allows ARexx macros to be attached to tasks to run other ARexx-supporting programs such as Editors, sound players, IFF file displays, spreadsheets, etc. - The colours used in AmiGantt displays can be individually altered and stored for each project. 1.3 Restrictions of AmiGantt NOTE -- These are restrictions placed on version 4.02.00 of AMIGANTT. They may be removed in subsequent releases of the software. - 500 tasks per project - 10 dependent tasks per task - 10 resources per task - task descriptions are limited to 30 characters each - resource descriptions are limited to 15 characters each - resource cost per unit (day/week/ or month) cannot exceed $9999.99 1.4 Installing the software AmiGantt consists of a single program file, called AMIGANTT, which can be placed anywhere the user desires. In most cases, installation will simply consist of copying this file into the desired directory. WorkBench users may simply drag the AmiGantt icon included on the diskette to the desired drawer. Project files created by AmiGantt are placed according to the user's wishes and hence, may also be located on any convenient disk volume. It can be run from either CLI or Workbench and an icon file has been provided for the latter (appropriately enough, called AmiGantt.info). The icon file should be copied to the same directory as the AmiGantt program. Version 3.00.00 of AmiGantt and above makes use of some of the features provided by the ARP library (AmigaDos Replacement Program) such as the file requestor and the CLI startup processing. In order to support these features, version 39+ (or above) of the ARP library must be installed in the LIBS directory of your system disk. A copy of this library, called arp.library is provided on the disk. This file should be copied to LIBS: and your Amiga re-booted before using AmiGantt 4.02.00. AmiGantt -- Project Management Software 2.0 Creating a Project 2.1 Main Screen When the program is first started, the first thing the user will see is the Main Screen of AmiGantt. The screen shows a blank task list and calendar area. (This is basically a Gantt Chart area). ______________________________________________________________________________ |_| AmiGantt 4.02.00 | | | Apr'88 11111 11222 22222 May'88 1111 11112 22222 33 ___ 12345 89012 56789 23456 90123 67890 34567 |*|1 Task descriptions ^ |*|2 | |*|3 Date Calendar |*|4 |*|5 | |6 | |7 | |8 | |9 | |10 | |11 | |12 | |13 <--- Task numbers | |14 | |15 | |16 | |17 | |18 Date scroll gadget | |19 | | |20 | | | | | |<-- Task scroll gadget _______________________|__________________________ |_|________________________|_________________________________________________| 2.1 Main Screen (Cont'd) The Calendar on the main screen is defaulted to the daily format and will begin on the Monday previous to or on the current system date -- which is usually today. The top left corner of this screen will display the version number of AmiGantt. Below the title line is the main body of the AmiGantt Gantt Chart. The numbers on the left side of the screen are the task numbers for each of the lines in the Gantt Chart. These numbers are used as reference in AmiGantt and should be used when describing dependencies between tasks. Immediately to the right of the numbers is where a portion of the text description of each task will be displayed. Have no fear, the full task description is provided on all printed output. To the right of the descriptions will appear the task duration bars, showing when the task occurs on the calendar. In some cases, tasks may extend beyond the right side of the screen or may even start on a date beyond the right edge. To view the task pointers for these, the date- slider gadget at the bottom of the screen may be used to shift the calendar 'window' to the right or left. You can also shift the calendar display left and right 1 week at a time using the right and left cursor keys. Note though, that the calendar will not shift beyond the project starting or ending dates. CURRENT TASK -- The blue block shown in the task area highlights the 'current task'. Any task operation, such as add, modify, delete, or move will operate on this highlighted 'current task'. The current task may be changed by either moving the highlight block up or down using the cursor positioning keys; or by placing the mouse pointer anywhere in the description field of the desired task and pressing the left mouse button. You can scroll the task numbers in the display using the task scroll gadget at the left of the screen. It is possible to scroll the current task off the displayed portion of the screen. AmiGantt keeps track of the current task though, and will highlight it when it appears on the screen again. If you use the cursor positioning keys to select the current task, the task display will automatically scroll up or down (if possible) when you hit the top or bottom of the display -- in order to keep the current task visible. 2.2 Menu Options As with any good Amiga program, AmiGantt functions are selected using the drop-down menus displayed when the right mouse button is pressed. There are six sets of menus available in AmiGantt: The PROJECT menu, WINDOW menu, TASK menu, PRINT menu, SORT menu, and the MISC menu. The various functions available in AmiGantt are logically collected under these menus and are described below. For those users more comfortable on the keyboard, there are Amiga-key replacements for the major options. 2.2.1 Project Menu This menu deals with functions that affect the entire project that is being worked on. It also includes some information about AmiGantt and the ability to quit the program. Each of the options found in this menu are described below. Open Project (Amiga O) To continue work on an already defined and saved project file, select Open Project and then fill in the name of the project file to be loaded into AmiGantt. More information on saving and loading of project files is provided in section 2.6 of this manual. Save Project... (Amiga S) Save Project allows the user to save the latest contents of the project to a file on disk. If a previous project was opened into AmiGantt for modification, Save will assume you want to use the same file name again and will prompt to ask if it's OK to wipe out the existing project file. If no file was previously loaded, Save will prompt the user to provide a suitable name for the project to be stored on disk and to write out the project tasks to that file. This file may then be loaded back into AmiGantt at any time (see Open Project above) for revision or update. Save As... This option allows the user to save the project to disk by directly asking for the file name he/she wishes to use. Again, if need be, AmiGantt will prompt to ask if it's all right to overwrite an existing file. Clear Project (Amiga C) By selecting Clear Project, the user can remove all tasks from the project and start with a clean slate. About Selecting this option from the Project menu will display a window with the current version number of AmiGantt and some information on how to get in touch with the author. Quit (Amiga Q) Selecting the Quit option from the Project Menu allows the user to leave AmiGantt. The same action may be accomplished by hitting the close window gadget at the top left of the Task (or Gantt) Window. If there were changes to the project and it has not been saved lately, AmiGantt will notify the user that changes to the project may be lost and will give the option to go back into AmiGantt and Save the project before exiting. Selecting the Cancel gadget in the requestor will return the user to normal AmiGantt main screen with the option to select the Save or Save As menu options. If the user wishes to ignore the changes made to the project, he should select the OK gadget from the requestor. If AmiGantt detects that no changes have been made to the project, selecting Quit will immediately leave the project without asking if you want to save. 2.2.2 Window Menu AmiGantt contains three main windows for display of the task information provided for a project. They are: a) the Gantt (or Main) Window, b) the Resource Window, and c) the Pert Window. Pert Chart When this function is selected, AmiGantt will open an additional window which will display the real-time updated Pert or Network chart for the project. Along the bottom of the window is a scroll gadget which can be used to change the range of tasks shown. The tasks shown in the window can also be changed a column at a time using the right and left cursor positioning keys. Resource Histogram As with the Pert Chart function above, selection of this option will cause AmiGantt to open an additional window which will display the current resource allocation for the project in histogram format. The Resource Window function will also open a Legend Window which displays the pattern used in the histograms for each of the project resources used within the time period shown in the window. Along the bottom of the window is a date scroll gadget which can be used to change the range of dates shown. The dates shown in the window can also be changed a week at a time using the right and left cursor positioning keys. The windows have all the usual gadgets assigned so that they may be moved or resized. There are no menus assigned to either of these two windows, but they may be closed by clicking on the close-window gadget in the top left corner. 2.2.3 Task Menu Functions in this menu allow the user to define, delete, modify, and alter the position of the tasks contained within a project. It also allows him/her to modify the default header information created for each project. NOTE: It is STRONGLY URGED THAT THE USER FIRST SET UP THE PROJECT HEADER by selecting the Modify Header option from this menu before proceeding with the addition of new tasks. See section 2.3 of this manual regarding the addition (modification) of the project header. Add Task (Amiga A) This option is selected to add new tasks to a given project. More information on adding a task is provided in section 2.4 of this document. It should be noted, though, that AmiGantt works on an 'insert before' mode of task addition. In other words, if the current task block is on a task number that has no description for it and Add Task is selected, AmiGantt will add that task number. If the current task block is positioned over a task number that does have a description and Add Task is selected, then AmiGantt will push all the tasks at the cursor position and below, down one line on the screen and insert the new task at that position. Again, more information on this will be provided in section 2.4. Delete Task (Amiga D) The user can remove a task by setting the current task block over a task description and selecting Delete Task. Before actually removing the task, AmiGantt will present the entire task description and give the user the option to gracefully back out. If you really want to remove the task, select the OK gadget at the bottom left of the task window. If you think better of it and want to keep the task, select the CANCEL gadget at the bottom right of the window. Modify Task (Amiga M) By setting the current task block over a previously defined task, and selecting Modify Task, the task fields are presented for changes. When the desired changes have been made, click on the OK gadget at the bottom left of the task window. If you change your mind and don't want to make any changes to the task, click on the CANCEL gadget at the bottom right. Move Task This function allows the user to pick up a task and move it to another place in the Gantt Chart listing. When selected, a requestor is opened asking the user to specify the number of the task to be moved (it defaults to the current task) and its new destination. Modify Header (Amiga H) Each project contains a 'header' that contains global information about the project. More information about the header information is contained in section 2.3 of this manual. Selecting Modify Header allows the user to view and modify this global information. IT IS STRONGLY RECOMMENDED THAT THIS OPTION BE SELECTED FIRST WHEN STARTING A NEW PROJECT -- BEFORE PUTTING IN ANY TASKS. 2.2.4 Print Menu This menu allows the user to select various options for output of reports from AmiGantt. During the operation of these options, the mouse pointer image will change to that of a printer with PIP (Print In Progress) at the bottom. This is to remind the user that AmiGantt will not process any other functions until the printing is complete. At any time during the printing process, the user can cancel the printout by pressing the ESC key on the keyboard or by selecting the CANCEL gadget on the print request window. Output to... When selected, this option presents a sub-menu with two further options. It allows the user to select whether print output should be routed to the PRT: (Preferences Printer) device or to a file on disk. The options are mutually exclusive and operational for all output from AmiGantt. If output to a file is selected, a file requestor window will be presented, asking the user for the name of a file in which to store the output reports. Just a note here -- Output to a file will not prompt if the file already exists so selection of a second report will wipe out the first. Print Type When selected, this option presents a sub-menu with two further options. It allows the user to select whether print output should be of a 'textual' type (using normal ASCII characters to generate the Gantt, Pert, and Resource reports) or a Graphic Bit-Map type (where an graphical image of the Gantt, Pert, and Resource charts, similar to the display on each of the windows but without the gadgets). The options are mutually exclusive and operational for all output from AmiGantt. Print Screen As would be expected by the description, selecting this option with the Output to... option set to PRT: will cause a screen 'dump' of what is currently being displayed to be routed to the user's default printer. If the Output to... option is set to file, AmiGantt will create an IFF file for each of the windows (Gantt, Resources, and Pert) that are being displayed at the time. As the files are being created, each window will be brought to the front of the display as it is being saved. Print Project Selection of this option causes AmiGantt to generate a complete printout of the entire project, including Gantt charts, task listings, resource histograms and the Pert Chart. More information regarding the project printouts is provided in section 3.2 of this manual. Print Tasks Selecting this option provides printouts of the Task Summary and complete Task List of the Project. Print Resources This option prints out the Resource Histogram and Project Summary. More information on these project reports are found in section 3.2 of this manual. Print Gantt Chart Selecting this option provides the user with just a printout of the project Gantt Chart, similar to the display on the main screen. Print Pert Chart This option will print out the network chart of the project. 2.2.5 Sort Menu By selecting any of these options, the tasks in the project will be sorted and re-ordered in the display according to the criteria selected. Sort by Starting Date In this option, the tasks will be sorted and displayed in ascending order of each task's earliest starting date. Headers and Milestones are placed at the end of the task list. Sort by Competion Date Here, the tasks are sorted and displayed in ascending order of the latest ending date of each task. As with the sort by Starting Date, Headers and Milestones are placed at the end of the task list. Sort by Critical Path In this option, AmiGantt will examine the list of tasks and determine those that form the Critical Path through the project. For AmiGantt, the Critical Path is defined as the set of tasks that form a continuous path from the begining to the end of the project. If there are multiple paths, the one with the longest duration is taken as the Critical Path. The tasks in the Critical Path are then floated to the top of the task display. The order of other tasks is maintained and they are displayed below the last task in the Critical Path. Original Order After a sort has been selected, and if there are no non-undo-able changes made to the task list, this option may be selected to return the tasks to their order before the sort was completed. Opening or Saving the project, or moving a task will negate AmiGantt's ability to undo the effects of the sort. 2.2.6 Misc Menu Write Icons This option is basically an on-off switch which selects whether AmiGantt will generate an icon when the Save As option is selected. The icon will contain all the necessary information to run the project directly from the WorkBench. Identify Critical Path This option is also an on-off switch which tells AmiGantt to find tasks which are on the Critical Path for the project, and change their display colour in the Gantt Chart. AmiGantt determines the Critical Path by examining all possible paths from the end of the project back to the beginning, then selecting the one with the longest duration. While this switch is on, AmiGantt will dynamically re-evaluate the path with each change to the task list. NOTE: This can significantly slow down the processing on input of tasks. Modify Colours When this option is selected from the Misc Menu, a separate window will open up with slider gadgets to adjust the Red, Green, and Blue composition of the colours used in the screen. The colour register being adjusted is shown in the lower right corner of the window, and the up and down triangles are gadgets to select which colour is being adjusted. Once the colours have been adjusted to your liking simply close the window. The colours will be automatically saved with the project when the Save or Save As options are selected. The Defaults gadget in the lower left of the box will return the colours to the original default set programmed within AmiGantt. You may exit the window by selecting the close gadget in the top left corner. 2.3 Adding the Project Header (Modify Header from Task Menu) As mentioned in section 2.1, each project contains a 'header' which holds certain global information about the project. The types of information stored in the header are: a) a description of the project; b) the start date of the project; c) the type of calendar used in the project (it can be daily, weekly or monthly); and d) the default colours used in the project When Modify Header is selected from the Task Menu, AmiGantt will present the Header Modification window and allow the user to modify these global values. (Note: Colours are modified from the MISC menu item) If you are just starting out in a new project, the fields displayed here will be set up with some initial default values. The Description fields will be blank, the Project Start Date will be set to the current system date, and the Calendar will be set to 'D' for Daily format. If a previously defined project was loaded using the Load Project selection from the Project Menu (see section 4.1), then these fields will display the values retrieved from the project file. DESCRIPTION - The Project Description field consists of 3 lines of 40 characters each in which you may place any descriptive information you wish about the project. Since the first line of the description will be used as title for the project and will be displayed in the top line of the Main Screen, it is suggested that this first line contain some sort of appropriate title for the project as a whole. The Description field will accept any characters, alpha or numeric, in upper or lower case. If you wish, any or all of the description lines may be left blank. START DATE - This field describes the overall start date for the project. As mentioned above, it is defaulted to the current system date, but you may change this to any value you wish. The date provided here will be used by AmiGantt to modify the calendar display on the Main Screen -- re-setting the first calendar entries on the left side of the screen starting with the project start date. This field also interacts with the Calendar field below it, in that a Daily Calendar will use the exact date provided as the project start date; a Weekly Calendar will take the Start Date if it's a Monday, or move it to the previous Monday; and a Monthly Calendar will move the Project Start Date to the first of the month for display purposes. The entry in this field is input in standard YYYYMMDD format where YYYY is the four digit year, such as 1988; MM is the two digit number of the month, such as 07 for July; and DD is the two digit number for the day of the month, such as 29. (It was done this way to make it easier for AmiGantt to do sorting and comparisons). Only numeric values are accepted in each of the fields and the date is validated to make sure it is a real date (i.e. not the 31st of February). CALENDAR - This field specifies the type of calendar entries the project will use. If 'D' for Daily is selected, the project accounting and record keeping will provide for input on particular days and all displays and reports will provide daily information. If 'W' for Weekly is selected, AmiGantt will deal with project tasks and entries on a weekly basis, with the smallest valid time unit being 1 week. As you might expect, the 'M' Monthly calendar provides for AmiGantt looking at the project from a monthly perspective. AmiGantt 4.02.00 will accept either uppercase or lowercase letters for the calendar (i.e. D or d, W or w, M or m) The lowercase versions will be automatically converted to the uppercase equivalent. After the user has made the appropriate changes, he should select the OK gadget in the lower left of the window to make the modifications to the project header. If he decides not to make changes at this time, he should select the CANCEL gadget in the lower right of the window to return to the Main Screen. NOTE -- The user can also move from field to field in the Header Modification window by pressing the RETURN key. However, pressing RETURN after the Calendar field will have the same effect as selecting the OK gadget. 2.4 Adding Tasks After the project header information has been updated to set up the global environment for the project, the next step is to start adding the individual tasks that make up the project. AmiGantt has been designed to let the user work in a top-down manner in defining the project -- setting out the major tasks to be accomplished, then providing finer and finer detail of sub-tasks to be completed. AmiGantt works on an 'insert-previous' mode for determining the placement of tasks. While the user does not have to specify the number of the task (AmiGantt handles this automatically), the current task block (see section 2.1) is important in determining where the task will be added. When adding a task to a project, the user should position the current task block over one of the tasks shown at the left of the screen. If the block is positioned on a line with no existing entry (i.e. the description shown to the right of the number is blank) and Add Task is selected, then AmiGantt will insert the task at the number shown on that line. If, on the other hand, the block is positioned on a line with an existing entry and Add Task is selected, the the task will be inserted before the existing task entry. (Actually, the new task will be added at the task number on that line and all others after it will be pushed down one line, giving them task numbers one larger, but the apparent effect is that of inserting before the current task). Once a task number has been highlighted and Add Task has been selected, AmiGantt will present the Add Task window, where the user may fill in the pertinent information about the task. The Task Window has undergone significant change for version 4.02.00 It now consists of 4 separate windows: a) The Main Window where the general and planning information regarding the task are provided; b) The Resource Window where the user provides descriptions of people and things used in the task; c) The Actuals Window where tracking information about what really happened is recorded; d) The ARexx Window where the user can attach an ARexx script to the task to run ARexx- compatible editors, word processors IFF-file viewers, or spreadsheets. This will allow the attachment of additional information or background to the task. When task options (such as Add, Modify, or Delete) are selected from the menu, the Task Main Window is displayed. At the bottom of the window are the usual OK and CANCEL gadgets to select or cancel the operation, as well as three additional gadgets to open up the Resource, Actuals, or ARexx windows. The EXECUTE gadget, also at the bottom of the Task Main Window, will cause immediate execution of the ARexx macro script attached to the task. When the Task Main Window is opened, it provides its own menu with Amiga-key equivalents for each of the gadgets at the bottom of the window. If the user decides that he did not really want to add a task at this time, selecting the CANCEL gadget at the bottom right of the window will return him to the Main Screen. TASK MAIN WINDOW Description - The Task Description field is an alpha-numeric field of 30 characters in which a short description of the nature of the task can be provided. Although only the first 20 or so characters of this description will be shown on the Main Screen, all reports will show the entire description. The user may input any information in this field. IT IS STRONGLY URGED THAT SOME SORT OF NON-BLANK DESCRIPTION BE PROVIDED FOR EACH VALID TASK. Start Date - As with the Project Start Date described in the 'Adding the Project Header' section of this manual, the task start date defines an absolute starting date for the task. It is in the same YYYYMMDD format and is validated for things like a month number of 13, days beyond 31, etc. This should be considered the 'planned' start date for the task, if one is known. In the case of the Task Start Date though, leaving the date field blank has a special meaning. It allows the task to 'float', with its actual start date changing, depending upon other tasks or the Project Start Date. If a task is specified with a blank start date and it is not dependent on any other tasks, then the actual start date of the task will float with the Project Start Date. That is, the task start date will be assumed to be the same as the Project Start Date and will change automatically with any changes made to the Project Start Date via the Modify Project Header selection. If a blank Task Start Date is specified and this task is dependent on other tasks (i.e. it cannot start until other tasks have been completed) then the actual start date of the task will float with the completion of the other dependent tasks. So, if Task 2 (which we are working on) is dependent on Task 1 (meaning Task 2 can't start until Task 1 is completed), then Task 2's starting date will become the day, or week, or month -- depending on the project calendar -- after Task 1 is scheduled to complete. If we change Task 1's start date or duration, then Task 2's start date will be automatically updated. End Date - As with the Start Date field, entries here should be in the same YYYMMDD format. Values for this field need not be supplied unless you want to set an absolute 'must finish by' date for this task. AmiGantt will interpret this field to be the latest possible end date for the task. When displaying this task in the Gantt chart this entry will also be used to determine if there is any 'float time' between the starting date of the task, plus its duration, and the end date supplied. If there is excess, AmiGantt will display this 'float' period as an outlined box on the Gantt Chart. Leaving this field blank simply means that the end date for the task will be determined by the start date plus the duration. Any changes in the start date (due to task dependencies, etc.) will be automatically reflected in a new end-date for the task. Duration - This field specifies the length of time it is planned to complete the task. The units of time for this field will depend upon the selection made for the Project Calendar type in the Header Fields. (See Section 2.3). The Duration field is numeric only and will not accept negative numbers. A project task with a Planned duration of 0, no start or end date and no dependencies has a special meaning in AmiGantt. It denotes a 'header line' placed in the Gantt chart just to make things more readable, separate groups of tasks, or provide additional explanation. If a Dependency is supplied for a task with duration = 0, this tells AmiGantt that this is a Milestone. It is recorded in the Gantt Chart by an asterisk (*). Depends On - In this field, the user describes any other tasks that must be completed before this task may start. In other words, that this task's start date is dependent on. Up to ten other tasks may be defined in this way and their task numbers should be placed in the Depends On field, separated by spaces or commas. (e.g. 8 9 10 or 8,9,10) Version 3.0.0 of AmiGantt and above support 'calculated dependencies'. In this case, you can specify that at task will begin 3 days after the end of another task. Or start 2 months before the end of another task. To implement this feature, you simply append a '+' or a '-' sign directly after the dependent task number, followed immediately by the number of units (days, weeks, or months.) The '+' sign means that the units following are added to the end of the dependent task and the '-' sign signifies time before the task's end date. (5+14 = 14 days after the end of task 5 17-2 = 2 months before the end of 17.) As mentioned in the Start Date field above, if the Task Start Date is left blank and dependent tasks are defined in the Depends On field then AmiGantt will look at each of the dependent tasks -- find out which has the latest end date -- then set the actual start date of this task to the next day, week, or month after that ending date. As far as the user will see, the task will still show a start date of blank but it will 'float' depending upon the start dates and durations of the dependent tasks. The beauty of connecting tasks together this way is that if one task is changed, or the project start date is updated, AmiGantt will manage and modify all the connections of tasks and adjust project schedule accordingly. RESOURCES WINDOW The fields on the Task Resource Window allow the user to specify up to 10 resources (typically people doing the project) that are assigned to this task and the cost, on a per-unit-of-time basis, for each. Title The Title fields (right below the RESOURCES: description) are 15 characters long, will accept any alphanumeric characters, and can be used to provide peoples names, initials, or job descriptions. Cost The Cost fields to the right of the Title fields, are numeric only. They will accept up to two decimal places and even negative numbers (if using someone or something can actually reduce the project cost). The '$' sign is unnecessary and invalid for this field. Any or all of these fields may be left blank. Cost fields which are left blank are assumed to be 0.00 F/V To the right of the Cost fields is a single character field marked 'F/V'. This field is used to indicate if the cost for a particular resource is Fixed or Variable. If the default value of 'V' is left in this field, then the cost of the resource is Variable and will be multiplied by the task duration to determine the real cost. If an 'F' is placed in this field to specify that the cost is fixed, then there will be no calculation and the cost is assumed to be that set value, no matter how long the project_duration. Pct Used At the right side of the window is a column of PCT USED fields. These specify how much of a person's or resource's time is dedicated to this task. The values in these fields are expressed as percentages - from 0 to 100. The fields default to 100%, but if, for example, a person was only to spend half their time on this task and half on administrative duties, you would fill in 50 in the PCT USED field. The Resource Histogram display and the Resource printouts will use this value to correctly apportion allocation and costing. ACTUALS WINDOW The Actuals Window provides a place to store information on the 'reality' of the task -- as opposed to what was planned. Where provided, AmiGantt will display the results of the Actuals along with the Planned values, to allow comparison. Actual Start Date This, as expected, should reflect the date on which the task actually started. The format for this date is the standard YYYYMMDD. Leaving this field blank has no particular effect on the interpretation of the type of task. If other Actual information (such as Duration or End Date) is provided, AmiGantt will simply assume that the task actaully started on the Planned Start Date. Actual Duration This field specifies the amount of time the task took. Its units of time (days, weeks, or months) depend on the setting of the Project Calendar type on the Project Header Window. As with the Planned Duration on the Task Main Window, this field is numeric only and will not accept negative numbers. Actual End Date Here, the date on which the task was finally completed is recorded. As with all date fields, its format is YYYYMMDD. AREXX WINDOW The ARexx Window provides 4 lines of 75 characters each into which ARExx commands may be entered. Since this is not a great deal of room for ARexx processing, in most cases this will consist of a call to execute an ARexx macro file contained in the REXX: directory. When the Execute gadget on the Arexx or Task Main Window is activated, the statements in these four fields will be sent to the REXX host port directly as commands. Hence, there is no need for the user to put a 'comment line' in the first line, as is required in ARexx macro files. After the appropriate values have been supplied for each of the fields, the user should select the OK Gadget in the lower left of the window to add the task to the project. If the user changes his mind about adding the task, the CANCEL gadget in the lower right of the window may be selected to return to the Main Screen without effecting any changes. As with the Modify Header window, the user may move from field to field down the screen by pressing the RETURN key once he/she has finished putting the desired value in the field. Pressing RETURN while the cursor is in the last Cost field will have the same effect as selecting the OK gadget at the bottom left of the window. Task Types There are three types of tasks which may be defined in an AmiGantt project: HEADERS, MILESTONES, and 'regular' TASKS HEADERS ...are entries made into the project schedule to separate groups of tasks or as explanatory notes. They have no effect on the project schedule and are descriptive only. To insert a HEADER entry, the Description field should be filled in with the desired information. All the other fields (such as Start and End Dates, Depends on, Duration, and Resources) should be left blank. MILESTONES ...are tasks which record the occurrence of a particular event on a particular date. Typically, they are goals to be strived for. To define a MILESTONE, the Description field should be filled in with appropriate text, the Start Date field may have the desired target date filled in, and the End Date and Duration fields should be left blank. As of Version 3.00.00 of AmiGantt, you can set the Milestone task to be dependent upon the completion of other tasks. You may fill in Resources if you wish, but these will not be included in any of AmiGantt's reports. AmiGantt will display MILESTONES on the Gantt Chart with an asterisk (*) at the appropriate day. 'Regular' TASKS ...are defined in the normal manner, as described in the Add Task section above. They define tasks to be completed in the project and have durations, dependencies (maybe), resources, start dates and end dates. However, the start and end dates may be implied by the dependencies. (So you don't fill them in) Thus, to summarize... HEADERS -- descriptive only -- no start date, end date, dependencies or duration MILESTONES -- description and start date (or dependencies) -- no duration Regular TASK -- description and duration as minimum -- start date may float by leaving it blank -- if end date is left blank, it is calculated based on start date + duration -- dependencies may be used to determine start date -- if dependencies are left blank, start date is assumed to be the same as project start date -- if a start date is provided, it is assumed to be the earliest start date for the task -- if an end date is provided, it is assumed to be the latest end date for the task -- differences between start date + duration and end date will be shown as a 'float' period 2.4.1 Adding Another Project as a Task AmiGantt provides a way in which other projects may be added as sub-projects to the project you are working on. In other words, another entire project becomes a 'task' of the master project you are currently defining. To define this sub-project, the user would set the current task block at the desired position and select Add Task to display the Add Task window as described in the previous section. In the DESCRIPTION field, instead of putting some text about the task to be completed, the user should put in two slashes ('//') right at the left-most edge of the field, followed by the volume, directory(ies) file name, and extensions of the previously saved project file, in normal AmigaDOS format. Thus the format of the description line should be -- //volume:directory/file.extension E.g. if there is another project file I want to add as a sub-project in file 42X in directory RNDPROJ on volume FRODO, the description line should look like -- //frodo:rndproj/42x Note that the entry is case-independent (as is normal for AmigaDOS convention), i.e. it doesn't matter if you type in upper or lower case letters. Although you can specify a start date if you wish to tie it to a particular date, this field and the rest may be left blank. When the entry is added, AmiGantt will examine that project file determine the starting date and duration of the entire project and copy all the resources from the project file (up to the 10 maximum for a task) into this task entry. If the start of this sub-project is dependent upon completion of other tasks or sub-projects, these task numbers should be filled into the DEPENDS ON field before selecting the OK gadget to add the task. 2.4 Modifying Tasks We all make mistakes or change our mind about something, so if the information within a particular task needs to be altered, or possibly an actual duration needs to be added, the user may position the current task block over the task he wishes to change and select Modify Task from the Task Menu. After doing so, AmiGantt will present the Modify Task window. Note that this looks very similar to the Add Task screen mentioned previously, with all the fields in the task modifiable. The difference here will be that the various fields will display the existing values for that task and the window name at the top left corner of the window will specify the MOD Entry action. Keeping in mind the same restrictions on data types for each of the fields as was mentioned in the Add Tasks section of this document, the user may modify the contents of any field in the task. Values of fields may be set to zero or blank by simply erasing the value in the field. Once the appropriate fields have been changed, select the OK gadget in the bottom left of the window to record the changes to the task. AmiGantt will then update the task, and update the complete project schedule with the new information. Note, that if changes are made to the project dependencies, it could take a second or two for AmiGantt to rearrange all the pointers and reset the various floating start dates. AmiGantt will tell you it is working on these pointers, etc. by changing the mouse pointer to a picture of a wristwatch. This signifies a 'Please Wait' condition and the user should wait until the pointer resumes it's normal shape before proceeding. If you decide that you didn't really want to change this task, simply select the CANCEL gadget in the lower right of the window to return to the Main Screen without effecting any changes. 2.5 Deleting Tasks Tasks can be removed from the project by positioning the current task block over the task to be removed and selecting Delete Task from the Task Menu. When Delete Task is selected, AmiGantt will present the user with the Delete Task window. (Which looks suspiciously similar to the Add Task and Modify Task windows). If the user decides this is, indeed, the task he wishes to delete, he should select the OK gadget in the bottom left of the window to confirm the removal. If he decides otherwise, selecting the CANCEL gadget in the lower right will return him to the Main Screen with no changes. Once a task has been deleted, AmiGantt will go through all the other tasks in the project and remove any dependencies upon the deleted tasks. If another task was dependent only upon the deleted task, then its dependency will revert to the project start date. Since all the tasks after the deleted tasks are automatically renumbered, AmiGantt will also examine tasks after the deleted task to adjust their dependencies. 2.6 Moving a Task As of version 4.02.00 ov AmiGantt, the Move Task function has been finally implemented!! This allows the user to alter the position of a task in the task list. Once moved, AmiGantt will automatically update the dependency network as well, to ensure the project retains its consistency. When this option is selected, AmiGantt will present a requestor asking which task is to be moved (using the task number from the list) and its destination. When initially presented, the requestor assumes you wish to move the 'current task' and displays this number in the 'Move Task' box. This number may be changed to any other valid task by selecting this gadget and replacing hte entry with the desired task number. The destination box (marked 'to' on the requestor) specifies where the selected task should be moved to. Any task number may be supplied except that the field may not be left blank. Note that the move will insert the task before the specified destination -- similar to add. Clicking on the PROCEED gadget will complete the move, while selecting the CANCEL gadget will leave the task in its original spot. Note: After a move, the task number pointers are re-aligned with their position in the list, so completing a move after sorting will eliminate the possibility of undoing the sort. The move has now established a 'new' original order. 2.7 Saving the Project (Save Project or Save As Project) Once the project has been completely defined and all the tasks have been entered, it would be wise to save the project to a permanent storage file on disk. Then, the project may be retrieved for update at a later time or included as part of a bigger project, as outlined in section 2.4.1. To save the contents of the project to disk, the user selects either Save or Save As from the Project Menu. For a new project, the user should select the Save As option which will allow him/her to create a new file and supply a name for the project file. If the project was loaded from a previously created file, the Save option may be selected to overwrite the file with the new changes. Assuming we are creating a new project and the Save As option is selected, AmiGantt will display a file requestor window in which the user may either select an existing file or provide the name of a new file to be created. The requestor supplied in version 3.00.00 of AmiGantt and above is produced by the ARP (AmigaDos Replacement Program) library functions attached to AmiGantt and includes some new features not normally found on file requestors. The list of files shown defaults to the current directory from which AmiGantt was run. As before, the filenames may be selected by clicking on them with the left mouse button. The scroll bar at the right of the requestor box will move through the sorted filename entries. Once the filename you wish is displayed, you may click on it, then on the OK box to select it. One of the added features of the ARP requestor is the ability to change the list to display the available devices by pressing the right mouse button. Then you may navigate through the directories of any device simply by clicking (with the left mouse button) on the directory shown. You can return back up one level by clicking on the 'Parent' button or redisplay the list of devices by re-pressing the right mouse button. In Save As mode, the filename box of the requestor is auto-selected so you can begin typing in the name for your new file as soon as the requestor appears -- instead of waiting for it to complete the display of the directory. The user should supply the name of the file, directory, and volume he wishes to save the project in. It's a good idea to use a suggestive name for the project file name, since it will then make it easier to remember for later retrieval and will make more sense if the file is included as a sub-project to some other, larger project. Naming conventions for project files follow the standard AmigaDOS file conventions. Once the appropriate information has been supplied the user selects the OK gadget to write the project out to the file. If a file by that name already exists, AmiGantt will notify the user and give him a chance to decide whether he wishes to overwrite the existing file or not. If the user wants to overwrite the existing file, he should select the OK gadget in the lower left of the requestor box. AmiGantt will then erase the contents of the existing file and replace them with the new project file. If instead, he wishes to keep the existing file and provide a new file name for the project, he should select the CANCEL gadget in the lower right of the requestor box. AmiGantt will then return to the main screen, without making any changes. AmiGantt -- Project Management Software 3.0 Printing a Project 3.1 Printing a Screen From the Main Screen, the contents of a displayed screen can be dumped out to the user's default printer device (PRT:) by selecting Screen from the Print menu. After selecting this option, AmiGantt will display the PIP (Printing in Progress) pointer and a graphic dump of the screen on display will be sent to the printer. Due to the manner in which AmigaDOS accomplishes this dump, the user should avoid making changes to the screen while the printout is proceeding. As mentioned earlier, if the user has selected output to a file instead of the printer, AmiGantt will generate IFF files of each of the windows open at the time the request is made. The files created will have suffixes of _gantt.iff, _pert.iff, and _resource.iff added to the file name supplied. As it is saving each of the windows, AmiGantt will bring the window to the front of the display to let the user know what is going on. NOTE: Task Windows are not written to an IFF file. 3.2 Printing the Project Printing out the contents of an entire project via screen dumps would not be the most economical nor useful method of seeing the project as a whole, so AmiGantt provides a Project Print function which will provide a number of different reports about the project. Included in these reports are the following -- a) GANTT chart b) Task List and Summary c) Resource Summary d) Resource Histogram e) Pert chart Each of these reports are discussed in more detail below. To generate these reports, the user selects Project from the Print Menu. AmiGantt will change the mouse pointer to the PIP (Printing in Progress) picture while it is generating the reports. It will return to the 'normal' pointer when the report is completed. If a graphic printout has been selected, AmiGantt will then present the printer selection window which allows the user to alter the graphic printout options for this selection. The settings are originally taken from the Printer Graphics Preferences. Changes made here will be in effect for this printout only. The window contains a number of gadgets for adjusting the graphics printout settings: ASPECT This arrow-head gadget is a 'cycle gadget' in the parlance of WB2.0 Selecting the arrow-head graphic in the gadget will cause the text to cycle between the options available. The Aspect gadget allows the user to select the orientation of the graphic printout -- either Portrait (vertical) or Landscape (horizontal). IMAGE The Image gadget is another cycle gadget which selects whether the printout will be in Positive or Negative imagery. SHADING The Shading Gadget is also a cycle gadget which selects the type of shading to be used in the printout. The available options are B&W (black and white), color, and greyscale. SMOOTHING Another cycle gadget, this one will turn on and off the graphic smoothing option in the printout, making curves gentler and removing some of the 'jaggies'. CENTRE (or CENTER) Yet another cycle gadget which when turned on, will center the graphic printout on the print page. DENSITY And another cycle gadget with values from 1 to 7. This selects the density (dots per inch) which the printer will use to produce the output. 1 is the lowest density (roughest output) whicle 7 is the highest density. Most printer drivers don't go above 4, but the user should test this for their own printer. IMAGE SIZE This option has two gadgets associated with it for setting the maximum number of pixels to be used in the dimensions of the graphic. The effect of changing these values is to magnify or reduce the size of the graphic. Decreasing the values will seem to magnify the graphic image (the minimum is 400) while increasing the values will reduce the size of the image, permitting more of it to be shown on a single page. H stands for the height of the image, while W stands for the width. The user is encouraged to experiment with these values. There is no reason why they have to be equal to one another! When the settings have been established, selecting the Print gadget at the bottom of the window will allow AmiGantt to proceed. AmiGantt will then check the Preference settings for your printer to determine if they are suitable for the text reports. They should be set at: a) 15 pitch, if you have narrow tractor paper b) a left margin of 8 or less and c) a right margin of at least 140 If any of these are not correct, AmiGantt will present a requestor asking if you wish to have AmiGantt send the correct sequences to the printer to set it up. If you select OK, AmiGantt will use the driver selected in Preferences to send the appropriate escape sequences to set the pitch and the right margin. At any time during the printing of the reports, the user may stop the printing by pressing the ESC key on the keyboard or by pressing the STOP gadget on the printer window. If the printer has a large data buffer though, the printout may continue for a short time after the ESC key (or STOP gadget) has been pressed. For the Gantt Chart, Pert Chart and Resource Histogram, two types of printout are available -- selected by the Type option of the Print menu. The GRAPHIC option, which is the default, provides high quality bit-map grpahic printouts on printers that can support this output. It uses the graphics options of the printer driver specified in the Preferences program (such as graphic density and orientation). During a GRAPHIC printout, AmiGantt attempts to create a Printer Rastport for drawing the printable image. The memory for this raster must be allocated from CHIP memory so if you are low on CHIP (such as running an interlaced screen on an Amiga with 512K of chip) an error message will be displayed telling you there isn't enough space for the raster and suggesting you decrease the values in the Image fields. The values in the Image fields directly relate to the size of raster being allocated (basically the calculation is width * height * 3 / 8 for the total in bytes). If you reduce the values, your printout will be a bit bigger and cover a few more pages, but it will work! The second option is the TEXTUAL, which produces ASCII-character based representations of the Gantt, Pert, and Resource charts (much as in earlier versions of AmiGantt). This option should be selected if your printer does not support bitmap graphics printing. 3.2.1 Gantt Chart As outlined in the Introduction section of this manual, AmiGantt was designed around the Gantt Chart model in order to provide a simple, top-down interface in the definition and management of projects. The main screen interface and printouts of AmiGantt are simplified Gantt Chart representations. Milestones are shown on the chart using asterisks (*). Actual Durations of tasks are shown using a filled bar, printed over the planned shaded bar. In the report printouts provided by AmiGantt, the Gantt chart will show the entire project (or as much of it as possible) on a single page. If the project should go beyond either 60 tasks (the vertical limit) or dates shown on the printout calendar (depends on the type of project calendar) then AmiGantt will generate a new page of printout to cover the next portion of tasks or calendar. These extra pages are generated in such a way so that the entire project can be 'glued together' into one master sheet by attaching additional date sheets to the right of the first page and task sheets to the bottom of the first page. On the Gantt Chart, project task numbers are shown on the left side, followed by the complete description. The task start date and duration are then plotted on the project calendar. Those tasks which are not completed (no actual duration provided) are shown in light arrows. Completed tasks are shown as dark blocks. 3.2.2 Task List & Summary The next report prepared by the project printout function is the detail task list and summary. The detail task list shows every task that has been defined for the project and all information provided for each task. This report should be used mainly to verify input and dependencies. The task summary report provides a shorter, less detailed look at the tasks in the project with additional information regarding planned and actual costs of the tasks and the entire project. Beside each task description, the start and end dates of the task are shown. If the dates shown are for actual start and end (i.e. actual duration has been provided), an '(A)' will be placed beside each of the dates. If they are planned start and end, a '(P)' will be placed beside each date. Next to the start and end dates for each task is the planned and actual cost of each task. The numbers presented here are calculated by AmiGantt from the planned and actual durations and the costs for each of the resources identified for each task. These Plan and Actual Costs for the tasks are totalled at the bottom of the page. An example of the task detail list and task summary are provided in section 5.0 of this manual. 3.2.3 Resource Summary The AmiGantt printouts also provide a resource summary listing which shows all of the resources that have been committed to the project, the planned and actual time commitment of each of those resources, and the planned and actual costs of the resources during the duration of the project. AmiGantt generates this listing by examining each task in the project and collecting information on each resource defined. The cost information is gathered by collecting the cost for each resource in a task and multiplying it by the planned and actual duration of the task. At the bottom of the page, the total commitment and costs for the project are totalled for comparison with the total costs provided on the Task Summary report mentioned earlier. 3.2.4 Resource Histogram The Resource Histogram produced by AmiGantt is useful in determining when resources will be required for various stages of the project and when conflicts occur for a given resource. Frequently, when defining a project, it is difficult to see when a given person or physical piece of hardware is expected to be in two places at the same time. The Resource Histogram, with its overall view of the project from a time vs. resource basis, quickly shows these inconsistencies. 3.2.5 Pert Chart The Pert Chart (or Network Chart as it is sometimes known) displays the tasks in a project and their relationship to each other. Its display is basically a series of paths from the beginning of the project to the end, showing the tasks that must be completed along each path to reach the final goal. The top path in a Pert Chart is usually the critical path which is the one in which the combined tasks have the longest duration, which means that if one of those tasks takes longer than expected, the entire project will suffer. In AmiGantt however, the top path on the Pert Chart is simply the one with the most tasks in it. This was done for display purposes. AmiGantt -- Project Management Software 4.0 Modifying Existing Projects 4.1 Loading the Project As mentioned in section 2.1, once a project has been defined and saved, it can be easily retrieved for modification or update by selecting the Load option from the Project Menu. Once this option has been selected, a file requestor will be presented to allow the user to select and/or define the name of the project file to be loaded. In this requestor, the user should fill in the file name, directory, and volume on which a previously defined project file has been stored. The user should fill in the appropriate information, then select the OK gadget to request loading of the project. As mentioned before, this requestor is generated by the ARP library and hence has the additional capability of displaying a list of all devices by pressing the right mouse button. The user may then navigate the directories of any device using the left mouse button and the scroll bar. AmiGantt will check for the existence of the file and if it is not found will present an error message and give the user another chance to define the project file. If the file does exist, AmiGantt will also check the internal structure of the file to determine if it is, indeed, a AmiGantt file. If it is not, the user will be notified via an error message and given the opportunity to define another file. If the user wishes not to load a project file, or cannot find the existing project file, then he can select the CANCEL gadget from the file requestor to return to the Main Screen. After successfully defining an existing AmiGantt file and selecting the OK gadget, AmiGantt will read the file, load in all the tasks, and return the user to the Main Screen which has been updated with the first tasks and their calendar mappings. At the same time, AmiGantt will also load the defined header information and will change its calendar display and colours to match the header entry. At this point, the user is free to change the project as desired or produce printouts of the project. 4.2 Modifying the Header Information Once an existing project has been loaded, the user may choose to change any or all of the information in the tasks or to add new tasks. He may also wish to change any of the information in the Project Header. As mentioned in section 2.3, the project header information may be accessed by selecting the Modify Header option on the Task Menu. In the case of 'loaded' projects, this screen will now display the header information provided when the project was created or last modified. The user may choose to change any of the information in this header, and select the OK gadget to record the changes. If the user changes the project calendar, a message will be presented at the top of the screen, asking if the project tasks should be converted to the new base. If the user selects the NO gadget at the lower right of the requestor box, AmiGantt will change the project calendar, the calendar display on the Main Screen, and assume that all duration entries in the tasks should be converted directly to the new calendar base. In other words, if the previous calendar base was D for Daily, and the user changes the project calendar to M for monthly and says NO to the conversion, then a task duration that was originally 2 days will become 2 months. Similarly, a task resource that used to have a cost of $100 per day, will now have a cost of $100 per month. Selecting the OK gadget will cause AmiGantt to convert the task durations from the original calendar base to the new calendar base using the rules outlined below. 4.2.1 Conversion of Costs/Durations Original Base New Base Conversion Factor ------------- -------- -------------------- Daily Weekly Divide duration by 5 Multiply cost by 5 Daily Monthly Divide duration by 22 Multiply cost by 22 Weekly Daily Multiply duration by 5 Divide cost by 5 Weekly Monthly Divide duration by 4 Multiply cost by 4 Monthly Daily Multiply duration by 22 Divide cost by 22 5.0 Input ARexx Port As mentioned in the Features section of this document, AmiGantt 4.02.00 supports an input ARexx port in addition to the command port attached to each task. This input port allows the user to run some of the functions of AmiGantt from an Arexx macro. The functions supported at the input port include: a) Loading an AmiGantt version 3 or 4 project file b) Opening the Pert or Resource Windows c) Closing the Pert or Resource Windows (once opened) d) Printing the Tasks, Gantt Chart, Pert Chart, Resource Histogram or the entire project file e) Quitting out of AmiGantt. Commands are sent to the AmiGantt input port as text strings from the ARexx macro. Some commands take additional parameters as a second text string. An example macro for AmiGantt is shown below. The name of the port is AmiGanttPort. /* RexxAmiGantt - an ARexx program to test the input interface to AmiGantt version 4.0 */ address COMMAND 'run dh1:csource/amigantt40/amigantt' /* wait for the AmiGantt Port to come up */ do while (SHOW('Ports','AmiGanttPort')=0) nop end address 'AmiGanttPort' 'load dh1:csource/amigantt40/wazoo' address 'AmiGanttPort' 'open pert' address 'AmiGanttPort' 'open resource' address 'AmiGanttPort' 'quit' /**************************************************************/ The Commands supported are: LOAD to tell AmiGantt to load and display a version 3 or 4 project file. The full file name (max of 255 characters including volume and directories) should be provided as the . OPEN to open specific information windows on a project. Valid values for are RESOURCE and PERT Each parameter will open the Resources and Pert window respectively. CLOSE Closes the Resource or Pert Windows, if they are open. Valid values for are: RESOURCE and PERT as in the OPEN command. QUIT to close all windows and exit from AmiGantt. Note there is no parameter required with this command. PRINT to print out various parts of the project. At this time, the print defaults (text vs graphics, file vs printer, etc.) cannot be set via the ARexx input port. Thus, AmiGantt will use the regular defaults. Valid values for are: TASKS PERT RESOURCES GANTT FILE These print parameters have the same effect as the equivalent entries in the PRINT menu. If the AmiGantt ARexx port processor encounters a command it cannot recognize, it will return a result value of 20 and an "Invalid Command" result string. If an invalid project file is provided as a parameter to the LOAD command, AmiGantt will display the "Invalid file" requestor, and the port will return a result value of 10. On successful completion of each command, the result value will be zero. 6.0 Enhancements to version 4.02.00 of AmiGantt and known anomolies 6.1 Enhancements 1. The file format of AmiGantt projects has changed with this version. Version 4.00.00 can load and read version 3.00.00 and above project files. When you Save the file, it will be automatically converted to version 4.00.00 format. 2. The Pert Chart now uses the Helvetica 9 font, which is provided on the standard WorkBench 1.3, rather than the special Gantt 6 font provided in earlier releases. It makes the printouts look better. 3. Resource information now includes 'percentage use' to define how much of a person's total time is dedicated to this task. The Resource Histogram display and costing reports will use this percentage to adjust the total committment of the person. 4. AmiGantt now opens its own 8 colour screen which makes it easier to drag all the windows away at once and permits more extensive use of colour on the Gantt and Resource charts. The colours may be adjusted from the Modify Colours option of the MISC menu. Changes in colour are automatically saved with each project. 5. AmiGantt 4.02.00 has two AREXX interfaces: a) An input port which allows the user to run certain functions of AmiGantt from an ARexx macro; and b) An output port from which ARexx commands attached to any Task can be executed to run other ARexx-compatible programs such as editors, IFF file displays, and spread- sheets. 6. AmiGantt 4.02.00 now recognizes when actual changes have been made to a project and presents the "Are you sure..." requestor only if there is a danger of losing the changes. 7. The biggest change most will notice is that when printing, a new option window is displayed which allows modification of most of the printing parameters. The biggest advantage here is being able to set the Width and Height of the graphic printout so you can 'scale' the output for the best looking print. Values greater than 1024 should be ignored by the program, and if I remember correctly, any less than about 400 is also ignored. Other than that, have a ball! 8. I've also adjusted the default colours a bit, to make them a bit softer, and a little less circussy. As always, you can adjust these via the Modify Colors menu option. 9. The general look and feel of the program has, as much as possible, been brought up to WB2.0 standards. It's not complete yet in this regard, but it's getting there. 10. An option to undo sorts has been added. Called 'Original Order' in the Sort Menu, it will return the tasks to the order they were in before the sort was selected. Note, that opening, saving, or moving tasks within the project will 'set' the task order and shut off this undo feature. 11. The Move Task feature has been finally completed. 12. The name of the AREXX port has been changed to WB2.0 standards. The new name is AMIGANTT.1 13. A check has been added to disallow saving to a blank file name. 14. AmiGantt will no longer present the 'Are you sure?' requestor on quitting after a Clear Project. 6.2 Known Anomolies 1. AmiGantt 4.02.00 is more memory intensive than earlier versions, in that it opens up its own 8-colour screen. The resolution (medium, interlaced) is determined from the settings in Preferences. It will also take advantage of overscan and PAL sizes, so it is possible to run out of available CHIP memory. At this time, there is no way to force AmiGantt to open a WorkBench screen, as it did in earlier versions. 2. The Pert Chart is generated by starting at the last task in the project (denoted by the latest starting date) and working backwards through the dependency network. If you have tasks which are not connected in some way to the last task, then they will not show up on the Pert Chart. 3. Although the top line in a Pert Chart is normally the critical path, for ease of display, AmiGantt puts the path with the greatest number of tasks at the top of the Pert. In most cases, this will also be the critical but not always. The Sort on Critical Path and Identify Critical Path options work correctly, selecting the path which has the longest planned duration. 4. Sorry, but because of difficulties in adjusting the text for use in the Gantt chart, I've had to force the screen text font to topaz 8 for the time being. 5. There's still a problem with the program crashing when you select the STOP gadget from the Printer Window or hit the ESC key during a print. I can't find the bug yet, but I'll put out a maintenance release as soon as I do.