Portfolio Tool Kit V2.0 by Centennial Software Systems Aurora, Colorado (c) Centennial Software Systems 1990 All rights Reserved 1. Portfolio Tool Kit is copyrighted (c) 1990 by Centennial Software Systems, Aurora, CO. 2. Atari and Portfolio are trademarks or registered trademarks of Atari Corporation. 3. IBM and IBM PC are trademarks of International Business Machine Corporation. 4. MS-DOS and PC-DOS are trademarks of Microsoft Corporation. TABLE OF CONTENTS I - Introduction II - Freeware Information III - Warranty IV - Version Information V - PORTDISK - Portfolio Disk Information VI - PORTINFO - Portfolio System Information VII - PORTOPT - Portfolio System Option Setter VIII - PORTTONE - Portfolio Tone Generator IX - PORTFLTR - Portfolio Document Filter X - PORTBOOT - Portfolio Software System Reset XI - PORTDIV - Portfolio Divide-Fault Handler XII - PORTDIR - Portfolio Directory Display XIII - PORTKEYS - Portfolio Function Key Reassignment I - Introduction The Portfolio Tool Kit is a package of powerful programs and utilities designed to make using the Atari Portfolio hand held computer simple and easy. All of the utilities and programs in the package have been written specifically for the Portfolio and as such take into consideration the various features of the Portfolio as well as its limitations. As a result the programs in this package no longer will execute on IBM PC's and PC clones as they would in previous revisions, all of the programs and utilities in the Portfolio Tool Kit V2.0 will only execute on the Atari Portfolio. Each of the utilities and programs included in this package are described in a separate section of this document. Each of these sections describes the purpose and use of the program, the current revision level of the program and sample output when applicable. The Portfolio Tool Kit is constantly undergoing upgrades, enhancements, and additions. Any and all suggestions, problem reports, enhancement requests and comments regarding this package should be directed to: Centennial Software Systems 5707 South Odessa Street Aurora, CO 80015 Attn: Carl Koop or via Compuserve to : Carl Koop UID: 73637,650 II - Freeware Information The Portfolio Tool Kit is being distributed as a "freeware" package. This means that you are free to distribute copies of it to friends and associates, upload it to BBS's, etc. providing that all of the programs and utility files as well as this document are included in a completely unaltered form. III - Warranty The programs and utilities comprising the Portfolio Tool Kit are provided "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular use. The entire risk of the quality and performance of the programs and utilities is with you. Should programs prove defective, you assume the entire cost of all necessary correction, servicing, or repair. IV - Version Information V2.0 represents a major upgrade to all of the programs and utilities in the Portfolio Tool Kit. Each of the programs that were included in the V1.0 package have been completely re-written in order to reduce program size, increase program speed and to take full advantage of the features of the Atari Portfolio. Many of these programs have also had additional functionality added to them in an attempt to make them more useful and complete. In addition, several new utilities and programs have been added to the Portfolio Tool Kit that were not in V1.0. These include a software system reset utility, a divide-fault handler, and a word processing filter. The size reductions to each file in the V2.0 release have been significant, so much so that even with the addition of the new programs and utilities and with the additional functionality added to several of the original tasks, the overall size of the package has been significantly reduced. The chart below shows the size of each program included in the package. Filename Size (bytes) PORTBOOT 1019 PORTDISK 1667 PORTDIV 1509 PORTDIR 2273 PORTFLTR 3564 PORTINFO 3919 PORKEYS 3996 PORTOPT 2833 PORTTONE 3694 TOTAL: 24474 V - PORTDISK.EXE - Portfolio Disk Information Ver 2.0 PURPOSE: To display information regarding all installed disk devices. USAGE: PORTDISK There are no user specified options when executing PORTDISK. The program will automatically determine which 'disks' are installed (A: through C:) and then display the amount of total, allocated and available disk space for each. The amounts are displayed as byte counts. Total disk space refers to the amount of space available to the user for file storage after the disk has been formatted. Allocated disk space refers to the amount of disk space already allocated for file storage on the disk. Free disk space refers to the amount of disk space still available to the user. DISPLAY: PORTDISK works on all three external display modes normal, tracked or static. Due to the nature of the display, it is not advisable to use the tracked mode. EXAMPLE : A:> portdisk Portfolio Disk Information V2.0 Disk Total Allocated Free A: 125952 43008 82944 C: 15488 2688 12800 Centennial Software Systems (c) 1990 VI - PORTINFO.EXE - Portfolio System Information Ver 2.0 PURPOSE: To display information regarding the Portfolio's current configuration and system options. USAGE: PORTINFO There are no user specified options when executing PORTINFO. When executed PORTINFO will determine and then display the following information: DIP Operating System version number followed by the BIOS revision, the amount of system memory installed and what is currently available to the user, the amount of free space (and total space) on each disk, and which type of peripheral is installed in the expansion port. Once this has been displayed the Portfolio will 'beep' and then wait for the user to hit the return key before continuing. Once the return key has been pressed, PORTINFO will display information on the cursor mode, refresh rate, clock speed, screen mode, alarms, buzzer, and key clicks. This information is followed by the systems date and time. Again, once this information has been displayed the Portfolio will 'beep' and hold the screen until the return key is pressed before going to end of task. DISPLAY: PORTINFO works on external display modes,normal, and static. Due to the nature of the display, normal mode is recommended. EXAMPLE: a:> portinfo Portfolio System Information V2.0 DIP Operating System 2.11 v1.051 128Kb RAM installed, 96Kb available Drive A: 110592 free out of 125952 Drive B: is not installed in system Drive C: 30336 free out of 31232 Peripheral installed: Parallel Port Centennial Software Systems (c) 1990 Portfolio System Information V2.0 Cursor : Block Refresh: Normal Alarms: On Speed : Normal Buzzer: Off Screen : 40x8 Clicks: On Date : Fri Sep 07 1990 Time : 14:29:51 Centennial Software Systems (c) 1990 VII - PORTOPT.EXE - Portfolio System Option Setter Ver 2.0 PURPOSE: To Allow the setting of various system options without having to 'walk through' several layers of menu's. USAGE: PORTOPT [opt1 opt2 opt3 ...] When executed, PORTOPT will process each of the supplied parameters, in the sequence in which they are supplied, setting the various options. If an incorrect option is detected, the message "Erroneous Option" is displayed and the option is ignored. NOTE: you must press the return key after each illegal option in order to continue processing. The following start line options are supported: aon : Turns alarms on aoff : Turns alarms off bon : Turns buzzer on boff : Turns buzzer off kon : Turns key clicks on koff : Turns key clicks off cb : Sets block cursor co : Sets cursor off rn : Sets refresh to normal mode rk : Sets refresh to key mode rt : Sets refresh to timed mode rb : Sets refresh to both key and timed mode sn : Sets speed to normal (128 seconds) mode sf : Sets speed to fast (1 second) mode NOTE: For more information on the various optional settings the user is referred to the 'Portfolio Owner's Manual' Chapter 8 - The Setup Facility. If PORTOPT is started without any of the optional parameters supplied, a brief menu of the options and their formats is displayed. DISPLAY: PORTPT works on all three external display modes, normal, static, and tracked, however, as withh all of the Portfolio Tool Kit utilities, normal mode is recommended. EXAMPLE: a:> portopt aoff kon Portfolio System Option Setter V1.0 ALARMS : Off Key Clicks: On Centennial Software Systems (c) 1990 VII - PORTTONE.EXE - Portfolio Tone Generator Ver 2.0 PURPOSE: PORTTONE.EXE, the Portfolio Tone Generator, is a simple program designed to allow you to make use of the Portfolio's built in melody tone generator. PORTTONE requires no additional files (such as ANSI.SYS or BEEP.EXE) to execute and will accept input either directly from the keyboard or from a text file. USAGE: PORTTONE Once started PORTTONE will display an options menu which allows the user to select which mode it should be run in. The options allow the user to create a new music file, replay an existing file, or play directly from the keyboard. PORTTONE will translate the alphabetic characters A through Y to the 25 different tones that the Portfolio is capable of generating. When any other character is detected PORTTONE will go to end of task. Input can be either upper or lower case. Music files can either be created with PORTTONE or via any editor as well. Music file records have the format @ ##, where @ is any character, upper or lower case A-Y and ## is the 2 digit number (the value must be two digits!)specifying the duration, in 10Ms intervals, of the tone when played. For example to play an A5 for 30Ms the entry would be: G 03 The following is a list of the characters acknowledged by PORTTONE and the notes that they correspond, or translate, to : A - D#5 B - E5 C - F5 D - F#5 E - G5 F - G#5 G - A5 H - A#5 I - B5 J - C6 K - C#6 L - D6 L - D#6 M - E6 N - F6 P - F#6 Q - G6 R - G#6 S - A6 T - A#6 U - B6 V - C7 W - C#7 X - D7 Y - D#7 Z - EXIT NOTE: Remember that the generation of tones on the Portfolio will put quite a strain on the Portfolio's batteries, so it is strongly recommended that, whenever possible, you run PORTTONE with the AC adapter connected. PORTTONE is completely menu driven and any options, requests for filenames, etc. are self explanitory. It is important to note, that PORTTONE will never erase or overwrite a file unless you specifically tell it to. DISPLAY: PORTTONE works on all three external display modes, normal, static, and tracked, however, the recommended mode is normal. EXAMPLE: a:> porttone portfltr Portfolio Document Filter V2.0 Filtering document...Filtering complete. Centennial Software Systems (c) 1990 X - PORTBOOT.EXE - Portfolio Software System reset Vers 2.0 Purpose: To allow the user to perform either a cold boot (complete hardware and software reset) or a warm boot (software reset only) via software. Usage: PORTBOOT There are no command line parameters when using PORTBOOT. Once started PORTBOOT will display a 'System Reset Menu' which allows the user to select either a Coldboot, Warmboot, or simply exit without re@ Opρ92+42:44:44<;67712::4:42(7:3744402226290202477106272243:044::4<96<;:792:42924927 '"! 492:40:42924405790221('*!'4 also usefull if you whish to have batch streams automatically force the user into reseting the system. Display: Portboot will work/@m&@8H @x$D HH@ D <xH   @HH DH 9y xH {3{cKy#{k+s3Kc+qhQ+s+ssK a{3 )˛+kCIɀhPhQ˛+i++k+shQ{c#{{j| The following start line options are supported: aon : Turns alarms on aoff : Turns alarms off bon : Turns buzzer on boff : Turns buzzer off kon : Turns key clicks on koff : Turns key clicks off cb : Sets block cursor co : Sets cursor off rn : Sets refresh to normal mode rk : Sets refresh to key mode rt : Sets refresh to timed mode rb : Sets refresh to both key and timed mode sn : Sets speed to normal (128 seconds) mode sf : Sets speed to fast (1 second) mode NOTE: For more information on the various optional settings the user is referred to the 'Portfolio Owner's Manual' Chapter 8 - The Setup Facility. If PORTOPT is started without any of the optional parameters supplied, a brief menu of the options and their formats is displayed. DISPLAY: PORTPT works on all three external display modes, normal, static, and tracked, however, as withh all of the Portfolio Tool Kit utilities, normal mode is recommended. EXAMPLE: a:> portopt aoff kon Portfolio System Option Setter V1.0 ALARMS : Off Key Clicks: On Centennial Software Systems (c) 1990 VII - PORTTONE.EXE - Portfolio Tone Generator Ver 2.0 PURPOSE: PORTTONE.EXE, the Portfolio Tone Generator, is a simple program designed to allow you to make use of the Portfolio's built in melody tone generator. PORTTONE requires no additional files (such as ANSI.SYS or BEEP.EXE) to execute and will accept input either directly from the keyboard or from a text file. USAGE: PORTTONE Once started PORTTONE will display an options menu which allows the user to select which mode it should be run in. The options allow the user to create a new music file, replay an existing file, or play directly from the keyboard. PORTTONE will translate the alphabetic characters A through Y to the 25 different tones that the Portfolio is capable of generating. When any other character is detected PORTTONE will go to end of task. Input can be either upper or lower case. Music files can either be created with PORTTONE or via any editor as well. Music file records have the format @ ##, where @ is any character, upper or lower case A-Y and ## is the 2 digit number (the value must be two digits!)specifying the duration, in 10Ms intervals, of the tone when played. For example to play an A5 for 30Ms the entry would be: G 03 The following is a list of the characters acknowledged by PORTTONE and the notes that they correspond, or translate, to : A - D#5 B - E5 C - F5 D - F#5 E - G5 F - G#5 G - A5 H - A#5 I - B5 J - C6 K - C#6 L - D6 L - D#6 M - E6 N - F6 P - F#6 Q - G6 R - G#6 S - A6 T - A#6 U - B6 V - C7 W - C#7 X - D7 Y - D#7 Z - EXIT NOTE: Remember that the generation of tones on the Portfolio will put quite a strain on the Portfolio's batteries, so it is strongly recommended that, whenever possible, you run PORTTONE with the AC adapter connected. PORTTONE is completely menu driven and any options, requests for filenames, etc. are self explanitory. It is important to note, that PORTTONE will never erase or overwrite a file unless you specifically tell it to. DISPLAY: PORTTONE works on all three external display modes, normal, static, and tracked, however, the recommended mode is normal. EXAMPLE: a:> porttone