home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / os2 / dxp200.arj / DXP.DOC next >
Encoding:
Text File  |  1992-05-19  |  38.2 KB  |  1,137 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                                             Disk eXPress
  9.  
  10.                                                             for Creating
  11.                                                          Diskette Images
  12.  
  13.                                                                      DXP
  14.                                                             Version 2.00
  15.                                                                 05/19/92
  16.  
  17.  
  18.  
  19.                                   TABLE OF CONTENTS
  20.        _________________________________________________________________
  21.  
  22.             1.0. INTRODUCTION TO Disk eXPress ........................3
  23.                  1.1. What is Disk eXPress? ..........................3
  24.                  1.2. Features of Disk eXPress .......................3
  25.                  1.2. New features in Disk eXPress Version 2 .........4
  26.                  1.4. New Disk eXPress companion program: Xtract .....4
  27.             2.0. SYSTEM REQUIREMENTS .................................5
  28.             3.0. COPYRIGHT NOTICE ....................................5
  29.             4.0. WARRANTY ............................................5
  30.             5.0. COST OF Disk eXPress ................................6
  31.             6.0. CONTENTS OF THIS PACKAGE ............................6
  32.             7.0. SYNTAX ..............................................7
  33.                  7.1. Quick start ....................................7
  34.                  7.2. Disk eXPress and Xtract help screens ...........8
  35.             8.0. COMMAND LINE SWITCHES DESCRIPTION ...................10
  36.                  8.1. Regular mode ...................................10
  37.                  8.2. Extract mode ...................................11
  38.                  8.3. Batch mode support .............................12
  39.                  8.4. Disk eXPress real-time bar graph display .......12
  40.             9.0. EXAMPLES ............................................13
  41.                  9.1. Example 1 ......................................13
  42.                  9.2. Example 2 ......................................14
  43.                  9.3. Example 3 ......................................14
  44.                  9.4. Example 4 ......................................15
  45.                  9.5. Example 5 ......................................15
  46.                  9.6. Example 6 ......................................16
  47.                  9.7. Example 7 ......................................16
  48.             10.0. ERROR MESSAGES .....................................18
  49.             11.0. LIMITATIONS ........................................20
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                                                                        2
  75.  
  76.  
  77.  
  78.        1.0. INTRODUCTION TO Disk eXPress
  79.        _________________________________________________________________
  80.  
  81.  
  82.        1.1. What is Disk eXPress?
  83.  
  84.        Disk eXPress (DXP) allows a diskette image to be created for
  85.        electronic transmission.  Think of it as a way for preparing a
  86.        diskette to be FAXed like a regular document.  Once the diskette
  87.        image is created, it can be transmitted with the use of a modem
  88.        on regular phone line, or any other electronic networks.
  89.  
  90.        One area of use is to archive diskette images on hard drives or
  91.        tapes.  This can be useful for companies maintaining an
  92.        electronic bulletin board service for clients, in which diskette
  93.        images for the latest hardware drivers, or fixes are available
  94.        for download.  This gaurantees the contents of the diskette to be
  95.        the same as the original -- including all directory structures,
  96.        date and time stamps of all the files and directories, and the
  97.        location of any hidden information.
  98.  
  99.        For simple file archival purpose, the use of Disk eXPress should
  100.        be avoided.  The user is recommended to use one of the many fine
  101.        archive programs available on the market.  Disk eXPress is useful
  102.        for archiving bootable diskettes, diskettes containing hidden
  103.        information, or files and directory entries containing characters
  104.        unrecognizable by the usual file system functions.  Unlike a file
  105.        archive program, Disk eXPress requires a diskette drive and a
  106.        diskette in order to restore any information stored in an image.
  107.  
  108.  
  109.        1.2. Features of Disk eXPress
  110.  
  111.        -  Disk eXPress recognizes all standard DOS formatted diskettes,
  112.           this includes 160K, 180K, 320K, 360K, 720K, 1.2M, 1.44M, and
  113.           the latest 2.88M diskettes.  Any internal or external diskette
  114.           drives via DOS or OS/2 block device drivers are recognized
  115.           (ie: diskette drives accessed via DRIVER.SYS, $FDD5.SYS, etc.)
  116.           All information on the diskette is saved to a file for
  117.           electronic transmission, no information is lost! (see /a
  118.           switch for detail).
  119.        -  Disk eXPress can be used for diskette conversion.  For
  120.           example, a 360K diskette image can be restored onto a 720K,
  121.           1.44M, or 2.88M diskette.  If someone sends you a bootable
  122.           360K diskette image, you can restore it onto a 720K diskette,
  123.           and the resulting diskette will be bootable.
  124.        -  Advanced virus protection.  Disk eXPress detects illegal
  125.           program modifications whether it's by virus, or bad electronic
  126.           transmissions.
  127.        -  Multiple 32-bit CRC data protection.  The image is protected
  128.           by several 32-bit CRCs.  In some cases, if a certain part of
  129.           the image is modified, the resulting diskette can still be
  130.           usable.
  131.  
  132.  
  133.                                                                        3
  134.  
  135.  
  136.  
  137.        -  Upgradability of self-extract code.  Disk eXPress provides a
  138.           means to upgrade the self-extract code within the image file
  139.           for bug fixes, and future code enhancements upgrade.
  140.  
  141.        (note: version 2 image is not compatible with version 1.
  142.         Replacement of version 1 self-extract code is not allowed.)
  143.  
  144.  
  145.  
  146.        1.2. New features in Disk eXPress Version 2
  147.  
  148.        -  Disk eXPress is now a dual mode executable file.  It runs
  149.           under both OS/2 and DOS.  There is only one version of the
  150.           executable as opposed to two in the previous release.
  151.        -  Disk eXPress exploits the multi-threading capability when it
  152.           is run under OS/2.  It performs simultaneous disk I/O and data
  153.           compression.  This typically gives 10 to 50% speed up compare
  154.           to running it under DOS.
  155.        -  Disk eXPress supports long filename for diskette images
  156.           created under OS/2 with HPFS (High Performance File System)
  157.           disk partition.
  158.        -  New data compression algorithm based on a modified Lempel-Ziv-
  159.           Huffman method.  Disk eXPress now compresses smaller than
  160.           version 1, and is also 2 to 3 times faster.  The compression
  161.           rate is comparable to most file archive programs.  Compression
  162.           is dynamic -- non-compressible data is simply stored.
  163.        -  Real-time bar graph display showing current compression rate,
  164.           disk read/write and compression activities (this capability is
  165.           limited under DOS).
  166.        -  Self-extract diskette image is also a dual mode executable.
  167.           /DOS and /OS2 switches are no longer required (please refer to
  168.           version 1 documentation).  All the extra functions are
  169.           removed, and are now built-into the extract mode of Disk
  170.           eXPress itself.
  171.        -  Disk eXPress can now produce non-self-extract image (pure
  172.           image data).  This is useful for diskette archival purpose on
  173.           hard drive or tape.
  174.        -  Diskette decompression code is now built-into Disk eXPress.
  175.           This can be used to decompress version 2 pure diskette image
  176.           or any version 1 or 2 self-extract images.  It has the full
  177.           set of options, including diskette formatting, conversion, and
  178.           verification.  The decompressor is also fully multi-threaded
  179.           under OS/2 to yield the fastest decompression time.
  180.        -  A new switch (/t) is added to all the decompressors so that
  181.           the integrity of the image can be tested before committing the
  182.           lengthy diskette write process.
  183.  
  184.  
  185.        1.4. New Disk eXPress companion program: Xtract
  186.  
  187.        -  Xtract is a dual mode executable.  It features all the
  188.           decompression capability of Disk eXPress, including multi-
  189.           threading under OS/2.
  190.  
  191.  
  192.                                                                        4
  193.  
  194.  
  195.  
  196.        -  It is used when distributing pure diskette images in which
  197.           licensing is not required for redistributing Xtract itself.
  198.  
  199.  
  200.  
  201.        2.0. SYSTEM REQUIREMENTS
  202.        _________________________________________________________________
  203.  
  204.        IBM PC, PC-AT, PS/1, PS/2 and 100% compatibles.  Minimum 256K
  205.        conventional memory.  MS-DOS or PC-DOS version 3.00 for Disk
  206.        eXPress (DOS version 3.20 is required for running self-extract
  207.        images produced by Disk eXPress).  OS/2 1.2 and above (including
  208.        OS/2 Version 2) is required under OS/2.  Hard disk is required
  209.        for storing large image file.  User must also provide the
  210.        necessary program(s) for sending diskette image files through
  211.        telephone network with the use of a modem, and whatever is
  212.        necessary with any other electronic networks.
  213.  
  214.  
  215.  
  216.        3.0. COPYRIGHT NOTICE
  217.        _________________________________________________________________
  218.  
  219.        DXP (Disk eXPress)  Version 2.00  05/19/92
  220.        XTRACT (Xtract)     Version 2.00  05/19/92
  221.        Copyright (c) 1991-92 by
  222.        Albert J. Shan
  223.  
  224.        All Rights Reserved.  No part of this program can be
  225.        disassembled, modified or altered by any means.
  226.  
  227.  
  228.  
  229.        4.0. WARRANTY
  230.        _________________________________________________________________
  231.  
  232.        I, Albert J. Shan, make no warranties, expressed or implied,
  233.        including, but not limited to, merchantability or fitness for any
  234.        particular purpose.  In no event shall Albert J. Shan be liable
  235.        for indirect or consequential damages arising from the use of the
  236.        software program.
  237.  
  238.        You are free to redistribute this shareware package in its
  239.        entirety.  No part of this package may be included as part of a
  240.        commercial package.  If you have any questions about commercial
  241.        distribution of Disk eXPress, I can be contacted at:
  242.  
  243.        Albert J. Shan
  244.        866 Citadel Drive
  245.        Port Coquitlam, British Columbia
  246.        CANADA  V3C 5Y1
  247.  
  248.        or via CompuServe, ID 70730,401
  249.  
  250.  
  251.                                                                        5
  252.  
  253.  
  254.  
  255.  
  256.        5.0. COST OF Disk eXPress
  257.        _________________________________________________________________
  258.  
  259.        Disk eXPress Version 1 was labeled as "beggarware" in which user
  260.        is not required to pay a fee.  Due to all the effort and time I
  261.        put in for Version 2, it is now marketed as shareware.  The user
  262.        is granted a 30 days trial period, after which he or she is
  263.        required to register the product.  The cost of a single machine
  264.        license is $24 Canadian.  Unlimited distribution right of Xtract
  265.        is granted upon licensing Disk eXPress.  Please refer to the file
  266.        ORDER.FRM for details.
  267.  
  268.  
  269.  
  270.        6.0. CONTENTS OF THIS PACKAGE
  271.        _________________________________________________________________
  272.  
  273.        The following files are included in this package:
  274.  
  275.            DXP.EXE    - Disk eXPress executable
  276.            XTRACT.EXE - Standalone Disk eXPress image decoder
  277.                         (not included in the shareware version)
  278.            DXP.DOC    - This documentation
  279.            DXP.HST    - History file
  280.            ORDER.FRM  - Order form
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                                                        6
  311.  
  312.  
  313.  
  314.        7.0. SYNTAX
  315.        _________________________________________________________________
  316.  
  317.        7.1. Quick start
  318.  
  319.        The synatx of Disk eXPress is very similar to the COPY command.
  320.        To create a diskette image, type:
  321.  
  322.          dxp drive: filename
  323.  
  324.        To create a diskette from an image file, type:
  325.  
  326.          dxp filename drive:
  327.  
  328.  
  329.        For example, to create a diskette image from your drive B:,
  330.        simply type:
  331.  
  332.          dxp b: my_image
  333.  
  334.        The file "my_image.exe" will be created after Disk eXPress is
  335.        finished.
  336.  
  337.        You can specify any combination of command switches anywhere on
  338.        the command line.  Spaces between command line switches are not
  339.        required.  By default, the file extension is ".EXE" regardless of
  340.        what user specifies.  When creating a pure diskette image with
  341.        the /i switch, user is free to choose the file extension.  For
  342.        consistency, the recommended file extension to use is ".DXP".
  343.  
  344.        For example, under OS/2 with HPFS drive, a pure diskette image
  345.        can be created as follows:
  346.  
  347.          dxp a: "This is diskette 3 of 5.DXP" /i
  348.  
  349.        You may also stop Disk eXPress at any time by pressing Ctrl-C or
  350.        Ctrl-Break.  The BREAK ON/OFF setting under DOS is ignored.
  351.  
  352.        If Disk eXPress encounters any cluster marked as bad in the File
  353.        Allocation Table, you may receive a warning:
  354.  
  355.         X bad cluster(s) detected.
  356.         Bad clusters may not be reliably read by Disk eXPress!
  357.         However, if you do not encounter any 'Abort/Retry?'
  358.         message during read, the image should be fine.
  359.  
  360.        (Note: Disk eXPress will by-pass FAT scanning if the /a switch is
  361.         specified.)
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.                                                                        7
  370.  
  371.  
  372.  
  373.        7.2. Disk eXPress and Xtract help screens
  374.  
  375.        Type DXP at the OS/2 or DOS prompt to receive this help screen:
  376.  
  377.         Disk eXPress (OS/2 and DOS) Version 2.00  05/19/92
  378.         Created by Albert J. Shan  Copyright (c) 1991-92
  379.  
  380.         Regular mode: DXP [options] [drive:] [d:][path]filename
  381.            [options]  /?    Display extract mode help screen
  382.                       /a    Read the entire disk (all sectors)
  383.                       /d    Input diskette image description (5 lines max.)
  384.                       /i    Output just the diskette image
  385.                       /n    Disable data compression
  386.                       /s    Suppress overwrite prompt and self-check message
  387.                      drive  Drive letter of a valid floppy drive
  388.         [d:][path]filename  Name of output file
  389.  
  390.         Valid options with only filename specified:
  391.                       /d    Display description in image file
  392.                       /e    Edit description in image file
  393.                       /r    Replace or add extract code to image file
  394.  
  395.         Note: Items enclosed in [] are optional.
  396.               Diskette must not contain any unreadable sectors.
  397.  
  398.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K,
  399.                            1.44M and 2.88M DOS diskettes.
  400.  
  401.  
  402.        Type DXP /?, and you'll get the help screen for the extract mode:
  403.  
  404.         Disk eXPress (OS/2 and DOS) Version 2.00  05/19/92
  405.  
  406.         *** Type DXP by itself to see the regular mode help screen ***
  407.  
  408.         Extract mode: DXP [options] [d:][path]filename [drive:]
  409.            [options]  /t    Test image integrity only
  410.                       /d    Display description in image file
  411.                       /f    Format destination diskette
  412.                       /s    Suppress overwrite prompt and self-check message
  413.                       /v    Verify ON (system verify plus read and compare)
  414.                       /c    Convert image onto a higher density diskette
  415.                             (Target diskette must be pre-formatted, and
  416.                             of different form factor.  It also overrides /f)
  417.         [d:][path]filename  Name of input file
  418.                      drive  Drive letter of a valid floppy drive
  419.  
  420.         Note: Items enclosed in [] are optional.
  421.               The target diskette must be free of defects (no bad sectors).
  422.  
  423.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K,
  424.                            1.44M and 2.88M DOS diskettes.
  425.  
  426.  
  427.  
  428.                                                                        8
  429.  
  430.  
  431.  
  432.        Type XTRACT and you'll see the following help screen:
  433.  
  434.         Xtract (OS/2 and DOS) Version 2.00  05/19/92
  435.         Created by Albert J. Shan  Copyright (c) 1991-92
  436.  
  437.         Usage: XTRACT [options] [d:][path]filename [drive:]
  438.  
  439.              [options]  /t  Test image integrity only
  440.                         /d  Display description in image file
  441.                         /f  Format destination diskette
  442.                         /s  Suppress overwrite warning/self-check prompt
  443.                         /v  Verify ON (system verify plus read and compare)
  444.                         /c  Convert image onto a higher density diskette
  445.                             (Target diskette must be pre-formatted, and
  446.                             of different form factor.  It also overrides /f)
  447.         [d:][path]filename  Name of input file
  448.                      drive  Drive letter of a valid floppy disk drive
  449.  
  450.         Note: The target diskette must be free of defects (no bad sectors).
  451.  
  452.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K,
  453.                            1.44M and 2.88M DOS diskettes.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.                                                                        9
  488.  
  489.  
  490.  
  491.        8.0. COMMAND LINE SWITCHES DESCRIPTION
  492.        _________________________________________________________________
  493.  
  494.        When Disk eXPress is used under regular mode for making diskette
  495.        images, the following switches are available:
  496.  
  497.  
  498.        8.1. Regular mode
  499.  
  500.        /a  By default, Disk eXPress reads up to the last allocated
  501.            sector, according to the information it finds in the File
  502.            Allocation Table (FAT).  If there is any deleted files at the
  503.            end of FAT that you may want to recover later, the default
  504.            action will prevent you from a successful file recovery.  Use
  505.            /a to ask Disk eXPress to save all disk sectors to the image
  506.            file.
  507.  
  508.        /d  Prompt user to input description for the diskette image.  A
  509.            maximum of 5 lines of 40 characters each can be stored.
  510.  
  511.        /i  Create a pure diskette image file.  The self-extract code
  512.            will not be bundled with the resulting file.  Disk eXPress
  513.            does not enforce any file extension for pure diskette image.
  514.            For consistency, it is recommended to use ".DXP" as file
  515.            extension.  Without specifying this switch, the default file
  516.            extension will be ".EXE".
  517.  
  518.        /n  Disable compression.  If the contents of the diskette is
  519.            highly compressed, Disk eXPress may not succeed in
  520.            compressing the data any further.  This can be visually
  521.            inspected when Disk eXPress is ran the first time without the
  522.            /n switch.  If the real-time compression rate is very low
  523.            (close to 0%), the supression of compression is recommended.
  524.  
  525.        /s  Diable any overwrite (y/N) prompt and Disk eXPress self-check
  526.            message.
  527.  
  528.        Three switches are available when no drive letter is specified in
  529.        regular mode:
  530.  
  531.        /d  Display the description of the image file.  The full path to
  532.            the diskette image must be specified.
  533.  
  534.        /e  Edit the description stored in an image file.  This is used
  535.            to correct the description later instead of having to redo
  536.            the entire image from scratch.
  537.  
  538.        /r  Replace or add extract code to image file.  Full path and
  539.            complete filename must be specified.  If /r is used against a
  540.            self-extract diskette image, the self-extract code will be
  541.            replaced with the one stored with Disk eXPress.  No backup
  542.            file is created if the operation is successful.  If used
  543.            against a pure image file, the self-extract code will be
  544.  
  545.  
  546.                                                                       10
  547.  
  548.  
  549.  
  550.            added, and a new file with ".EXE" extension will be created.
  551.            The ".EXE" file created by this switch is stored in the same
  552.            location of the original image file.
  553.  
  554.            Note: The file extension replacement algorithm simply removes
  555.            any file extension starting after the last '.' and then
  556.            appending "EXE".  Since it is possible to use multiple '.'
  557.            under HPFS, the text after the last '.' is discarded.  It is
  558.            advisible to avoid using multiple '.' with HPFS filename, and
  559.            use a space instead.
  560.  
  561.  
  562.        8.2. Extract mode
  563.  
  564.        Disk eXPress can decode and extract 3 types of images: type 0
  565.        (non-compressed), type 1 (Version 1 compression), and type 2
  566.        (Version 2 compression).  When Disk eXPress is used for
  567.        extracting an image file, the image file can be a pure image
  568.        file, or a self-extracting executable.  The full path to the
  569.        image file must be specified.  Wild cards are not allowed.  All
  570.        the switches available in the extract mode of Disk eXPress are
  571.        identical to the standanlone Xtract program.
  572.  
  573.        /t  Test the integrity of the image only.  Disk eXPress performs
  574.            data decompression (if necessary) and run through a 32-bit
  575.            CRC computation on the data stored in the image.  It reports
  576.            the stored and computed CRC values.  If these values do not
  577.            agree, the image will be bad.  It overrides the specification
  578.            of drive letter, /f, /s, /v, and the /c switch.
  579.  
  580.        /d  Display the description of the image file.  The full path to
  581.            the diskette image must be specified.
  582.  
  583.        /f  Format the destination diskette.  Only standard DOS formats
  584.            are supported.
  585.  
  586.        /s  Diable any overwrite (y/N) prompt and Disk eXPress self-check
  587.            message.
  588.  
  589.        /v  Verify on.  It performs a track verify via operating system
  590.            call, followed by a track read, and a byte by byte
  591.            comparison.  The byte by byte comparison is added as an extra
  592.            protection should the CRC test of track verify failed to pick
  593.            up an error.  If disk cache is used, the byte comparison test
  594.            may not be vaild due to the fact that the cache is supplying
  595.            the data, with no actual read performed.
  596.  
  597.        /c  Convert the image onto a higher density diskette.  The target
  598.            diskette must be of different form factor (3.5" to 5.25" and
  599.            vice versa, but not 3.5" 720K to 3.5" 1.44M).  It requires a
  600.            formatted diskette, and will automatically overrides the /f
  601.            switch.
  602.  
  603.  
  604.  
  605.                                                                       11
  606.  
  607.  
  608.  
  609.            Here is a list of all diskette conversion possibilities:
  610.  
  611.              160K/180K/320K/360K to 720K/1.44M/2.88M
  612.                             720K to 1.2M
  613.                             1.2M to 1.44M/2.88M
  614.  
  615.  
  616.        8.3. Batch mode support
  617.  
  618.        You can use Disk eXPress, Xtract, and self-extract images in a
  619.        batch file (.CMD files under OS/2 and .BAT files under DOS).  The
  620.        return code returned by these programs are currently limited to
  621.        either a 0 or 1.  A return code of 0 indicates operation is
  622.        successful.  All display output is sent to stdout, and can be
  623.        redirected to a file (Note: error output is currently sent to
  624.        stdout, not stderr).
  625.  
  626.  
  627.        8.4. Disk eXPress real-time bar graph display
  628.  
  629.        One of the new features of Disk eXPress Version 2 is the use of a
  630.        real-time bar graph display.  Disk eXPress and Xtract will
  631.        exercise the multi-threading capability under OS/2, and you'll
  632.        see a display similar to the following:
  633.  
  634.                                    3%      25%       50%       75%      100%
  635.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  636.           COMPRESS  52%   37    1  █████████████████▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒
  637.  
  638.        The above bar graph depicts 3 concurrent threads:
  639.  
  640.           ▒ Read thread.  Performs continous reading of diskette (or
  641.             disk file if it is in extract mode), and releases the
  642.             diskette drive (or disk file) for use by another process
  643.             when reading is finished.
  644.           ▓ Compression/decompression thread.  Compression/decompression
  645.             is performed as soon as data is available from the read
  646.             thread.
  647.           █ Write thread.  Compressed data is written to a disk file (or
  648.             decompressed data written to diskette in extract mode).
  649.             This can be another diskette drive or any block device.
  650.  
  651.        The description under "Action" shows what thread has just started
  652.        executing.
  653.  
  654.        The number under "Rate" shows the current compression rate.  It
  655.        is the percentage reduction with respect to the size of the
  656.        original data.
  657.  
  658.        The numbers under "Track" and "Head" show the current disk track
  659.        and head where operation is being performed.
  660.  
  661.  
  662.  
  663.  
  664.                                                                       12
  665.  
  666.  
  667.  
  668.        Since DOS only has one thread of execution, only one bar is
  669.        updated at any time.  Read/Compress/Decompress/Write occurs
  670.        sequentially.
  671.  
  672.  
  673.  
  674.        9.0. EXAMPLES
  675.        _________________________________________________________________
  676.  
  677.        9.1. Example 1
  678.  
  679.        To pack a 360K diskette in drive B: onto a file called 'disk1'
  680.        for modem transmission, you type:
  681.  
  682.            dxp b: e:\upload\disk1
  683.  
  684.        By default, Disk eXPress will automatically append ".EXE" onto
  685.        the output file name.  If you specify something else as file
  686.        extension, it will be removeded before appending.  If the command
  687.        line syntax is correct, Disk eXPress will first run a self-check
  688.        for virus/modification, then it will proceed to create the
  689.        diskette image.  You'll receive a screen similar to the following
  690.        after Disk eXPress is finished:
  691.  
  692.           Checking Disk eXPress for modifications ... OK.
  693.  
  694.           360K diskette found in drive B:
  695.  
  696.           File Allocation Table statistics:
  697.           Track 33 head 1 contains the last allocated sector, sector 609.
  698.  
  699.                                    3%      25%       50%       75%      100%
  700.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  701.              STORE  28%   33    1  ████████████████████████████████████████
  702.  
  703.           32-bit CRC of diskette image is DB49A615
  704.  
  705.        By default, Disk eXPress will analyze the FAT and save up to the
  706.        last sector used on the diskette.  In the above example, it stops
  707.        at track 33, head 1, because sector 609 is the last allocated
  708.        sector.  If you have a fragmented diskette, you might receive a
  709.        screen similar to the following when you run Disk eXPress:
  710.  
  711.           Checking Disk eXPress for modifications ... OK.
  712.  
  713.           1.44M diskette found in drive A:
  714.  
  715.           File Allocation Table statistics:
  716.           Track 36 head 1 contains the last allocated sector, sector 1319.
  717.  
  718.           Disk fragmentation detected:
  719.           814 unallocated sectors will be saved in image
  720.           (61% of total used sectors).
  721.  
  722.  
  723.                                                                       13
  724.  
  725.  
  726.  
  727.           The diskette requires compression for maximum storage efficiency.
  728.  
  729.                                    3%      25%       50%       75%      100%
  730.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  731.           COMPRESS  48%   16    0  ██████▓▓▒▒▒▒▒▒▒
  732.  
  733.        etc.
  734.  
  735.        Running a disk optimization utility on the diskette will help
  736.        packing files tightly together for maximum storage efficiency.
  737.        Alternatively, you can copy all the files to another freshly
  738.        formatted diskette so that the files are packed next to each
  739.        other.
  740.  
  741.  
  742.        9.2. Example 2
  743.  
  744.        To save the entire diskette from drive A: (including all the
  745.        unused sectors) into the image with compression turned off, you
  746.        type:
  747.  
  748.            dxp /a /n a: e:\upload\disk1
  749.  
  750.        You will see this warning if the file exists:
  751.  
  752.           Checking Disk eXPress for modifications ... OK.
  753.  
  754.           E:\UPLOAD\DISK1.EXE exists, overwrite? (y/N):
  755.  
  756.        Default action is 'No' for pressing the 'Enter' key.  Type 'y'
  757.        then 'Enter' to overwrite.
  758.  
  759.        To suppress the warning, specify /s on the command line:
  760.  
  761.            dxp /a /n a: e:\upload\disk1 /s
  762.  
  763.        Notice that you can specify switches anywhere you want on the
  764.        command line, Disk eXPress will sort them out for you.
  765.  
  766.  
  767.        9.3. Example 3
  768.  
  769.        To enter a description when creating an image, you type:
  770.  
  771.            dxp b: test15 /s /d
  772.  
  773.        You'll see:
  774.  
  775.           Checking Disk eXPress for modifications ... OK.
  776.  
  777.           Please enter diskette description: (5 lines max.)
  778.             ┌────────────────────────────────────────┐
  779.           1:
  780.  
  781.  
  782.                                                                       14
  783.  
  784.  
  785.  
  786.  
  787.        You're then prompted to enter a maximum of five lines of
  788.        description (40 characters for each line).  To enter a blank
  789.        line, just press Enter.
  790.  
  791.        To continue our example, type in the following:
  792.  
  793.           Please enter diskette description: (5 lines max.)
  794.             ┌────────────────────────────────────────┐
  795.           1: Joe,
  796.           2: This is the latest beta release of Space
  797.           3: Commander.  Try it out without a joy
  798.           4: stick and let me know how it goes.
  799.           5:   Regards, John
  800.  
  801.           360K diskette found in drive B:
  802.  
  803.           File Allocation Table statistics:
  804.           Track 33 head 1 contains the last allocated sector, sector 609.
  805.  
  806.                                    3%      25%       50%       75%      100%
  807.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  808.              STORE  28%   16    1  ███████████████████▓▓▒▒▒▒▒▒▒
  809.  
  810.        etc.
  811.  
  812.  
  813.        9.4. Example 4
  814.  
  815.        To change the description of the diskette image produced in the
  816.        last example, type:
  817.  
  818.            dxp e:\upload\test15.exe /e
  819.  
  820.        The /e switch allows description in the image file to be edited.
  821.        Note: The /r switch (self-extract code replacement) can also be
  822.        specified together with the /e switch.
  823.  
  824.  
  825.        9.5. Example 5
  826.  
  827.        Now that you have the self-extract image, what are you going to
  828.        do with it?  Simply run it!  To unpack the disk image created in
  829.        example 3, type 'test15' to see the help screen:
  830.  
  831.           Disk eXPress Self-Extract Diskette Image (OS/2 and DOS)
  832.           Version 2.00  05/19/92  Copyright (c) 1991-92
  833.  
  834.           Usage: TEST15 [/t] [drive:]
  835.  
  836.              /t  Test image integrity only
  837.           drive  Drive letter of a valid floppy disk drive
  838.  
  839.  
  840.  
  841.                                                                       15
  842.  
  843.  
  844.  
  845.           Note: The target diskette must be formatted and must not
  846.                 have any bad sectors.
  847.  
  848.        To finish our example, now type:
  849.  
  850.            test15 b:
  851.  
  852.        You'll see:
  853.  
  854.           ┌────── Diskette Image Description ──────┐
  855.            Joe,
  856.            This is the latest beta release of Space
  857.            Commander.  Try it out without a joy
  858.            stick and let me know how it goes.
  859.              Regards, John
  860.           └────────────────────────────────────────┘
  861.           360K diskette image stored in file.
  862.  
  863.  
  864.           Diskette in drive B: is about to be overwritten
  865.           with new information.  Do you wish to continue? (y/N)
  866.  
  867.        Default action is 'No' for pressing the 'Enter' key.  Press 'y'
  868.        then 'Enter' to start diskette image extraction.
  869.  
  870.  
  871.        9.6. Example 6
  872.  
  873.        To test the integrity of the diskette image without writing out
  874.        to the diskette, simply type:
  875.  
  876.            test15 /t
  877.  
  878.        And you'll see:
  879.  
  880.           ┌────── Diskette Image Description ──────┐
  881.            Joe,
  882.            This is the latest beta release of Space
  883.            Commander.  Try it out without a joy
  884.            stick and let me know how it goes.
  885.              Regards, John
  886.           └────────────────────────────────────────┘
  887.           360K diskette image stored in file.
  888.  
  889.           100% Read
  890.  
  891.             32-bit CRC stored: DB49A615
  892.           32-bit CRC computed: DB49A615
  893.  
  894.        Note: /t overrides drive letter specified on the command line.
  895.  
  896.  
  897.  
  898.  
  899.  
  900.                                                                       16
  901.  
  902.  
  903.  
  904.        9.7. Example 7
  905.  
  906.        Now that Joe got the diskette image.  He doesn't have a 360K or
  907.        1.2M drive (5.25" drive).  All he has is a 1.44M 3.5" drive.  He
  908.        also happens to have a spare 720K (low-density) diskette he can
  909.        use.  What can he do?  He can use the /c switch in the extract
  910.        mode of Disk eXPress or Xtract.  The /c switch can be used to
  911.        convert the diskette image from 360K to 720K, and all the data
  912.        will still be intact, and usable.  The diskette used for
  913.        conversion must be pre-formatted.  So, Joe went ahead and
  914.        formatted the diskette as a 720K diskette, and he typed:
  915.  
  916.            dxp test15.exe a: /c
  917.  
  918.        And receives the following screen (answer y at the prompt):
  919.  
  920.         Checking Disk eXPress for modifications ... OK.
  921.         Checking test15.EXE for modifications ... OK.
  922.  
  923.           360K diskette image (Disk eXPress type 2)
  924.  
  925.         Diskette in drive A: is about to be overwritten
  926.         with new information.  Do you wish to continue? (y/N) y
  927.  
  928.           720K diskette found in drive A:
  929.         Converting 360K image onto 720K diskette ...
  930.  
  931.                               3%      25%       50%       75%      100%
  932.             Action Track Head ├────────┼─────────┼─────────┼─────────┤
  933.         DECOMPRESS   20    0  █████████▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  934.  
  935.        etc.
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                                                                       17
  960.  
  961.  
  962.  
  963.        10.0. ERROR MESSAGES
  964.        _________________________________________________________________
  965.  
  966.        Disk eXPress incorporates 32-bit CRC checking for itself and the
  967.        image it produces.  In the event of a virus infection or other
  968.        means of modifications (such as errors in electronic
  969.        transmissions), the program will abort, and the following message
  970.        is displayed:
  971.  
  972.        *** File has been modified or not a valid image file.
  973.  
  974.        Here is a run down of major error messages produced by Disk
  975.        eXPress, Xtract and self-extract images: (a beep followed by one
  976.        of the following messages)
  977.  
  978.        > For bad or not properly formatted diskette during read, write,
  979.          format or verify:
  980.  
  981.          *** Read Error: Abort, Retry? (a/R):
  982.  
  983.          *** Write Error: Abort, Retry? (a/R):
  984.  
  985.          *** Format Error: Abort, Retry? (a/R):
  986.  
  987.          *** Verify Error: Abort, Retry? (a/R):
  988.  
  989.          *** Bad CRC.
  990.  
  991.          *** Sector not found.
  992.  
  993.          *** General failure reading drive X:
  994.  
  995.          *** Unknown media/inconsistent boot record.
  996.  
  997.        > When disk is full during image creation (output will be
  998.          deleted):
  999.  
  1000.          *** Error writing disk or disk full.
  1001.  
  1002.        > With a write protected diskette during diskette write:
  1003.  
  1004.          *** Diskette is write protected.
  1005.  
  1006.        > When replacing self-extract code in images with a lower
  1007.          revision level of Disk eXPress:
  1008.  
  1009.          *** Image was created by Disk eXPress x.xx
  1010.          which is of higher revision level.
  1011.  
  1012.        > When diskette drive is not ready:
  1013.  
  1014.          *** Drive X: not ready.
  1015.  
  1016.  
  1017.  
  1018.                                                                       18
  1019.  
  1020.  
  1021.  
  1022.        > When drive specified is not available or not a diskette drive:
  1023.  
  1024.          *** Invalid drive specified.
  1025.  
  1026.          *** Drive X: is not a floppy drive.
  1027.  
  1028.        > When attempting to replace a version 1 self-extract header with
  1029.          version 2 by the /r switch:
  1030.  
  1031.          *** filename is not a type 2 image.
  1032.  
  1033.        > When Disk eXPress or Xtract is asked to extract an unrecognized
  1034.          image file:
  1035.  
  1036.          *** File has been modified or not a valid image file.
  1037.  
  1038.        > When Disk eXPress or Xtract is asked to convert a diskette
  1039.          image to the same form factor diskette:
  1040.  
  1041.          *** Conversion not supported on target diskette.
  1042.  
  1043.        > Some error messages returned by Disk eXPress are displayed as:
  1044.  
  1045.          *** Error n, Drive X:
  1046.  
  1047.        In such event, please document the procedure on how to get to the
  1048.        above error, and contact me as soon as possible.
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.                                                                       19
  1078.  
  1079.  
  1080.  
  1081.        11.0. LIMITATIONS
  1082.        _________________________________________________________________
  1083.  
  1084.        When Disk eXPress is used to produce a self-extract diskette
  1085.        image, the extract code is bundled as an overhead for each image
  1086.        produced.  The overhead is currently at 25K.  This is acceptable,
  1087.        considering the size of any non-trivial diskette image is usually
  1088.        quite large (in the order of several hundred kilo bytes or even
  1089.        mega bytes).  25K should require no more that two minutes for a
  1090.        2400 baud modem to transfer, and with a 14.4K V.32bis modem, the
  1091.        overhead is less than 16 seconds.
  1092.  
  1093.        Other limitations include the inability to read a diskette drive
  1094.        over the LAN (limitation of the network driver), and Disk eXPress
  1095.        over any copy protected programs.  Another limitation is its
  1096.        inability to read over physically bad sectors.
  1097.  
  1098.        Any suggestions and comments are welcome.  Suggestions for new
  1099.        features may eventually be incorporated into a future release.
  1100.        Currently on the draw board includes the 32-bit version for OS/2
  1101.        2.0, and the possibility of making it into a multi-threaded PM
  1102.        application with the use of System Object Model (SOM).
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.                                                                       20
  1137.