home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / TTIME20.ZIP / TTIME.DOC < prev    next >
Text File  |  1992-09-01  |  36KB  |  984 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                             T r a n s f e r  T I M E
  12.                             ------------------------
  13.                                      (TTIME)
  14.  
  15.  
  16.  
  17.                                    Version 2.0
  18.  
  19.  
  20.                              June, 1992 Release Date
  21.  
  22.  
  23.                            ┌─────────┐
  24.                      ┌─────┴───┐     │              (tm)
  25.                    ──│         │o    │──────────────────
  26.                      │   ┌─────┴╨──┐ │  Association of
  27.                      │   │         │─┘  Shareware
  28.                      └───│    o    │    Professionals
  29.                    ──────│    ║    │────────────────────
  30.                          └────╨────┘    MEMBER
  31.  
  32.  
  33.  
  34.                       U S E R   D O C U M E N T A T I O N
  35.                       -----------------------------------
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                 BBS SysOps:  Please refer to the SYSOP.DOC file
  42.              for distribution information, and to the DESCRIBE.DOC
  43.           file for description, keyword and miscellaneous information.
  44.  
  45.                Disk Vendors, User Groups, SIG/Libraries:  Please
  46.            refer to the VENDOR.DOC file for distribution information,
  47.            and to the DESCRIBE.DOC file for description, keywords and
  48.                         miscellaneous information.
  49.  
  50.  
  51.  
  52. TTIME Version 2.0                                     User Documentation
  53.  
  54.     TABLE OF CONTENTS AND OTHER MISCELLANEOUS INFORMATION:
  55.  
  56.     Chapter One:  About TTIME in general . . . . . . . . . . . . . . . . 1
  57.                   Hardware Requirements. . . . . . . . . . . . . . . . . 1
  58.                   What TTIME can do for you. . . . . . . . . . . . . . . 1
  59.                   What TTIME cannot do for you . . . . . . . . . . . . . 2
  60.  
  61.  
  62.     Chapter Two:  Using TTIME, with examples . . . . . . . . . . . . . . 3
  63.                   The prompted mode. . . . . . . . . . . . . . . . . . . 3
  64.                   By filename. . . . . . . . . . . . . . . . . . . . . . 5
  65.                   By filesize. . . . . . . . . . . . . . . . . . . . . . 6
  66.                   TTIME's HELP mode. . . . . . . . . . . . . . . . . . . 6
  67.                   Installing TTIME with your terminal package. . . . . . 7
  68.  
  69.     Chapter Three:Customizing TTIME. . . . . . . . . . . . . . . . . . . 9
  70.  
  71.     Chapter Four: Registration and Customer Support. . . . . . . . . . .12
  72.  
  73.     Chapter Five: Acknowlegements and Revision History . . . . . . . . .14
  74.  
  75.  
  76.     Other Files you'll want to read: (they should be included with your
  77.     copy of TTIME)
  78.  
  79.     PACKING.LST    To be sure you got ALL of the TTIME package
  80.  
  81.     SHR-WARE.DOC   Background information on Shareware and the ASP
  82.  
  83.     WARRANTY.DOC   Warranty information about this Evaluation Package
  84.  
  85.     LICENSE.DOC    Terms of use and copying restrictions
  86.  
  87.     REGISTER.DOC   Registration information for users, also information
  88.                    about the Software Update Program option
  89.  
  90.  
  91.     Special Interest Files for BBS Sysops and Distributors:
  92.  
  93.     VENDOR.DOC     Information and restrictions for disk vendors, distrib-
  94.                    utors, user groups and more
  95.  
  96.     SYSOP.DOC      Information and restrictions for BBS SysOps
  97.  
  98.     DESCRIBE.DOC   For either/all, miscellaneous information, program
  99.                    descriptions and background on RGH Software
  100.  
  101.     REGISTER.DOC   If you're NOT an ASP member, review this if you want
  102.                    to be sure you'll continue to receive updates!
  103.  
  104.  
  105.  
  106. TTIME Version 2.0                                     User Documentation
  107.  
  108.     CHAPTER ONE:  About TTIME in general...
  109.  
  110.          TTIME is a telecommunications utility for the following systems:
  111.  
  112.           - Any PC-DOS or MS-DOS compatible system using DOS Version 3.1
  113.             or later;
  114.  
  115.           - 256K or more of RAM (you'll especially need more if you run
  116.             TTIME from a shell in your telecommunications program);
  117.  
  118.           - Any disk system (hard or floppy)
  119.  
  120.          TTIME estimates the needed time to transfer a file from one
  121.     computer to another, supporting a wide range of modem speeds and a
  122.     number of the most popular file transfer protocols.  If you're not
  123.     sure what a file transfer protocol is, check the IBM New User's
  124.     forum on CompuServe, they have some nice descriptions on the various
  125.     file transfer protocols available.
  126.  
  127.          In addition to estimating the required time, TTIME can be
  128.     configured to estimate how much a file transfer will COST you (be it
  129.     telephone long-distance charges, connect fees, surcharges, or any
  130.     combination of the above) as well.
  131.  
  132.          TTIME is designed to be easy to use and actually requires very
  133.     little learning on your part.  If you're one of those people who hates
  134.     reading software manuals, go ahead and quit reading now.  Just type
  135.     the command:
  136.  
  137.               TTIME
  138.  
  139.     and press Enter.  TTIME will take your hand and lead you through the
  140.     rest.
  141.  
  142.          If, however, you want to learn how to make TTIME do all it can
  143.     for you, keep reading.  I promise by the time you're done with this
  144.     manual, you'll fully understand how to make it work for you, and how
  145.     you can customize the cost reporting feature of TTIME.
  146.  
  147.     WHAT TTIME CAN DO FOR YOU:
  148.  
  149.          TTIME will provide it's best-guess estimates for modem speeds of
  150.     1200, 2400 and 9600 bps (bits per second, sometimes erroneously called
  151.     'baud').
  152.  
  153.          TTIME currently supports the XMODEM, YMODEM, ZMODEM and
  154.     CompuServe B+ file transfer protocols.
  155.  
  156.          TTIME can make its estimates by you giving it the file name you
  157.     want an estimate for (provided the file is on your computer, and
  158.     you're sending it to another computer), or by file size in bytes (this
  159.     method will work for a file you're sending to another computer, but is
  160.     probably best used to estimate how long it'll take for a file to be
  161.     sent from another computer to yours).
  162.  
  163.  
  164.  
  165.       June 1, 1992                                                   Page 1
  166.  
  167.  
  168.  
  169. TTIME Version 2.0                                     User Documentation
  170.  
  171.  
  172.          TTIME can be run as a stand-alone program (from the DOS prompt),
  173.     but it works best when used as an add-in to your telecommunication
  174.     program.  Many of the most popular telecommunications (or terminal)
  175.     programs support what is called a 'DOS Shell' or 'Shell to DOS'
  176.     function where the terminal will temporarily let you run a DOS
  177.     command, then return to being connected to the other computer system.
  178.     This is probably the best use for TTIME.
  179.  
  180.          More advanced terminal software will actually let you install
  181.     TTIME using a 'hotkey' (key combination that will run TTIME) so it's
  182.     always just a keypress or two away.
  183.  
  184.          I'll try to help you figure out how to make TTIME work with your
  185.     terminal software, but you must keep in mind that I can't afford to
  186.     buy every possible software package and therefore have direct
  187.     experience with only a few programs.  You'll need to refer to the
  188.     instructions that came with your terminal software in order to learn
  189.     how to install it on YOUR system and make it work.
  190.  
  191.     WHAT TTIME CANNOT DO FOR YOU:
  192.  
  193.          It won't actually send or receive programs over your modem.
  194.     That's what your terminal software is for.
  195.  
  196.          It won't be able to predict EXACTLY how long a file transfer will
  197.     take.  TTIME assumes a good phone connection, and bases its estimates
  198.     on a file being transferred at a normal rate of efficiency (no retries
  199.     or errors caused by noisy phone lines).  If you often have problems
  200.     with sending or receiving files, then TTIME will probably be incorrect
  201.     in its estimates of how long a file transfer will take.
  202.  
  203.          It won't support any of the new compression tricks that some
  204.     modems use (such as MNP-4 or MNP-5 data compression).  Since the
  205.     results of these compression techniques depend as much on how good a
  206.     connection you have as well as the speeds of the modems involved,
  207.     trying to calculate these figures would give such a wide spread of
  208.     time from best case to worst case that the resulting estimates would
  209.     be of no use.
  210.  
  211.          It won't support any of the proprietary (private) modem-to-modem
  212.     protocols (such as the Hayes protocol or the Courier HST protocol),
  213.     again because of the variable results that these protocols would
  214.     cause.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.       June 1, 1992                                                   Page 2
  229.  
  230.  
  231.  
  232. TTIME Version 2.0                                     User Documentation
  233.  
  234.     CHAPTER TWO:  Using TTIME, With Examples:
  235.  
  236.     USING TTIME IN THE PROMPTED MODE:
  237.  
  238.          Probably the easiest way to start TTIME is to use your terminal
  239.     software's 'Shell to DOS' command.  When the DOS prompt appears,
  240.     simply type the command:
  241.  
  242.               TTIME
  243.  
  244.     and press Enter.  This will start TTIME in the 'prompted mode', where
  245.     it will give you a lot of hand-holding and instruct you to either
  246.     enter the name of the file to estimate the transfer time for, or the
  247.     file size in bytes.
  248.  
  249.          Here we need to get technical for a few minutes - but only for a
  250.     few minutes, I promise.  If you're an experienced DOS jockey and
  251.     understand such things as 'pathnames' then you'll only need to glance
  252.     lightly over this section.
  253.  
  254.          When TTIME asks you for a filename to provide an estimate for,
  255.     you have to remember a few things.  First, the file must exist on your
  256.     disk already.  This is because TTIME is going to take a look at it to
  257.     see how large it is, so it can estimate how long the file transfer is
  258.     going to take.
  259.  
  260.          (In the following examples, I'm using all capital letters so the
  261.     names I'm using stand out.  You don't need to capitalize the names
  262.     when you type them in for TTIME.  It understands lower case letters
  263.     just fine.  Also, where you see this symbol:  <enter> , this doesn't
  264.     mean to type the word enter between the brackets, just press the
  265.     Enter or Return key on your keyboard.)
  266.  
  267.          Let's suppose you want to send a file called 'WORKFILE.TXT' to
  268.     someone else's computer.  As long as it's on the disk you're using
  269.     right now, and in your current directory, this is OK.  Just tell TTIME
  270.     to give you an estimate for:
  271.  
  272.               WORKFILE.TXT   <enter>
  273.  
  274.          But, suppose it was somewhere else?  Then, you'd need to add a
  275.     'path' to the name so TTIME could find the file.  Let's suppose that
  276.     you start up your terminal software by typing:
  277.  
  278.               CD\TERMINAL   <enter>
  279.               PHONE         <enter>
  280.  
  281.          Your 'current directory' is the TERMINAL directory.  Let's say
  282.     that your WORKFILE.TXT file is located in the WORDSTUF directory.  So,
  283.     to tell TTIME you want to use that file for an estimate, you'd answer:
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.       June 1, 1992                                                   Page 3
  292.  
  293.  
  294.  
  295. TTIME Version 2.0                                     User Documentation
  296.  
  297.               \WORDSTUF\WORKFILE.TXT   <enter>
  298.  
  299.     to tell TTIME that the file is on this disk, in the WORDSTUF
  300.     directory.
  301.  
  302.          Even worse, let's suppose it's on a different disk.  You're on
  303.     the C: drive, in the TERMINAL directory, and the file you want to send
  304.     to the other system is on the D: drive, in the WORDSTUF directory.
  305.     You'd have to add the drive letter to the name, like:
  306.  
  307.               D:\WORDSTUF\WORKFILE.TXT   <enter>
  308.  
  309.     so that TTIME could find it easily.
  310.  
  311.          Supposing that the file is on the OTHER computer?  You type in
  312.     the name of the file, and TTIME tells you 'Cannot find requested file.
  313.     Press any key..." and nothing happens!
  314.  
  315.          This means that the file can't be found on your disk.  Of course
  316.     not!  It's on the other end of the phone line!  So, you'll have to
  317.     tell TTIME how large the file is.
  318.  
  319.          Usually, when you get a list of files from another computer on
  320.     your terminal software, it'll include a file size, often somewhere
  321.     very near the name.  Let's say this is a part of a list the other
  322.     computer has shown you when you asked it to list files:
  323.  
  324.     **********************************************************************
  325.     * 2 - IBM Utilities
  326.     **********************************************************************
  327.  
  328.     TTIME.ARC     04-15-91   102453  Estimate file transfer times by phone
  329.     MASTER.ZIP    04-14-91    91236  Master database program version 3
  330.     CLSC.COM      04-13-91     1075  Clear Screen with Colors
  331.  
  332.     (more files listed)
  333.  
  334.     and you decide to download TTIME.ARC (wise decision! <g>).  Since
  335.     TTIME.ARC doesn't exist on your drive, you'll need to tell TTIME the
  336.     file size.  Looking at the listing, you decide that 102453 must be the
  337.     file size, right?  So, after TTIME asks you for the file name or size
  338.     to estimate, just answer:
  339.  
  340.               102453   <enter>
  341.  
  342.          To summarize, when using TTIME in the 'prompted mode', you'd type
  343.     in the program name (TTIME), then when it asks you for the file name
  344.     or file size you simply answer with the name (if the file is on your
  345.     disk) or the file size (this will work whether the file is on your
  346.     disk or not, but is most useful when you're having a file sent to your
  347.     computer).
  348.  
  349.          Here are a couple actual examples, using the 'prompted mode' of
  350.     operation:
  351.  
  352.  
  353.  
  354.       June 1, 1992                                                   Page 4
  355.  
  356.  
  357.  
  358. TTIME Version 2.0                                     User Documentation
  359.  
  360.     (Example One:  Prompted Mode, by File Name)
  361.  
  362.  
  363.       C>ttime
  364.                   TTIME Version 2.0  Copyright (c) 1991 by RGH Software
  365.                 Unregistered Evaluation Copy - Did you FORGET to register?
  366.  
  367.       (Press ENTER alone to quit program and exit to DOS)
  368.       File size, or name to check (may include path): b:\ttime.exe
  369.  
  370.       File: B:\TTIME.EXE                         Size:       47,169
  371.  
  372.       Protocol/Time:      1200 bps         2400 bps         9600 bps
  373.        XMODEM            7 min  10 sec    3 min  35 sec    0 min  53 sec
  374.        YMODEM            7 min   4 sec    3 min  32 sec    0 min  53 sec
  375.        CIS B+/ZMODEM     7 min   1 sec    3 min  30 sec    0 min  52 sec
  376.       Estimated Cost:   $   1.51         $   0.75         $   0.34
  377.       (press any key to continue...)
  378.  
  379.     (Example Two:  Prompted Mode, by File Size)
  380.  
  381.     C>ttime
  382.                 TTIME Version 2.0   Copyright (c) 1991 by RGH Software
  383.               Unregistered Evaluation Copy - Did you FORGET to register?
  384.  
  385.     (Press ENTER alone to quit program and exit to DOS)
  386.     File size, or name to check (may include path): 47169
  387.  
  388.     File: (Size = 47169)                       Size:       47,169
  389.  
  390.     Protocol/Time:      1200 bps         2400 bps         9600 bps
  391.      XMODEM            7 min  10 sec    3 min  35 sec    0 min  53 sec
  392.      YMODEM            7 min   4 sec    3 min  32 sec    0 min  53 sec
  393.      CIS B+/ZMODEM     7 min   1 sec    3 min  30 sec    0 min  52 sec
  394.     Estimated Cost:   $   1.51         $   0.75         $   0.34
  395.     (press any key to continue...)
  396.  
  397.     USING TTIME IN THE FILENAME MODE:
  398.  
  399.          TTIME can also give you an estimate for a file on your system
  400.     that you want to send to another system, by typing the name of the
  401.     file following the TTIME command, and BEFORE you press the <enter>
  402.     key.  An example of this method of operation:
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.       June 1, 1992                                                   Page 5
  418.  
  419.  
  420.  
  421. TTIME Version 2.0                                     User Documentation
  422.  
  423.     (Example Three:  File Name mode)
  424.  
  425.       C>ttime b:\ttime.exe
  426.               TTIME Version 2.0   Copyright (c) 1991 by RGH Software
  427.             Unregistered Evaluation Copy - Did you FORGET to register?
  428.  
  429.     File: B:\TTIME.EXE                       Size:       47,169
  430.  
  431.     Protocol/Time:      1200 bps         2400 bps         9600 bps
  432.      XMODEM            7 min  10 sec    3 min  35 sec    0 min  53 sec
  433.      YMODEM            7 min   4 sec    3 min  32 sec    0 min  53 sec
  434.      CIS B+/ZMODEM     7 min   1 sec    3 min  30 sec    0 min  52 sec
  435.     Estimated Cost:   $   1.51         $   0.75         $   0.34
  436.     (press any key to continue...)
  437.  
  438.     USING TTIME IN THE FILESIZE MODE:
  439.  
  440.          Again, you can specify the file size to estimate for, by typing
  441.     in the size following the TTIME command, but BEFORE you press the
  442.     <enter> key.  An example of this method of operation:
  443.  
  444.     (Example Four:  File Size Mode)
  445.  
  446.     C>ttime 47169
  447.                 TTIME Version 2.0   Copyright (c) 1991 by RGH Software
  448.               Unregistered Evaluation Copy - Did you FORGET to register?
  449.  
  450.     File: (Size = 47169)                       Size:       47,169
  451.  
  452.     Protocol/Time:      1200 bps         2400 bps         9600 bps
  453.      XMODEM            7 min  10 sec    3 min  35 sec    0 min  53 sec
  454.      YMODEM            7 min   4 sec    3 min  32 sec    0 min  53 sec
  455.      CIS B+/ZMODEM     7 min   1 sec    3 min  30 sec    0 min  52 sec
  456.     Estimated Cost:   $   1.51         $   0.75         $   0.34
  457.     (press any key to continue...)
  458.  
  459.     TTIME'S HELP MODE:
  460.  
  461.          Should you ever lose your documentation, or forget how TTIME
  462.     works, simply type the following:
  463.  
  464.               TTIME /H <enter>
  465.  
  466.                    - or -
  467.               TTIME /? <enter>
  468.  
  469.     and TTIME will show you a little help screen to remind you how it
  470.     works.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.       June 1, 1992                                                   Page 6
  481.  
  482.  
  483.  
  484. TTIME Version 2.0                                     User Documentation
  485.  
  486.     INSTALLING TTIME WITH YOUR TERMINAL PACKAGE:
  487.  
  488.          This is where my detailed instructions begin to falter.  You see,
  489.     there are literally dozens of popular terminal software packages out
  490.     there, and each of them has their own little idiosyncracies on how
  491.     (and even IF) they'll allow you to use external programs (programs
  492.     outside of the terminal package).
  493.  
  494.          Here, I can only offer some very general guidelines on how you
  495.     might be able to use TTIME with your software package.  I've listed
  496.     them in order of most preferable to least preferable.
  497.  
  498.          You should refer to the documentation that came with your
  499.     terminal package to see which of these methods it will support.  If
  500.     you are in doubt, go ahead and try each method in the order listed.
  501.     This trial and error approach shouldn't damage anything (but don't
  502.     blame me if it does!) and you may find a way that works well for you.
  503.  
  504.          I would request that you let me know (either when you register
  505.     your TTIME program, or by CompuServe Mail otherwise) how you got it to
  506.     work with your terminal software.  As I get hints and tips from users
  507.     on how they got it to work, I'll continue to update this section with
  508.     the solutions I get.  So far, only a few users have told me how they
  509.     got it to work.
  510.  
  511.          GENERAL SUGGESTION #1 - If your terminal package supports the
  512.     addition of external programs by using a 'hot key' (you press a key
  513.     combination to call the program) this would be the best approach.
  514.  
  515.          GENERAL SUGGESTION #2 - If your terminal package allows you to
  516.     define an external program such as a text editor, you might want to
  517.     consider using this approach.  This, of course, will mean that you
  518.     won't be able to use a text editor while using your terminal package.
  519.     Among the software packages I've recieved tips on that support this
  520.     option are:  Crosstalk-XVI, Mirror and Mirror II.
  521.  
  522.          GENERAL SUGGESTION #3 - Some terminal packages will let you
  523.     install an 'external file transfer protocol' (that is, a program to
  524.     send and receive files by a means that your software doesn't
  525.     ordinarily support).  You can add TTIME to your list of 'external
  526.     protocols' and see if this works.  Although I haven't heard of a case
  527.     where this DOES work, I have been told that Telix will let you define
  528.     TTIME as an external protocol, but then adds a bunch of junk
  529.     characters following the TTIME command and you cannot get an estimate
  530.     using this method.
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.       June 1, 1992                                                   Page 7
  544.  
  545.  
  546.  
  547. TTIME Version 2.0                                     User Documentation
  548.  
  549.          GENERAL SUGGESTION #4 - Most terminal packages will allow you to
  550.     press a key combination that allows you to enter a command to run from
  551.     the DOS command line.  You can press this key combination, then enter
  552.     the TTIME command (and the file name or file size if you like) and it
  553.     will run.  Telix supports this option with the Alt-V key combination
  554.     (press and hold the Alt key, then press the V key, then let both keys
  555.     go.  The bottom line will change to:  DOS Command C>  and you can then
  556.     type in the TTIME command).
  557.  
  558.          GENERAL SUGGESTION #5 - If all else fails, most terminal packages
  559.     will support a 'Shell to DOS', 'DOS Shell' or 'Command Prompt' option
  560.     where the terminal stops temporarily, loads the DOS program and lets
  561.     you type in a command just like normal.  When you are done, you must
  562.     type the word EXIT <enter> to return to your terminal software.  Among
  563.     the terminal packages that do suppport this are ProComm and ProComm
  564.     Plus (Alt-F4), Crosstalk-XVI, Mirror and Mirror II (press Esc, then
  565.     when the   Command?  prompt appears on the bottom of the screen type
  566.     ru <enter>  , and Telix (Alt-J).
  567.  
  568.          Among the software packages that TTIME just won't work with are:
  569.     CompuServe's Professional Connection and Information Manager programs,
  570.     older versions of Smartcom that came with many Hayes modems.  You may
  571.     find other software packages that it won't work with.  If so, please
  572.     try checking with me first, I may (by then) have a solution for you!
  573.  
  574.          Regarding WINDOWS:  You CAN get TTIME to run under Windows 2.x or
  575.     3.x by setting up a TTIME.PIF file that specifies that it must run
  576.     under a full-screen window and needs 256 K of memory to run.  For some
  577.     obstinate reason, TTIME won't operate in a window but must have the
  578.     full DOS screen to work.  I'm working on this one and hope to have a
  579.     more Windows-compliant version soon.
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.       June 1, 1992                                                   Page 8
  607.  
  608.  
  609.  
  610. TTIME Version 2.0                                     User Documentation
  611.  
  612.  
  613.     CHAPTER THREE:  Customizing TTIME
  614.  
  615.          One thing that we haven't mentioned yet is the display at the
  616.     bottom of the TTIME display (below the ZMODEM/CIS B+ line) where it
  617.     reports 'Estimated Cost'.  This is a new feature added in Version 2.0
  618.     - the ability of TTIME to estimate the cost to send or receive a file!
  619.  
  620.          The program, as delivered, estimates the cost for a file transfer
  621.     from CompuServe and assumes that you're making a local call (no toll
  622.     or long distance charges) and that you're dialing a CompuServe Gateway
  623.     number (not Tymnet or Telenet).
  624.  
  625.          You can, however, use the program TT20CUST.EXE to create a
  626.     'customized' copy of TTIME that will more accurately reflect your
  627.     actual costs for transfering files.
  628.  
  629.          In fact, you could easily create several 'customized' versions,
  630.     one for each pay-per-hour or long distance BBS you call, and get
  631.     really accurate estimates for all the calls you make!
  632.  
  633.          Let's figure out how to customize TTIME so it supports the
  634.     following:
  635.  
  636.          You call the BIG-PC BBS which charges $5.00 per hour for 1200 or
  637.     2400 bps access and $9.50 per hour for 9600 bps access.  It's a long
  638.     distance call for you, and Bell tells you that the approximate cost
  639.     for a call from your home to the BIG-PC BBS is about 25 cents per
  640.     minute.
  641.  
  642.          First, you need to calculate the 'per-minute' cost for these
  643.     calls.  At 1200 and 2400 bps, the cost is $5.00 per hour which
  644.     translates to about 8.3 cents per minute ($5.00 per hour divided by 60
  645.     minutes).  Add to that 8.3 cents the 25 cents per minute for the phone
  646.     call and you get 33.3 cents per minute.  At 9600 bps, the cost is
  647.     $9.50 per hour which translates to about 15.8 cents per minute ($9.50
  648.     per hour divided by 60 minutes).  Add to that 15.8 cents the 25 cents
  649.     per minute for the phone call and you get 39.8 cents per minute.
  650.  
  651.          TT20CUST needs to have the figures given to it in the format:
  652.  
  653.               a.bbb
  654.  
  655.     where the cost is dollars (a), followed by a decimal point (.), then
  656.     by cents and tenths of a cent (bbb).  In our example, there are no
  657.     dollars per minute, so that'd be a zero (0), followed by a decimal
  658.     point and the approximate cost we figured.  So, for 1200 and 2400 bps
  659.     access, you'd use the figure:
  660.  
  661.               0.333
  662.  
  663.     and for 9600 bps access, the figure:
  664.  
  665.               0.398
  666.  
  667.  
  668.  
  669.       June 1, 1992                                                   Page 9
  670.  
  671.  
  672.  
  673. TTIME Version 2.0                                     User Documentation
  674.  
  675.     since TTIME's estimates are 'rounded off' to the nearest tenth of a
  676.     cent.  You'd write these numbers down as you'll need them in a minute.
  677.  
  678.          I next recommend copying the TTIME20.BIN and TT20CUST.EXE files
  679.     onto a blank, formatted floppy diskette.  I recommend that you do this
  680.     for several reasons:
  681.  
  682.          1)  If (heaven forbid) something goes wrong in the customizing
  683.              process, all you've lost is a floppy disk that you can re-
  684.              format;
  685.  
  686.          2)  This avoids the inevitable 'OOPS!  I accidentally destroyed
  687.              my ONLY copy of the unmodified TTIME.EXE program!' error
  688.              that'll send you screaming back to me for another copy;
  689.  
  690.          3)  You should NEVER perform a patching or customizing job on
  691.              the disk you bought, nor on your hard drive, JUST IN CASE!
  692.  
  693.          If you fail to heed my warning, probably nothing bad will happen.
  694.     But, I want to warn you ahead of time that if it does, you can't blame
  695.     me because I told you so!
  696.  
  697.          After you've done this, you start the customizing program by
  698.     making the disk that TTIME20.BIN and TT20CUST.EXE are on the 'current
  699.     drive' then the command TT20CUST.  Assuming you've heeded my warning
  700.     and copied the files onto your A: floppy drive, you'd type the
  701.     following:
  702.  
  703.               A:   <enter>
  704.               TT20CUST   <enter>
  705.  
  706.          First, the customizing program will make sure that there isn't a
  707.     copy of TTIME.EXE already on your disk.  If it finds one, it'll beep
  708.     and warn you that it's about to destroy that copy.  IF THIS HAPPENS,
  709.     MAKE DOUBLE, DOUBLE SURE that this ISN'T your ONLY COPY before you
  710.     press the 'Y' key to continue and destroy it!  If you press ANY OTHER
  711.     KEY EXCEPT THE 'Y' KEY, the customize program will stop dead in its
  712.     tracks and you can then rename or move the current copy of TTIME.EXE
  713.     so it'll be safe.
  714.  
  715.          Next, the customizing program will check to be sure you have the
  716.     proper copy of TTIME20.BIN to customize.  If you DON'T, it'll beep at
  717.     you, warn you that your copy of TTIME20.BIN is not correct and abort
  718.     the customizing process.  This is for your own safety, since this
  719.     error will only happen if someone has modified the TTIME20.BIN program
  720.     without my permission or if you're trying to use the customize program
  721.     on the wrong version of TTIME.
  722.  
  723.          If all else has been OK to this point, you'll be asked to enter
  724.     the new cost amounts for 1200/2400 bps and 9600 bps estimates.  This
  725.     is where those two numbers you wrote down (0.333 for 1200/2400 bps and
  726.     0.398 for 9600 bps) will be used.  Be sure that you enter them in the
  727.     proper order.
  728.  
  729.  
  730.  
  731.  
  732.       June 1, 1992                                                   Page 10
  733.  
  734.  
  735.  
  736. TTIME Version 2.0                                     User Documentation
  737.  
  738.          Finally, after checking the numbers you've entered (to be sure
  739.     that they match the necessary format exactly), and confirming that
  740.     you've entered the proper amounts (it'll ask if it can proceed; if you
  741.     press 'Y' it will customize the program, any other key will let you
  742.     re-enter the amounts again), you wind up with a customized copy of
  743.     TTIME.EXE that reflects what it costs YOU to transfer files to and
  744.     from the BIG-PC BBS, including long distance charges!
  745.  
  746.          You could now rename this copy of TTIME.EXE to something else
  747.     (like maybe TTBIG.EXE) and use it to estimate your costs in calling
  748.     the BIG-PC BBS.  Please note that if you customize a copy of TTIME,
  749.     you should NOT give copies of it to anyone else.  Distributing
  750.     modified copies of TTIME violates my copyright, and is likely to make
  751.     me very unhappy when I find out about it!
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.       June 1, 1992                                                   Page 11
  796.  
  797.  
  798.  
  799. TTIME Version 2.0                                     User Documentation
  800.  
  801.     CHAPTER FOUR:  Registration and Customer Support
  802.  
  803.          A lot of the information in this section is duplicated in the
  804.     REGISTER.DOC file, but I want to lightly touch on why you must
  805.     register your copy of TTIME if you want to continue to use it.
  806.  
  807.          TTIME is not free software.  TTIME is a Shareware product (please
  808.     read the SHR-WARE.DOC file for more details) and you are required to
  809.     pay a registration fee of $10 if you find that you're still using
  810.     TTIME after a reasonable evaluation period (say, 30 days).
  811.  
  812.          Why should you pay?  Well:
  813.  
  814.          1)  Payment is required by law if you are going to keep using it.
  815.  
  816.          2)  I've put many hundreds of hours into developing, testing and
  817.              improving the TTIME package from its humble beginnings to the
  818.              product you see now.  Payment for my labor is only fair.
  819.  
  820.          3)  A software package purchased in a store requires that you
  821.              make payment up front, BEFORE you even know that the soft-
  822.              ware will work the way you want it.  With Shareware, you
  823.              get a good trial at home first, before paying for the soft-
  824.              ware.
  825.  
  826.          4)  Shareware depends on your honesty.  If no one registers a
  827.              shareware program, then the author will likely discontinue
  828.              improving and supporting that program.  It's up to you and
  829.              your registrations to keep TTIME (and other shareware pro-
  830.              grams) healthy and growing.
  831.  
  832.          Registered Users, in exchange for their $10 registration fee,
  833.     will recieve:
  834.  
  835.          1)  My most heartfelt gratitude, and the undying appreciation
  836.              of my wife (who's put up with me in front of the keyboard
  837.              as late as 4:30am working on this release!)
  838.  
  839.          2)  The latest version of TTIME, with your registration number
  840.              permanently emblazoned on it (so all who see it may envy
  841.              you)
  842.  
  843.          3)  FREE UPDATES!  All Registered Users will receive the next
  844.              major release and/or bug fix version free of charge.  This
  845.              means, if I release a new version followed by a bug fix
  846.              version (or vice versa), you'll receive two free update
  847.              disks at no additional charge!
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.       June 1, 1992                                                   Page 12
  859.  
  860.  
  861.  
  862. TTIME Version 2.0                                     User Documentation
  863.  
  864.          4)  FREE COMPUSERVE TIME!  By special arrangement with Compu-
  865.              Serve, ASP authors are allowed to offer to registered users
  866.              an offer for a FREE CompuServe IntroPak, with your very own
  867.              CompuServe ID number, password, and $15 in FREE CONNECT TIME
  868.              that you can use to explore the CompuServe network (or, for
  869.              that matter, to visit the ASP Forum for help, hints, support
  870.              and other great ASP member product information).
  871.  
  872.          Furthermore, Registered Users can obtain preferential support of
  873.     TTIME through several sources:
  874.  
  875.           - on CompuServe, by addressing CompuServe Mail to me at my
  876.             User ID (76670,110)
  877.  
  878.           - By U.S. Mail, at the address shown on the registration form
  879.  
  880.           - By calling either VOICE or FAX to (616) 832-3328.  Voice calls
  881.             will be taken only from 10am to 3pm Eastern time, fax calls
  882.             may be placed 24 hours a day.
  883.  
  884.          For Disk Vendors, User Groups, SIGs, Software Libraries and BBSs
  885.     that also wish to support the Shareware concept (and TTIME), there is
  886.     a program called the 'Software Update Program' where for a payment of
  887.     $10 you'll be entitled to FREE updates of all Shareware programs
  888.     offered by RGH Software.
  889.  
  890.          ASP Associate Members in good standing (Vendor and BBS) need not
  891.     pay this $10 fee - you'll automatically be entered in the Software
  892.     Update Program.
  893.  
  894.          For non-ASP members, I cannot guarantee that you'll receive any
  895.     updates or future releases.  In my last disk mailing, fewer than 10%
  896.     of all the vendors, BBS's and libraries I mailed disks to even
  897.     bothered to send a letter or postcard back acknowledging that they got
  898.     the diskette in the first place!  With the cost of mailings increasing
  899.     about every year or so, I find that I can no longer afford to send
  900.     disks to people who don't show any interest in my products.
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.       June 1, 1992                                                   Page 13
  919.  
  920.  
  921.  
  922. TTIME Version 2.0                                     User Documentation
  923.  
  924.     CHAPTER FIVE:  Acknowledgements and Revision History
  925.  
  926.          IBM-PC is a trademark of IBM Corporation
  927.  
  928.          PC-DOS is a trademark of IBM Corporation
  929.  
  930.          MS-DOS is a trademark of Microsoft Inc.
  931.  
  932.          ASP is a trademark of the Association of Shareware Professionals
  933.  
  934.          CompuServe is a service of H&R Block, Inc.
  935.  
  936.          America On-Line is a service of Quantum Information Services.
  937.  
  938.          All telecommunications packages mentioned in the installation
  939.     section are hereby acknowledged as trademark, copyright or owned by
  940.     their respective companies.
  941.  
  942.  
  943.         TTIME was programmed using Microsoft QuickBASIC version 4.5 and
  944.     various support modules.
  945.  
  946.          TTIME is Copyright (c) 1991 by RGH Software.  All Rights
  947.     Reserved.
  948.  
  949.  
  950.     REVISION HISTORY:
  951.  
  952.          Version 1.0 - Original release in early 1990.  Supported the
  953.     XMODEM and YMODEM file transfer protocols, 1200/2400/9600 bps
  954.     operation.
  955.  
  956.          Version 1.1 - Released in March 1990, added support for the
  957.     ZMODEM and CompuServe B+ file transfer protocols.
  958.  
  959.          Version 1.2 - Died in beta testing.  Never actually released to
  960.     the general public.
  961.  
  962.          Version 1.3 - Released in late 1990.  Since many users were
  963.     complaining that TTIME routinely underestimated transfer times, I made
  964.     it assume that file transfers would be less efficient.
  965.  
  966.          Version 1.3a - Also released in late 1990, this is a bug fix that
  967.     repairs a rounding error reported by user Rip Strautman.
  968.  
  969.          Version 2.0 - Released June of 1992; the version you now have in
  970.     front of you.
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.       June 1, 1992                                                   Page 14
  982.  
  983. 
  984.