















                    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 <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
           Centennial Software Systems (c) 1990


