home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / dxp234.zip / DXP.DOC next >
Text File  |  1994-07-08  |  56KB  |  1,492 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                                             Disk eXPress
  9.  
  10.                                                         The SuperCharged
  11.                                                Diskette Imaging software
  12.                                                         for OS/2 and DOS
  13.  
  14.                                                                      DXP
  15.                                                             Version 2.34
  16.                                                                 03/08/94
  17.  
  18.  
  19.  
  20.                                   TABLE OF CONTENTS
  21.        _________________________________________________________________
  22.  
  23.             1.0. INTRODUCTION TO Disk eXPress ........................3
  24.                  1.1. What is Disk eXPress? ..........................3
  25.                  1.2. Features of Disk eXPress .......................3
  26.                  1.3. New features in Disk eXPress Version 2 .........4
  27.                  1.4. New Disk eXPress companion program: Xtract .....4
  28.                  1.5. What's new in Version 2.10 .....................5
  29.                  1.6. What's new in Version 2.20 .....................5
  30.                  1.7. What's new in Version 2.31 .....................5
  31.                  1.8. What's new in Version 2.32 .....................6
  32.                  1.9. What's new in Version 2.33/2.34 ................6
  33.             2.0. SYSTEM REQUIREMENTS .................................6
  34.             3.0. COPYRIGHT NOTICE ....................................6
  35.             4.0. WARRANTY ............................................7
  36.             5.0. COST OF Disk eXPress ................................7
  37.             6.0. CONTENTS OF THIS PACKAGE ............................7
  38.             7.0. SYNTAX ..............................................8
  39.                  7.1. Quick start ....................................8
  40.                  7.2. Disk eXPress help screens ......................10
  41.             8.0. COMMAND LINE SWITCHES DESCRIPTION ...................12
  42.                  8.1. Regular mode ...................................12
  43.                  8.2. Extract mode ...................................14
  44.                  8.3. Diskettes containing bad sectors ...............16
  45.                  8.4. Batch mode support .............................16
  46.                  8.5. Disk eXPress real-time bar graph display .......17
  47.             9.0. EXAMPLES ............................................18
  48.                  9.1. Example 1 ......................................18
  49.                  9.2. Example 2 ......................................19
  50.                  9.3. Example 3 ......................................19
  51.                  9.4. Example 4 ......................................20
  52.                  9.5. Example 5 ......................................20
  53.                  9.6. Example 6 ......................................21
  54.                  9.7. Example 7 ......................................21
  55.                  9.8. Example 8 ......................................22
  56.                  9.9. Example 9 ......................................22
  57.             10.0. ERROR MESSAGES .....................................23
  58.                  10.1. List of error messages ........................23
  59.                  10.2. List of error return codes ....................24
  60.             11.0. LIMITATIONS ........................................26
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                                                                        2
  76.  
  77.  
  78.  
  79.        1.0. INTRODUCTION TO Disk eXPress
  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 a 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 guarantees 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 encouraged 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 512-byte per sector PC
  112.           style diskettes.  This includes 160K, 180K, 320K, 360K, 720K,
  113.           1.2M, 1.44M, and the latest 2.88M diskettes.  Any internal or
  114.           external diskette drives connected via DOS or OS/2 block
  115.           device drivers are recognized (ie: diskette drives accessed
  116.           via DRIVER.SYS, $FDD5.SYS, etc.)  All information on the
  117.           diskette is saved to a file for electronic transmission, no
  118.           information is lost! (see /a 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 non-critical part
  129.           of the image is modified, the resulting diskette will still be
  130.           usable.
  131.  
  132.  
  133.  
  134.                                                                        3
  135.  
  136.  
  137.  
  138.        -  Upgradability of the self-extracting code.  Disk eXPress
  139.           provides a means to upgrade the self-extracting code within
  140.           the image file for bug fixes, and future code enhancements
  141.           upgrade.
  142.  
  143.  
  144.        1.3. New features in Disk eXPress Version 2
  145.  
  146.        -  Disk eXPress is now a dual mode executable file.  It runs
  147.           under both OS/2 and DOS.  There is only one version of the
  148.           executable as opposed to two in the previous release.
  149.        -  Disk eXPress exploits the multi-threading capability when it
  150.           is run under OS/2.  It performs simultaneous disk I/O and data
  151.           compression.  This typically gives 10 to 50% speed up compare
  152.           to running it under DOS.
  153.        -  Disk eXPress supports long filename for diskette images
  154.           created under OS/2 with HPFS (High Performance File System)
  155.           disk partition.
  156.        -  New data compression algorithm based on a modified Lempel-Ziv-
  157.           Huffman method.  Disk eXPress now compresses smaller than
  158.           version 1, and is also 2 to 3 times faster.  The compression
  159.           rate is comparable to most file archive programs.  Compression
  160.           is dynamic -- non-compressible data is simply stored.
  161.        -  Real-time bar graph display showing current compression rate,
  162.           disk read/write and compression activities (this capability is
  163.           limited under DOS).
  164.        -  Self-extracting diskette image is also a dual mode executable.
  165.           /DOS and /OS2 switches are no longer required (please refer to
  166.           version 1 documentation).  All the extra functions are
  167.           removed, and are now built-into the extract mode of Disk
  168.           eXPress itself.
  169.        -  Disk eXPress can now create non-self-extracting image.  This
  170.           is useful for diskette archival purpose on hard drive or tape.
  171.        -  Diskette decompression code is now built-into Disk eXPress.
  172.           This can be used to decompress version 2 non-self-extracting
  173.           diskette image or Disk eXPress version 1 and 2 self-extracting
  174.           images.  It has the full set of options, including diskette
  175.           formatting, conversion, and verification.  The decompressor is
  176.           also fully multi-threaded under OS/2 to yield the fastest
  177.           diskette extraction time.
  178.        -  The /t switch is added to all the decompressors so that the
  179.           integrity of the image can be tested before committing the
  180.           lengthy diskette write process.
  181.  
  182.  
  183.        1.4. New Disk eXPress companion program: Xtract
  184.  
  185.        -  Xtract is a dual mode executable.  It features all the
  186.           decompression capability of Disk eXPress, including multi-
  187.           threading under OS/2.
  188.        -  It is used for distributing non-self-extracting diskette
  189.           images in which unlimited distribution right is granted for
  190.  
  191.  
  192.  
  193.                                                                        4
  194.  
  195.  
  196.  
  197.           Xtract for non-commercial products and non-profit services
  198.           after purchasing a licensed copy of Disk eXPress.
  199.        -  Xtract is included in the licensed version of Disk eXPress
  200.           (not included in the shareware version).
  201.  
  202.  
  203.        1.5. What's new in Version 2.10
  204.  
  205.        -  New /q switch for QuickFormatting diskette.
  206.        -  New /DOS switch to create self-extracting images that run
  207.           under DOS and OS/2 DOS box ONLY.  Reduction of 14K overhead in
  208.           self-extracting code.
  209.        -  New /s switch in self-extracting image to bypass warning
  210.           prompt.
  211.        -  Code and compiler optimizations to reduce self-extracting code
  212.           size by 2K and at the same time, achieve a 10% overall speed
  213.           up.
  214.        -  Description can now be entered via environment variables
  215.           (DXPDESC1 to DXPDESC5).
  216.        -  Low level diskette access code has been completely rewritten
  217.           for the DOS side to allow full functionality of Disk eXPress
  218.           under OS/2 DOS box.
  219.        -  Prompt for additional selections ("Format once" and "Format
  220.           all") when a diskette write error is encountered.  This allows
  221.           formatting of just the current track or all subsequent tracks
  222.           before diskette writes.
  223.  
  224.  
  225.        1.6. What's new in Version 2.20
  226.  
  227.        -  Disk eXPress now reads non-DOS diskette.  Diskettes with 512-
  228.           byte sectors and conform to PC physical diskette formats are
  229.           supported.
  230.        -  New 32-bit OS/2 version of Disk eXPress is now included.  The
  231.           32-bit version typically runs 40% faster on the compression /
  232.           decompression thread and is functionally equivalent to the 16-
  233.           bit version.  It also consumes about the same amount of memory
  234.           as the 16-bit version when both are run under OS/2 2.x.  Note:
  235.           the 32-bit version will not run under real DOS.  However, it
  236.           can be launched from the DOS box of OS/2 2.1.
  237.  
  238.  
  239.        1.7. What's new in Version 2.31
  240.  
  241.        -  /fs option for sector skew optimization during diskette
  242.           formatting to allow fastest future diskette read/write speed
  243.           (available only under OS/2).
  244.        -  Threads priority tuning to achieve 5 to 10% increase in speed
  245.           (available only under OS/2).
  246.        -  /d switch for displaying description with self-extracting
  247.           images.
  248.  
  249.  
  250.  
  251.  
  252.                                                                        5
  253.  
  254.  
  255.  
  256.        -  /p switch for specifying pass phrase for encrypting image
  257.           file.  Both the pass phrase and the encryption key are not
  258.           stored in the image file for increased security.
  259.        -  /w switch for wiping out unused tracks at the end of the
  260.           diskette during image extraction.
  261.        -  /a switch is extended to allow direct specification of non-DOS
  262.           diskette.
  263.  
  264.        1.8. What's new in Version 2.32
  265.  
  266.        -  Wildcard processing for self-extracting code replacement (/r
  267.           switch).
  268.        -  Ability to create diskette image from diskette with bad
  269.           (unreadable) sectors.
  270.        -  Proper saving of image description to a file via I/O
  271.           redirection (dxp image /d > filename).
  272.  
  273.        1.9. What's new in Version 2.33/2.34
  274.  
  275.        -  Bug fix release and change of shareware ordering through BMT
  276.           Micro.
  277.  
  278.        -  For a list of bug fixes, please refer to the history file
  279.           (DXP.HST).
  280.  
  281.  
  282.        2.0. SYSTEM REQUIREMENTS
  283.        _________________________________________________________________
  284.  
  285.        IBM PC, PC-AT, PS/1, PS/2 and 100% compatibles.  Minimum 256K
  286.        conventional memory.  MS-DOS or PC-DOS version 3.20 or above;
  287.        OS/2 1.2 or above, including OS/2 Version 2.x, is required.  Hard
  288.        disk is required for storing large image file.  User must also
  289.        provide the necessary program(s) for sending diskette image files
  290.        through telephone network with the use of a modem, and whatever
  291.        is necessary with any other electronic networks.
  292.  
  293.  
  294.        3.0. COPYRIGHT NOTICE
  295.        _________________________________________________________________
  296.  
  297.        DXP/DXP32 (Disk eXPress)  Version 2.34  07/08/94
  298.        XTRACT/XTRACT32 (Xtract)  Version 2.34  07/08/94
  299.        (c) Copyright 1991-94 by Albert J. Shan.  All Rights Reserved.
  300.  
  301.        No part of this program may be disassembled, modified or altered
  302.        by any means.
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.                                                                        6
  312.  
  313.  
  314.  
  315.        4.0. WARRANTY
  316.        _________________________________________________________________
  317.  
  318.        I, Albert J. Shan, make no warranties, expressed or implied,
  319.        including, but not limited to, merchantability or fitness for any
  320.        particular purpose.  In no event shall Albert J. Shan be liable
  321.        for indirect or consequential damages arising from the use of the
  322.        software program.
  323.  
  324.        You are free to redistribute this shareware package in its
  325.        entirety.  No part of this package may be included as part of a
  326.        commercial package.  If you have any questions about commercial
  327.        distribution of Disk eXPress, I can be contacted at:
  328.  
  329.        Albert J. Shan
  330.        4620 Granville Avenue
  331.        Richmond, B.C.
  332.        CANADA  V7C 1E4
  333.  
  334.        or via CompuServe, ID 70730,401
  335.        or via Internet, 70730.401@compuserve.com
  336.  
  337.  
  338.        5.0. COST OF Disk eXPress
  339.        _________________________________________________________________
  340.  
  341.        The user is granted a 30 days trial period, after which he or she
  342.        is required to register the product.  The cost of a single
  343.        machine license is $25 U.S.  Please refer to the file ORDER.FRM
  344.        for details.
  345.  
  346.  
  347.        6.0. CONTENTS OF THIS PACKAGE
  348.        _________________________________________________________________
  349.  
  350.        The following files are included in this package:
  351.  
  352.            DXP.EXE         - 16-bit OS/2 and DOS executable
  353.            DXP32.EXE       - 32-bit OS/2 executable
  354.            DXP.DOC         - This documentation
  355.            DXP.HST         - History file
  356.            ORDER.FRM       - Order form
  357.            README          - Last minute information
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.                                                                        7
  371.  
  372.  
  373.  
  374.        7.0. SYNTAX
  375.        _________________________________________________________________
  376.  
  377.        7.1. Quick start
  378.  
  379.        The syntax of Disk eXPress is very similar to the COPY command.
  380.        To create a diskette image, type:
  381.  
  382.          dxp drive: filename
  383.  
  384.        To create a diskette from an image file, type:
  385.  
  386.          dxp filename drive:
  387.  
  388.        For example, to create a diskette image from your drive B:,
  389.        simply type:
  390.  
  391.          dxp b: my_image
  392.  
  393.        The file "my_image.exe" will be created when Disk eXPress
  394.        finsihes.
  395.  
  396.        To create the diskette from the self-extracting file created
  397.        above, you type:
  398.  
  399.          my_image b:
  400.  
  401.        OR
  402.  
  403.          dxp my_image.exe b:
  404.  
  405.        Disk eXPress allows command switches to be specified anywhere on
  406.        the command line.  Spaces between command line switches are not
  407.        required.  By default, the file extension is ".EXE" regardless of
  408.        what user specifies.  When creating a non-self-extracting
  409.        diskette image with the /i switch, user is free to choose the
  410.        file extension.  For consistency, the recommended file extension
  411.        to use is ".DXP".
  412.  
  413.        For example, under OS/2 with HPFS drive, a non-self-extracting
  414.        diskette image can be created as follows:
  415.  
  416.          dxp a: "This is diskette 3 of 5.DXP" /i
  417.  
  418.        To create the diskette from the image:
  419.  
  420.          dxp "This is diskette 3 of 5.DXP" a: /f /v
  421.  
  422.        The /f switch tells Disk eXPress to format the diskette a track
  423.        at a time just before each track write.
  424.  
  425.        The /v switch tells Disk eXPress to verify the diskette write
  426.        after the track is written.
  427.  
  428.  
  429.                                                                        8
  430.  
  431.  
  432.  
  433.  
  434.        Note: When using quotes for HPFS filenames, make sure the quotes
  435.        are in front and after if you are specifying a full path:
  436.  
  437.        INCORRECT:
  438.  
  439.          dxp c:\"Disk Image 1.dxp" a:
  440.          c:\images\"Disk Image 2" a:
  441.  
  442.        CORRECT:
  443.  
  444.          dxp "c:\Disk Image 1.dxp" a:
  445.          "c:\images\Disk Image 2" a:
  446.  
  447.  
  448.        To QuickFormat a diskette in drive A:, type:
  449.  
  450.          dxp a: /q
  451.  
  452.        The /s switch may be used to bypass the QuickFormat warning
  453.        prompt.
  454.  
  455.  
  456.        You may stop Disk eXPress at any time by pressing Ctrl-C or Ctrl-
  457.        Break.  The BREAK ON/OFF setting under DOS is ignored.
  458.  
  459.        If Disk eXPress encounters any cluster marked as bad in the File
  460.        Allocation Table, you may receive a warning:
  461.  
  462.         X bad cluster(s) detected in the File Allocation Table.
  463.  
  464.        Disk eXPress will try to recover any unreadable sectors.  If any
  465.        sector is proved to be unreadable, it will store the sector in
  466.        the diskette image with all zeros.
  467.  
  468.        Note:
  469.        Disk eXPress will not detect bad clusters in advance if you by-
  470.        pass File Allocation Table (FAT) scanning by specifying the /a
  471.        switch.
  472.  
  473.        Disk eXPress or Xtract cannnot restore a diskette image onto a
  474.        diskette that contains physically bad sectors.
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                                                                        9
  489.  
  490.  
  491.  
  492.        7.2. Disk eXPress help screens
  493.  
  494.        Type DXP at the OS/2 or DOS prompt to receive this help screen:
  495.  
  496.         Disk eXPress (16-bit OS/2 and DOS) V2.34  07/08/94  SHAREWARE VERSION
  497.         (c) Copyright 1991-94 Albert J. Shan.  All Rights Reserved.
  498.  
  499.         Regular mode: DXP [options] [drive:] [d:][path]filename
  500.           [options]  /?    Display extract mode help screen
  501.                      /a[c] Read the entire diskette [c = diskette capacity]
  502.                      /d    Input diskette image description (5 lines max.)
  503.                      /DOS  Output DOS only self-extracting executable
  504.                      /i    Output non-self-extracting diskette image
  505.                      /n    Disable data compression
  506.                      /p"s" Specify pass phrase "s = pass phrase"
  507.                      /s    Suppress overwrite prompt
  508.                     drive  Drive letter of the target diskette drive
  509.                  filename  Name of output file
  510.         Valid options with only filename specified:
  511.                      /d    Display description in image file
  512.                      /e    Edit description in image file
  513.                      /r    Replace or add self-extracting code to image file
  514.  
  515.         Note: Items enclosed in [] or "" are optional.
  516.               Diskette must not contain any unreadable sectors.
  517.  
  518.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K, 1.44M
  519.         and 2.88M standard 512-byte sector diskettes.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.                                                                       10
  548.  
  549.  
  550.  
  551.        Type DXP /?, and you'll get the help screen for the extract mode:
  552.  
  553.         Disk eXPress (16-bit OS/2 and DOS) V2.34  07/08/94  SHAREWARE VERSION
  554.         *** Type DXP by itself to see the regular mode help screen ***
  555.  
  556.         Extract mode: DXP [options] [d:][path][filename] [drive:]
  557.           [options]  /t    Test image file integrity only
  558.                      /d    Display description in image file
  559.                      /f[s] Format target diskette [sector skew optimization]
  560.                      /p"s" Specify pass phrase "s = pass phrase"
  561.                      /s    Suppress overwrite prompt
  562.                      /v    Verify ON (system verify plus read and compare)
  563.                      /w    Wipe unused tracks
  564.                      /c    Convert image onto a higher density diskette
  565.                            (Target diskette must be pre-formatted, and
  566.                             of different form factor.  It also overrides /f)
  567.                  filename  Name of input file
  568.                     drive  Drive letter of the target diskette drive
  569.         Valid option with only drive specified:
  570.                      /q    QuickFormat target diskette
  571.  
  572.         Note: Items enclosed in [] are optional.
  573.               The target diskette must be free of defects (no bad sectors).
  574.  
  575.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K, 1.44M
  576.         and 2.88M standard 512-byte sector diskettes.
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.                                                                       11
  607.  
  608.  
  609.  
  610.        8.0. COMMAND LINE SWITCHES DESCRIPTION
  611.        _________________________________________________________________
  612.  
  613.        When Disk eXPress is used under regular mode for making diskette
  614.        images, the following switches are available:
  615.  
  616.  
  617.        8.1. Regular mode
  618.  
  619.        /a   By default, Disk eXPress reads up to the last allocated
  620.             sector, according to the information it finds in the File
  621.             Allocation Table (FAT) in order to reduce the size of the
  622.             image file.  However, if there is any deleted files at the
  623.             end of FAT that you may want to recover later, the default
  624.             action will prevent you from a successful file recovery.
  625.             Use /a to tell Disk eXPress to create an exact duplicate of
  626.             the original diskette by saving ALL disk sectors to the
  627.             image file.
  628.  
  629.             When Disk eXPress detects non-DOS diskette, this switch will
  630.             be automatically applied.  If you suspect automatically
  631.             diskette sensing is incorrect, you can supply the actual
  632.             capacity of the diskette by speifying /ac, where c = 160,
  633.             180, 320, 360, 720, 1.2, 1.44, or 2.88.  Only the first 3
  634.             characters are checked, so /a1.44M is equivalent to /a1.4.
  635.  
  636.        /d   Prompt user to input description for the diskette image.  A
  637.             maximum of 5 lines of 40 characters each can be stored.
  638.             Disk eXPress bypasses user input, and reads the description
  639.             from the environment variables DXPDESC1 to DXPDESC5, if
  640.             there is at least one defined.  You can also redirect the
  641.             decription input from a file like this:
  642.  
  643.             C:> type desc.txt | dxp a: image1 /d
  644.  
  645.             (Make sure the description text file has exactly 5 lines of
  646.             text in it.)
  647.  
  648.             You can also save the description to a file for editing:
  649.  
  650.             C:> dxp image2.exe /d > desc2.txt
  651.  
  652.        /DOS By default, Disk eXPress creates self-extracting images that
  653.             can be run under OS/2 and DOS.  By specifying this switch, a
  654.             DOS only self-extracting image is created.  The DOS code has
  655.             been written so that it will run under OS/2 DOS box with
  656.             almost no speed penality.  This cuts self-extracting code
  657.             overhead by about 14K.
  658.  
  659.        /i   Create a non-self-extracting diskette image file.  The self-
  660.             extracting code will not be bundled with the resulting file.
  661.             Disk eXPress does not enforce any file extension for non-
  662.             self-extracting diskette image.  For consistency, it is
  663.  
  664.  
  665.                                                                       12
  666.  
  667.  
  668.  
  669.             recommended to use ".DXP" as file extension.  Without
  670.             specifying this switch, the default file extension will be
  671.             ".EXE".
  672.  
  673.        /n   Disable compression.  If the contents of the diskette is
  674.             highly compressed, Disk eXPress may not succeed in
  675.             compressing the data any further.  This can be visually
  676.             inspected when Disk eXPress is run the first time without
  677.             the /n switch.  If the real-time compression rate is very
  678.             low (close to 0%), disabling compression is recommended.
  679.  
  680.        /p   Specify pass phrase for encrypting the image file.  Pass
  681.             phrase can be specified immediately after the switch;
  682.             otherwise, it will prompt you to type in a pass phrase.  The
  683.             pass phrase must be 4 to 64 characters in length.  It is
  684.             case sensitive and spaces can be embedded.  When the pass
  685.             phrase contains space, it can be specified as: /p"Secret
  686.             Pass Phrase".  Special characters can also be entered by
  687.             using the Alt-NumPad key sequence.  For example, if you wish
  688.             to use the "beta" character, you can hold down the Alt key,
  689.             press 225 on the NumPad, and release the Alt key.
  690.  
  691.             Once the pass phrase is used, Disk eXPress will
  692.             automatically encrypt the image data based on the pass
  693.             phrase.  The pass phrase and the encryption key are not
  694.             stored anywhere in the image file, thus making it impossible
  695.             for anyone to find out the pass phrase or the encryption key
  696.             by looking at a binary dump.  The self-extracting image will
  697.             prompt for pass phrase and perform 32-bit CRC checking to
  698.             make sure the image header and the executable code are not
  699.             tampered.  The self-extracting code will not run if it fails
  700.             the CRC test.
  701.  
  702.       NOTE: Data encryption is only as good as the person who uses it.
  703.             Better security can be obtained by specifying a longer pass
  704.             phrase with six characters or more.  It is also the user's
  705.             responsibility to keep the pass phrase in a safe place and
  706.             make it known to the other users who are also using the Disk
  707.             eXPress image archives.
  708.  
  709.             The encryption algorithm used is by no means bullet proof,
  710.             and may not resist cryptanalysis.  However, it is reasonably
  711.             complex to prevent the average computer users from
  712.             deciphering the data.  Better result is obtained if the
  713.             image file is compressed.  If you have sensitive data, the
  714.             use of a more sophisticated encrypter is recommended.
  715.  
  716.        /s   Suppress any overwrite (y/N) prompt.  It assumes an answer
  717.             of 'y' to all prompts.
  718.  
  719.        Three switches are available when no drive letter is specified in
  720.        regular mode:
  721.  
  722.  
  723.  
  724.                                                                       13
  725.  
  726.  
  727.  
  728.        /d   Display the description of the image file.  The full path to
  729.             the diskette image must be specified.
  730.  
  731.        /e   Edit the description stored in an image file.  This is used
  732.             to correct the description later instead of having to redo
  733.             the entire image from scratch.  It will automatically prompt
  734.             you for the pass phrase if the image file is encrypted.  See
  735.             the /p switch on bypassing the pass phrase prompt.
  736.  
  737.        /r   Replace or add extract code to image file.  Filename may
  738.             contain any wildcard characters (ie: ? and *).  If /r is
  739.             used against a self-extracting diskette image, the self-
  740.             extracting code will be replaced with the one stored within
  741.             Disk eXPress.  No backup file is created if the operation is
  742.             successful.  If used against a non-self-extracting image
  743.             file, the self-extracting code will be added, and a new file
  744.             with ".EXE" extension will be created.  The ".EXE" file
  745.             created by this switch is stored in the same location of the
  746.             original image file.  The /DOS, /e, /p and /s switch can be
  747.             used together with this switch.  NOTE: the /e switch does
  748.             not allow the specification of wildcards.
  749.  
  750.             Note: The file extension replacement algorithm simply
  751.             removes any file extension starting after the last '.' and
  752.             then appending "EXE".  Since it is possible to use multiple
  753.             '.' under HPFS, the text after the last '.' is discarded.
  754.             It is advisable to avoid using multiple '.' with HPFS
  755.             filename, and use a space instead.
  756.  
  757.  
  758.        8.2. Extract mode
  759.  
  760.        Disk eXPress can decode and extract 3 types of images: type 0
  761.        (non-compressed), type 1 (Version 1 compression), and type 2
  762.        (Version 2 compression), including non-DOS, and encrypted images.
  763.        When Disk eXPress is used for extracting an image file, the image
  764.        file can be a non-self-extracting image file, or a self-
  765.        extracting executable.  The full path to the image file must be
  766.        specified.  Wild cards are not allowed.  All the switches
  767.        available in the extract mode of Disk eXPress are identical to
  768.        the standalone Xtract program.
  769.  
  770.        /t   Test the integrity of the image only.  Disk eXPress performs
  771.             data decompression (if necessary) and runs through a 32-bit
  772.             CRC computation on the data stored in the image.  It reports
  773.             the stored and computed CRC values.  If these values do not
  774.             match, the image will be bad.  It overrides the
  775.             specification of a drive letter, /f, /s, /v, and the /c
  776.             switch.  It will prompt for pass phrase if the image file is
  777.             encrypted.  See the /p switch on bypassing the prompt.
  778.  
  779.        /d   Display the description of the image file.  The full path to
  780.             the diskette image must be specified.
  781.  
  782.  
  783.                                                                       14
  784.  
  785.  
  786.  
  787.  
  788.        /f   Format the target diskette.  Only standard PC physical
  789.             diskette formats with 512-byte sectors are supported.  If
  790.             /fs is specified, sector skew optimization is performed to
  791.             allow the fastest diskette read/write speed in the future.
  792.             The speed up is anywhere from 10 to 50% depending on the
  793.             hardware.  The formatting time is longer when this option is
  794.             specified.  Sector skew optimization is only available under
  795.             OS/2, and not available in the shareware release.
  796.  
  797.        /p   Specify pass phrase for unlocking the file for various
  798.             operations.  Disk eXPress detects encrypted image file, and
  799.             will automatically prompt for a pass phrase even if this
  800.             switch is not specified.  Pass phrase can specified
  801.             immediately after the switch to bypass the pass phrase
  802.             prompt.  The pass phrase must be 4 to 64 characters in
  803.             length.  It is case sensitive and spaces can be embedded.
  804.             When the pass phrase contains space, it can be specified as:
  805.             /p"Secret Pass Phrase".
  806.  
  807.        /s   Suppress any overwrite (y/N) prompt.  It assumes an answer
  808.             of 'y' to all prompts.
  809.  
  810.        /v   Verify on.  It performs a track verify via operating system
  811.             call, follows by a track read, and a byte-by-byte comparison
  812.             with the original data.  The byte-by-byte comparison is
  813.             added as an extra protection should the CRC test of track
  814.             verify failed to pick up an error.  If disk cache is used
  815.             under DOS, the byte comparison test may not be valid due to
  816.             the fact that the cache is supplying the data with no actual
  817.             read performed on the diskette.  Disk eXPress bypasses disk
  818.             cache when it is run under OS/2.
  819.  
  820.        /w   Wipe unused tracks on diskette during image file extraction.
  821.             Unused space at the end of the target diskette is written
  822.             with hex F6 so that any sensitive data previously written on
  823.             the diskette are erased.  NOTE: this function is not
  824.             available in self-extracting images.
  825.  
  826.        /c   Convert the image onto a higher density diskette.  The
  827.             target diskette must be of different form factor (3.5" to
  828.             5.25" and vice versa, but not 3.5" 720K to 3.5" 1.44M due to
  829.             hardware limitations).  It requires a formatted diskette,
  830.             and will automatically override the /f switch.
  831.  
  832.             Here is a list of all the diskette conversion possibilities:
  833.  
  834.               160K/180K/320K/360K to 720K/1.44M/2.88M
  835.                              720K to 1.2M
  836.                              1.2M to 1.44M/2.88M
  837.  
  838.        /q   QuickFormat of diskette in drive.  This is useful for
  839.             quickly erasing all files on a DOS formatted diskette.  The
  840.  
  841.  
  842.                                                                       15
  843.  
  844.  
  845.  
  846.             File Allocation Table (FAT) and all directory entries are
  847.             erased to zero.  Bad sectors and volume serial are preserved
  848.             after QuickFormatting.
  849.  
  850.  
  851.        8.3. Diskettes containing bad sectors
  852.  
  853.        Starting from version 2.32, Disk eXPress allows the creation of
  854.        diskette images from diskettes containing unreadable (ie: bad)
  855.        sectors.  When Disk eXPress encounters unreadable sectors, the
  856.        following message is displayed:
  857.  
  858.        Read Error: Abort, Retry, Ignore? (a/R/i):
  859.  
  860.        Choose "Retry" to tell Disk eXPress to retry reading the entire
  861.        track of information in one operation, and will re-prompt for the
  862.        above message if any of the sectors on the track is unreadable.
  863.  
  864.        Choose "Ignore" to tell Disk eXPress to retry reading each sector
  865.        on the track in sequence.  Any unreadable sectors will be saved
  866.        as 512 bytes of zeros.  The image header is updated to notify the
  867.        extraction code that the image file in question contains
  868.        unreadable sectors from the previous image built.
  869.  
  870.  
  871.        8.4. Batch mode support
  872.  
  873.        You can use Disk eXPress, Xtract, and self-extracting images in a
  874.        batch file (.CMD file under OS/2 and .BAT file under DOS).  For a
  875.        list of error return codes, please refer to section 10.2 for
  876.        details.  Normally, all display output is sent to standard out
  877.        (stdout), and can be redirected to a file.  Errors and warning
  878.        messages are sent to standard error (stderr).  You can discard
  879.        all Disk eXPress output by redirecting both stdout and stderr to
  880.        NUL (ie: DXP A: MyDisk > NUL 2>NUL).
  881.  
  882.        In addition to entering diskette image description via the /d
  883.        switch, you can also enter the description from within a batch
  884.        file as shown below:
  885.  
  886.        SET DXPDESC1=Disk eXPress
  887.        SET DXPDESC2=Version 2.34
  888.        SET DXPDESC4=(c) Copyright 1991-94 Albert J. Shan
  889.        dxp a: MyDisk /d
  890.        SET DXPDESC1=
  891.        SET DXPDESC2=
  892.        SET DXPDESC4=
  893.  
  894.        Line 3 and 5 are treated as blanks since DXPDESC3 and DXPDESC5
  895.        are not specified.  Batch mode description editing (/e) is also
  896.        supported.
  897.  
  898.  
  899.  
  900.  
  901.                                                                       16
  902.  
  903.  
  904.  
  905.        8.5. Disk eXPress real-time bar graph display
  906.  
  907.        One of the new features of Disk eXPress Version 2 is the use of a
  908.        real-time bar graph display.  Disk eXPress and Xtract will
  909.        exercise the multi-threading capability under OS/2, and you'll
  910.        see a display similar to the following:
  911.  
  912.                                    3%      25%       50%       75%      100%
  913.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  914.           COMPRESS  52%   37    1  █████████████████▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒
  915.  
  916.        The above bar graph depicts 3 concurrent threads:
  917.  
  918.           ▒ Read thread.  Performs continuous reading of diskette (or
  919.             disk file if it is in extract mode), and releases the
  920.             diskette drive (or disk file) for use by another process
  921.             when reading is finished.
  922.           ▓ Compression/decompression thread.  Compression/decompression
  923.             is performed as soon as data is available from the read
  924.             thread.
  925.           █ Write thread.  Compressed data is written to a disk file (or
  926.             decompressed data written to diskette in extract mode).
  927.             This can be another diskette drive or any block device.
  928.  
  929.        The description under "Action" shows which thread has just
  930.        started executing.
  931.  
  932.        The number under "Rate" shows the current compression rate.  It
  933.        is the percentage reduction with respect to the size of the
  934.        original data.
  935.  
  936.        The numbers under "Track" and "Head" show the current disk track
  937.        and head where operation is being performed.
  938.  
  939.        Since DOS has only one thread of execution, only one bar is
  940.        updated at any time.  Read/Compress/Decompress/Write occurs
  941.        sequentially.
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.                                                                       17
  961.  
  962.  
  963.  
  964.        9.0. EXAMPLES
  965.        _________________________________________________________________
  966.  
  967.        9.1. Example 1
  968.  
  969.        To pack a 360K diskette in drive B: onto a file called 'disk1'
  970.        for modem transmission, you type:
  971.  
  972.            dxp b: e:\upload\disk1
  973.  
  974.        By default, Disk eXPress will automatically append ".EXE" onto
  975.        the output file name.  If you specify something else as file
  976.        extension, it will be removed before appending.  If the command
  977.        line syntax is correct, Disk eXPress will first run a self-check
  978.        for virus/modification, then it will proceed to create the
  979.        diskette image.  You'll receive a screen similar to the following
  980.        after Disk eXPress is finished:
  981.  
  982.           360K diskette found in drive B:
  983.  
  984.           File Allocation Table statistics:
  985.           Track 33 head 1 contains the last allocated sector, sector 609.
  986.  
  987.                                    3%      25%       50%       75%      100%
  988.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  989.              STORE  28%   33    1  ████████████████████████████████████████
  990.  
  991.           32-bit CRC of diskette image is DB49A615
  992.  
  993.        By default, Disk eXPress will analyze the FAT and save up to the
  994.        last sector used on the diskette.  In the above example, it stops
  995.        at track 33, head 1, because sector 609 is the last allocated
  996.        sector.  If you have a fragmented diskette, you might receive a
  997.        screen similar to the following when you run Disk eXPress:
  998.  
  999.           1.44M diskette found in drive A:
  1000.  
  1001.           File Allocation Table statistics:
  1002.           Track 36 head 1 contains the last allocated sector, sector 1319.
  1003.  
  1004.           Disk fragmentation detected:
  1005.           814 unallocated sectors will be saved in image
  1006.           (61% of total used sectors).
  1007.           The diskette requires compression for maximum storage efficiency.
  1008.  
  1009.                                    3%      25%       50%       75%      100%
  1010.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  1011.           COMPRESS  48%   16    0  ██████▓▓▒▒▒▒▒▒▒
  1012.  
  1013.        etc.
  1014.  
  1015.        Running a disk optimization utility on the diskette will help
  1016.        packing files tightly together for maximum storage efficiency.
  1017.  
  1018.  
  1019.                                                                       18
  1020.  
  1021.  
  1022.  
  1023.        Alternatively, you can copy all the files to another freshly
  1024.        formatted diskette so that the files are packed next to each
  1025.        other.
  1026.  
  1027.  
  1028.        9.2. Example 2
  1029.  
  1030.        To save the entire diskette from drive A: (including all the
  1031.        unused sectors) onto the image with compression turned off, you
  1032.        type:
  1033.  
  1034.            dxp /a /n a: e:\upload\disk1
  1035.  
  1036.        You will see this warning if the file exists:
  1037.  
  1038.           Output file E:\UPLOAD\DISK1.EXE exists, overwrite? (y/N):
  1039.  
  1040.        Default action is 'No' for pressing the 'Enter' key.  Type 'y'
  1041.        then 'Enter' to overwrite.
  1042.  
  1043.        To suppress the warning, specify /s on the command line:
  1044.  
  1045.            dxp /a /n a: e:\upload\disk1 /s
  1046.  
  1047.        Notice that you can specify switches anywhere you want on the
  1048.        command line, Disk eXPress will sort them out for you.
  1049.  
  1050.  
  1051.        9.3. Example 3
  1052.  
  1053.        To enter a description when creating an image, you type:
  1054.  
  1055.            dxp b: test15 /s /d
  1056.  
  1057.        You'll see:
  1058.  
  1059.           Please enter diskette description: (5 lines max.)
  1060.             ┌────────────────────────────────────────┐
  1061.           1:
  1062.  
  1063.        You're then prompted to enter a maximum of five lines of
  1064.        description (40 characters for each line).  To enter a blank
  1065.        line, just press Enter.
  1066.  
  1067.        To continue our example, type in the following:
  1068.  
  1069.           Please enter diskette description: (5 lines max.)
  1070.             ┌────────────────────────────────────────┐
  1071.           1: Joe,
  1072.           2: This is the latest beta release of Space
  1073.           3: Commander.  Try it out without a joy
  1074.           4: stick and let me know how it goes.
  1075.           5:   Regards, John
  1076.  
  1077.  
  1078.                                                                       19
  1079.  
  1080.  
  1081.  
  1082.  
  1083.           360K diskette found in drive B:
  1084.  
  1085.           File Allocation Table statistics:
  1086.           Track 33 head 1 contains the last allocated sector, sector 609.
  1087.  
  1088.                                    3%      25%       50%       75%      100%
  1089.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  1090.              STORE  28%   16    1  ███████████████████▓▓▒▒▒▒▒▒▒
  1091.  
  1092.        etc.
  1093.  
  1094.  
  1095.        9.4. Example 4
  1096.  
  1097.        To change the description of the diskette image created in the
  1098.        last example, type:
  1099.  
  1100.            dxp e:\upload\test15.exe /e
  1101.  
  1102.        The /e switch allows description in the image file to be edited.
  1103.        Note: The /r switch (self-extracting code replacement) can also
  1104.        be specified together with the /e switch.
  1105.  
  1106.  
  1107.        9.5. Example 5
  1108.  
  1109.        Now that you have the self-extracting image, what are you going
  1110.        to do with it?  Simply run it!  To unpack the disk image created
  1111.        in example 3, type 'test15' to see the help screen:
  1112.  
  1113.           Disk eXPress Self-Extracting Diskette Image (OS/2 and DOS)
  1114.           Version 2.34  07/08/94
  1115.           (c) Copyright 1991-93 Albert J. Shan.  All Rights Reserved.
  1116.  
  1117.           Usage: TEST15 [/d] [/s] [/t] [drive:]
  1118.  
  1119.              /d  Display image description
  1120.              /s  Suppress overwrite prompt
  1121.              /t  Test image integrity only
  1122.           drive  Drive letter of a valid floppy disk drive
  1123.  
  1124.           Note: The target diskette must be formatted and must not
  1125.                 have any bad sectors.
  1126.  
  1127.        To finish our example, now type:
  1128.  
  1129.            test15 b:
  1130.  
  1131.        You'll see:
  1132.  
  1133.           ┌────── Diskette Image Description ──────┐
  1134.            Joe,
  1135.  
  1136.  
  1137.                                                                       20
  1138.  
  1139.  
  1140.  
  1141.            This is the latest beta release of Space
  1142.            Commander.  Try it out without a joy
  1143.            stick and let me know how it goes.
  1144.              Regards, John
  1145.           └────────────────────────────────────────┘
  1146.           360K diskette image (Disk eXPress type 2)
  1147.  
  1148.  
  1149.           Diskette in drive B: is about to be overwritten
  1150.           with new information.  Do you wish to continue? (y/N)
  1151.  
  1152.        Default action is 'No' for pressing the 'Enter' key.  Press 'y'
  1153.        then 'Enter' to start diskette image extraction.  The /s switch
  1154.        can be specified to bypass the prompt.  The /d switch can be used
  1155.        alone to display the description in the image.
  1156.  
  1157.  
  1158.        9.6. Example 6
  1159.  
  1160.        To test the integrity of the diskette image without writing out
  1161.        to the diskette, simply type:
  1162.  
  1163.            test15 /t
  1164.  
  1165.        And you'll see:
  1166.  
  1167.           ┌────── Diskette Image Description ──────┐
  1168.            Joe,
  1169.            This is the latest beta release of Space
  1170.            Commander.  Try it out without a joy
  1171.            stick and let me know how it goes.
  1172.              Regards, John
  1173.           └────────────────────────────────────────┘
  1174.           360K diskette image (Disk eXPress type 2)
  1175.  
  1176.           100% Read
  1177.  
  1178.             32-bit CRC stored: DB49A615
  1179.           32-bit CRC computed: DB49A615
  1180.  
  1181.        Note: /t overrides drive letter specified on the command line.
  1182.  
  1183.  
  1184.        9.7. Example 7
  1185.  
  1186.        Now that Joe got the diskette image.  He doesn't have a 360K or
  1187.        1.2M drive (5.25" drive).  All he has is a 1.44M 3.5" drive.  He
  1188.        also happens to have a spare 720K (low-density) diskette he can
  1189.        use.  What can he do?  He can use the /c switch in the extract
  1190.        mode of Disk eXPress or Xtract.  The /c switch can be used to
  1191.        convert the diskette image from 360K to 720K, and all the data
  1192.        will still be intact, and usable.  The diskette used for
  1193.  
  1194.  
  1195.  
  1196.                                                                       21
  1197.  
  1198.  
  1199.  
  1200.        conversion must be pre-formatted.  So, Joe went ahead and
  1201.        formatted the diskette as a 720K diskette, and he types:
  1202.  
  1203.            dxp test15.exe a: /c
  1204.  
  1205.        And receives the following screen (answer y at the prompt):
  1206.  
  1207.         Checking test15.EXE for modifications ... OK.
  1208.  
  1209.           360K diskette image (Disk eXPress type 2)
  1210.  
  1211.         Diskette in drive A: is about to be overwritten
  1212.         with new information.  Do you wish to continue? (y/N) y
  1213.  
  1214.           720K diskette found in drive A:
  1215.         Converting 360K image onto 720K diskette ...
  1216.  
  1217.                               3%      25%       50%       75%      100%
  1218.             Action Track Head ├────────┼─────────┼─────────┼─────────┤
  1219.         DECOMPRESS   20    0  █████████▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  1220.  
  1221.        etc.
  1222.  
  1223.  
  1224.        9.8. Example 8
  1225.  
  1226.        To QuickFormat a diskette, type:
  1227.  
  1228.          dxp a: /q
  1229.  
  1230.        OR
  1231.  
  1232.          xtract a: /q
  1233.  
  1234.        And you'll see:
  1235.  
  1236.        Drive A: is about to be QuickFormatted.
  1237.        Do you wish to continue? (y/N)
  1238.  
  1239.        The default action is 'No' for pressing the Enter key.  The /s
  1240.        switch can be used to bypass the warning prompt.
  1241.  
  1242.        Type 'y' and press Enter and you'll see:
  1243.  
  1244.        QuickFormatting 1.44M diskette ... Done.
  1245.  
  1246.  
  1247.        9.9. Example 9
  1248.  
  1249.        To build a non-self-extracting, non-DOS diskette image, with pass
  1250.        phrase at the same time, type:
  1251.  
  1252.          dxp a: unixboot.dxp /i /p"FoO BaR"
  1253.  
  1254.  
  1255.                                                                       22
  1256.  
  1257.  
  1258.  
  1259.        10.0. ERROR MESSAGES
  1260.        _________________________________________________________________
  1261.  
  1262.        10.1. List of error messages
  1263.  
  1264.        Disk eXPress incorporates 32-bit CRC checking for itself and the
  1265.        image it creates.  In the event of a virus infection or other
  1266.        means of modifications (such as errors in electronic
  1267.        transmissions), the program will abort, and the following message
  1268.        is displayed:
  1269.  
  1270.        *** Executable code has been modified!
  1271.  
  1272.        Here is a run down of major error messages produced by Disk
  1273.        eXPress, Xtract and self-extracting images: (usually a beep
  1274.        followed by one of the following messages)
  1275.  
  1276.        - For bad or not properly formatted diskette during read, write,
  1277.          format or verify (no beep for any Abort, Retry messages):
  1278.  
  1279.          Read Error: Abort, Retry, Ignore? (a/R/i):
  1280.  
  1281.          Write Error: Abort, Retry? (a/R):
  1282.  
  1283.          Write Error: Abort, Retry, Format once, Format all? (a/R/o/f):
  1284.  
  1285.          Format Error: Abort, Retry? (a/R):
  1286.  
  1287.          Verify Error: Abort, Retry? (a/R):
  1288.  
  1289.          *** Bad CRC.
  1290.  
  1291.          *** Sector not found.
  1292.  
  1293.          *** General failure reading drive X:
  1294.  
  1295.          *** Non-standard/unformatted diskette.
  1296.  
  1297.        - When disk is full during image creation (output will be
  1298.          deleted):
  1299.  
  1300.          *** Error writing disk or disk full.
  1301.  
  1302.        - With a write protected diskette during diskette write:
  1303.  
  1304.          *** Diskette is write protected.
  1305.  
  1306.        - When replacing self-extracting code in images with a lower
  1307.          revision level of Disk eXPress:
  1308.  
  1309.          *** Cannot operate on Disk eXPress Vx.xxx image.
  1310.  
  1311.        - When diskette drive is not ready:
  1312.  
  1313.  
  1314.                                                                       23
  1315.  
  1316.  
  1317.  
  1318.  
  1319.          *** Drive X: not ready.
  1320.  
  1321.        - When drive specified is not available or not a diskette drive:
  1322.  
  1323.          *** Invalid drive/path specified.
  1324.  
  1325.          *** Drive X: is not a floppy drive.
  1326.  
  1327.        - When attempting to replace a version 1 self-extracting header
  1328.          with version 2 by the /r switch:
  1329.  
  1330.          *** Cannot operate on Disk eXPress V1.0xx image.
  1331.  
  1332.        - When Disk eXPress or Xtract is asked to extract an unrecognized
  1333.          image file:
  1334.  
  1335.          *** Problem with file: filename
  1336.          Probable cause of problem:
  1337.  
  1338.          1. File is not a Disk eXPress image file,
  1339.          2. Image file has been modified,
  1340.          3. Image file was created by a special version of Disk eXPress.
  1341.  
  1342.        - When Disk eXPress or Xtract is asked to convert a diskette
  1343.          image to the same form factor diskette:
  1344.  
  1345.          *** Conversion not supported on target diskette.
  1346.  
  1347.        - When pass phrase entered is incorrect upon an image extraction:
  1348.  
  1349.         *** Incorrect pass phrase, operation aborted.
  1350.  
  1351.        - Some error messages returned by Disk eXPress are displayed as:
  1352.  
  1353.          *** Error n, Drive X:
  1354.  
  1355.        In such event, please document the procedure on how to get to the
  1356.        above error, and contact me as soon as possible.
  1357.  
  1358.  
  1359.        10.2. List of error return codes
  1360.  
  1361.        The following is a list of error return codes produced by Disk
  1362.        eXPress, Xtract, and self-extracting images:
  1363.  
  1364.        Code Number    Cause of Error
  1365.             0         Operation successful, no error found.
  1366.             1         No operation is performed; such as the displaying
  1367.                       of help screens.
  1368.             2         Incorrect Operating System version.
  1369.             3         User abort by answering 'N' to a (Y/N) type
  1370.                       prompt.
  1371.  
  1372.  
  1373.                                                                       24
  1374.  
  1375.  
  1376.  
  1377.             4         User press Ctrl-C or Ctrl-Break to abort program.
  1378.             5         Memory allocation error (Program error).
  1379.             6         Cannot create thread under OS/2 (check THREADS= in
  1380.                       OS/2's CONFIG.SYS).
  1381.             7         Other system errors.  The actual return code is
  1382.                       displayed on the screen as: *** Error n, Drive X:.
  1383.             8-9       Reserved.
  1384.             10        Drive specified is not a floppy drive.
  1385.             11        Invalid Drive or path specified.
  1386.             12        Uncertain media in drive (non-standard/unformatted
  1387.                       diskette).
  1388.             13        Diskette Drive not ready.  No diskette in drive,
  1389.                       or drive is in used by another program.
  1390.             14        Diskette is write protected.
  1391.             15        Disk write error or disk full.
  1392.             16        CRC Error.  Possibily due to bad diskette.
  1393.             17        Sector not found.  Possibility due to bad
  1394.                       diskette.
  1395.             18        Diskette Format error.  Possibily due to bad
  1396.                       diskette.
  1397.             19        General failure.  Possibily due to unformatted
  1398.                       diskette.
  1399.             20-29     Reserved.
  1400.             30        Cannot open file.  Either it is not found or in
  1401.                       used by another program.
  1402.             31        Bad image file header.  Image header failed CRC
  1403.                       test.
  1404.             32        File is corrupted possibily due to error in
  1405.                       electronic transimssion or infection by virus.
  1406.             33        Bad image file CRC.  Possibily due to error in
  1407.                       electronic transmission.
  1408.             34        Incorrect image file version.
  1409.             35        Unknown image type.
  1410.             36        No files found for /r switch processing.
  1411.             37-39     Reserved.
  1412.             40        Diskette and image file mismatch.
  1413.             41        Cannot format diskette due to diskette/image file
  1414.                       mismatch.
  1415.             42        The diskette capacity specified in /a is not
  1416.                       acceptable for the diskette drive.
  1417.             43        Cannot convert image file to the requested
  1418.                       diskette format due to floppy hardware limitation.
  1419.             44        Cannot QuickFormat diskette because it is not a
  1420.                       DOS formatted diskette.
  1421.             45        Incorrect pass phrase entered for unpacking the
  1422.                       image file.
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.                                                                       25
  1433.  
  1434.  
  1435.  
  1436.        11.0. LIMITATIONS
  1437.        _________________________________________________________________
  1438.  
  1439.        Diskette images created by Disk eXPress version 2 are not
  1440.        compatible with version 1 images.  Replacement of version 1 self-
  1441.        extracting code with the /r switch is not allowed.
  1442.  
  1443.        When Disk eXPress is used to create a self-extracting diskette
  1444.        image, the extract code is bundled as an overhead for each image
  1445.        created.  The overhead is currently at 25K (11K for DOS only
  1446.        image).  This is acceptable, considering the size of any non-
  1447.        trivial diskette image is usually quite large (in the order of
  1448.        several hundred kilo bytes or even mega bytes).  25K should
  1449.        require about two minutes for a 2400 baud modem to transfer, and
  1450.        with a 14.4K V.32bis modem, the transfer time is about 16
  1451.        seconds.
  1452.  
  1453.        Other limitations include the inability to read a diskette drive
  1454.        over the LAN (limitation of the network driver), and Disk eXPress
  1455.        over any copy protected programs.  Another limitation is its
  1456.        inability to read over physically bad sectors.
  1457.  
  1458.        Any suggestions and comments are welcome.  Suggestions for new
  1459.        features may eventually be incorporated into a future release.
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.                                                                       26
  1492.