Disk Information

System Information

System Option Setter

Tone Generator

Document Filter

Software System Reset

Divide-Fault Handler

Directory Display

Function Key Reassignment

Time Display TSR

                 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 © 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

    XIV  -   PORTCLOK - Portfolio Time Display TSR

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         
                     PORTCLOK      1737         

                           TOTAL: 26211             

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 <music.txt

         Portfolio Tone Generator        V1.0
                 PortTone Options
                Create music file
                Replay music file
                Play from keyboard
                Exit PortTone
         Centennial Software Systems (c) 1990

IX - PORTFLTR.EXE - Portfolio Document Filter Ver 2.0

PURPOSE: To convert word processing document files into standard

        ASCII text files by filtering out all of the special 
        control characters so that the file may be edited on 
        the Portfolio's built in editor.  PORTFLTR is not 
        limited to word processing files, but can be used to 
        filter special characters out of any file.  Note: this 
        program is designed to allow PC word processing files 
        to be moved to the Portfolio and not from the Portfolio 
        to a PC (although it can be used in that fashion).

USAGE: PORTFLTR

        When invoked, PORTFLTR will prompt the user for the 
        names of an input file and output file.  Once these 
        filenames have been supplied, PORTFLTR will read the 
        input file a character at a time and pass through all 
        valid ASCII printable characters to the output file 
        with the high order bit stripped off.  Form feeds, 
        carriage returns, and linefeeds are simply passed 
        through without any modification.  TABs are expanded to 
        eight spaces each and all other non-printable ASCII 
        codes are discarded.

        Once the filtering process is started, PORTFLTR will 
        display the message 'Filtering document...' to the 
        screen.  Upon completion of the filtering process the 
        message 'Filtering complete.' is displayed as the 
        program goes to end of task.

        Upon completion, PORTFLTR will append a standard End Of 
        File (EOF) mark to the output file.  It is important to 
        note that PORTFLTR will make no modifications to the 
        input file.

DISPLAY: PORTFLTR works on all three external display modes,

        normal, static, and tracked, however the recommended 
        mode is normal.  

EXAMPLE: a:> 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-booting 
        the system.

        While this utility will not be useful if the Portfolio 
        is in an 'undetermined' state and is not capable of 
        executing tasks, it is useful if you simply wish to 
        reset the system (ie. reload AUTOEXEC.BAT, insure that 
        the system is in a known state, etc.).  PORTBOOT ia 
        also usefull if you whish to have batch streams 
        automatically force the user into reseting the system.

Display: Portboot will work in all three external display modes,

        normal, tracked, and static.  As with all Portfolio 
        Tool Kit software, normal mode is recommended.

EXAMPLE: a:> portboot

         Portfolio Document Filter       V2.0
         Centennial Software Systems (c) 1990

                  System Reset Menu
               Coldboot - System Reset
               Warmboot - Ctl/Alt/Del
               Exit     - No Reboot

XI - PORTDIV.COM - Portfolio Divide-Fault Handler V2.0

Purpose: PORTDIV is designed to trap 'Divide By Zero' errors and

        prevent the system from 'hanging' or causing other 
        related problems.

Usage: PORTDIV

        There are no user supplied parameters used with 
        Portdiv.  When executed, the program replaces the 
        standard divide fault handler by installing itself as a 
        Terminate and Stay Resident (TSR) program.  Once 
        installed, whenever a divide fault is detected, Portdiv 
        displays the message "Divide Fault!" to the screen and 
        waits for the user to press any key.  Once the key is 
        pressed the error message is cleared, the quotient is 
        set to zero, and the program that caused the divide 
        fault continues execution.

        The "Divide By Zero" error is in fact misnamed and is 
        typically misinterpreted.  This error occurs whenever 
        the result of a divide instruction is larger than the 
        maximum value that can be held in the destination 
        and/or whenver the divisor is zero, therefore the name 
        divide fault is much more accurate.

        It is important to remember that when the Portdiv 
        handler executes the quotient is set to zero.  While 
        this is acceptable under most conditions it may in fact 
        cause problems for a small number of programs.  
        However, since Portdiv will prevent the problems often 
        seen on the Portfolio when dealing with divide faults, 
        the good certianly out weighs the bad.

        Portdiv will only install itself once, multiple 
        executions result in the message "Handler already 
        installed!".  While Portdiv is 1509 bytes long, only 
        368 bytes of memory are utilized for the TSR portion.  
        The rest of the code is deleted when the program goes 
        to end of task.

Display: Portdiv will work in all three external display modes,

        normal, tracked, and static.  As with all Portfolio 
        Tool Kit software, normal mode is recommended.

EXAMPLE: a:> portdiv

         Portfolio Divide-Fault Handler  V2.0

             Handler is now installed.

         Centennial Software Systems (c) 1990

XII - PORTDIR.EXE - Portfolio Directory Display V2.0

Purpose: To display files found on any of the Portfolio's disk

        devices in a format that is easier to read and is more 
        condusive to the Portfolio's limited display.

