home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / vrac / ttime300.zip / TTIME.DOC < prev    next >
Text File  |  1994-01-15  |  43KB  |  1,184 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                 T r a n s f e r  T I M E
  13.                                 ------------------------
  14.                                         (TTIME)
  15.  
  16.  
  17.                                       Version 3.0
  18.  
  19.  
  20.                              January 15, 1994 Release Date
  21.  
  22.  
  23.  
  24.                              ┌─────────┐
  25.                        ┌─────┴───┐     │              (tm)
  26.                      ──│         │o    │──────────────────
  27.                        │   ┌─────┴╨──┐ │  Association of
  28.                        │   │         │─┘  Shareware
  29.                        └───│    o    │    Professionals
  30.                      ──────│    ║    │────────────────────
  31.                            └────╨────┘    MEMBER
  32.  
  33.  
  34.  
  35.                           U S E R   D O C U M E N T A T I O N
  36.                           -----------------------------------
  37.  
  38.                             SHAREWARE (UNREGISTERED) VERSION
  39.  
  40.  
  41.  
  42.  
  43.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  44.  
  45.      TABLE OF CONTENTS AND OTHER MISCELLANEOUS INFORMATION:
  46.  
  47.      Chapter One:  About TTIME in general . . . . . . . . . . . . . . 2
  48.  
  49.                    Hardware Requirements. . . . . . . . . . . . . . . 2
  50.  
  51.                    What TTIME can do for you. . . . . . . . . . . . . 2
  52.  
  53.                    What TTIME cannot do for you . . . . . . . . . . . 3
  54.  
  55.  
  56.      Chapter Two:  Using TTIME, with examples . . . . . . . . . . . . 4
  57.  
  58.                    The prompted mode. . . . . . . . . . . . . . . . . 4
  59.  
  60.                    By filename. . . . . . . . . . . . . . . . . . . . 8
  61.  
  62.                    By filesize. . . . . . . . . . . . . . . . . . . . 8
  63.  
  64.                    TTIME's HELP mode. . . . . . . . . . . . . . . . .10
  65.  
  66.                    Installing TTIME with your terminal package. . . .11
  67.  
  68.  
  69.      Chapter Three:Customizing TTIME. . . . . . . . . . . . . . . . .12
  70.  
  71.  
  72.      Chapter Four: Registration and Customer Support. . . . . . . . .17
  73.  
  74.  
  75.      Chapter Five: Acknowledgements and Revision History. . . . . . .19
  76.  
  77.  
  78.           NOTE:  Throughout the documentation, you will note that some
  79.           portions of the text have the following preceding them:
  80.  
  81.      ┌─────────────────────┐
  82.      │ NEW TO THIS VERSION │
  83.      └─────────────────────┘
  84.  
  85.           These labels indicate areas where TransferTIME has been
  86.           significantly improved from the last version and may be of
  87.           special interest.
  88.  
  89.           Also new to this edition is the VENDINFO system.  Many files that
  90.           used to be distributed with the program (README.TXT, VENDOR.DOC and
  91.           so on) have been replaced with VENDINFO.DIZ.  Use the READ_ME.BAT
  92.           file to view this information!
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.                                       Page 1
  102.  
  103.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  104.  
  105.      CHAPTER ONE:  About TTIME in general...
  106.  
  107.           TTIME is a telecommunications utility for the following systems:
  108.  
  109.           - Any PC-DOS or MS-DOS compatible system using DOS Version 3.1
  110.           or later;
  111.  
  112.           - 320K or more of RAM (you'll especially need more if you run
  113.           TTIME from a shell in your telecommunications program);
  114.  
  115.           - Any disk system (hard or floppy)
  116.  
  117.           TTIME estimates the needed time to transfer a file from one
  118.      computer to another, supporting a wide range of modem speeds and a
  119.      number of the most popular file transfer protocols.  If you're not
  120.      sure what a file transfer protocol is, check the IBM New User's
  121.      forum on CompuServe.  They have some nice descriptions on the various
  122.      file transfer protocols available.
  123.  
  124.           In addition to estimating the required time, TTIME can be
  125.      configured to estimate how much a file transfer will COST you (be it
  126.      telephone long-distance charges, connect fees, surcharges, or any
  127.      combination of the above) as well.
  128.  
  129.           TTIME is designed to be easy to use and actually requires very
  130.      little learning on your part.  If you're one of those people who hates
  131.      reading software manuals, go ahead and quit reading now.  Just type
  132.      the command:
  133.  
  134.                TTIME
  135.  
  136.      and press Enter.  TTIME will take your hand and lead you through the
  137.      rest.
  138.  
  139.           If, however, you want to learn how to make TTIME do all it can
  140.      for you, keep reading.  I promise by the time you're done with this
  141.      manual, you'll fully understand how to make it work for you, and how
  142.      you can customize the many features of TTIME to serve YOU best!
  143.  
  144.           WHAT TTIME CAN DO FOR YOU:
  145.  
  146.           Using the default configuration file, TTIME gives its "best
  147.      guess" estimates for file transfers using the XModem, YModem-G,
  148.      CompuServe B+, and ZModem file transfer protocols.  It comes set with
  149.      default modem speeds of 2400, 9600 and 14400 bits per second (bps,
  150.      sometimes erroneously referred to as "baud"), estimating both the time
  151.      and the cost of the file transfer.  By default, TTIME bases its costs
  152.      on the last-known CompuServe network charges with no added long
  153.      distance or network access fees.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.                                       Page 2
  162.  
  163.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  164.  
  165.      ┌─────────────────────┐
  166.      │ NEW TO THIS VERSION │
  167.      └─────────────────────┘
  168.  
  169.           By customizing the default values contained in the configuration
  170.      file (TTIME.INI), you can adjust the performance of TTIME to more
  171.      closely match your own experiences.  Full details are contained in
  172.      CHAPTER THREE - CUSTOMIZING TTIME.
  173.  
  174.           TTIME can be run as a stand-alone program (from the DOS prompt),
  175.      but it works best when used as an add-in to your telecommunication
  176.      program.  Many of the most popular telecommunications (or terminal)
  177.      programs support what is called a 'DOS Shell' or 'Shell to DOS'
  178.      function where the terminal will temporarily let you run a DOS
  179.      command, then return to being connected to the other computer system.
  180.      This is probably the best use for TTIME.
  181.  
  182.           More advanced terminal software will actually let you install
  183.      TTIME using a 'hotkey' (key combination that will run TTIME) so it's
  184.      always just a keypress or two away.
  185.  
  186.           I'll try to help you figure out how to make TTIME work with your
  187.      terminal software, but you must keep in mind that I can't try every
  188.      possible software package.  Many users have provided information that
  189.      should help us figure out how to make TTIME easily accessed from your
  190.      favorite terminal package.
  191.  
  192.           WHAT TTIME CANNOT DO FOR YOU:
  193.  
  194.           It won't actually send or receive programs over your modem.
  195.      That's what your terminal software is for.
  196.  
  197.           It won't be able to predict EXACTLY how long a file transfer will
  198.      take.  TTIME assumes a good phone connection, and bases its estimates
  199.      on a file being transferred at a normal rate of efficiency (no retries
  200.      or errors caused by noisy phone lines).
  201.  
  202.           It won't always be able to accurately predict file transfers
  203.      where both modems are using advanced error correction and data
  204.      compression or proprietary (private) modem-to-modem protocols, since
  205.      the compression varies widely depending on the type of data being
  206.      transmitted.
  207.  
  208.      ┌─────────────────────┐
  209.      │ NEW TO THIS VERSION │
  210.      └─────────────────────┘
  211.  
  212.           However, with some experience, you'll be able to overcome many of
  213.      these shortcomings by making adjustments in the configuration file
  214.      (TTIME.INI) to more closely reflect your "real-world" modem
  215.      experiences.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.                                       Page 3
  222.  
  223.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  224.  
  225.           CHAPTER TWO:  Using TTIME, With Examples:
  226.  
  227.           USING TTIME IN THE PROMPTED MODE:
  228.  
  229.           Probably the easiest way to start TTIME is to use your terminal
  230.      software's 'Shell to DOS' command.  When the DOS prompt appears,
  231.      simply type the command:
  232.  
  233.                TTIME
  234.  
  235.      and press Enter.  This will start TTIME in the 'prompted mode', where
  236.      it will give you a lot of hand-holding and instruct you to either
  237.      enter the name of the file to estimate the transfer time for, or the
  238.      file size in bytes.
  239.  
  240.           Here we need to get technical for a few minutes - but only for a
  241.      few minutes, I promise.  If you're an experienced DOS jockey and
  242.      understand such things as 'pathnames' then you'll only need to glance
  243.      lightly over this section.
  244.  
  245.           When TTIME asks you for a filename to provide an estimate for,
  246.      you have to remember a few things.  First, the file must exist on your
  247.      disk already.  This is because TTIME is going to take a look at it to
  248.      see how large it is, so it can estimate how long the file transfer is
  249.      going to take.
  250.  
  251.           (In the following examples, I'm using all capital letters so the
  252.      names I'm using stand out.  You don't need to capitalize the names
  253.      when you type them in for TTIME.  It understands lower case letters
  254.      just fine.  Also, where you see this symbol:  <enter> , this doesn't
  255.      mean to type the word enter between the brackets, just press the Enter
  256.      or Return key on your keyboard.)
  257.  
  258.           Let's suppose you want to send a file called 'WORKFILE.TXT' to
  259.      someone else's computer.  As long as it's on the disk you're using
  260.      right now, and in your current directory, this is OK.  Just tell TTIME
  261.      to give you an estimate for:
  262.  
  263.                WORKFILE.TXT   <enter>
  264.  
  265.           But, suppose it was somewhere else?  Then, you'd need to add a
  266.      'path' to the name so TTIME could find the file.  Let's suppose that
  267.      you start up your terminal software by typing:
  268.  
  269.                CD\TERMINAL   <enter>
  270.                PHONE         <enter>
  271.  
  272.           Your 'current directory' is the TERMINAL directory.  Let's say
  273.      that your WORKFILE.TXT file is located in the WORDSTUF directory.  So,
  274.      to tell TTIME you want to use that file for an estimate, you'd answer:
  275.  
  276.                \WORDSTUF\WORKFILE.TXT   <enter>
  277.  
  278.      to tell TTIME that the file is on this disk, in the WORDSTUF
  279.      directory.
  280.  
  281.                                       Page 4
  282.  
  283.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  284.  
  285.           Even worse, let's suppose it's on a different disk.  You're on
  286.      the C: drive, in the TERMINAL directory, and the file you want to send
  287.      to the other system is on the D: drive, in the WORDSTUF directory.
  288.      You'd have to add the drive letter to the name, like:
  289.  
  290.                D:\WORDSTUF\WORKFILE.TXT   <enter>
  291.  
  292.      so that TTIME could find it.
  293.  
  294.      ┌─────────────────────┐
  295.      │ NEW TO THIS VERSION │
  296.      └─────────────────────┘
  297.  
  298.           You can specify several files to transfer at once, and TTIME will
  299.      show you the estimates for each file.  For example, let's suppose that
  300.      you want to send the files WORKFILE.TXT (still in the D:\WORDSTUF
  301.      directory) and WORKFILE.WK1 (which is in the D:\SPREAD directory).  To
  302.      have TTIME give you estimates for both these files, you'd answer:
  303.  
  304.                D:\WORDSTUF\WORKFILE.TXT D:\SPREAD\WORKFILE.WK1  <enter>
  305.  
  306.           Notice that the names of the files are separated by a single
  307.      space.  You can enter as many filenames as you like, and TTIME will
  308.      show you the estimated file transfer time and cost for each file, in
  309.      the order you gave.  You'll be asked to press any key (any number or
  310.      letter key will do) before the next estimate will be shown, so you'll
  311.      have time to see the information before TTIME continues.
  312.  
  313.           You can also use the DOS "wildcard" characters ('*' and '?') to
  314.      match multiple files.  Assume that you want to send someone all the
  315.      files with the extension .TXT in the current directory.  When TTIME
  316.      asks you for the file name or size to estimate, answer:
  317.  
  318.                *.TXT  <enter>
  319.  
  320.      and it will find all the matching files, total up their sizes, and
  321.      give you an estimate for the total time and cost of all the files
  322.  
  323.           Supposing that the file is on the OTHER computer?  You type in
  324.      the name of the file, and TTIME tells you 'Cannot find requested file.
  325.      Press any key..." and nothing happens!
  326.  
  327.           This means that the file can't be found on your disk.  Of course
  328.      not!  It's on the other end of the phone line!  So, you'll have to
  329.      tell TTIME how large the file is.
  330.  
  331.           Usually, when you get a list of files from another computer on
  332.      your terminal software, it'll include a file size, often somewhere
  333.      very near the name.  Let's say this is a part of a list the other
  334.      computer has shown you when you asked it to list files:
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.                                       Page 5
  342.  
  343.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  344.  
  345.      **********************************************************************
  346.      * 2 - IBM Utilities
  347.      **********************************************************************
  348.  
  349.      TTIME.ARC     04-15-93   102453  Estimate file transfer times by phone
  350.      MASTER.ZIP    04-14-93    91236  Master database program version 3
  351.      CLSC.COM      04-13-93     1075  Clear Screen with Colors
  352.  
  353.          (more files listed)
  354.  
  355.      and you decide to download TTIME.ARC (wise decision! <g>).  Since
  356.      TTIME.ARC doesn't exist on your drive, you'll need to tell TTIME the
  357.      file size.  Looking at the listing, you decide that 102453 must be the
  358.      file size, right?  So, after TTIME asks you for the file name or size
  359.      to estimate, just answer:
  360.  
  361.                102453   <enter>
  362.  
  363.      ┌─────────────────────┐
  364.      │ NEW TO THIS VERSION │
  365.      └─────────────────────┘
  366.  
  367.           As with file names, you can give several file sizes to estimate
  368.      at the same time.  Let's assume that you wanted to know how long it
  369.      would take to transfer both the TTIME.ARC and MASTER.ZIP files to your
  370.      computer.  When TTIME asks you for the file name or size to estimate,
  371.      answer:
  372.  
  373.                102453 91236    <enter>
  374.  
  375.      and TTIME will give you an estimate for each file.
  376.  
  377.           To summarize, when using TTIME in the 'prompted mode', you'd type
  378.      in the program name (TTIME), then when it asks you for the file name
  379.      or file size you simply answer with the name (if the file is on your
  380.      disk) or the file size (this will work whether the file is on your
  381.      disk or not, but is most useful when you're having a file sent to your
  382.      computer).
  383.  
  384.      ┌─────────────────────┐
  385.      │ NEW TO THIS VERSION │
  386.      └─────────────────────┘
  387.  
  388.           Remember that you can specify multiple files, or file sizes, or
  389.      use "wildcards" - or even mix and match them!
  390.  
  391.           Here are a couple actual examples, using the 'prompted mode' of
  392.      operation:
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                       Page 6
  402.  
  403.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  404.  
  405.  
  406.      <Example One - Prompted Mode by Filename>
  407.  
  408.                     TransferTIME 3.0  Copyright 1993 by RGH Software
  409.                    Unregistered Evaluation Version - Please Register!
  410.  
  411.      File(s) to estimate -> TTIME.EXE
  412.  
  413.  
  414.                     TransferTIME 3.0  Copyright 1993 by RGH Software
  415.                    Unregistered Evaluation Version - Please Register!
  416.  
  417.      File: TTIME.EXE                                 Size:          47,894
  418.  
  419.        Protocol Name        2400 bps         9600 bps        14400 bps
  420.      XMODEM                3 min 41 sec     0 min 54 sec     0 min 37 sec
  421.      CIS B+/YMODEM-G       3 min 34 sec     0 min 53 sec     0 min 36 sec
  422.      ZMODEM                3 min 28 sec     0 min 51 sec     0 min 34 sec
  423.        ESTIMATED COST:      $  0.85          $  0.38          $  0.38
  424.  
  425.           (...press any key to continue...)
  426.  
  427.  
  428.      <Example Two - Prompted Mode by Filesize>
  429.  
  430.                     TransferTIME 3.0  Copyright 1993 by RGH Software
  431.                    Unregistered Evaluation Version - Please Register!
  432.  
  433.      File(s) to estimate -> 47894
  434.  
  435.  
  436.                     TransferTIME 3.0  Copyright 1993 by RGH Software
  437.                    Unregistered Evaluation Version - Please Register!
  438.  
  439.      File: <ESTIMATING BY SIZE>                      Size:          47,894
  440.  
  441.        Protocol Name        2400 bps         9600 bps        14400 bps
  442.      XMODEM                3 min 41 sec     0 min 54 sec     0 min 37 sec
  443.      CIS B+/YMODEM-G       3 min 34 sec     0 min 53 sec     0 min 36 sec
  444.      ZMODEM                3 min 28 sec     0 min 51 sec     0 min 34 sec
  445.        ESTIMATED COST:      $  0.85          $  0.38          $  0.38
  446.  
  447.           (...press any key to continue...)
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                       Page 7
  462.  
  463.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  464.  
  465.  
  466.           USING TTIME IN THE FILENAME MODE:
  467.  
  468.           TTIME can also give you an estimate for a file on your system
  469.      that you want to send to another system, by typing the name of the
  470.      file following the TTIME command, and BEFORE you press the <enter>
  471.      key.  An example of this method of operation:
  472.  
  473.      <Example Three - Command Line, by Filename>
  474.  
  475.      C:\UTIL>ttime ttime.exe
  476.  
  477.  
  478.                     TransferTIME 3.0  Copyright 1993 by RGH Software
  479.                    Unregistered Evaluation Version - Please Register!
  480.  
  481.      File: TTIME.EXE                                 Size:          47,894
  482.  
  483.        Protocol Name        2400 bps         9600 bps        14400 bps
  484.      XMODEM                3 min 41 sec     0 min 54 sec     0 min 37 sec
  485.      CIS B+/YMODEM-G       3 min 34 sec     0 min 53 sec     0 min 36 sec
  486.      ZMODEM                3 min 28 sec     0 min 51 sec     0 min 34 sec
  487.        ESTIMATED COST:      $  0.85          $  0.38          $  0.38
  488.  
  489.           (...press any key to continue...)
  490.  
  491.  
  492.           USING TTIME IN THE FILESIZE MODE:
  493.  
  494.           Again, you can specify the file size to estimate for, by typing
  495.      in the size following the TTIME command, but BEFORE you press the
  496.      <enter> key.  An example of this method of operation:
  497.  
  498.      <Example Four - Command Line, by Filesize>
  499.  
  500.      C:\UTIL>ttime 47894
  501.  
  502.  
  503.                     TransferTIME 3.0  Copyright 1993 by RGH Software
  504.                    Unregistered Evaluation Version - Please Register!
  505.  
  506.      File: <ESTIMATING BY SIZE>                      Size:          47,894
  507.  
  508.        Protocol Name        2400 bps         9600 bps        14400 bps
  509.      XMODEM                3 min 41 sec     0 min 54 sec     0 min 37 sec
  510.      CIS B+/YMODEM-G       3 min 34 sec     0 min 53 sec     0 min 36 sec
  511.      ZMODEM                3 min 28 sec     0 min 51 sec     0 min 34 sec
  512.        ESTIMATED COST:      $  0.85          $  0.38          $  0.38
  513.  
  514.           (...press any key to continue...)
  515.  
  516.      ┌─────────────────────┐
  517.      │ NEW TO THIS VERSION │
  518.      └─────────────────────┘
  519.  
  520.           As with the "prompted" mode of operation, you may mix several
  521.                                       Page 8
  522.  
  523.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  524.  
  525.      file names, file sizes, "wild card" file masks - all on the same
  526.      command line.
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.                                       Page 9
  582.  
  583.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  584.  
  585.           TTIME'S HELP MODE:
  586.  
  587.           Should you ever lose your documentation, or forget how TTIME
  588.      works, simply type the following:
  589.  
  590.                TTIME /H <enter>
  591.  
  592.                 - or -
  593.  
  594.                TTIME /? <enter>
  595.  
  596.      and TTIME will show you a brief help screen to remind you how it
  597.      works:
  598.  
  599.  
  600.                 TransferTIME 3.0  Copyright 1993 by RGH Software
  601.                Unregistered Evaluation Version - Please Register!
  602.  
  603.  TransferTIME 3.0 for DOS is a tool for anyone who wants to know how long a
  604.  file transfer will take, or how much the file transfer will cost - BEFORE
  605.  beginning the file transfer.
  606.  
  607.  The syntax for using TransferTIME is as follows:
  608.  
  609.       TTIME [filename1...] [filesize1...] [/h] [/?]
  610.  
  611.  Where [filename1] and [filesize] are optional file names or sizes in bytes to
  612.  provide an estimate for.  More than one name or size may be given, and the DOS
  613.  wildcard characters may also be used.  Seperate each name or size with a
  614.  single space.
  615.  
  616.  TTIME /H or TTIME /? will show this reminder screen.
  617.  
  618.  Please remember that this is an unregistered (evaluation) TransferTIME copy
  619.  and continued use requires payment of a registration fee to RGH Software.
  620.  
  621.  Press any key to continue with the TransferTIME program...
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.                                       Page 10
  642.  
  643.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  644.  
  645.           INSTALLING TTIME WITH YOUR TERMINAL PACKAGE:
  646.  
  647.           Here, I offer some very general guidelines on how you might be
  648.      able to use TTIME with your software package.  I've listed them in
  649.      order of most preferable to least preferable.
  650.  
  651.           You should refer to the documentation that came with your
  652.      terminal package to see which of these methods it will support.  If
  653.      you are in doubt, go ahead and try each method in the order listed.
  654.  
  655.           This trial and error approach shouldn't damage anything (but
  656.      don't blame me if it does!) and you may find a way that works well for
  657.      you.
  658.  
  659.           I do request that you let me know (either when you register
  660.      your TTIME program, or by CompuServe Mail otherwise) how you got it to
  661.      work with your terminal software.  As I get hints and tips from users
  662.      on how they got it to work, I'll continue to update this section with
  663.      the solutions I get.
  664.  
  665.           GENERAL SUGGESTION #1 - If your terminal package supports the
  666.      addition of external programs by using a 'hot key' (you press a key
  667.      combination to call the program) this would be the best approach.
  668.  
  669.           GENERAL SUGGESTION #2 - If your terminal package allows you to
  670.      define an external program such as a text editor, you might want to
  671.      consider using this approach.  This, of course, will mean that you
  672.      won't be able to use a text editor while using your terminal package.
  673.  
  674.           GENERAL SUGGESTION #3 - Some terminal packages will let you
  675.      install an 'external file transfer protocol' (that is, a program to
  676.      send and receive files by a means that your software doesn't
  677.      ordinarily support).  You can add TTIME to your list of 'external
  678.      protocols' and see if this works.
  679.  
  680.           GENERAL SUGGESTION #4 - Almost every terminal package allows the
  681.      user to "shell to DOS" or "run a DOS command" by pressing a key
  682.      combination.  If yours supports this feature, then simply press the
  683.      key combination to exit to the DOS prompt, then use the TTIME program
  684.      to get your estimate.
  685.  
  686.           GENERAL SUGGESTION #5 - If you're running a multi-tasking system
  687.      such as Microsoft Windows or QEMM's DESQview, you can open another
  688.      "window" and run TTIME in it.  However, this approach can cause some
  689.      problems with your terminal package, as it may cause you to "miss"
  690.      characters while TTIME is running.
  691.  
  692.           If you're running Microsoft Windows, then I suggest that you
  693.      consider obtaining and trying a copy of TransferTIME for Windows.  If
  694.      you cannot find a copy from the same place you got this program,
  695.      contact RGH Software and we'll let you know how to get one.  NOTE -
  696.      registered users will AUTOMATICALLY get both the latest DOS and
  697.      Windows versions of TTIME when they register.
  698.  
  699.  
  700.  
  701.                                       Page 11
  702.  
  703.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  704.  
  705.  
  706.          CHAPTER THREE:  Customizing TTIME
  707.  
  708.      ┌─────────────────────┐
  709.      │ NEW TO THIS VERSION │
  710.      └─────────────────────┘
  711.  
  712.           TTIME stores much useful information in a file named TTIME.INI
  713.      that you can edit using any text editor.  It comes pre-configured with
  714.      a "default" setup that should work on most systems.  The default
  715.      TTIME.INI file is shown below:
  716.  
  717.      [TransferTIME 3.0]
  718.      ForeColor = 6
  719.      BackColor = 0
  720.      RegKey1 =
  721.      RegKey2 = 00000000
  722.  
  723.      [Protocols]
  724.      Prot1Name = XModem
  725.      Prot2Name = CIS B+/YModem-G
  726.      Prot3Name = ZModem
  727.      Prot1Effic = 0.900
  728.      Prot2Effic = 0.929
  729.      Prot3Effic = 0.958
  730.  
  731.      [Speeds]
  732.      Speed1 = 2400
  733.      Speed2 = 9600
  734.      Speed3 = 14400
  735.  
  736.      [Costs]
  737.      Cost1 = 0.213
  738.      Cost2 = 0.380
  739.      Cost3 = 0.380
  740.  
  741.           For ease of understanding, the information in the file is
  742.      separated into sections, and each section has a title that describes
  743.      the information contained in that section.  Let's take a look at each
  744.      section to see how you might want to modify the default settings.
  745.  
  746.           The first section, labeled [TransferTIME 3.0] contains
  747.      information on whether or not this copy is registered (paid for), and
  748.      what screen colors TTIME should use:
  749.  
  750.      [TransferTIME 3.0]
  751.      ForeColor = 6
  752.      BackColor = 0
  753.      RegKey1 =
  754.      RegKey2 = 00000000
  755.  
  756.           The "ForeColor" line controls the color that letters and numbers
  757.      will appear in.  The "BackColor" line controls the color of the rest
  758.      of the screen will appear in.  The ForeColor may be set to any value
  759.      between 0 and 31, and the BackColor may be set to any value between 0
  760.      and 7.  The numbers correspond to colors as shown in this chart:
  761.                                       Page 12
  762.  
  763.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  764.  
  765.  
  766.      1 = blue       5 = magenta    9 = light blue      13 = light magenta
  767.      2 = green      6 = brown      10 = light green    14 = yellow
  768.      3 = cyan       7 = white      11 = light cyan     15 = bright white
  769.      4 = red        8 = grey       12 = light red      0 = black
  770.  
  771.           Adding 16 to any of the colors above for ForeColor will result in
  772.      blinking letters and numbers.  I don't particularly recommend that you
  773.      use blinking letters/numbers, as the result can be somewhat
  774.      distracting.
  775.  
  776.           You may want to try various combinations (like the default of
  777.      ForeColor = 6 and BackColor = 0 for brown letters/numbers on a black
  778.      screen, or ForeColor = 7 and BackColor = 1 for white letters/numbers
  779.      on a blue screen) to find a combination that you like.
  780.  
  781.           The next two lines (RegKey1 and RegKey2) contain information
  782.      about this copy of TTIME, and your serial number.  You should NOT
  783.      alter the information contained in these two lines.
  784.  
  785.           The next section, labeled [Protocols], contains information about
  786.      the file transfer protocols TTIME will use:
  787.  
  788.      [Protocols]
  789.      Prot1Name = XModem
  790.      Prot2Name = CIS B+/YModem-G
  791.      Prot3Name = ZModem
  792.      Prot1Effic = 0.900
  793.      Prot2Effic = 0.929
  794.      Prot3Effic = 0.958
  795.  
  796.           The first three lines contain the names of the file transfer
  797.      protocols, and the next three lines contain the efficiency rating for
  798.      those file transfer protocols.  These efficiency ratings are based on
  799.      input and experience over three years by myself and a large number of
  800.      users, and shouldn't be changed UNLESS you're changing the protocol as
  801.      well.
  802.  
  803.           The first thing you need to do is to transfer several files using
  804.      the "new" transfer protocol.  For the most accurate results, do so
  805.      with ERROR CORRECTION and FILE COMPRESSION TURNED OFF (if your modem
  806.      supports these features - refer to your modem user's manual for
  807.      details on whether or not it does and how to turn these features off).
  808.  
  809.      **********************************************************************
  810.      WARNING - if you don't turn error correction and file compression off,
  811.      then the results of your tests will be inaccurate and TTIME will be
  812.      unable to give you reasonable estimates.
  813.      **********************************************************************
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.                                       Page 13
  822.  
  823.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  824.  
  825.  
  826.           Pick three files to transfer.  One should be a fairly small file
  827.      (perhaps 10,000 bytes or so), one should be a medium-sized file
  828.      (perhaps 40,000 to 50,000 bytes) and one should be a good-sized file
  829.      (of perhaps 100,000 bytes or more).  Write down the exact size of the
  830.      file, and how long (in minutes and seconds) it took to transfer each
  831.      file.
  832.  
  833.           When you're done, add up the total file sizes and the total time
  834.      it took to transfer the three files.  Convert the total time into
  835.      seconds, and divide the total file sizes by the total seconds.  This
  836.      figure is the number of characters per second transferred - keep it
  837.      handy, because we're almost done.
  838.  
  839.           Take the modem speed used to transfer the files, and divide it by
  840.      ten to give you the speed of the modem in characters per second.
  841.      Finally, take the characters per second transferred and divide that
  842.      number by the modem's speed in characters per second, and you've got
  843.      your efficiency rating.
  844.  
  845.           An example will probably help make it clearer.  Let's assume you
  846.      want to replace the first protocol (XModem) with a new protocol you're
  847.      using, called FastFile.  You are using a 9600 bps modem, and have
  848.      turned your error correction and data compression off.
  849.  
  850.           You transfer three files - one is 35,000 bytes, one is 65,000
  851.      bytes and one is 110,000 bytes.  It took 38 seconds for the first, 68
  852.      seconds for the second, and 117 seconds for the third file.
  853.  
  854.           Adding the three file sizes (35,000 + 65,000 + 110,000) gives you
  855.      a total of 200,000 bytes.  Adding the three times (38 + 68 + 117)
  856.      gives you a total time of 223 seconds.
  857.  
  858.           Dividing the 200,000 bytes by 223 seconds gives you a character
  859.      per second speed of 896.86 characters per second.  Your modem speed
  860.      was 9600 bps, so it's transmitting 960 characters per second.
  861.  
  862.           You divide 896.86 (the file characters per second) by 960 (the
  863.      modem characters per second) and wind up with an efficiency rating of
  864.      0.934 for the FastFile protocol.
  865.  
  866.           So, finally, you'd change the first protocol line to read:
  867.  
  868.                Prot1Name = FastFile
  869.  
  870.      and the first efficiency rating line to read:
  871.  
  872.                Prot1Effic = 0.934
  873.  
  874.      and from now on, TTIME will include information on your new file
  875.      transfer protocol each time you use it!
  876.  
  877.           The next section, labeled [Speeds], simply records the modem
  878.      speeds (in bits per second) that you want TTIME to make estimates for.
  879.      The default settings are as listed below:
  880.  
  881.                                       Page 14
  882.  
  883.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  884.  
  885.      [Speeds]
  886.      Speed1 = 2400
  887.      Speed2 = 9600
  888.      Speed3 = 14400
  889.  
  890.           You may wish to change these to reflect different speeds that
  891.      your modem supports, or to reflect the results of data compression
  892.      that your modem may offer.
  893.  
  894.           For example, let's assume that you've found that your 14400 bps
  895.      modem generally can use data compression to get an actual character
  896.      per second speed of 1600 characters per second.  You'd calculate this
  897.      the same way you calculated the file characters per second above, or
  898.      if you're lucky, your terminal program will tell you this.
  899.  
  900.           You might then want to change the third modem speed (14400) to
  901.      reflect your "real-life" experience.  To do this, simply multiply the
  902.      speed above (in our example, 1600) by ten (making 16000) and edit the
  903.      desired line (we're changing the 14400 line) to show the new speed:
  904.  
  905.                Speed3 = 16000
  906.  
  907.           Another example - suppose that your modem only supports a maximum
  908.      speed of 9600 bps, and you want to have TTIME show estimates for 1200
  909.      bps, 2400 bps and 9600 bps.  You'd change the three lines as shown
  910.      below:
  911.  
  912.                Speed1 = 1200
  913.                Speed2 = 2400
  914.                Speed3 = 9600
  915.  
  916.      to give these estimates.
  917.  
  918.           The final section, titled [Costs], is where TTIME stores the cost
  919.      PER MINUTE to calculate its cost information.  You should note that
  920.      the cost estimate is based on THE SECOND PROTOCOL IN YOUR LIST, so you
  921.      should change that protocol (if needed) to give the most accurate
  922.      estimate.  The default settings are as follows:
  923.  
  924.      [Costs]
  925.      Cost1 = 0.213
  926.      Cost2 = 0.380
  927.      Cost3 = 0.380
  928.  
  929.           These costs reflect the current costs for CompuServe access using
  930.      normal CompuServe access numbers.  The figure for Cost1 represents
  931.      what you pay for access at the first listed modem speed, the figure
  932.      for Cost2 represents what you pay for access at the second listed
  933.      modem speed, and the figure for Cost3 represents what you pay for
  934.      access at the third listed modem speed.
  935.  
  936.           They may be easily changed to reflect the actual costs you pay
  937.      for calls as follows:
  938.  
  939.           First, take any per-hour charges and divide by 60 to get the per-
  940.      minute cost.  If you have long distance charges, contact your phone
  941.                                       Page 15
  942.  
  943.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  944.  
  945.      company representative to ask them the per-minute charge for the call,
  946.      and add this cost to the per-minute connection fee.
  947.  
  948.           As an example, let's assume you call the BIG BBS and pay them a
  949.      fee of $5 per hour for 2400 bps access, or $8 per hour for 9600 bps or
  950.      14400 bps access.  The phone company informs you that it costs you
  951.      twelve cents per minute to call BIG BBS.
  952.  
  953.           So, your 2400 bps cost is .083 ($5 divided by 60 minutes) plus
  954.      .12 (long distance), or .203 dollars per minute.  Your 9600 bps and
  955.      14400 bps cost is .133 ($8 divided by 60 minutes) plus .12 (long
  956.      distance), or .253 dollars per minute.  You'd then change the cost
  957.      section to read as follows:
  958.  
  959.                Cost1 = 0.203
  960.                Cost2 = 0.253
  961.                Cost3 = 0.253
  962.  
  963.           The three decimal places used above are generally accurate enough
  964.      to give a good estimate of the cost.
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.                                       Page 16
  1002.  
  1003.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  1004.  
  1005.           CHAPTER FOUR:  Registration and Customer Support
  1006.  
  1007.           A lot of the information in this section is duplicated in the
  1008.      REGISTER.DOC file, but I want to lightly touch on why you must
  1009.      register your copy of TTIME if you want to continue to use it.
  1010.  
  1011.           TTIME is not free software.  TTIME is a Shareware product (please
  1012.      read the REGISTER.DOC file for more details) and you are required to
  1013.      pay a registration fee of $30 if you find that you're still using
  1014.      TTIME after a reasonable evaluation period (30 days).
  1015.  
  1016.           Why should you pay?  Well:
  1017.  
  1018.           1)  Payment is required by law if you are going to keep using it.
  1019.  
  1020.           2)  I've put many hundreds of hours into developing, testing and
  1021.           improving the TTIME package from its humble beginnings to the
  1022.           product you see now.  Payment for my labor is only fair.
  1023.  
  1024.           3)  A software package purchased in a store requires that you
  1025.           make payment up front, BEFORE you even know that the soft-
  1026.           ware will work the way you want it.  With Shareware, you
  1027.           get a trial in your everyday computing environment first, before
  1028.           paying for the software.
  1029.  
  1030.           4)  Shareware depends on your honesty.  If no one registers a
  1031.           shareware program, then the author will likely discontinue
  1032.           improving and supporting that program.  It's up to you and
  1033.           your registrations to keep TTIME (and other shareware pro-
  1034.           grams) healthy and growing.
  1035.  
  1036.           Registered Users, in exchange for their $30 registration fee,
  1037.      will receive:
  1038.  
  1039.           1)  My most heartfelt gratitude, and the undying appreciation
  1040.           of my wife (who's put up with me in front of the keyboard
  1041.           as late as 4:30am working on this release!)
  1042.  
  1043.           2)  The latest version of TTIME, with your registration number
  1044.           permanently emblazoned on it (so all who see it may envy
  1045.           you).  Registration now gets you BOTH the DOS and WINDOWS
  1046.           versions of TTIME.
  1047.  
  1048.           Registered users will also get a utility program that makes
  1049.           changing the TTIME.INI file quick and easy (including mouse
  1050.           support for ease of editing) instead of using a text editor
  1051.           to make desired changes.
  1052.  
  1053.           3)  FREE UPDATES!  All Registered Users will receive the next
  1054.           major release and/or bug fix version free of charge.  This
  1055.           means, if I release a new version followed by a bug fix
  1056.           version (or vice versa), you'll receive two free update
  1057.           disks at no additional charge!  Registered Users will be
  1058.           notified via mail of updates after the expiration of their
  1059.           free update period, and can purchase updated versions at a
  1060.           significant discount.
  1061.                                       Page 17
  1062.  
  1063.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  1064.  
  1065.           4)  FREE COMPUSERVE TIME!  By special arrangement with Compu-
  1066.           Serve, ASP authors are allowed to offer to registered users
  1067.           an offer for a FREE CompuServe IntroPak, with your very own
  1068.           CompuServe ID number, password, and $15 in FREE CONNECT TIME
  1069.           that you can use to explore the CompuServe network (or, for
  1070.           that matter, to visit the ASP Forum for help, hints, support
  1071.           and other great ASP member product information).
  1072.  
  1073.          Furthermore, Registered Users can obtain preferential support of
  1074.          TTIME through several sources:
  1075.  
  1076.                - on CompuServe, by addressing CompuServe Mail to me at my
  1077.                  User ID (76670,110);
  1078.  
  1079.                - By U.S. Mail, at the address shown on the registration
  1080.                  form;
  1081.  
  1082.                - Via fax or voice (only to registered users)
  1083.  
  1084.          ┌────────────────────────────────────────────────────────────────┐
  1085.          │                                                                │
  1086.          │                 ASP Ombudsman Information                      │
  1087.          │                                                                │
  1088.          │  RGH Software is a member of the Association of Shareware      │
  1089.          │  Professionals (ASP).  ASP wants to make sure that the         │
  1090.          │  shareware principle works for you.  If you are unable to      │
  1091.          │  resolve a shareware-related problem with an ASP member        │
  1092.          │  by contacting the member directly, ASP may be able to help.   │
  1093.          │  The ASP Ombudsman can help you resolve a dispute or problem   │
  1094.          │  with an ASP member, but does not provide technical support    │
  1095.          │  for members' products.  Please write to the ASP Ombudsman at: │
  1096.          │     ASP Ombudsman                  _______                     │
  1097.          │     545 Grover Road           ____|__     |                (R) │
  1098.          │     Muskegon, MI           --|       |    |------------------- │
  1099.          │        49442-9427 (USA)      |   ____|__  |  Association of    │
  1100.          │  or send a Compuserve        |  |       |_|  Shareware         │
  1101.          │  message via CompuServe      |__|   o   |    Professionals     │
  1102.          │  mail to 70475,1071, or    -----|   |   |--------------------- │
  1103.          │  a FAX to 616-788-2765.         |___|___|    MEMBER            │
  1104.          │                                                                │
  1105.          └────────────────────────────────────────────────────────────────┘
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                       Page 18
  1122.  
  1123.           TransferTIME (TTIME) Version 3.0   Shareware (Evaluation) Version
  1124.  
  1125.           CHAPTER FIVE:  Acknowledgements and Revision History
  1126.  
  1127.           IBM-PC is a trademark of IBM Corporation
  1128.           PC-DOS is a trademark of IBM Corporation
  1129.           MS-DOS is a trademark of Microsoft Inc.
  1130.           Microsoft Windows and Windows are trademarks of Microsoft Inc.
  1131.           ASP is a trademark of the Association of Shareware Professionals
  1132.           CompuServe is a service of H&R Block, Inc.
  1133.           America On-Line is a service of Quantum Information Services.
  1134.  
  1135.           TTIME was programmed using Microsoft QuickBASIC version 4.5 and
  1136.           various support modules.
  1137.  
  1138.           TTIME is Copyright (c) 1991-1993 by RGH Software.  All Rights
  1139.           Reserved.
  1140.  
  1141.  
  1142.           REVISION HISTORY:
  1143.  
  1144.           Version 1.0 - Original release in early 1990.  Supported the
  1145.           XMODEM and YMODEM file transfer protocols, 1200/2400/9600 bps
  1146.           operation.
  1147.  
  1148.           Version 1.1 - Released in March 1990, added support for the
  1149.           ZMODEM and CompuServe B+ file transfer protocols.
  1150.  
  1151.           Version 1.2 - Died in beta testing.  Never actually released to
  1152.           the general public.
  1153.  
  1154.           Version 1.3 - Released in late 1990.  Since many users were
  1155.           complaining that TTIME routinely underestimated transfer times, I
  1156.           made it assume that file transfers would be less efficient.
  1157.  
  1158.           Version 1.3a - Also released in late 1990, this is a bug fix that
  1159.           repairs a rounding error reported by user Rip Strautman.
  1160.  
  1161.           Version 2.0 - Released April 1991, added the cost estimating
  1162.           features and revised the estimates again to account for reports
  1163.           that the CompuServe estimates were still a bit off.
  1164.  
  1165.           Version 2.1 - Released October 1992, support for the new 14400
  1166.           bps modems added.  Generally tightened the code up a bit and
  1167.           improved some of the support routines.
  1168.  
  1169.           Version 3.0 - DOS version totally re-written, initial Windows
  1170.           version.  Many improvements including almost total customization
  1171.           by the end user.  This is the version you're now evaluating!!
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.                                       Page 19
  1182.  
  1183. 
  1184.