home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 87.img / TELEDISK.ZIP / TELEDISK.DOC < prev   
Text File  |  1988-05-17  |  44KB  |  1,081 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                       TELEDISK - A DISKETTE TRANSMITTAL PROTOCOL
  21.  
  22.  
  23.                                Version 1.02 - May, 1988
  24.  
  25.  
  26.                          Copyright 1988, C. P. Guzis and Sydex
  27.                                  153 North Murphy Ave.
  28.                                  Sunnyvale, CA  94086
  29.                                     (408) 739-4866
  30.  
  31.                                   All Rights Reserved
  32.  
  33.  
  34.                                          NOTICE
  35.  
  36.                 THIS IS NOT FREE  SOFTWARE!    If  you  paid  a  "public
  37.                 domain"  vendor for this program,  you paid for the ser-
  38.                 vice of copying the program, and not for the program it-
  39.                 self.   Rest assured  that  nothing  ever  gets  to  the
  40.                 originators  of this product from such a sale.   You may
  41.                 evaluate this product,  but if you make use of  it,  you
  42.                 must register your copy.
  43.  
  44.                 We  offer  several  inducements  to you for registering.
  45.                 First of all,  you receive the most up-to-date  copy  of
  46.                 the  program that we have - and we do update the product
  47.                 on a regular  basis.    You  also  receive  support  for
  48.                 TELEDISK  -  which can be quite valuable at times.   And
  49.                 finally,  we have a few utilities not  included  in  the
  50.                 evaluation package.   Make no mistake, however - this is
  51.                 a  fully  functional  version  of   TELEDISK   and   not
  52.                 "crippled" in any way.
  53.  
  54.                 To  register,  just  send a check or a company P.O.  for
  55.                 $25.00,  together with your name and  address  and  some
  56.                 reference  to TELEDISK (we need to know what you are or-
  57.                 dering) to -
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                          SYDEX
  68.                                  153 North Murphy Ave.
  69.                                   Sunnyvale, CA  94086
  70.  
  71.                 You'll receive your  registered  copy  of  TELEDISK  and
  72.                 printed documentation in about 2 weeks.
  73.  
  74.  
  75.  
  76.                                    ADDITIONAL NOTICES
  77.  
  78.                 This  is  "user-supported"  software.   You  are  hereby
  79.                 granted a license by Sydex to distribute this evaluation
  80.                 copy of TELEDISK and its documentation,  subject to  the
  81.                 following conditions:
  82.  
  83.                      1.  TELEDISK  may  be  distributed  freely  without
  84.                      charge in its evaluation form only.
  85.  
  86.                      2.  TELEDISK may not be sold,  licensed,  or a  fee
  87.                      charged  for its use.   If a fee is charged in con-
  88.                      nection with TELEDISK,  it must cover the  cost  of
  89.                      copying  or dissemination only.   Such charges must
  90.                      be clearly identified as such  by  the  originating
  91.                      party.  Under no circumstances may the purchaser be
  92.                      given the impression that he is buying TELEDISK it-
  93.                      self.
  94.  
  95.                      3.  TELEDISK  must be presented as a complete unit,
  96.                      including this documentation.  Neither TELEDISK nor
  97.                      its documentation may be amended or altered in  any
  98.                      way.
  99.  
  100.                 Any  other  use or distribution of TELEDISK is expressly
  101.                 forbidden without the written consent of SYDEX.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                    Table of Contents
  129.  
  130.  
  131.              TELEDISK -- AT A GLANCE......................................1
  132.  
  133.              WHAT IS TELEDISK AND WHAT DOES IT DO?........................2
  134.  
  135.              GETTING STARTED WITH TELEDISK................................3
  136.  
  137.              COPYING FROM DISKETTE TO A FILE..............................4
  138.  
  139.              COPYING FROM A FILE TO A DISKETTE............................6
  140.  
  141.              COPYING FROM A DISKETTE TO A DISKETTE........................8
  142.  
  143.              THE OPERATING DISPLAY........................................8
  144.  
  145.              ACCESSING OTHER DISK DRIVES.................................10
  146.  
  147.              STRUCTURE OF THE TELEDISK TDn FILES.........................11
  148.  
  149.              PROBLEMS AND LIMITATIONS....................................13
  150.  
  151.              REVISION RECORD.............................................13
  152.  
  153.              OTHER PRODUCTS BY SYDEX.....................................14
  154.  
  155.  
  156.  
  157.  
  158.            Index.........................................................15
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.                                            i
  182.  
  183.  
  184.  
  185.  
  186.  
  187.            TELEDISK -- AT A GLANCE
  188.  
  189.                 WHAT IT IS --
  190.  
  191.                 TELEDISK is a utility which will  convert  any  diskette
  192.                 into a file and vice-versa.   The diskette need not be a
  193.                 DOS diskette;  certain types  of  "copy-protected"  dis-
  194.                 kettes are also handled.  The result is an exact copy of
  195.                 the original diskette.  The file produced by TELEDISK is
  196.                 compressed  to  minimal  size  and  is  handled  by most
  197.                 telecommunications file  transfer  protocols,  including
  198.                 Kermit and XMODEM.
  199.  
  200.  
  201.                 HOW TO USE IT --
  202.  
  203.                 The  program file is named TELEDISK.EXE;  no other files
  204.                 are needed.  TELEDISK is menu-driven; to begin,  use the
  205.                 DOS command -
  206.  
  207.                      TELEDISK
  208.  
  209.                 If the display is unreadable, use -
  210.  
  211.                      TELEDISK M
  212.  
  213.                 Follow the directions on the menus; press the F1 key for
  214.                 online  help.    The ESCape key is used to terminate the
  215.                 current activity.  If you are using a diskette-only sys-
  216.                 tem,  you should have one or two blank,  formatted  dis-
  217.                 kettes  to  hold  output  file  which TELEDISK produces.
  218.                 It's good practice to  write-protect  the  source  (ori-
  219.                 ginal) diskette when you are making a file from it using
  220.                 TELEDISK.
  221.  
  222.                 All  TELEDISK files have an filename extension (type) of
  223.                 TD0 through TD9.
  224.  
  225.  
  226.            For detailed information, consult the rest of this document.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                         Page 1
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.            WHAT IS TELEDISK AND WHAT DOES IT DO?
  248.  
  249.            Sydex develops software and we also carry out support  activities
  250.            for  that  software.   Part of any "bug hunting" operation is the
  251.            task of duplicating problems.   And part of duplicating  problems
  252.            is obtaining the necessary supporting materials.
  253.  
  254.            If "supporting materials" means only one or two files,  obtaining
  255.            them is easy - just upload them via a modem and a  communications
  256.            package.   If, however, the supporting material takes the form of
  257.            many files in several directories, getting the information over a
  258.            telephone line tends to be quite an operation.   Our only  viable
  259.            response  in  such  a  case  had been "Can you Fed Ex it to us?".
  260.            Clearly, something better was warranted.
  261.  
  262.            And so TELEDISK was born.  This utility allows you to take a dis-
  263.            kette and convert it into a file.   You can  then  transmit  this
  264.            file  using  your  favorite  communications program and again use
  265.            TELEDISK to reconstruct an exact copy of the diskette  from  that
  266.            file.  No muss, no fuss - and very easy to use.
  267.  
  268.            Some applications immediately suggest themselves:
  269.  
  270.                 *     "No  brainer"  file transmission.   Just send the whole
  271.                      diskette without worrying about getting all  the  right
  272.                      files.
  273.  
  274.                 *     Preservation of disk directory entries,  including hid-
  275.                      den,  read-only and system files,  as  well  as  volume
  276.                      labels and directories.
  277.  
  278.                 *     Transmit diskettes complete with boot sectors.
  279.  
  280.                 *     Transfer  "foreign" diskette formats - an answer to how
  281.                      to send a diskette from,  say,  a Wang  word  processor
  282.                      over the phone lines.
  283.  
  284.                 *     If diskette image files are placed on a hard disk, they
  285.                      can be saved on a streamer tape backup unit.
  286.  
  287.                 *     Now,  this  one isn't obvious...   But,  since TELEDISK
  288.                      makes a file from a diskette,  this file can be used to
  289.                      obtain  data  from  foreign  formats.   The layout of a
  290.                      TELEDISK output file will be presented later on in this
  291.                      document.
  292.  
  293.            Something needs to be said about "copy protected" diskettes.   It
  294.            is  not  the  intent  of Sydex or TELEDISK to encourage copyright
  295.            violation by making it easier to transmit "copy  protected"  dis-
  296.            kettes.    It  is true that TELEDISK will handle a number of copy
  297.            protection schemes,  resulting in a faithful reproduction of  the
  298.            original; however, this is a necessary "side effect" of the basic
  299.  
  300.                                         Page 2
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.            operation of TELEDISK.  Please note that most commercial software
  308.            agreements  do  not  authorize  you  to  redistribute copyrighted
  309.            material to third parties, and that by doing so,  you may be held
  310.            in violation of U.S.  copyright law,  as well as being liable for
  311.            civil damages.
  312.  
  313.            TELEDISK has a number of interesting features:
  314.  
  315.                 *     The ability to copy one or both sides of a diskette.
  316.  
  317.                 *     The ability to copy just the diskette sectors allocated
  318.                      by DOS.
  319.  
  320.                 *     Optional use of an "advanced"  data  compression  algo-
  321.                      rithm (Lempel-Zev) to produce minimal file size.
  322.  
  323.                 *     Automatic "splitting" of files across several diskettes
  324.                      if necessary.  This is essential for diskette-only sys-
  325.                      tems.
  326.  
  327.                 *     Menu-driven with online help screens.
  328.  
  329.                 *     Support  of low-density (180K and 360K) formats as well
  330.                      as high-density (1.2M and 1.44M) formats.
  331.  
  332.            To use TELEDISK, you'll need at least 256K of memory and one dis-
  333.            kette drive.   For high-density diskette support,  you'll need an
  334.            PC AT-type machine or an upper-level IBM PS/2 system.
  335.  
  336.  
  337.            GETTING STARTED WITH TELEDISK
  338.  
  339.            The  whole of TELEDISK is contained in the file TELEDISK.EXE;  no
  340.            other files are required.  To start TELEDISK, simply enter
  341.  
  342.                      TELEDISK
  343.  
  344.            at the DOS command prompt.   If your computer has a color display
  345.            adapter, TELEDISK will make use of color in its displays.  If you
  346.            have a monochrome display connected to a CGA or EGA, you'll prob-
  347.            ably want to suppress color selection by invoking TELEDISK with
  348.  
  349.                      TELEDISK M
  350.  
  351.            After  a sign-on display,  you'll be presented with the following
  352.            opening menu:
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                         Page 3
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.            +------------------- Teledisk Ver. 1.0 -------------------------+
  368.            |            Copyright 1988, Sydex, C. P. Guzis                 |
  369.            |             Press ESCape to exit, F1 for help                 |
  370.            +---------------------------------------------------------------+
  371.            +--------------------- OPERATOR MESSAGES -----------------------+
  372.            | Select Function - ESCape to quit, F1 for help                 |
  373.            +---------------------------------------------------------------+
  374.            +---------------------------------------------------------------+
  375.            |                                                               |
  376.            |                        MAIN MENU                              |
  377.            |                                                               |
  378.            |                                                               |
  379.            | Select function with the cursor keys.  ENTER  confirms your   |
  380.            | choice and goes to next menu. F1 gets help, ESCape exits      |
  381.            | to DOS.                                                       |
  382.            |                                                               |
  383.            |                                                               |
  384.            |   Copy Disk to File    Copy File to Disk    Copy Disk to Disk |
  385.            |                                                               |
  386.            |                                                               |
  387.            |                                                               |
  388.            +---------------------------------------------------------------+
  389.  
  390.            The actual display will appear to be slightly different from that
  391.            which is presented here;  the restrictions of a printed  page  do
  392.            not allow entirely accurate reproduction.
  393.  
  394.            Observe  that  the F1 key is always the key to press to get help.
  395.            In addition,  the ESCape key will generally terminate the current
  396.            operation and return to the previous display.
  397.  
  398.            To  make a file from a diskette,  use the cursor keys to position
  399.            the blinking area to "Copy Disk to File" and press the ENTER key.
  400.            To recreate a diskette from a file,  use the cursor keys to posi-
  401.            tion the blinking area to "Copy File to Disk" and press the ENTER
  402.            key.
  403.  
  404.            The  choice "Copy Disk to Disk" is the equivalent of a "Copy Disk
  405.            to File" followed by a "Copy File to Disk" using the  same  file;
  406.            no file is actually created, however.
  407.  
  408.            After selecting the function to be performed by TELEDISK,  a sub-
  409.            menu will  be  displayed  for  selection  of  various  additional
  410.            operating  parameters.    Each sub-menu and the operation of each
  411.            function are discussed in the sections which follow.
  412.  
  413.  
  414.            COPYING FROM DISKETTE TO A FILE
  415.  
  416.            If the "Copy Disk to File" operation was selected,  a second menu
  417.            appears:
  418.  
  419.  
  420.                                         Page 4
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.            +---------------------- Teledisk Ver. 1.0 ----------------------+
  428.            |            Copyright 1988, Sydex, C. P. Guzis                 |
  429.            |             Press ESCape to exit, F1 for help                 |
  430.            +---------------------------------------------------------------+
  431.            +--------------------- OPERATOR MESSAGES -----------------------+
  432.            | Select Function - ESCape to quit, F1 for help                 |
  433.            +---------------------------------------------------------------+
  434.            +---------------------------------------------------------------+
  435.            |                     COPY DISK TO FILE                         |
  436.            |                                                               |
  437.            | Select choices with cursor keys.  Move between lines with up  |
  438.            | and down keys.  ENTER begins execution.  F1 gets help, ESCape |
  439.            | goes back to the opening menu.                                |
  440.            |                                                               |
  441.            |    Source Diskette Drive               A:  B:  C:  D:         |
  442.            |                                                               |
  443.            |    Check Diskette for Data       Both Sides  One Side         |
  444.            |                                                               |
  445.            |    Read Which Sectors              All  DOS Allocated         |
  446.            |                                                               |
  447.            |    Data compression method         Normal    Advanced         |
  448.            |                                                               |
  449.            |                                                               |
  450.            +---------------------------------------------------------------+
  451.  
  452.            Source Diskette Drive refers to where the diskette data is coming
  453.            from.  If you've added a diskette drive to your computer and it's
  454.            not  addressed  by  the  drive  letters A-D,  consult the section
  455.            titled "Accessing Other Diskette Drives".
  456.  
  457.            The drive to be used to read the source diskette is selected with
  458.            the right- and left-arrow cursor keys.   This drive may  also  be
  459.            used for the resulting output file - a prompt will be issued when
  460.            diskettes need to be switched.
  461.  
  462.            Check Diskette for Data has meaning only if the diskette is not a
  463.            DOS  diskette  and "DOS Allocated" under "Read Which Sectors" has
  464.            been selected.   If "Both Sides" is selected,  both sides of  the
  465.            diskette  are  inspected for data.   If only one side is found to
  466.            contain data, then only that side is examined.   If "One Side" is
  467.            selected,  the  second  surface  of  the diskette will not be ex-
  468.            amined.   This feature is useful when a single-sided diskette has
  469.            been copied to a diskette which has had both sides formatted.
  470.  
  471.            Read Which Sectors determines how the source diskette data is in-
  472.            terpreted.   If "All" is selected,  no interpretation of the dis-
  473.            kette is attempted,  and all sectors on the diskette are recorded
  474.            verbatim.    If  "DOS Allocated" is selected,  an attempt will be
  475.            made to recognize the diskette as having one of the standard  DOS
  476.            formats.   If the diskette does,  in fact, contain a recognizable
  477.            DOS file structure, then only those sectors actually belonging to
  478.            data files will be recorded.
  479.  
  480.                                         Page 5
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.            Data Compression Method determines  how  much  effort  should  be
  489.            spent  "squeezing"  the diskette file to its smallest representa-
  490.            tion.   "Normal" causes simple repeated-byte  compression  to  be
  491.            used and operates quite rapidly.  "Advanced" compression make use
  492.            of  Lempel-Zev  compression in addition to repeated-byte compres-
  493.            sion.   Advanced compression is somewhat slower than normal  com-
  494.            pression,  particularly  on  XT-class  computers,  but  typically
  495.            results in an output file size 30-40 percent  smaller  than  that
  496.            achieved with normal compression only.
  497.  
  498.            After the appropriate selections have been made, the ENTER key is
  499.            pressed  and  a  prompt appears for the name of the file to which
  500.            the diskette information will be written.   If the file name sup-
  501.            plied contains an extension, that extension will be ignored.  All
  502.            TELEDISK files are initially created with an extension of TD0.
  503.  
  504.            If  an  output file is created on a diskette and the diskette has
  505.            insufficient room to hold the entire initial TD0  file,  TELEDISK
  506.            prompts  for  another  diskette and creates a new file with a TD1
  507.            name extension.   This process  continues from diskette  to  dis-
  508.            kette until the Copy Disk to File operation is complete.
  509.  
  510.            If such a multi-volume file is used when a File to Disk operation
  511.            is performed, TELEDISK will prompt for each diskette as it is re-
  512.            quired.   If all volumes were copied to a hard disk, no prompting
  513.            is performed.
  514.  
  515.            After the file name has been entered and TELEDISK  has  succeeded
  516.            in creating the file,  the operating display appears and TELEDISK
  517.            proceeds with the copy operation.
  518.  
  519.  
  520.            COPYING FROM A FILE TO A DISKETTE
  521.  
  522.            If Copy File to Disk is selected on the main menu,  the following
  523.            display is presented:
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.                                         Page 6
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.            +---------------------- Teledisk Ver. 1.0 ----------------------+
  549.            |            Copyright 1988, Sydex, C. P. Guzis                 |
  550.            |             Press ESCape to exit, F1 for help                 |
  551.            +---------------------------------------------------------------+
  552.            +--------------------- OPERATOR MESSAGES -----------------------+
  553.            | Select Function - ESCape to quit, F1 for help                 |
  554.            +---------------------------------------------------------------+
  555.            +---------------------------------------------------------------+
  556.            |                                                               |
  557.            |                     COPY FILE TO DISK                         |
  558.            |                                                               |
  559.            | Select choice with the cursor keys.  ENTER begins execution.  |
  560.            | F1 gets help, ESCape goes back to the opening menu.           |
  561.            |                                                               |
  562.            |                                                               |
  563.            |    Destination Diskette Drive              A:  B:  C:  D:     |
  564.            |                                                               |
  565.            |     Enter source file name or ENTER for list -                |
  566.            |                                                               |
  567.            +---------------------------------------------------------------+
  568.  
  569.            Here,  only  the  drive to receive the diskette copy is selected.
  570.            Once ENTER is pressed,  a prompt for the name of the source  file
  571.            is displayed.  A file extension of TD0 is assumed by TELEDISK for
  572.            all  files.   If the ENTER key is pressed in lieu of a file name,
  573.            the following display appears:
  574.  
  575.            +---------------------- FILE SELECTION -------------------------+
  576.            |                                                               |
  577.            | Select file name with the cursor keys.  Press ENTER to        |
  578.            | confirm your selection.  Press F2 to specify a new drive/path.|
  579.            | ESCape exits without selecting; F1 gets help.                 |
  580.            |                                                               |
  581.            |          Current path: C:\WORKDIR                             |
  582.            |                                                               |
  583.            |                                                               |
  584.            |      ONE      TWO      THREE    FOUR                          |
  585.            |                                                               |
  586.            |                                                               |
  587.            |                                                               |
  588.            +---------------------------------------------------------------+
  589.  
  590.            This display shows all files with the extension  TD0  and  allows
  591.            selection  of one by use of the cursor keys.   Pressing the ENTER
  592.            key confirms the selection and recreation of the original  source
  593.            diskette will begin.   If the F2 key is pressed, a prompt appears
  594.            for the name of a new drive and directory for this display.    If
  595.            ESCape is pressed, the original Copy File to Disk display will be
  596.            shown.
  597.  
  598.  
  599.  
  600.                                         Page 7
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.            COPYING FROM A DISKETTE TO A DISKETTE
  608.  
  609.            As  mentioned  earlier,  this option is the logical equivalent of
  610.            performing a Disk to File operation,  followed by a File to Disk.
  611.            However,  no  intermediate  file  is created.   The menu for this
  612.            function appears as follows:
  613.  
  614.            +---------------------- Teledisk Ver. 1.0 ----------------------+
  615.            |            Copyright 1988, Sydex, C. P. Guzis                 |
  616.            |             Press ESCape to exit, F1 for help                 |
  617.            +---------------------------------------------------------------+
  618.            +--------------------- OPERATOR MESSAGES -----------------------+
  619.            | Select Function - ESCape to quit, F1 for help                 |
  620.            +---------------------------------------------------------------+
  621.            +---------------------------------------------------------------+
  622.            |                                                               |
  623.            |                     COPY DISK TO DISK                         |
  624.            |                                                               |
  625.            | Select choices with the cursor keys.  Move between lines with |
  626.            | cursor up and down keys.  ENTER begins execution.  F1 gets    |
  627.            | help, ESCape goes back to the opening menu.                   |
  628.            |                                                               |
  629.            |    Source Diskette Drive                   A:  B:  C:  D:     |
  630.            |                                                               |
  631.            |    Destination Diskette Drive              A:  B:  C:  D:     |
  632.            |                                                               |
  633.            |    Check Diskette for Data           Both Sides  One Side     |
  634.            |                                                               |
  635.            |    Read Which Sectors                All  DOS Allocated       |
  636.            |                                                               |
  637.            |                                                               |
  638.            +---------------------------------------------------------------+
  639.  
  640.            Source Diskette Drive specifies which drive  is  to  contain  the
  641.            original  for  the  copy  operation;  Destination  Diskette Drive
  642.            specifies the drive to receive the copy.   The same drive may  be
  643.            selected for both;  TELEDISK will prompt for the correct diskette
  644.            when required.
  645.  
  646.            Check Diskette for Data and Read Which Sectors are  the  same  as
  647.            the  options of the same name described in Copy Disk to File ear-
  648.            lier.
  649.  
  650.  
  651.            THE OPERATING DISPLAY
  652.  
  653.            After  the  operating  function  and  its  parameters  have  been
  654.            selected, the following display appears:
  655.  
  656.  
  657.  
  658.  
  659.  
  660.                                         Page 8
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.            +---------------------- Teledisk Ver. 1.0 ----------------------+
  669.            |            Copyright 1988, Sydex, C. P. Guzis                 |
  670.            |             Press ESCape to exit, F1 for help                 |
  671.            +---------------------------------------------------------------+
  672.            +--------------------- OPERATOR MESSAGES -----------------------+
  673.            | Scanning Drive A:, Track 0                                    |
  674.            +---------------------------------------------------------------+
  675.  
  676.            |-+-+-+-+-|-+-+-+-+-|-+-+-+-+-|-+-+-+-+-|-+-+-+-+-|-+-+-+-+-|-+-+
  677.            0         10        20        30        40        50        60
  678.  
  679.            +-------- GENERAL INFO ---------++------ ANALYSIS INFO ---------+
  680.            |                               ||                              |
  681.            |                               ||                              |
  682.            |                               ||                              |
  683.            |                               ||                              |
  684.            |                               ||                              |
  685.            |                               ||                              |
  686.            |                               ||                              |
  687.            |                               ||                              |
  688.            +-------------------------------++------------------------------+
  689.  
  690.  
  691.            Notice  the  "thermometer"  at  about  the middle of the display.
  692.            TELEDISK uses a "bar" indicator as the operation proceeds to give
  693.            an idea of the progress of the operation.   The  numbers  on  the
  694.            "thermometer" correspond to diskette track numbers.   A 360K dis-
  695.            kette contains 40 tracks;  720K,  1.2M and 1.44M all  contain  80
  696.            tracks.  Thus, if the thermometer bar indicates 20 on a 1.2M dis-
  697.            kette, the operation is about one-quarter complete.
  698.  
  699.            All  prompts  for disk changes,  as well as general progress mes-
  700.            sages are displayed in the OPERATOR MESSAGES  window.    Messages
  701.            requiring action are displayed in high-intensity,  blinking char-
  702.            acters.
  703.  
  704.            The GENERAL INFO display tells what  was  discovered  during  the
  705.            course  of analyzing the diskette,  or from reading the file from
  706.            which a diskette is to be produced.   A note is made of the  fol-
  707.            lowing:
  708.  
  709.                 *     Single- or Double-sided diskette
  710.  
  711.                 *     Diskette density
  712.  
  713.                 *     Data compression method used
  714.  
  715.                 *     Sector address range on each side
  716.  
  717.  
  718.  
  719.  
  720.                                         Page 9
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.            The  ANALYSIS INFO display presents a running narration of opera-
  728.            tion.   The display scrolls as it becomes filled and  provides  a
  729.            track and side "tag" for each item of information displayed.
  730.  
  731.            When  the  selected copy operation is complete,  a prompt is dis-
  732.            played in the OPERATOR MESSAGES window.  Pressing any key at this
  733.            point will cause the opening menu to be displayed.
  734.  
  735.  
  736.            ACCESSING OTHER DISK DRIVES
  737.  
  738.            TELEDISK obtains the number of diskette drives from the  informa-
  739.            tion furnished by the computer's ROM BIOS.  How the ROM BIOS gets
  740.            this  information  depends  on  the  machine  type.    On XT-type
  741.            machines, the number of drives is set by two DIP switch positions
  742.            on the motherboard.   On AT-class machines,  the number of drives
  743.            is set via the SETUP program and stored in battery-backed RAM.
  744.  
  745.            A  computer  may have an added diskette drive that is not visible
  746.            to the ROM BIOS, but is accessed by a special device driver (most
  747.            commonly DRIVER.SYS).   In this case the ROM BIOS will return too
  748.            small a number for the total drive count.
  749.  
  750.            TELEDISK  may be informed of the total number of drives on a com-
  751.            puter by having this number specified on the command line.    For
  752.            example, a command of the form:
  753.  
  754.                      TELEDISK 3
  755.  
  756.            informs TELEDISK that three diskette drives are present.   Rather
  757.            than refer to them as A:,  B: and C:,  TELEDISK refers  to  these
  758.            drives by their physical unit numbers, or 0, 1, and 2.
  759.  
  760.            CAUTION  -- When specifying the number of drives do not allow the
  761.            source and destination of a copy  operation  to  share  the  same
  762.            unit!    TELEDISK  has  no certain way of determining which drive
  763.            letter (A:, B:, etc.) corresponds to a physical unit (0, 1, etc).
  764.            If you are  uncertain  about  your  operating  procedure,  write-
  765.            protect your source diskette!
  766.  
  767.            The  monochrome  display  option  may be specified along with the
  768.            number of drives by simply placing the "M" for monochrome and the
  769.            number of drives together:
  770.  
  771.                      TELEDISK 4M
  772.  
  773.            or alternately,
  774.  
  775.                      TELEDISK M4
  776.  
  777.  
  778.  
  779.  
  780.                                         Page 10
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.            STRUCTURE OF THE TELEDISK TDn FILES
  788.  
  789.            The first file of a TELEDISK series has,  as its file name exten-
  790.            sion, TD0.  A subsequent file will have the extension TD1, and so
  791.            on.
  792.  
  793.            Every TELEDISK data file has a header of the following form:
  794.  
  795.                 File Identification, 2 bytes, with a value of 'TD' if normal
  796.                 data  compression was used to write it,  or 'td' if advanced
  797.                 data compression was used.
  798.  
  799.                 Volume Sequence, 1 byte, the first volume is volume 0.
  800.  
  801.                 Check Signature, 1 byte.   This is a unique signature common
  802.                 to all files in a sequence.  That is, the headers for a TD0,
  803.                 TD1,  TD2  sequence would all have this same check signature
  804.                 byte.
  805.  
  806.                 Version number, 1 byte.   Version of TELEDISK used to create
  807.                 this file.  A decimal value of 10 would signify version 1.0,
  808.                 11 would signify version 1.1 and so on...
  809.  
  810.                 Source Density,  1 byte.  Recording density of source drive;
  811.                 0 = 250K bps,  1 = 300K bps,  2 = 500K bps.   If this was  a
  812.                 single-density FM diskette, this number is biased by 128.
  813.  
  814.                 Drive Type,  1 byte.   Type of source drive.   1 = 360K, 2 =
  815.                 1.2M, 3 = 720K, 4 = 1.44M.   Note that the actual media size
  816.                 is  not  recorded;  thus  type 3 may be either 5.25" or 3.5"
  817.                 media.
  818.  
  819.                 Track Density,  1 byte.   Track density of source  drive  in
  820.                 relation to source media.   0 = source density matches media
  821.                 density.  1 = double density media in quad density drive.  2
  822.                 = quad density media in double density drive.
  823.  
  824.                 DOS Mode,  1 byte.   Nonzero if source diskette was analyzed
  825.                 according to DOS allocation.
  826.  
  827.                 Media  surfaces,  1  byte.    1  =  single-sided media,  2 =
  828.                 double-sided media.
  829.  
  830.                 Header CRC, 2 bytes.  A 16 bit CRC for this header.
  831.  
  832.            After the header,  the diskette structure information and  sector
  833.            data  follows.   If advanced data compression was used to produce
  834.            this file, the information appears in 6,144 byte blocks of 12 bit
  835.            Lempel-Zev code.   Each block is preceded by a 2 byte CRC and a 2
  836.            byte code packet count (one packet = 12 bits).
  837.  
  838.  
  839.  
  840.                                         Page 11
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.            The  information  for  each  track  (or surface) is prefixed by a
  848.            header of the following format:
  849.  
  850.                 Sector count, 1 byte.  How many sectors are contained on the
  851.                 current track.   If this is the end of the data  file,  this
  852.                 field is set to 255.
  853.  
  854.                 Physical  cylinder,  1  byte.   The physical position of the
  855.                 source drive head when this track was read.
  856.  
  857.                 Physical side,  1 byte.   The actual surface (0 or 1) of the
  858.                 diskette on which this track occurred.
  859.  
  860.                 CRC check byte,  1 byte.   A CRC checksum of the preceding 3
  861.                 bytes.
  862.  
  863.            After each track header,  there follows a list of sector headers.
  864.            Each sector header is of the following format:
  865.  
  866.                 Cylinder,  1 byte.  The cylinder number of this sector as it
  867.                 appeared in the ID address field.
  868.  
  869.                 Side,  1 byte.   The side code of this sector as it appeared
  870.                 in the ID address field.
  871.  
  872.                 Sector number,  1 byte.  The sector number of this sector as
  873.                 it appeared in the ID address field.
  874.  
  875.                 Sector length code, 1 byte.  The length code (0 = 128 bytes,
  876.                 1 = 256 bytes, etc.) of this sector as it appeared in the ID
  877.                 address field.
  878.  
  879.                 Syndrome flags, 1 byte.  Flags indicating various conditions
  880.                 of the sector data field, namely,
  881.  
  882.                      1  - This sector number occurred more than once on this
  883.                      track.
  884.  
  885.                      2  - A data CRC error occurred  when  this  sector  was
  886.                      read.
  887.  
  888.                      4    - A deleted data control mark was present for this
  889.                      sector.
  890.  
  891.                      16 - A DOS sector copy was requested;  this sector  was
  892.                      not  allocated.   In this case,  no sector data follows
  893.                      this header.
  894.  
  895.                      32 - This sector's data field  is  missing;  no  sector
  896.                      data follows this header.
  897.  
  898.  
  899.  
  900.                                         Page 12
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.                      64  -  No ID address field was present for this sector,
  908.                      but there is a data field.   The sector information  in
  909.                      the header represents fabricated information.
  910.  
  911.                 Sector  CRC,  2 bytes.   A CRC checksum of the sector header
  912.                 information as well as the sector data which follows.
  913.  
  914.            If present,  (see the syndrome flags above) the data for the cur-
  915.            rent sector follows the header.   Note that this data is also in-
  916.            cluded in the CRC checksum in the header.
  917.  
  918.  
  919.            PROBLEMS AND LIMITATIONS
  920.  
  921.            TELEDISK has been tested on several different classes of PC  com-
  922.            patibles  and  should  provide satisfactory operation.   However,
  923.            there are some known potential problem areas:
  924.  
  925.                 PC Compatibility - TELEDISK depends on  a  standard  PC  en-
  926.                 vironment for operation.  TELEDISK will not function with PC
  927.                 incompatibles such as the Tandy 2000,  Heath/Zenith Z-100 or
  928.                 AT&T 7300.  TELEDISK supports Monochrome,  CGA,  EGA and VGA
  929.                 display adapters.
  930.  
  931.                 High-Density  Formats  - TELEDISK requires an PC-AT class of
  932.                 machine to make use of the high  density  (1.2M  and  1.44M)
  933.                 diskette formats.  The IBM PS/2 models 50 through 80 satisfy
  934.                 this criterion also.   PC-XT-type machines with high-density
  935.                 controllers will operate in low-density mode only.
  936.  
  937.                 Other formats - When directed to copy DOS allocated sectors,
  938.                 TELEDISK  examines  the first sector of the diskette.   If a
  939.                 boot sector with a valid Disk Parameter  Block  is  present,
  940.                 the  parameters  contained  within the boot sector are used.
  941.                 If no valid boot sector is found,  the second sector of  the
  942.                 diskette  is  read  to  find  a  valid File Allocation Table
  943.                 (FAT).  If none is found, a non-DOS copy is performed.
  944.  
  945.                 Copy Protection - TELEDISK makes an "intelligent" guess when
  946.                 confronted with unusual track configurations.   Copy protec-
  947.                 tion  schemes  using  the  "super-sector" method will not be
  948.                 reproduced accurately by TELEDISK;  the PC  disk  controller
  949.                 makes this impossible.
  950.  
  951.  
  952.            REVISION RECORD
  953.  
  954.            Version 1.0 - April 1988, Initial release.
  955.            Version 1.01 - May 1988,  Cleaned up help screens,  added single-
  956.                 density (FM) mode.
  957.            Version 1.02 - May 1988,  Check sector 0 for  DPB,  faster  track
  958.                 scan algorithm.
  959.  
  960.                                         Page 13
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.            OTHER PRODUCTS BY SYDEX
  970.  
  971.                 SHAREWARE
  972.  
  973.                 ANADISK  -  The compleat diskette utility.   Nothing like it
  974.                      anywhere else; scan,  edit,  repair and copy just about
  975.                      any  kind  of diskette.   $15.00 Shareware registration
  976.                      fee.
  977.  
  978.                 22NICE - A CP/M 2.2 emulation package.    Supports  the  NEC
  979.                      V-series  chips  or  performs emulation by software for
  980.                      both the 8080 and Z80 processors.    Includes  terminal
  981.                      emulation  and  diskette handling for Osborne,  Kaypro,
  982.                      Morrow and Actrix.  Allows use of CP/M utilities inter-
  983.                      changeably  with  DOS  programs.     $30.00   Shareware
  984.                      registration fee.
  985.  
  986.                 COPYQM - Cheap diskette duplicator.  Format, copy and verify
  987.                      multiple  diskettes  from a single master.   Implements
  988.                      "smart"  drive  status   determination,   freeing   the
  989.                      operator's  hands  from keyboard interaction.   Handles
  990.                      all standard DOS formats including  3.5"  1.44M  files.
  991.                      $15.00 Shareware registration fee.
  992.  
  993.                 FORMATQM  -  Mass  diskette formatter - format a box of dis-
  994.                      kettes at a single sitting.   Implements "smart"  drive
  995.                      status determination, freeing the operator's hands from
  996.                      keyboard  interaction.    Format  a 360K diskette in 41
  997.                      seconds.   Supports all standard DOS formats.    $15.00
  998.                      Shareware registration fee.
  999.  
  1000.  
  1001.                 RETAIL SOFTWARE
  1002.  
  1003.                 SIMCGA 4.2 - Color Graphics Adapter simulation on monochrome
  1004.                      (Hercules-compatible)    graphics-equipped    machines.
  1005.                      Available  from  better  software  retailers  and  dis-
  1006.                      tributed  by  ABCO  and American Software Distributors.
  1007.                      $39.95 suggested list price.
  1008.  
  1009.  
  1010.  
  1011.  
  1012.               ----------------------------------------------------------
  1013.            This document contains names and terms which  may  be  trademarks
  1014.            owned by one or more of the following:
  1015.  
  1016.                 International Business Machines (IBM, PS/2, PC-AT)
  1017.                 Microsoft (MS-DOS)
  1018.  
  1019.  
  1020.                                         Page 14
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.                                          Index
  1028.  
  1029.  
  1030.            A                                    Command form, 3
  1031.            Applications                         Copy disk to disk, 4, 8
  1032.              Disk directory, 2                  Copy disk to file, 4
  1033.              Diskette backup storage, 2         Copy file to disk, 4, 6
  1034.              File transmission, 2
  1035.              Foreign diskette formats, 2      S
  1036.              Format conversion, 2             System Requirements, 3
  1037.  
  1038.            C
  1039.            Copy Protection, 2, 13
  1040.  
  1041.            D
  1042.            Data Compression, 11
  1043.              Advanced, 3, 6
  1044.              Normal, 6
  1045.            Diskette density, 3, 13
  1046.            Display Adapter, 3, 10, 13
  1047.            DOS
  1048.              Allocation, 5
  1049.            Drive number, 5, 8, 10
  1050.              Physical unit, 10
  1051.              Total number of, 10
  1052.  
  1053.            E
  1054.            ESCape key, 4, 7
  1055.  
  1056.            F
  1057.            Files
  1058.              Naming conventions, 6, 7, 11
  1059.              "Splitting", 3
  1060.              Structure of, 11
  1061.  
  1062.            H
  1063.            Help key, 4
  1064.  
  1065.            M
  1066.            Menu
  1067.              Copy disk to disk, 8
  1068.              Copy disk to file, 4
  1069.              Copy file to disk, 7
  1070.              File selection, 7
  1071.              Opening, 4
  1072.  
  1073.            O
  1074.            Operating display, 9
  1075.              Analysis messages, 10
  1076.              Genral information, 9
  1077.              Operator messages, 9
  1078.            Operation
  1079.  
  1080.                                           15
  1081.