Usage: PORTDIR [filename]

        Filenames are displayed in three columns with each 
        column left justified.  After six lines have been 
        displayed (18 filnames) the display will pause and wait 
        for the user to press the return key to continue.  If 
        any other key is selected the display will stop at that 
        point.

        Once all files have been displayed the number of files 
        found, and the free space remaining on the disk is 
        shown across the botom of the display.

Display: Portdir will work in all three external display modes,

        normal, tracked, and static.  As with all Portfolio 
        Tool Kit software, normal mode is recommended.

EXAMPLE: a:> portdir port*.c??

         Portfolio Directory Display       V2.0
         portfind.exe portinfo.exe porttone.exe
         portboot.exe portfltr.exe portinfo.exe
         portopt.exe
            7 File(s)  107520 Bytes Free

XIII - PORTKEYS.EXE - Portfolio Function Key Reassignment V2.0

Purpose: To provide an easy method for creating batch (.BAT)

        files that can be used to reassign multi-character key 
        sequences to the Portfolio's function keys.  In order 
        for the key reassignments to take effect you must first 
        install ANSI.SYS into your DOS and then execute the 
        batch fiale created by PORTKEYS.

Usage: PORTKEYS

        Once started PORTKEYS will first ask for the name of 
        the batch file to create.  If this file already exists, 
        PORTKEYS will inform you of this fact and then ask if 
        you want to erase it or not.  Replying 'Y' will erase 
        the existing file and create a new file with the same 
        name.  Replying 'N' will put you back to the original 
        prompt for a filename.  

        Once the file has been created, PORTKEYS will ask you 
        to enter the key to be reassigned.  You can reply by 
        pressing F^ through F10 or F1 through F10 in 
        conjunction with either the CTRL or ALT keys.  PORTKEYS 
        will then display your selection in a text format (such 
        as 'F05+ALT').  If you select an illegal key PORTKEYS 
        will issue an error message.  NOTE:  Only the keys 
        listed above are considered legal.  F1 through F5 are 
        not available since they are frequently used by the 
        Portfolio's internal applications.

        After the reassignment key has been selected, you will 
        be prompted to enter the string to assign.  All you 
        need to do is enter the character string that you wish 
        to reassign to the function key selected in the 
        paragraph above.  Once the string is entered PORTKEYS 
        will present a menu allowing you to add another 
        reassignment to the current file, or to save the file 
        in its current state.  If you choose to add another 
        line, PORTKEYS will return you to the key selection 
        prompt.  Saving the file as is, will save the file and 
        present the final menu which allows you to create 
        another reassignment file, or exit back to DOS.

Display: Portkeys will work in all three external display modes,

        normal, tracked, and static.  As with all Portfolio 
        Tool Kit software, normal mode is recommended.

EXAMPLE: a:> portkeys

         Portfolio Function Key Reassign  V2.0
          Enter filename:
          REASSIGN.BAT
          Enter key to reassign:
          F10+CTRL
          Enter string to assign:
          PORTDISK

XIV - PORTCLOK.COM - Portfolio Clock Display TSR V2.1

Purpose: PORTCLOK is designed to display the current time of day

        in either the upper left or upper right hand corner of
        the Portfolio's LCD screen.  The display is active when
        in DOS as well as when runnning internal and external
        applications.

Usage: PORTCLOK

        There are no user supplied parameters used with 
        Portclok.  When executed for the first time, the 
        program diplays a menu which allows you to select 
        one of three options.  The first two options determine
        where the clock will be displayed while the third 
        allows you to abort the clock installation. Once the 
        location has been selected PortClok installs itself 
        as a Terminate and Stay Resident (TSR) program 
        and automatically begins displaying the current time 
        of day in the location you selected.  The display 
        format is 'HH:MM'. 

        When PortClok is executed a second time the menu 
        changes and the first two options allow you to toggle 
        the display on or off while the third option exits the 
        program without changing the status of the display.

        Since Portclok updates the time of day display by 
        writing directly to the video RAM as opposed to 
        writting directly to the screen the display is only 
        updated when the screen is refreshed, therfore it is 
        recommended that the refresh rate be set to 'KEYS' or 
        'BOTH'.  Setting the refresh rate to these modes means 
        that under the few circumstances (such as when the 
        display is scrolling quickly, or when exiting one of 
        the Portfolio's internal applications) when the display 
        may be disrupted, the display will be quickly updated. 

        While the file Portclok.Com file is 1737 bytes long, 
        only 512 bytes of memory are utilized for the TSR 
        portion.  The rest of the code is deleted when the
        program goes to end of task.

Display: Portclok will work in all three external display modes,

        normal, tracked, and static, however, as with all 
        Portfolio Tool Kit software, normal mode is 
        recommended.  It is important to remember that for best 
        results the refresh rate should be set to 'KEYS' or 
        'BOTH'.

EXAMPLE: a:> portclok

         Portfolio Clock Display TSR     V2.1

            Clock display is now installed.

         Centennial Software Systems (c) 1990