Club Amiga de Montreal

home *** CD-ROM | disk | FTP | other *** search

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 184.lha / Amigantt_v2.01 / AMIGANTT.DOC < prev next >

Wrap

Text File | 1988-04-29 | 77.5 KB | 1,549 lines

AMIGANTT Project Management Tool Version 2.01.00 Program Description September 30, 1988 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.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 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 4.0 Modifying Existing Projects 4.1 Loading the Project 4.2 Changing the Header Information 4.2.1 Conversion of Costs/Durations 5.0 Enhancements for version 2.01.00 of AmiGantt and known anomolies 6.0 Examples of Report Output 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 -- it was 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, or 2000) under Workbench 1.2 and above(!!). 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 (NOTE -- the Pert Chart display is not available in version 2.01). - 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 creates icons for each project saved, which allows Workbench users to directly enter the project simply by double-clicking its icon. - 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 are tied to a particular date and connot be 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 and milestones) may be dependent (cannot start until the first is finished) on up to 10 other tasks - can store planned and actual durations of tasks - up to 10 resources may be defined for each task - costs for each resource may be uniquely defined in each 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 - Resource Summary - Task Listing (Detail) - Task Summary 1.3 Restrictions of AMIGANTT NOTE -- These are restrictions placed on version 2.01 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. 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). Verson 2.01.00 of AMIGANTT an dabove make 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 34 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 2.01.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. An example of this screen is shown below. The screen shows a blank task list and calendar area. ______________________________________________________________________________ |·| AmiGantt 2.01.00 - Tasks | | | Apr'88 11111 11222 22222 May'88 1111 11112 22222 33 Jun'88 1 ___ 12345 89012 56789 23456 90123 67890 34567 01123 67890 |*|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 weekly format and will begin on the Monday previous (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 date pointers, 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. CURRENT TASK -- The orange block shown in the task area highlights the 'current task'. Any task operation, such as add, modify, or delete 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 again 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 five sets of menus available in AMIGANTT: The PROJECT menu, WINDOW menu, TASK menu, PRINT menu, and the SORT 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. Load Project (Amiga L) To continue work on an already defined and saved project file, select Load 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 Loaded 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 Load 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, AMIGANTT will prompt to ask if it's all right to overwrite an existing file. New Project (Amiga N) By selecting New Project, the user can remove all tasks from the project and start with a clean slate. Info 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 'Want to Leave?' 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. 2.2 Menu Options (Cont'd) 2.2.2 Window Menu AMIGANTT contains three main windows for display of the task information provided for a project. This menu allows the user to open either or both of the other two windows. NOTE -- Although version 2.01.00 of AMIGANTT will allow the user to open the Pert window, nothing is being done to them at this time. This functionality will be added in a later version of AMIGANTT. 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. In later versions of AMIGANTT, the user will be able to interact with this window as well to change the dependencies and interconnection of tasks within the project. 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. For those not familiar with what a resource histogram looks like, AMIGANTT produces one in its printout suite available from the PRINT menu. 2.2.3 Task Menu Functions in this menu allow the user to define, delete, and modify the tasks contained within a project. It also allows him/her to modify the default header information created for each project. NOTE (again) 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 thing better of it and want to keep the task, select the CANCEL gadget at the bottom right of the window. 2.2 Menu Options (Cont'd) 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. Move Task NOTE -- This option is not available in version 2.01.00 of AMIGANTT. When functioning, it will allow the user to pick up a task and move it to another place in the Gantt Chart listing. 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 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. 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. Two things to note here -- Output to a file will not prompt if the file already exists (this will be added in a later release) so selection of a second report will wipe out the first. Also, screen prints (see function below) do not look at this option. They are automatically routed to the PRT: device. A later version of AMIGANTT will allow the generation of an IFF file as output of the screen. Print Screen As would be expected by the description, selecting this option will cause a screen 'dump' of what is currently being displayed to be routed to the user's default printer. Print Project Selection of this option causes AMIGANTT to generate a complete printout of the entire project, including Gantt charts, task listings, and resource histograms. 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. Examples of these two reports are provided in section 5 of this document. 2.2 Menu Options (Cont'd) Print Resources This option prints out the Resource Histogram and Project Summary. More information on these project reports and examples are found in sections 3.2 and 5.0 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. NOTE -- This printout is not available in version 2.01.00 of AMIGANTT. 2.2.5 Sort Menu Two of the sorting options are operational in version 2.01.00 of AMIGANTT. By selecting either 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 This option is not operational in version 2.01.00 of AMIGANTT. 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 and c) the type of calendar used in the project (it can be daily, weekly or monthly) 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. 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). 2.3 Adding the Project Header (Cont'd) 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. 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. 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. 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. 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. 2.4 Adding Tasks (Cont'd) 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 sould be in the same YYYMMDD format. Values for this field need not be supplied unles 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 determin 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 a set of dots 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.) wil be automatically reflected in a new end-date for the task. DURATION - This field specifies the length of time it will take 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). Two fields are provided for duration here -- the Planned duration, which is what you thought it would take, and the Actual duration, which is what it did take. Normally, in the project definition mode where you are adding new tasks, only the Planned duration would be defined. The Actual would be left at 000 until that task had been completed. The DURATION field is numeric only and will not accept negative numbers. A project task with a Planned duration of 0 and no start or end date has a special meaning in AMIGANTT. It denotes an 'information line' placed in the Gantt chart just to make things more readable, separate groups of tasks, or provide additional explanation. If a Start Date 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 (*) and connot be dependant on other tasks. DEPENDS ON - In this field, the user would describe 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) 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 - The fields below the DEPENDS ON field 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. 2.4 Adding Tasks (Cont'd) 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. 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 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 should have the desired target date filled in, and the End Date, Duration, and Depends on fields should be left blank. 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 tasksk to be completed in the project and have durations, resources, start dates and end dates. Thus, to summarize... HEADERS -- descriptive only -- no start date, end date, dependencies or duration MILESTONES -- Description and start date -- no dependencies or 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 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. If the project was loaded from a previous written 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 2.01.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 witht he 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. 3.2 Printing the Project Printing out the contents of an entire project via screen dumps would not 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 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 which will blank out when the report is completed. Version 2.01.00 and above of AMIGANTT will then check the Preference settings for your printer to determine if they are suitable for the reports. They should be set at: a) 15 pitch, if you have narrow tractor paper and b) a right margin of at least 135 If either 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. If the printer has a large data buffer though, the printout may continue for a short time after the ESC key has been pressed. 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. On the Gantt Charts, tasks are displayed using an extended arrow to show the start date and duration of the task. 'Float' periods between the last day of the duration and a 'latest end date' established when the task was added, are shown by a series of dots succeeding the arrow. Milestones are shown on the chart using asterisks (*). Actual Durations of tasks are shown using 'x' or a dark block, instead of the extended arrow. It is possible to have a later portion of the arrow still showing if, by some lucky chance, the actual duration of the task was shorter than the Planned duration. 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 n 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. An example of the Gantt Chart printout is provided in section 5.0 of this manual. 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 double-ups occur on 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. An example of the Resource Histogram produced by AMIGANTT is shown in section 5.0 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 by 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 20 tasks and their calendar mappings. At the same time, AMIGANTT will also load the previously defined header information and will change its calendar display 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 Enhancements to version 2.01.00 of AmiGantt and known anomolies 5.1 Enhancements a) The file structure used to store AMIGANTT project information has been expanded. This unfortunately means that projects created with version 1.01.00 or 1.01.01 of AMIGANTT cannot be used in AMIGANTT 2.01.00. A conversion program is 'in the works'. b) AMIGANTT 2.01.00 now creates project icons under 'Save' or 'Save As'. These icons can then be used to directly enter a project from Workbench simply by double-clicking them. c) AMIGANTT 2.01.00 uses the standard ARP library file requestor and GADS interface from CLI. The file requestor has much added functionality from that used in AMIGANTT 1.01.00 and 'Loads', 'Saves' and 'Save As' default to the current directory where AMIGANTT (or the project) was run, rather than DF1: d) Float values for tasks are now supported through the setting of a 'latest end date' for each task. e) Other projects are now supported as tasks, allowing the user to create a 'master schedule' of all the other projects. f) The maximum number of tasks permitted in a projet has been increased from 100 to 500 g) The 'Sort by Starting Date' and 'Sort by Completion Date' options are now operational. h) Grids have been added to the Gantt Chart display to improve readability i) Milestones may now be defined by providing a Start Date and no duration j) AMIGANTT 2.01.00 has added the Resource Histogram window display which will automatically update as tasks are added, deleted, or modified. k) The printer preferences settings are now read by AMIGANTT prior to printing reports. If they are not correct, the user has the option to let AMIGANTT send the appropriate codes to set the printer up properly. l) After Loading a Project, or Modifying the Project Header, the screen title will be updated to the first line of the project description. m) Long requestor messages have been changed to 2 lines to make them easier to read (and less startling) n) Various internal structures have been redefined to keep the overall size of AMIGANTT 2.01.00 around 100K o) Pressing the ESC key during a pirntout will cause the print job to be aborted. Known Anomolies a) If AMIGANTT 2.01.00 is started from CLI, the second time a project is loaded, a GURU will occur complaining about attempting to Free Twice. This does not occur if AMIGANTT is started from Workbench by either the AMIGANTT icon or a project icon. b) Due to a bug in the Lattice C sprintf function, totals on some of the reports may not be correct. c) Again, due to a Lattice C bug, the columns of data in the reports do not line-up properly. AMIGANTT -- Project Management Software 6.0 Examples of Report Output Sat Apr 16 14:22:29 1988 AMIGANTT - PROJECT REPORT Page: 1 Test Project for AMIGANTT v.2.01.00 Denman Island Corp. Team Leader: Don Tolson Apr'88 11111 11222 22222 May'88 1111 11112 22222 33 Jun'88 1 11111 22222 2223 Jul'88 11111 11222 22222 12345 89012 56789 23456 90123 67890 34567 01123 67890 34567 01234 78901 45678 12345 89012 56789 1234 1 Design Amigantt Program ----------------------> 2 Design Review ----> 3 Signoff on design > 4 SOFTWARE DEVELOPMENT 5 Develop Amigantt Main Module -----------------------------------> 6 Test of Main Module -----> 7 Develop Print Module -----------------> 8 Test Print Module -----> 9 INTEGRATION TESTING 10 Test of Main and Print Module -----------> 11 Total Package Test -----> 12 DOCUMENTATION -----------------------> 13 Final Release Signoff -----> Sat Apr 16 14:22:29 1988 AMIGANTT - PROJECT REPORT Page: 2 Test Project for AMIGANTT v. 2.01.00 Denman Island Corp. Team Leader: Don Tolson Project Summary Project Personnel Total Commitment Total Costs Plan Actual Plan Actual ----------------- ------------------------------- ------------------------------ d tolson 56 0 Days 33600.00 0.00 director 6 0 Days 6000.00 0.00 se1 70 0 Days 17500.00 0.00 writer 20 0 Days 6000.00 0.00 =============================== ============================== 152 0 Days 63100.00 0.00 Sat Apr 16 14:22:29 1988 AMIGANTT - PROJECT REPORT Page: 3 Test Project for AMIGANTT v. 2.01.00 Denman Island Corp. Team Leader: Don Tolson Task Listing # Description Start End Float Duration: Plan Actual Depends on: ---- ----------- ----- ----- ----- ---- ------ ----------- 1 Design Amigantt Program 1988/04/11 1988/05/06 Y 20 0 d tolson 600.00 2 Design Review 1988/05/09 1988/05/13 Y 5 0 1 d tolson 600.00 3 Signoff on design 1988/05/16 1988/05/16 Y 1 0 1 2 d tolson 600.00 director 1000.00 4 SOFTWARE DEVELOPMENT 5 Develop Amigantt Main Module 1988/05/17 1988/06/27 Y 30 0 3 se1 250.00 6 Test of Main Module 1988/06/28 1988/07/04 Y 5 0 5 se1 250.00 d tolson 600.00 7 Develop Print Module 1988/05/17 1988/06/06 Y 15 0 3 se1 250.00 8 Test Print Module 1988/06/07 1988/06/13 Y 5 0 7 se1 250.00 d tolson 600.00 9 INTEGRATION TESTING 10 Test of Main and Print Module 1988/07/05 1988/07/18 Y 10 0 6 8 se1 250.00 d tolson 600.00 11 Total Package Test 1988/07/19 1988/07/25 Y 5 0 10 se1 250.00 d tolson 600.00 12 DOCUMENTATION 1988/05/17 1988/06/13 Y 20 0 3 writer 300.00 13 Final Release Signoff 1988/07/26 1988/08/01 Y 5 0 11 12 d tolson 600.00 director 1000.00 Sat Apr 16 14:22:29 1988 AMIGANTT - PROJECT REPORT Page: 4 Test Project for AMIGANTT v. 2.01.00 Denman Island Corp. Team Leader: Don Tolson Task Summary # Description Start End Cost - Plan Actual ---- ----------- ----- ----- ------------ --------- 1 Design Amigantt Program 1988/04/11(P) 1988/05/06(P) 12000.00 0.00 2 Design Review 1988/05/09(P) 1988/05/13(P) 3000.00 0.00 3 Signoff on Design 1988/05/16(P) 1988/05/16(P) 1600.00 0.00 4 SOFTWARE DEVELOPMENT 5 Develop Amigantt Main Module 1988/05/17(P) 1988/06/27(P) 7500.00 0.00 6 Test of Main Module 1988/06/28(P) 1988/07/04(P) 4250.00 0.00 7 Develop Print Module 1988/05/17(P) 1988/06/06(P) 3750.00 0.00 8 Test Print Module 1988/06/07(P) 1988/06/13(P) 4250.00 0.00 9 INTEGRATION TESTING 10 Test of Main and Print Module 1988/07/05(P) 1988/07/18(P) 8500.00 0.00 11 Total Package Test 1988/07/19(P) 1988/07/25(P) 4250.00 0.00 12 DOCUMENTATION 1988/05/17(P) 1988/06/13(P) 6000.00 0.00 13 Final Release Signoff 1988/07/26(P) 1988/08/01(P) 8000.00 0.00 =========== ========= 63100.00 0.00 Sat Apr 16 14:22:29 1988 AMIGANTT - PROJECT REPORT Page: 5 Test Project for AMIGANTT v. 2.01.00 Denman Island Corp. Team Leader: Don Tolson Resource Histogram * = d tolson - = director . = se1 % = writer | | 10-| | 9- | | P 8- | E | O 7- | P | L 6- | E | 5- | | 4- | %%%% % | %%%% % 3- | %%%% %%%%% %%%%% %.... . | %%%% %%%%% %%%%% %.... . 2- | -.... ..... ..... ..... . .... ..... ..... ..... .---- - | -.... ..... ..... ..... . .... ..... ..... ..... .---- - 1- |***** ***** ***** ***** ***** *.... ..... ..... .**** *.... ..... .**** ***** ***** ***** ***** * |***** ***** ***** ***** ***** *.... ..... ..... .**** *.... ..... .**** ***** ***** ***** ***** * ------------------------------------------------------------------------------------------------------------------------------- 12345 89012 56789 23456 90123 67890 34567 01123 67890 34567 01234 78901 45678 12345 89012 56789 12345 89012 56789 23456 90112 Apr'8811111 11222 22222 May'88 1111 11112 22222 33 Jun'88 1 11111 22222 2223 Jul'88 11111 11222 22222 Aug'88 111 11111 22222 233