home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / UTILS / S_S17.ZIP / SS.DOC < prev    next >
Text File  |  1992-11-16  |  102KB  |  3,099 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                      ShapeShifter(tm)  Archive Conversion System
  30.  
  31.                           Copyright (c)1992 By Curtis Little
  32.  
  33.                                  All Rights Reserved
  34.  
  35.  
  36.  
  37.                        "Software Solutions That Make Sense"(tm)
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                   Table of Contents
  47.  
  48.  
  49.  
  50.  
  51.           License . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  52.  
  53.           Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  54.  
  55.           Getting Started . . . . . . . . . . . . . . . . . . . . . . .   6
  56.                Acknowledgments  . . . . . . . . . . . . . . . . . . . .   6
  57.                How to Contact the Support Board . . . . . . . . . . . .   6
  58.                Required Equipment . . . . . . . . . . . . . . . . . . .   6
  59.  
  60.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   7
  61.                Overview of ShapeShifter . . . . . . . . . . . . . . . .   7
  62.                ShapeShifter Features  . . . . . . . . . . . . . . . . .   7
  63.                Registering ShapeShifter . . . . . . . . . . . . . . . .   9
  64.                Using a Mouse  . . . . . . . . . . . . . . . . . . . . .   9
  65.                     Selecting menu items with a mouse . . . . . . . . .   9
  66.                     Selecting an input field with a mouse . . . . . . .   9
  67.                     Exiting an input screen with a mouse  . . . . . .    10
  68.                     Using a mouse on dialog boxes . . . . . . . . . .    10
  69.                Starting ShapeShifter  . . . . . . . . . . . . . . . .    10
  70.                ShapeShifter Command Line Options  . . . . . . . . . .    11
  71.                Specifying On/Off Options  . . . . . . . . . . . . . .    12
  72.  
  73.           ShapeShifter Option Descriptions  . . . . . . . . . . . . .    13
  74.                Archiver Name  . . . . . . . . . . . . . . . . . . . .    13
  75.                Author Verification  . . . . . . . . . . . . . . . . .    14
  76.                Bad files directory  . . . . . . . . . . . . . . . . .    14
  77.                Command to Execute After All Conversions Are Complete     15
  78.                Command to execute after creating an archive with this
  79.                     archiver  . . . . . . . . . . . . . . . . . . . .    15
  80.                Command to execute before beginning the conversion
  81.                     session . . . . . . . . . . . . . . . . . . . . .    16
  82.                Command to execute before creating an archive with this
  83.                     archiver  . . . . . . . . . . . . . . . . . . . .    17
  84.                Command to execute before extracting an archive with
  85.                     this
  86.                     archiver  . . . . . . . . . . . . . . . . . . . .    17
  87.                Convert archives containing subdirs  . . . . . . . . .    18
  88.                Convert to . . . . . . . . . . . . . . . . . . . . . .    18
  89.                Create Command . . . . . . . . . . . . . . . . . . . .    18
  90.                Create list of files converted . . . . . . . . . . . .    19
  91.                Date Stamping Method . . . . . . . . . . . . . . . . .    19
  92.                Dir File(s)  . . . . . . . . . . . . . . . . . . . . .    20
  93.                Dir Type . . . . . . . . . . . . . . . . . . . . . . .    20
  94.                Extension  . . . . . . . . . . . . . . . . . . . . . .    22
  95.                Extract Command  . . . . . . . . . . . . . . . . . . .    22
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                File Attributes  . . . . . . . . . . . . . . . . . . .    22
  104.                File Start,Len . . . . . . . . . . . . . . . . . . . .    23
  105.                Keep original archive  . . . . . . . . . . . . . . . .    23
  106.                Log File . . . . . . . . . . . . . . . . . . . . . . .    24
  107.                Logging Level  . . . . . . . . . . . . . . . . . . . .    24
  108.                Max age of files to convert  . . . . . . . . . . . . .    25
  109.                Memory to make available . . . . . . . . . . . . . . .    26
  110.                Preserve Author Verified files . . . . . . . . . . . .    26
  111.                R. Just  . . . . . . . . . . . . . . . . . . . . . . .    26
  112.                Recurse Archives . . . . . . . . . . . . . . . . . . .    27
  113.                Recurse Subdirs  . . . . . . . . . . . . . . . . . . .    27
  114.                Redirect I/O . . . . . . . . . . . . . . . . . . . . .    28
  115.                Redo archives that are already the target type . . . .    29
  116.                Save Converted List in . . . . . . . . . . . . . . . .    29
  117.                Scanner Command  . . . . . . . . . . . . . . . . . . .    29
  118.                Scanner supports subdirs . . . . . . . . . . . . . . .    30
  119.                Size Start,Len . . . . . . . . . . . . . . . . . . . .    31
  120.                Strip attributes (HSR) . . . . . . . . . . . . . . . .    31
  121.                SubDirs  . . . . . . . . . . . . . . . . . . . . . . .    32
  122.                Switch! to EMS . . . . . . . . . . . . . . . . . . . .    32
  123.                Switch! to XMS . . . . . . . . . . . . . . . . . . . .    33
  124.                Test Only  . . . . . . . . . . . . . . . . . . . . . .    33
  125.                Update BBS/Dir File With New Extension and Size  . . .    33
  126.                Use 43/50 Line Mode  . . . . . . . . . . . . . . . . .    34
  127.                Use Switch!  . . . . . . . . . . . . . . . . . . . . .    34
  128.                Use Virus Scanner  . . . . . . . . . . . . . . . . . .    36
  129.  
  130.           Appendices  . . . . . . . . . . . . . . . . . . . . . . . .    37
  131.                Appendix A - How ShapeShifter Detects Corrupt
  132.                     Archives. . . . . . . . . . . . . . . . . . . . .    38
  133.                Appendix B - Archivers, Scanners, and User Programs
  134.                     Supported by
  135.                     ShapeShifter  . . . . . . . . . . . . . . . . . .    40
  136.                Appendix C - ShapeShifter Error Messages . . . . . . .    41
  137.                Appendix D - Specifying Command Lines  . . . . . . . .    48
  138.                     Example Command Lines . . . . . . . . . . . . . .    49
  139.  
  140.           Index . . . . . . . . . . . . . . . . . . . . . . . . . . .    51
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.           License
  150.  
  151.           You are granted a nonexclusive personal right to use this Software
  152.           under the terms stated in this Agreement.  Unregistered users are
  153.           allowed to evaluate this software for a period NOT TO EXCEED FIFTEEN
  154.           (15) DAYS.  If, on or before this time expires, you wish to continue
  155.           using this software, you must register by sending the registration fee
  156.           to the author "Curtis Little" for EACH COPY to be used.  A message may
  157.           be displayed to remind you if you exceed the trial use period.  
  158.  
  159.           You may not modify or alter the Software or any of the accompanying
  160.           files and/or documentation.  This license is effective until
  161.           terminated.  You may terminate it at any time by destroying your
  162.           copies of the Software.  It will also terminate if you fail to comply
  163.           with any term or condition of this Agreement.  You agree upon such
  164.           termination to destroy your copies of the Software.
  165.  
  166.           The shareware version of this software may be freely distributed as
  167.           long as the following conditions are met:
  168.  
  169.                1)   All files are distributed as is and in unmodified form.
  170.  
  171.                2)   No more than a $5.00 handling fee can be charged without the
  172.                     express written consent of the author "Curtis Little".
  173.  
  174.                3)   This Software may not be distributed with or as a part of
  175.                     any other product or software package without the express
  176.                     written consent of the author "Curtis Little".
  177.  
  178.           Registered users may not transfer or assign ownership of this license
  179.           to any other person without the express written consent of the author
  180.           (Curtis Little).  Attempts to sublicense, assign, or transfer any of
  181.           the rights, duties, or obligations hereunder is void.  You may not
  182.           copy, modify, alter, electronically transfer, or lease the registered
  183.           version of this Software and supporting files.  Registered owners may
  184.           use this software on more than one computer providing there is no
  185.           possibility it will be used on more than one computer at any one time.
  186.  
  187.           Business and government users of the Software are not allowed the
  188.           evaluation period.  Use in a business or government institution
  189.           without first paying the required registration fee is in violation of
  190.           this license agreement.
  191.  
  192.           By using the Software you acknowledge that you have read this
  193.           agreement, understand it and agree to be bound by it's terms and
  194.           conditions.
  195.  
  196.  
  197.  
  198.           4                                            ShapeShifter License
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.           Warranty
  208.  
  209.           With respect to the physical diskette sent to registered owners,
  210.           the author warrants the same to be free from defects in materials
  211.           and workmanship for a period of 60 days from the date of 
  212.           registration.  In the event of notification within the warranty
  213.           period of defects in material or workmanship the author will
  214.           replace the defective diskette.  The remedy for breach of this
  215.           warranty shall be limited to replacement and shall not encompass
  216.           any other damages, including but not limited to loss of profit,
  217.           and special, incidental, consequential, or other similar claims.
  218.  
  219.           The author specifically disclaims all other warranties, expressed
  220.           or implied, including but not limited to implied warranties of
  221.           merchantability and fitness for a particular purpose and the
  222.           program license granted herein in particular, and without
  223.           limiting operation of the program license with respect to any
  224.           particular application, use, or purpose.  IN NO EVENT SHALL THE
  225.           AUTHOR BE LIABLE FOR ANY LOSS OF PROFIT, LOST SAVINGS, COMMERCIAL
  226.           DAMAGE, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
  227.           OF THE USE OR INABILITY TO USE THIS SOFTWARE EVEN IF THE AUTHOR
  228.           (Curtis Little) OR AN AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED
  229.           OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER
  230.           PARTY.
  231.  
  232.           This agreement shall be governed by the laws of the state of
  233.           California.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.           ShapeShifter - User's Guide                                     5
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.           Getting Started
  268.  
  269.  
  270.           Acknowledgments
  271.  
  272.           In this manual several products are referred to:
  273.  
  274.                MS-DOS is a registered trademark of Microsoft Corporation.
  275.  
  276.                PKZIP & PKUNZIP are registered trademarks of PKWare, Inc.
  277.  
  278.                ARC is a registered trademark of SEA
  279.  
  280.                IBM PC, XT, AT, and PS/2 are trademarks of International
  281.                Business Machines, Inc.
  282.  
  283.  
  284.           How to Contact the Support Board
  285.  
  286.           An electronic bulletin board is used to support ShapeShifter. 
  287.           You may contact the support board 24 hours a day.  The support
  288.           board is:
  289.  
  290.                Lost At C BBS
  291.                (303) 290-1007
  292.  
  293.           You may also contact me via US mail at:
  294.  
  295.                PO Box 33613
  296.                Northglen, CO  80233
  297.  
  298.           If you have any questions/suggestions regarding ShapeShifter feel
  299.           free to call or write.  The support board is open to the public,
  300.           however, registered users will receive priority service.
  301.  
  302.  
  303.           Required Equipment
  304.  
  305.                IBM PC, XT, AT, PS/2 or MS-DOS Compatible
  306.                MS-DOS 2.0 or above
  307.                At least 256K memory available to application programs
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.           6                                  ShapeShifter - Getting Started
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.            
  323.  
  324.  
  325.  
  326.           Introduction
  327.  
  328.           Overview of ShapeShifter
  329.  
  330.           ShapeShifter is a highly sophisticated program designed to make
  331.           the task of converting from one archive format to another an
  332.           effortless task.  ShapeShifter is also handy for scanning files
  333.           contained in archives for viral infections.  ShapeShifter sports
  334.           many options affording the user a great degree of flexibility
  335.           (ShapeShifter can even be set to automatically update BBS dir
  336.           files!).  Since ShapeShifter is designed to be used as a command
  337.           line utility, it can be used for unattended operation (unattended
  338.           operation is effectively available to registered users only due
  339.           to the opening delay screen).
  340.  
  341.           This manual is intended as more of a reference than a users
  342.           guide.  I don't expect that too many people are anxious to sit
  343.           down and read a long boring guide about a program when it's
  344.           relatively easy to make things work without doing so.  At a
  345.           minimum you may wish to read this section of the manual to learn
  346.           how to call ShapeShifter, and then refer to the reference section
  347.           of the manual when you desire to learn the specifics about a
  348.           certain field or error message.
  349.  
  350.           This section of the manual lists the major features supported by
  351.           ShapeShifter followed by brief instructions on the calling syntax
  352.           for ShapeShifter.  Later sections of the manual explain each of
  353.           ShapeShifter's options in detail.
  354.  
  355.  
  356.           ShapeShifter Features
  357.  
  358.           ShapeShifter's major features include the following:
  359.  
  360.                o    Mouse support
  361.  
  362.                o    Support for virtually all archive types both past and
  363.                     present.  The user may configure ShapeShifter to use
  364.                     future archive types in addition to adding support for
  365.                     types not configured at default.  (And I won't claim
  366.                     ShapeShifter is the only one to support this like some
  367.                     others do ;-)
  368.  
  369.  
  370.  
  371.  
  372.           ShapeShifter - User's Guide                                     7
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.                o    Supports a user configured Virus Scanner.  The user has
  382.                     the freedom to determine which virus scanner (if any)
  383.                     should be used.  Even if your scanner doesn't support
  384.                     subdirs, ShapeShifter can properly handle it so even
  385.                     archives that do have subdirectories will have every
  386.                     file scanned!
  387.  
  388.                o    ShapeShifter not only can log information about the
  389.                     files converted, but it can also automatically update
  390.                     the BBS directory file(s) for virtually all BBS types
  391.                     available today.
  392.  
  393.                o    Supports author verified files created by PKZIP.  Since
  394.                     many authors (like myself) use PKZIPs -AV feature to
  395.                     certify authentic files, ShapeShifter was designed to
  396.                     not modify these files unless you specifically tell it
  397.                     too.
  398.  
  399.                o    ShapeShifter can run virtually all archiving programs
  400.                     to perform the conversion - including memory hogs that
  401.                     can't be run from other archive converters. 
  402.                     (ShapeShifter uses Switch! technology to free memory
  403.                     for the archivers that need it).
  404.  
  405.                o    Output of the archiver programs can be redirected (and
  406.                     *yes* this does include LHA!).
  407.  
  408.                o    Nested archives are no problem for ShapeShifter. 
  409.                     ShapeShifter can efficiently convert nested archives to
  410.                     the desired format.
  411.  
  412.                o    Provides full support of subdirectories in the
  413.                     archives.  If the archiver you're using supports
  414.                     subdirs, ShapeShifter can as well!
  415.  
  416.                o    Provides full support for file attributes (read only,
  417.                     hidden, and system).  If the archiver you're using
  418.                     supports attributes, ShapeShifter can as well!  If you
  419.                     desire, ShapeShifter can automatically strip file
  420.                     attributes during the conversion.
  421.  
  422.                o    43/50 line mode for EGA/VGA adapters is supported.
  423.  
  424.                o    ShapeShifter can recurse subdirs looking for files to
  425.                     convert, allowing simple conversion of every file on
  426.                     your computer's disk(s)!
  427.  
  428.  
  429.  
  430.           8                                     ShapeShifter - Introduction
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.                o    ShapeShifter allows a great deal of customization. 
  439.                     There are numerous options to control operation as well
  440.                     as hooks you can use to call your own programs to do
  441.                     things such as save archive comments before conversion,
  442.                     and then reinsert them after conversion!
  443.  
  444.           It's funny to note the list above doesn't scratch the surface of
  445.           ShapeShifter's power.  ShapeShifter clearly sets new standards
  446.           for archive conversion software.
  447.  
  448.  
  449.           Registering ShapeShifter
  450.  
  451.           ShapeShifter is *NOT* free software.  It is distributed as
  452.           shareware to allow users to test it before purchasing it.  (It is
  453.           shareware instead of commercial simply because I prefer the
  454.           shareware concept over the inflated prices that go with
  455.           commercial software to cover overhead that the user doesn't care
  456.           about anyway).  If you like ShapeShifter please send the
  457.           registration fee of $10.00 to the author.  For a measly $10.00
  458.           you will help support this software and help insure new shareware
  459.           products will be available from the author.  Your $10.00 entitles
  460.           you to use any version of ShapeShifter, and includes a way to
  461.           remove the beginning and ending delay screens.
  462.  
  463.           Using a Mouse
  464.  
  465.           ShapeShifter supports the use of a mouse.  If you have a mouse
  466.           driver enabled on your PC, ShapeShifter will automatically turn
  467.           on the cursor and be set for use of the mouse.  Note that due to
  468.           the nature of ShapeShifter, the main place a mouse can be used is
  469.           the configuration program (SSCFG).  The command line program SS
  470.           supports a mouse for the error message prompts only.
  471.  
  472.           Selecting menu items with a mouse
  473.           Using a mouse in ShapeShifter is pretty easily.  At menus simply
  474.           put the cursor on the item you wish to select and click any of
  475.           your mouse buttons.
  476.  
  477.           Selecting an input field with a mouse
  478.           On field input screens, you may use your mouse to select the
  479.           field to edit.  Simply put the cursor on the first character of
  480.           the input field you wish to modify, click, and the cursor will be
  481.           moved to that field ready for input.
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.           ShapeShifter - User's Guide                                     9
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.           Exiting an input screen with a mouse
  497.           After you are finished editing fields on an input screen, you may
  498.           use the mouse to specify whether to save or abort changes. 
  499.           Simply click the mouse on the portion of the bottom status line
  500.           that contains the text describing what you want to do.
  501.  
  502.           Using a mouse on dialog boxes
  503.           ShapeShifter displays prompts and error messages using a dialog
  504.           box.  With a mouse, simply click on the box containing the answer
  505.           you want to give.
  506.  
  507.  
  508.           Starting ShapeShifter
  509.  
  510.           When you call ShapeShifter you specify what it should do using
  511.           parameters on the command line (default settings as well as a few
  512.           options that can't be specified on the command line are
  513.           configured using SSCFG.EXE).  With ShapeShifter you are not
  514.           restricted to using different types of parameters in a predefined
  515.           order; ShapeShifter can handle parameters in any order you
  516.           specify them.  The types of parameters that ShapeShifter accepts
  517.           are:
  518.  
  519.                o    On/Off Options
  520.  
  521.                o    Other Options
  522.  
  523.                o    File names
  524.  
  525.           Options configure the way ShapeShifter operates.  Any parameter
  526.           that starts with a '-' or '/' is considered to be an option. 
  527.           There are two categories of options that you should be aware of. 
  528.           The first type of option can only have an on or off value.  These
  529.           options are specified with the following format:
  530.  
  531.                /option[+-]
  532.  
  533.           Note that the trailing + or - sign is optional, and if present
  534.           specifies how the option should be set (+ = ON, - = OFF).  If you
  535.           don't specify a trailing sign the option defaults to ON.
  536.  
  537.           The second type of option is one that can have a value other than
  538.           on or off.  The format for this type of option is:
  539.  
  540.                /option=XXXXX
  541.  
  542.           Note that the equal sign followed by the value to set the option
  543.           is required.
  544.  
  545.  
  546.           10                                    ShapeShifter - Introduction
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.           File names specify the file(s) that ShapeShifter should operate
  555.           on.  ShapeShifter allows you to specify as many filespecs as you
  556.           like - any of the specified file names can contain wildcards.
  557.  
  558.  
  559.           ShapeShifter Command Line Options
  560.  
  561.           There are quite a few options available that allow you to control
  562.           how ShapeShifter operates.  The following list shows the options
  563.           that can be used on the command line (see the option reference
  564.           for details on what each option does):
  565.  
  566.            /4       Sets the 43/50 line mode option.  (On/Off Option).
  567.  
  568.            /A=XXX   Sets the maximum age of files to process.  (You must specify
  569.                     a positive number in place of the XXX listed here).
  570.  
  571.            /C       Sets the option to create a list of converted files. 
  572.                     (On/Off Option).
  573.  
  574.            /D=X     Sets the date stamping method to use.  (You must specify one
  575.                     of the following letters in place of the X listed here:  L
  576.                     (Last file date), O (Original date), T (Today's date).
  577.  
  578.            /E=XXX   Sets the extension to convert to.  (A valid configured
  579.                     extension must be specified in place of the XXX listed
  580.                     here).
  581.  
  582.            /I       Sets the option telling ShapeShifter whether it should
  583.                     redirect output from the archivers/scanner.  (On/Off
  584.                     Option).
  585.  
  586.            /K       Sets the option telling ShapeShifter whether it should keep
  587.                     the original files that are converted.  (On/Off Option).
  588.  
  589.            /L=X     Sets the activity logging level (You must specify a number
  590.                     from 0 to 5 in place of the X listed here).
  591.  
  592.            /M       Sets option of mechanical (unattended mode) operation. 
  593.                     (On/Off Option).
  594.  
  595.            /N       Sets the option to support conversion of archives that
  596.                     contain nested archives.  (On/Off Option).
  597.  
  598.            /O       Sets the option to tell ShapeShifter whether it should redo
  599.                     options that are already in the target format.  (On/Off
  600.                     Option).
  601.  
  602.  
  603.  
  604.           ShapeShifter - User's Guide                                    11
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.            /P       Sets option to protect files created with PKZIP's -AV
  613.                     feature.  (On/Off Option).
  614.  
  615.            /R       Sets the option for recursion of directories when looking
  616.                     for matching files to convert.  (On/Off Option).
  617.  
  618.            /S       Option to tell ShapeShifter whether it should strip
  619.                     Read/Hidden/System attributes from files contained in
  620.                     archives.  (On/Off Option).
  621.  
  622.            /T       Test mode only option.  (On/Off Option).
  623.  
  624.            /U       Sets the option specifying whether ShapeShifter should
  625.                     update the configured BBS directory.
  626.  
  627.            /V       Sets the option to use the configured virus scanner. 
  628.                     (On/Off Option).
  629.  
  630.            /X       Set support of XMS and EMS for use by Switch! (On/Off
  631.                     Option).
  632.  
  633.  
  634.           Specifying On/Off Options
  635.  
  636.           When ShapeShifter scans the command line it looks for options by
  637.           looking for a leading '-' or '/'.  Once a '-' or '/' is found
  638.           ShapeShifter considers the next block of text (until a white space
  639.           character is hit) to be options specified by the caller.  On the
  640.           command line you can turn options on and turn options off.  The syntax
  641.           for specifying an option is as follows:
  642.  
  643.                -option[-|+][option 2[-|+]][option n...]
  644.  
  645.           Immediately after each option an optional "sign" can be used to
  646.           specify whether you want to turn the flag on (+) or off (-).  If the
  647.           sign isn't specified the option is turned on.  To look at an example
  648.           let's say you want to use ShapeShifter to strip extended attributes,
  649.           use logging level 5, not redo archives already in the target type,
  650.           convert to LZH (LHA), and recurse directories.  The following lists
  651.           several different ways to specify these options (all examples do the
  652.           same thing):
  653.  
  654.                -s -l5 -o- -r -e=lzh
  655.  
  656.                -s+ -l5 -o- -r+ -e=lzh
  657.  
  658.                -so-r -l5 -e=lzh
  659.  
  660.  
  661.  
  662.           12                                    ShapeShifter - Introduction
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.           As you can see there is a great deal of flexibility in how you specify
  671.           options to ShapeShifter.  Choose the method that you feel most
  672.           comfortable with.
  673.  
  674.           In the following Chapter each of the options supported by ShapeShifter
  675.           will be explained in detail.
  676.  
  677.  
  678.  
  679.           ShapeShifter Option Descriptions
  680.  
  681.           The remainder of this chapter will be dedicated to a description
  682.           of all options supported by ShapeShifter.  The configuration
  683.           program SSCFG.EXE should be used to set the default values of
  684.           each option to what you prefer.  Command line options allow you
  685.           to override the defaults you configure as well.
  686.  
  687.           In this chapter each option will be presented in alphabetical
  688.           order using the following format:
  689.  
  690.                Screen title (fieldname as displayed by SSCFG).
  691.  
  692.                Command line specifier for this option (if available)
  693.  
  694.                Screen this option is on in SSCFG.
  695.  
  696.                Synopsis (Description of this option)
  697.  
  698.                Notes (any special limitations or notes about this option).
  699.  
  700.           Okay, enough with the introductions, I'll move on to the option
  701.           descriptions.
  702.  
  703.           -------------------------------------------------------------
  704.           Archiver Name
  705.  
  706.           Command Line Specifier
  707.  
  708.                ** Not Available **
  709.  
  710.           SSCFG Screen This Option is On
  711.  
  712.                Archiver Options
  713.  
  714.           Synopsis
  715.  
  716.  
  717.  
  718.  
  719.  
  720.           ShapeShifter - User's Guide                                    13
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.           This option specifies the name of the archiver associated with a
  730.           specific extension (see the 'Extension' option).  The name you
  731.           specify is used to display what archive type is being converted
  732.           to.
  733.           -------------------------------------------------------------
  734.           Author Verification
  735.  
  736.           Command Line Specifier
  737.  
  738.                ** Not Available **
  739.  
  740.           SSCFG Screen This Option is On
  741.  
  742.                Archiver Options
  743.  
  744.           Synopsis
  745.  
  746.           This option specifies whether the archiver supports author
  747.           verified files.
  748.  
  749.           Notes
  750.  
  751.           ShapeShifter currently only supports PKZIP -AV files.  Other
  752.           author verification such as ARJ's security envelopes are not
  753.           supported.  (This decision mirrors the fact that PKZIPs -AV
  754.           feature is currently the only one in wide use for BBS files).
  755.  
  756.           If you have ShapeShifter configured to leave author verified
  757.           files alone (see the 'Preserve Author Verified files" option) it
  758.           will check for -AV files when converting from an archiver type
  759.           that has the Author Verification option set to 'Yes' (On).
  760.  
  761.           WARNING:  ShapeShifter does not use an external command or
  762.           archiver to determine if a file has -AV.  Instead, it looks
  763.           direct into the file expecting it to be in ZIP format.
  764.           -------------------------------------------------------------
  765.           Bad files directory
  766.  
  767.           Command Line Specifier
  768.  
  769.                ** Not available **
  770.  
  771.           SSCFG Screen This Option is On
  772.  
  773.                Misc Options
  774.  
  775.  
  776.  
  777.  
  778.           14                                     ShapeShifter - Option Reference
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.           Synopsis
  787.  
  788.           This option specifies a directory for ShapeShifter to move files
  789.           that it can't successfully convert.  If you specify a value here,
  790.           ShapeShifter will move all archives it encounters an error on
  791.           when converting.  (If the directory name you specify doesn't
  792.           exist, ShapeShifter will create it).
  793.  
  794.           Notes
  795.  
  796.           ShapeShifter considers a file bad if *any* error prevents it from
  797.           being properly converted.  Errors that keep a file from being
  798.           properly converted include disk errors as well as corrupt
  799.           archives.  For a complete list of circumstances that cause
  800.           ShapeShifter to consider the archive to be bad see the appendix
  801.           'How ShapeShifter Detects Corrupt Archives'.
  802.           -------------------------------------------------------------
  803.           Command to Execute After All Conversions Are Complete
  804.  
  805.           Command Line Specifier
  806.  
  807.                ** Not Available **
  808.  
  809.           SSCFG Screen This Option is On
  810.  
  811.                External Command Options
  812.  
  813.           Synopsis
  814.  
  815.           This option specifies the command line that ShapeShifter will
  816.           execute after all file conversions are done.
  817.  
  818.           Notes
  819.  
  820.           This option provides a way for you to do any special cleanup
  821.           desired.
  822.  
  823.           Note that the standard fields available for command lines from
  824.           ShapeShifter don't have meaning for this command line.
  825.  
  826.           See the appendix 'Specifying Command Lines' for details on how to
  827.           specify a command line to ShapeShifter.
  828.           -------------------------------------------------------------
  829.           Command to execute after creating an archive with this archiver
  830.  
  831.           Command Line Specifier
  832.  
  833.                ** Not Available **
  834.  
  835.  
  836.           ShapeShifter - User's Guide                                    15
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.           SSCFG This Option is On
  845.  
  846.                Archiver Options
  847.  
  848.           Synopsis
  849.  
  850.           This option specifies a command line that ShapeShifter will
  851.           execute after each new archive of this type is created.
  852.  
  853.           Notes
  854.  
  855.           The error-level set by this command is ignored by ShapeShifter.
  856.  
  857.           See the appendix 'Specifying Command Lines' for details on how to
  858.           specify a command line to ShapeShifter.
  859.           -------------------------------------------------------------
  860.           Command to execute before beginning the conversion session
  861.  
  862.           Command Line Specifier
  863.  
  864.                ** Not Available **
  865.  
  866.           SSCFG Screen This Option is On
  867.  
  868.                External Command Options
  869.  
  870.           Synopsis
  871.  
  872.           This option specifies a DOS command line that ShapeShifter should
  873.           execute before it converts the first file.
  874.  
  875.           Notes
  876.  
  877.           This provides you a way to do preliminary setup before
  878.           ShapeShifter starts it's operation.  Note that if the program you
  879.           specify returns an error level, ShapeShifter will consider it a
  880.           signal to abort the conversion.
  881.  
  882.           See the appendix 'Specifying Command Lines' for details on how to
  883.           specify a command line to ShapeShifter.
  884.  
  885.           Note that the standard fields available for command lines from
  886.           ShapeShifter don't have meaning for this command.
  887.           -------------------------------------------------------------
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.           16                                     ShapeShifter - Option Reference
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.           Command to execute before creating an archive with this archiver
  903.  
  904.           Command Line Specifier
  905.  
  906.                ** Not Available **
  907.  
  908.           SSCFG Screen This Option is On
  909.  
  910.                Archiver Options
  911.  
  912.           Synopsis
  913.  
  914.           This option specifies a command line that ShapeShifter will
  915.           execute before *each* archive of this type is created.  (See the
  916.           section 'Command Lines' for details on specifying command lines
  917.           to ShapeShifter).
  918.  
  919.           Notes
  920.  
  921.           If the command returns control with an error level set,
  922.           ShapeShifter will consider the archive to be corrupt and will
  923.           abort the conversion of the file.
  924.  
  925.           See the appendix 'Specifying Command Lines' for details on how to
  926.           specify a command line to ShapeShifter.
  927.  
  928.           -------------------------------------------------------------
  929.           Command to execute before extracting an archive with this
  930.           archiver
  931.  
  932.           Command Line Specifier
  933.  
  934.                ** Not Available **
  935.  
  936.           SSCFG Screen This Option is On
  937.  
  938.                Archiver Options
  939.  
  940.           Synopsis
  941.  
  942.           This option specifies a command line that should be executed
  943.           before *each* archive of the current type is extracted.
  944.  
  945.           Notes
  946.  
  947.           If the command that is executed returns control with an error
  948.           level set, the current archive will be considered corrupt and
  949.           won't be converted.
  950.  
  951.  
  952.           ShapeShifter - User's Guide                                    17
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.           See the appendix 'Specifying Command Lines' for details on how to
  961.           specify a command line to ShapeShifter.
  962.           -------------------------------------------------------------
  963.           Convert archives containing subdirs
  964.  
  965.           Command Line Specifier
  966.  
  967.                ** Not available **
  968.  
  969.           SSCFG Screen This Option is On
  970.  
  971.                Misc options
  972.  
  973.           Synopsis
  974.  
  975.           This option specifies whether ShapeShifter should convert
  976.           archives that contain subdirectories.  When you set this option
  977.           to 'Yes' (On), ShapeShifter will convert archives that contain
  978.           subdirectories (if the archiver used to extract the file *and*
  979.           the archiver used to create the new file support subdirs).  When
  980.           you set this option to 'No' (Off), ShapeShifter will not convert
  981.           files with subdirectories - even if the archivers do support
  982.           dirs.
  983.           -------------------------------------------------------------
  984.           Convert to  (Extension to convert files to)
  985.  
  986.           Command Line Specifier
  987.  
  988.                /E=XXX
  989.  
  990.           SSCFG Screen This Option is On
  991.  
  992.                Misc Options
  993.  
  994.           Synopsis
  995.  
  996.           This option specifies the file extension to convert archives to. 
  997.           The extension you specify must be an extension that is configured
  998.           as an archive extension using SSCFG.
  999.           -------------------------------------------------------------
  1000.           Create Command      (Command to execute to create an archive)
  1001.  
  1002.           Command Line Specifiers
  1003.  
  1004.                ** Not Available **
  1005.  
  1006.           SSCFG Screen This Option is On
  1007.  
  1008.                Archiver Options
  1009.  
  1010.           18                                     ShapeShifter - Option Reference
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.           Synopsis
  1019.  
  1020.           This option specifies the command line required to create an
  1021.           archive with the specified archiver.
  1022.  
  1023.           See the appendix 'Specifying Command Lines' for details on how to
  1024.           specify a command line to ShapeShifter.
  1025.           -------------------------------------------------------------
  1026.           Create list of files converted
  1027.  
  1028.           Command Line Specifiers
  1029.  
  1030.                /C
  1031.  
  1032.           SSCFG Screen This Option is On
  1033.  
  1034.                Misc Options
  1035.  
  1036.           Synopsis
  1037.  
  1038.           This option specifies whether ShapeShifter should create a list
  1039.           of the files that are converted.  If this option is set to 'Yes'
  1040.           (On), ShapeShifter creates a list of files converted in the file
  1041.           specified by the 'Save Converted List in' option.
  1042.           -------------------------------------------------------------
  1043.           Date Stamping Method
  1044.  
  1045.           Command Line Specifier
  1046.  
  1047.                /D=X      (Where X is replaced by one of the options listed
  1048.                          below)
  1049.  
  1050.           SSCFG Screen This Option is On
  1051.  
  1052.                Misc Options
  1053.  
  1054.           Synopsis
  1055.  
  1056.           This option determines what file date stamping option
  1057.           ShapeShifter is going to use.  The date stamping method may be
  1058.           one of the following:
  1059.  
  1060.                Date Stamping Method          What it means
  1061.                --------------------          -------------
  1062.                0 or O                        Original date - converted
  1063.                                              files will have the same file
  1064.                                              date after the conversion as
  1065.                                              they did before ShapeShifter
  1066.                                              saw them.
  1067.  
  1068.           ShapeShifter - User's Guide                                    19
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.                1 or T                        Today's date - converted files
  1077.                                              will be time stamped with the
  1078.                                              date and time they were
  1079.                                              converted.
  1080.  
  1081.                2 or L                        Last files date - converted
  1082.                                              files will be time stamped
  1083.                                              with the date and time of the
  1084.                                              latest file found within them.
  1085.           -------------------------------------------------------------
  1086.           Dir File(s)
  1087.  
  1088.           Command Line Specifier
  1089.  
  1090.                ** Not Available **
  1091.  
  1092.           SSCFG Screen This Option is On
  1093.  
  1094.                Misc Options
  1095.  
  1096.           Synopsis
  1097.  
  1098.           This option specifies the BBS dir file(s) to update (update only
  1099.           occurs if you have the 'Update BBS/Dir file with new extension
  1100.           and size' option set to 'Yes').
  1101.  
  1102.           You may specify multiple filespecs in this field (separated by a
  1103.           space), and any of the filespecs may contain wildcards.
  1104.  
  1105.           Notes
  1106.  
  1107.           When you have ShapeShifter configured to update a BBS file
  1108.           listing, *all* files matching the specs you specify in this field
  1109.           will be searched for files matching those that were converted. 
  1110.           For faster operation you should not specify filespecs that will
  1111.           cause excessive files to be searched.
  1112.           -------------------------------------------------------------
  1113.           Dir Type
  1114.  
  1115.           Command Line Specifier
  1116.  
  1117.                ** Not Available **
  1118.  
  1119.           SSCFG Screen This Option is On
  1120.  
  1121.                Misc Options
  1122.  
  1123.           Synopsis
  1124.  
  1125.  
  1126.           20                                     ShapeShifter - Option Reference
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.           This option specifies the type of BBS directory file that
  1135.           ShapeShifter should update.  (You must set the 'Update BBS/Dir
  1136.           file with new Extension and Size' option to 'Yes' to tell
  1137.           ShapeShifter to update the file).
  1138.  
  1139.           The following dir types are currently supported by ShapeShifter:
  1140.  
  1141.                Auntie (v 511 format)
  1142.                PC Board (v14.5 format)
  1143.                ProDoor
  1144.                Quick BBS
  1145.                TBBS
  1146.                User Defined
  1147.  
  1148.           Notes
  1149.  
  1150.           The support for defined BBS types is current as of the release of
  1151.           this software.  In order to provide support for future versions
  1152.           with a different format, or for a type not listed above, you may
  1153.           use the user defined type to tell ShapeShifter about the DIR file
  1154.           format.
  1155.  
  1156.           It should be noted that ShapeShifter can't support every possible
  1157.           file format.  To be able to update a BBS dir file, ShapeShifter
  1158.           has three requirements:
  1159.  
  1160.                The column that filenames start in must be reserved for the
  1161.                filename and not overlaid with other data on any line.  If
  1162.                data other than the filename can lie in the starting
  1163.                filename column, ShapeShifter may incorrectly think it found
  1164.                a file when it didn't.
  1165.  
  1166.                A file size field must be present, and it must reside on the
  1167.                same line as the filename.  In addition, it must be non-
  1168.                zero.
  1169.  
  1170.                The filename and size must each start in a fixed column.
  1171.  
  1172.           To update a user defined BBS file listing type, you must specify
  1173.           the file and size starting column information.  See the following
  1174.           options to specify the layout of a user defined file listing:
  1175.  
  1176.                File Start, Len
  1177.                Size Start, Len
  1178.           and  R. Just
  1179.           -------------------------------------------------------------
  1180.  
  1181.  
  1182.  
  1183.  
  1184.           ShapeShifter - User's Guide                                    21
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.           Extension  (Archive Extension)
  1193.  
  1194.           Command Line Specifier
  1195.  
  1196.                ** Not Available **
  1197.  
  1198.           SSCFG Screen This Option is On
  1199.  
  1200.                Archiver Options
  1201.  
  1202.           Synopsis
  1203.  
  1204.           This option specifies the extension used by a given archiver (if
  1205.           you're looking for the extension to convert to, see the 'Convert
  1206.           To' option).
  1207.  
  1208.           The extension you specify is used by ShapeShifter to identify
  1209.           files created by this archiver.
  1210.           -------------------------------------------------------------
  1211.           Extract Command     (Command to extract files from an archive)
  1212.  
  1213.           Command Line Specifier
  1214.  
  1215.                ** Not Available **
  1216.  
  1217.           SSCFG Screen This Option is On
  1218.  
  1219.                Archiver Options
  1220.  
  1221.           Synopsis
  1222.  
  1223.           This option specifiers the command line required to extract files
  1224.           using the specified archiver.
  1225.  
  1226.           See the appendix 'Specifying Command Lines' for details on how to
  1227.           specify a command line to ShapeShifter.
  1228.           -------------------------------------------------------------
  1229.           File Attributes     (Does the archiver support file attributes)
  1230.  
  1231.           Command Line Specifier
  1232.  
  1233.                ** Not Available **
  1234.  
  1235.           SSCFG Screen This Option is On
  1236.  
  1237.                Archiver Options
  1238.  
  1239.  
  1240.  
  1241.  
  1242.           22                                     ShapeShifter - Option Reference
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.           Synopsis
  1251.  
  1252.           This option specifies whether the current archiver supports
  1253.           Hidden/System/Read only attributes.
  1254.  
  1255.           Notes
  1256.  
  1257.           If you have ShapeShifter configured to strip attributes (see the
  1258.           'Strip attributes' option), this option is ignored.
  1259.           -------------------------------------------------------------
  1260.           File Start,Len
  1261.  
  1262.           Command Line Specifier
  1263.  
  1264.                ** Not Available **
  1265.  
  1266.           SSCFG Screen This Option is On
  1267.  
  1268.                Misc Options
  1269.  
  1270.           Synopsis
  1271.  
  1272.           This option specifies the starting column and length of the
  1273.           filename field in the BBS file listing.  The value you specify
  1274.           here is only used when you set the 'Dir Type' option to user
  1275.           defined.
  1276.           -------------------------------------------------------------
  1277.           Keep original archive  (Keep the original archive in addition to
  1278.           the newly converted version)
  1279.  
  1280.           Command Line Specifier
  1281.  
  1282.                /K[+-]
  1283.  
  1284.           SSCFG Screen This Option is On
  1285.  
  1286.                Misc Options
  1287.  
  1288.           Synopsis
  1289.  
  1290.           This option specifies whether or not ShapeShifter should keep the
  1291.           original archive file after conversion.  If you set this option
  1292.           to 'Yes' (On) both the original archive and the newly created
  1293.           archive will be kept on the disk.  You should set this option to
  1294.           'No' (Off) to cause the original archive to be removed after
  1295.           being successfully converted.  
  1296.  
  1297.           Notes
  1298.  
  1299.  
  1300.           ShapeShifter - User's Guide                                    23
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.           It isn't possible for ShapeShifter to honor the redo archives
  1309.           option when this option is set (since redoing an archive implies
  1310.           you will modify the original).  When this option is set it
  1311.           automatically overrides the Redo option.
  1312.           -------------------------------------------------------------
  1313.           Log File
  1314.  
  1315.           Command Line Specifier
  1316.  
  1317.                ** Not Available **
  1318.  
  1319.           SSCFG Screen This Option is On
  1320.  
  1321.                Misc Options
  1322.  
  1323.           Synopsis
  1324.  
  1325.           This option specifies the file name (or logical device) that
  1326.           ShapeShifter should log information about files converted to.
  1327.  
  1328.           Notes
  1329.  
  1330.           The logging level option must be set to non-zero for activity
  1331.           logging to occur.
  1332.  
  1333.           The file you specify may be a logical DOS device if desired.  For
  1334.           instance, PRN causes output to go to the printer attached to your
  1335.           computer on LPT1.
  1336.  
  1337.           If the file you specify already exists, ShapeShifter will append
  1338.           the logging information to the end of the file.
  1339.           -------------------------------------------------------------
  1340.           Logging Level
  1341.  
  1342.           Command Line Specifier
  1343.  
  1344.                /L=X      (Where X is replaced by a number from 0 to 5)
  1345.  
  1346.           SSCFG Screen This Option is On
  1347.  
  1348.                Misc Options
  1349.  
  1350.           Synopsis
  1351.  
  1352.           This option specifies the activity logging level for ShapeShifter
  1353.           to use.  When set to a non-zero value and a log file is specified
  1354.           (see the 'Log File' option), ShapeShifter will log activity as it
  1355.           converts files.  The following table shows the various log level
  1356.           values and what they do:
  1357.  
  1358.           24                                     ShapeShifter - Option Reference
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.                Level     Result
  1367.                -----     ------
  1368.                  0       No activity logging is performed
  1369.  
  1370.                  1       Lists file names converted in addition to errors
  1371.                          encountered.
  1372.  
  1373.                  2       File sizes (before and after are added to data
  1374.                          logged from lower levels)
  1375.  
  1376.                  3       Internal (nested) archive names that were
  1377.                          converted are added to the data from lower logging
  1378.                          levels.
  1379.  
  1380.                  4       Totals by subdirectory are added to the data from
  1381.                          lower log levels.
  1382.  
  1383.                  5       Adds overall totals to the other log levels.
  1384.           -------------------------------------------------------------
  1385.           Max age of files to convert
  1386.  
  1387.           Command Line Specifier
  1388.  
  1389.                /A=X      (Where X is replaced by the number of days)
  1390.  
  1391.           SSCFG Screen This Option is On
  1392.  
  1393.                Misc Options
  1394.  
  1395.           Synopsis
  1396.  
  1397.           This option sets the maximum age of files to be converted.  If
  1398.           you set this option to a non-zero value, only files that are
  1399.           newer than the conversion date minus the maximum age will be
  1400.           converted.  The following examples show how this option works:
  1401.  
  1402.                Max Age Setting          What ShapeShifter Does
  1403.                ---------------          ----------------------
  1404.                     0                   Converts all archives that match
  1405.                                         the specified filespecs -
  1406.                                         regardless of age.
  1407.  
  1408.                     1                   Only converts archives that match
  1409.                                         the specified filespecs and have a
  1410.                                         file date of yesterday or later.
  1411.  
  1412.                     2                   Only converts archives that match
  1413.                                         the specified filespecs and have a
  1414.                                         file date no more than 2 days old.
  1415.  
  1416.           ShapeShifter - User's Guide                                    25
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.           -------------------------------------------------------------
  1425.           Memory to make available  (Amount of memory to free for archiver)
  1426.  
  1427.           Command Line Specifier
  1428.  
  1429.                ** Not Available **
  1430.  
  1431.           SSCFG Screen This Option is On
  1432.  
  1433.                Archiver Options
  1434.  
  1435.           Synopsis
  1436.  
  1437.           This option specifies the amount of memory to make available for
  1438.           the archiver when Switch! is used (see the 'Use Switch!' option). 
  1439.  
  1440.           Notes
  1441.  
  1442.           A value of 640 as well as 0 causes the maximum amount of memory
  1443.           to be freed for running the current archiver.
  1444.           -------------------------------------------------------------
  1445.           Preserve Author Verified files
  1446.  
  1447.           Command Line Specifier
  1448.  
  1449.                /L
  1450.  
  1451.           SSCFG Screen This Option is On
  1452.  
  1453.                Misc Options
  1454.  
  1455.           Synopsis
  1456.  
  1457.           This option specifies whether ShapeShifter should leave -AV files
  1458.           (created by PKZIP) alone when it converts files.
  1459.           -------------------------------------------------------------
  1460.           R. Just  (Is the file size field right justified)
  1461.  
  1462.           Command Line Specifier
  1463.  
  1464.                ** Not Available **
  1465.  
  1466.           SSCFG Screen This Option is On
  1467.  
  1468.                Misc Options
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.           26                                     ShapeShifter - Option Reference
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.           Synopsis
  1483.  
  1484.           This option specifies whether or not the file size field is right
  1485.           justified when you use a user defined dir type.  (See the 'Dir
  1486.           Type' option).
  1487.           -------------------------------------------------------------
  1488.           Recurse Archives  (Convert archives that are nested inside other
  1489.           archives)
  1490.  
  1491.           Command Line Specifier
  1492.  
  1493.                /N
  1494.  
  1495.           SSCFG Screen This Option is On
  1496.  
  1497.                Misc Options
  1498.  
  1499.           Synopsis
  1500.  
  1501.           This option specifies whether archives inside files that are
  1502.           converted should also be converted.  If this option is set to
  1503.           'No' (Off), any archives inside a file being converted will be
  1504.           untouched.  If this option is set to 'Yes' (On), archives within
  1505.           files being converted will also be converted.  ShapeShifter can
  1506.           properly handle nested archives to virtually any level.
  1507.  
  1508.           Notes
  1509.  
  1510.           If you set this option to 'No', ShapeShifter will still
  1511.           successfully convert (if no other errors occur) archives that
  1512.           contain nested archives.  Be aware that archives within converted
  1513.           files will be left in their original format unless you turn this
  1514.           option on though.
  1515.           -------------------------------------------------------------
  1516.           Recurse Subdirs  (Recurse subdirectories looking for matching
  1517.           files to convert)
  1518.  
  1519.           Command Line Specifier
  1520.  
  1521.                /R
  1522.  
  1523.           SSCFG Screen This Option is On
  1524.  
  1525.                Misc Options
  1526.  
  1527.           Synopsis
  1528.  
  1529.           This option specifies whether ShapeShifter should search
  1530.           subdirectories for the specified files as it looks for files to
  1531.  
  1532.           ShapeShifter - User's Guide                                    27
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.           convert.  If you set this option to 'Yes' (On), ShapeShifter
  1541.           searches the child directories of each file specification looking
  1542.           for matching files.  If you set this option to 'No' (Off),
  1543.           ShapeShifter will only look in the directories specified for
  1544.           filespecs.
  1545.  
  1546.           Notes
  1547.  
  1548.           The file specifications you use with ShapeShifter are honored
  1549.           even when this option is set.  Consider the following examples:
  1550.  
  1551.                File Spec           What ShapeShifter does with Recurse On
  1552.                ---------           --------------------------------------
  1553.                *.ZIP               Searches the current directory as well
  1554.                                    as child directories for .ZIP files to
  1555.                                    convert.
  1556.  
  1557.                \*.*                Searches the entire current drive for
  1558.                                    files of any of the configured archive
  1559.                                    types to convert.
  1560.           -------------------------------------------------------------
  1561.           Redirect I/O  (Redirect I/O from the virus scanners and
  1562.           archivers)
  1563.  
  1564.           Command Line Specifier
  1565.  
  1566.                /I
  1567.  
  1568.           SSCFG Screen This Option Is On
  1569.  
  1570.                Misc Options
  1571.  
  1572.           Synopsis
  1573.  
  1574.           This option controls whether or not ShapeShifter attempts to
  1575.           redirect the output from archivers and the virus scanner.
  1576.  
  1577.           Note
  1578.  
  1579.           ShapeShifter's output redirection requires output to be DOS
  1580.           redirectable.   (Note, ShapeShifter *can* successfully redirect
  1581.           output from LHA and similar programs!).
  1582.  
  1583.           Although ShapeShifter can redirect output, it isn't really
  1584.           necessary.  ShapeShifter can cause all but direct screen writes
  1585.           to be within it's defined window area.
  1586.           ------------------------------------------------------------
  1587.  
  1588.  
  1589.  
  1590.           28                                     ShapeShifter - Option Reference
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.           Redo archives that are already the target type
  1599.  
  1600.           Command Line Specifier
  1601.  
  1602.                /O
  1603.  
  1604.           SSCFG Screen This Option is On
  1605.  
  1606.                Misc Options
  1607.  
  1608.           Synopsis
  1609.  
  1610.           This option controls whether or not ShapeShifter will recreate
  1611.           archives that are already in the target format.
  1612.  
  1613.           Notes
  1614.  
  1615.           Recreation of archives already in the target format is a handy
  1616.           way to remove BBS ad comments in addition to allowing you to
  1617.           insure the maximum compression of the archiver was used.
  1618.           -------------------------------------------------------------
  1619.           Save Converted List in
  1620.  
  1621.           Command Line Specifier
  1622.  
  1623.                ** Not Available **
  1624.  
  1625.           SSCFG Screen This Option is On
  1626.  
  1627.                Misc Options
  1628.  
  1629.           Synopsis
  1630.  
  1631.           This option specifies the filename (or logical device) for
  1632.           ShapeShifter to save the list of filenames that were converted. 
  1633.  
  1634.           Notes
  1635.  
  1636.           You may specify a filename or a DOS device for output of the
  1637.           converted files list.  For example, PRN causes output to go to
  1638.           the device attached to LPT1.
  1639.  
  1640.           If you specify the name of a file that already exists,
  1641.           ShapeShifter will append the converted file names to the end of
  1642.           the file.
  1643.           -------------------------------------------------------------
  1644.           Scanner Command
  1645.  
  1646.  
  1647.  
  1648.           ShapeShifter - User's Guide                                    29
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.           Command Line Specifier
  1657.  
  1658.                ** Not Available **
  1659.  
  1660.           SSCFG Screen This Option is On
  1661.  
  1662.                Misc Options
  1663.  
  1664.           Synopsis
  1665.  
  1666.           This option allows you to specify the DOS command line for the
  1667.           virus scanner of your choice.
  1668.  
  1669.           Notes
  1670.  
  1671.           See the appendix 'Specifying Command Lines' for information on
  1672.           special features available in ShapeShifter for command line
  1673.           specification.
  1674.  
  1675.           ShapeShifter requires a virus scanner that sets the DOS error
  1676.           level if a virus is detected (if you desire to use a virus
  1677.           scanner).  The scanner should use an exit code (errorlevel) of 0
  1678.           if there were no viral infections detected.  A non-zero exit code
  1679.           is interpreted by ShapeShifter as saying one or more of the files
  1680.           are infected.
  1681.           -------------------------------------------------------------
  1682.           Scanner supports subdirs
  1683.  
  1684.           Command Line Specifier
  1685.  
  1686.                ** Not Available **
  1687.  
  1688.           SSCFG Screen This Option is On
  1689.  
  1690.                Misc Options
  1691.  
  1692.           Synopsis
  1693.  
  1694.           This option specifies whether or not the virus scanner you're
  1695.           using supports automatic searching of child directories.
  1696.  
  1697.           Notes
  1698.  
  1699.           ShapeShifter doesn't require a scanner that supports subdirs.  If
  1700.           you set this option to 'No' (Off), ShapeShifter will call the
  1701.           scanner to look at files in each directory as required.  Setting
  1702.           this option to 'Yes' (On) may be faster for virus scanners that
  1703.           support dirs.
  1704.           -------------------------------------------------------------
  1705.  
  1706.           30                                     ShapeShifter - Option Reference
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.           Size Start,Len
  1715.  
  1716.           Command Line Specifier
  1717.  
  1718.                ** Not Available **
  1719.  
  1720.           SSCFG Screen This Option is On
  1721.  
  1722.                Misc Options
  1723.  
  1724.           Synopsis
  1725.  
  1726.           This option sets the starting column and length of the file size
  1727.           field in a user defined BBS listing.  ShapeShifter will only use
  1728.           the values you specify here if you set the 'Dir Type' option to
  1729.           user defined.
  1730.  
  1731.           Take a look at the 'R. Just' option to specify whether or not the
  1732.           file size field is right justified.
  1733.           -------------------------------------------------------------
  1734.           Strip attributes (HSR)
  1735.  
  1736.           Command Line Specifier
  1737.  
  1738.                /S
  1739.  
  1740.           SSCFG Screen This Option is On
  1741.  
  1742.                Misc Options
  1743.  
  1744.           Synopsis
  1745.  
  1746.           This option allows you to tell ShapeShifter to remove Hidden,
  1747.           System, and Read Only attributes found on files that are inside
  1748.           archives being converted.
  1749.  
  1750.           If you set this option to 'Yes' (On), ShapeShifter will remove
  1751.           all hidden/system/read only file attributes.
  1752.  
  1753.           Notes
  1754.  
  1755.           If the archiver you're converting to doesn't support file
  1756.           attributes and this option is off, ShapeShifter will report an
  1757.           error on attempts to convert any archive that contains files with
  1758.           one of the attributes set.  If on the otherhand you turn this
  1759.           option on, ShapeShifter will remove the file attributes thus
  1760.           allowing the archiver to handle the files.
  1761.           -------------------------------------------------------------
  1762.  
  1763.  
  1764.           ShapeShifter - User's Guide                                    31
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.           SubDirs        (Does the archiver support subdirs)
  1773.  
  1774.           Command Line Specifier
  1775.  
  1776.                ** Not Available **
  1777.  
  1778.           SSCFG Screen This Option is On
  1779.  
  1780.                Archiver Options
  1781.  
  1782.           Synopsis
  1783.  
  1784.           This option specifies whether the current archiver supports
  1785.           subdirectories within archives.
  1786.  
  1787.           Notes
  1788.  
  1789.           If you have ShapeShifter configured to support subdirs (see the
  1790.           'Convert archives containing subdirs' option) and this option is
  1791.           set to 'No' (Off), ShapeShifter will not allow conversion of
  1792.           archives with subdirs when converting to this type of archive. 
  1793.           Note that if ShapeShifter isn't configured to support conversion
  1794.           of archives with subdirs, this option is ignored.
  1795.           -------------------------------------------------------------
  1796.           Switch! to EMS
  1797.  
  1798.           Command Line Specifier
  1799.  
  1800.                /X   (Note:  This command line specifier also enables use of
  1801.                     XMS as a first choice)
  1802.  
  1803.           SSCFG Screen This Option is On
  1804.  
  1805.                Misc Options
  1806.  
  1807.           Synopsis
  1808.  
  1809.           This option controls whether or not ShapeShifter uses EMS when
  1810.           Switch!ing memory.
  1811.  
  1812.           Notes
  1813.  
  1814.           Switch! is only used if you configure it to be used for a given
  1815.           archiver.  (See the 'Use Switch' option description).
  1816.           -------------------------------------------------------------
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.           32                                     ShapeShifter - Option Reference
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.           Switch! to XMS
  1831.  
  1832.           Command Line Specifier
  1833.  
  1834.                /X   (Note:  This command line specifier also enables use of
  1835.                     EMS as a second choice)
  1836.  
  1837.           SSCFG Screen This Option is On
  1838.  
  1839.                Misc Options
  1840.  
  1841.           Synopsis
  1842.  
  1843.           This option controls whether or not ShapeShifter uses XMS when
  1844.           Switch!ing memory.
  1845.  
  1846.           Notes
  1847.  
  1848.           Switch! is only used if you configure it to be used for a given
  1849.           archiver.  (See the 'Use Switch' option description).
  1850.           -------------------------------------------------------------
  1851.           Test Only
  1852.  
  1853.           Command Line Specifier
  1854.  
  1855.                /T
  1856.  
  1857.           SSCFG Screen This Option is On
  1858.  
  1859.                Misc Options
  1860.  
  1861.           Synopsis
  1862.  
  1863.           When this option is set to 'Yes' (On), ShapeShifter will go
  1864.           through all the steps to convert the files you specify without
  1865.           actually creating or removing the old files.
  1866.           -------------------------------------------------------------
  1867.           Update BBS/Dir File With New Extension and Size
  1868.  
  1869.           Command Line Specifier
  1870.  
  1871.                /U
  1872.  
  1873.           SSCFG Screen This Option is On
  1874.  
  1875.                Misc Option
  1876.  
  1877.  
  1878.  
  1879.  
  1880.           ShapeShifter - User's Guide                                    33
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.           Synopsis
  1889.  
  1890.           This option specifies whether ShapeShifter should update a BBS
  1891.           type DIR file with the new file extensions and sizes.  If you set
  1892.           this option to 'Yes' (On), ShapeShifter will update the file(s)
  1893.           specified (see the 'Dir File(s)' option).
  1894.  
  1895.           Notes
  1896.  
  1897.           ShapeShifter uses several options to determine how to locate file
  1898.           names and sizes in the BBS directory for updating.  See the 'Dir
  1899.           Type' option description.
  1900.           -------------------------------------------------------------
  1901.           Use 43/50 Line Mode
  1902.  
  1903.           Command Line Specifier
  1904.  
  1905.                /4
  1906.  
  1907.           SSCFG Screen This Option is On
  1908.  
  1909.                Misc Options
  1910.  
  1911.           Synopsis
  1912.  
  1913.           This option specifies whether ShapeShifter should operate using
  1914.           43/50 line mode instead of the standard 25 lines.
  1915.  
  1916.           Notes
  1917.  
  1918.           This option is only available with an EGA, VGA, or equivalent.
  1919.           -------------------------------------------------------------
  1920.           Use Switch!
  1921.  
  1922.           Command Line Specifier
  1923.  
  1924.                ** Not Available **
  1925.  
  1926.           SSCFG Screen This Option is On
  1927.  
  1928.                Archiver Options
  1929.  
  1930.           Synopsis
  1931.  
  1932.           This option specifies whether ShapeShifter should use Switch! for
  1933.           the current archiver.  Switch! is a special function that allows
  1934.           ShapeShifter to free virtually all the memory it is using to make
  1935.           it available for running the archiver.
  1936.  
  1937.  
  1938.           34                                     ShapeShifter - Option Reference
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.           Notes
  1947.  
  1948.           This option is closely related to several other options:
  1949.  
  1950.                Memory to make available
  1951.  
  1952.                Switch! to EMS
  1953.  
  1954.                Switch! to XMS
  1955.           -------------------------------------------------------------
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.           ShapeShifter - User's Guide                                    35
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.           Use Virus Scanner
  2005.  
  2006.           Command Line Specifier
  2007.  
  2008.                /V
  2009.  
  2010.           SSCFG Screen This Option is On
  2011.  
  2012.                Misc Options
  2013.  
  2014.           Synopsis
  2015.  
  2016.           This option specifies whether ShapeShifter should use the
  2017.           configured virus scanner (see the 'Scanner Command' option).  If
  2018.           you set this option to 'Yes' (On), ShapeShifter will use the
  2019.           virus scanner you specified with SSCFG.
  2020.  
  2021.           Notes
  2022.  
  2023.           ShapeShifter requires a virus scanner that sets the DOS error
  2024.           level if a virus is detected (if you desire to use a virus
  2025.           scanner).  The scanner should use an exit code (errorlevel) of 0
  2026.           if there were no viral infections detected.  A non-zero exit code
  2027.           is interpreted by ShapeShifter as saying one or more of the files
  2028.           are infected.
  2029.           -------------------------------------------------------------
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.           36                                     ShapeShifter - Option Reference
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.                                                                  Appendices
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.           
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.           Appendix A - How ShapeShifter Detects Corrupt Archives.
  2122.  
  2123.           There are many circumstances that can keep an archive from being
  2124.           successfully converted.  The following is an alphabetic list by
  2125.           error message (as displayed on the ShapeShifter conversion
  2126.           screen) detailing all valid reasons for stoppage of a conversion,
  2127.           and whether the file will be considered corrupt by ShapeShifter
  2128.           (i.e. a corrupt file is moved to the configured bad files
  2129.           directory).  Note that ShapeShifter will *NOT* delete a file for
  2130.           being corrupt - this is a decision best left to the user!
  2131.  
  2132.                                                        Archive Moved
  2133.                Reason for failure                      To Bad Files Dir
  2134.                ------------------                      ----------------
  2135.                (-AV File)
  2136.                Author verification was detected in     *NO*
  2137.                the file and you have ShapeShifter
  2138.                configured to preserve author verified
  2139.                files.  (This is not considered as a 
  2140.                corrupt archive - it just keeps 
  2141.                ShapeShifter from modifying the file).
  2142.  
  2143.                (AttrAbort)
  2144.                File attributes are contained in the    Yes
  2145.                archive to be converted when the type
  2146.                of archive you're converting to isn't
  2147.                configured as supporting attributes 
  2148.                (and you don't have ShapeShifter set
  2149.                to strip attributes).
  2150.  
  2151.                (Corrupt)
  2152.                Archiver returns with an error level    Yes
  2153.                set when ShapeShifter attempts to 
  2154.                extract the contents of a file.
  2155.  
  2156.                (CreateErr)
  2157.                The archiver returned with an error     Yes
  2158.                level set when ShapeShifter attempted
  2159.                to create the new file.
  2160.  
  2161.                (CreateErr)
  2162.                The target file already exists.         Yes
  2163.  
  2164.                (CreateErr)
  2165.                The expected target file couldn't be    Yes
  2166.                found after the archive creation
  2167.                command was completed.
  2168.  
  2169.  
  2170.           38                                        ShapeShifter Appendices
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.                (DirAbort)
  2179.                Subdirectories were detected in the     Yes
  2180.                archive when the type of archive 
  2181.                you're converting to isn't configured
  2182.                as supporting dirs, or ShapeShifter is
  2183.                configured to not allow conversion of
  2184.                files containing subdirs.
  2185.  
  2186.                (EXEC Err)
  2187.                Failure to spawn the archiver, virus    Yes
  2188.                scanner, or a user command (i.e. not
  2189.                enough memory, command not found, etc)
  2190.  
  2191.                (INFECTED!)
  2192.                Virus Scanner returns with an error     Yes
  2193.                level set.
  2194.  
  2195.                (RedoAbort)
  2196.                When attempting to redo an archive      Yes
  2197.                that was already in the target format,
  2198.                ShapeShifter was unable to generate a 
  2199.                unique filename.  (It tries 1000
  2200.                different extensions when attempting to
  2201.                create a temp file for the conversion).
  2202.  
  2203.                (Skipped)
  2204.                Skipped file because it is already      *NO*
  2205.                in the target format and ShapeShifter
  2206.                isn't configured to redo archives 
  2207.                already in the target format.
  2208.  
  2209.                (SysError)
  2210.                Internal program error                  Yes
  2211.                (This occurs if a system or internal
  2212.                error in ShapeShifter occurs).
  2213.  
  2214.                (UserAbort)
  2215.                User configured program returns with    Yes
  2216.                an error level set.
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.           ShapeShifter - User's Guide                                    39
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.           Appendix B - Archivers, Scanners, and User Programs Supported by
  2237.           ShapeShifter
  2238.  
  2239.           ShapeShifter supports a wide variety of programs including user
  2240.           commands that allow you to customize operation for a variety of
  2241.           situations.  There is one *major* requirement for a program to
  2242.           work properly with ShapeShifter - use of the DOS error level
  2243.           (exit code).  ShapeShifter expects commands to return with the
  2244.           error level set if an error is detected (it doesn't matter what
  2245.           the error level is set to - as long as it's non-zero).  Likewise,
  2246.           ShapeShifter expects the error level to be cleared (set to zero)
  2247.           when an error doesn't occur.
  2248.  
  2249.           Any program that returns control to ShapeShifter with a non-zero
  2250.           errorlevel set can't be used.  On the other hand, if a program
  2251.           always returns control with the error level cleared, ShapeShifter
  2252.           will work with the program but will be crippled in that it can't
  2253.           detect when an archive is corrupt.
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.           40                                        ShapeShifter Appendices
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.           Appendix C - ShapeShifter Error Messages
  2295.  
  2296.           This appendix gives a list (alphabetical) of the common
  2297.           ShapeShifter error messages.  Each message is accompanied by a
  2298.           short description describing what the message means.
  2299.  
  2300.  
  2301.           Abort ShapeShifter?
  2302.                This message is displayed when the ESCape key is pressed
  2303.                during a conversion session. 
  2304.  
  2305.           Aborted: Archive creation error
  2306.                This message occurs when the archiver fails to create the
  2307.                archive as expected.  Note that this message is only used
  2308.                when you have activity logging turned on.
  2309.  
  2310.           Aborted: Contains subdirs
  2311.                This message occurs when ShapeShifter fails to convert an
  2312.                archive because it contains subdirs and the archive being
  2313.                converted to doesn't support dirs (or you have ShapeShifter
  2314.                configured not to support them).  Note that this message is
  2315.                only used when you have activity logging turned on.
  2316.  
  2317.           Aborted: Contains attributes
  2318.                This message occurs when ShapeShifter fails to convert an
  2319.                archive because one or more files in the archive have an
  2320.                attribute set, and the archive type you're converting to
  2321.                isn't configured as supporting attributes.  You may also
  2322.                specify the strip attributes option to overcome this
  2323.                problem.  Note that this message is only used when you have
  2324.                activity logging turned on.
  2325.  
  2326.           Aborted: Internal error
  2327.                This message occurs when an internal error in ShapeShifter
  2328.                kept the archive from being properly converted.  Note that
  2329.                this message is only used when you have activity logging
  2330.                turned on.
  2331.  
  2332.           Aborted: User program canceled
  2333.                This message occurs when a user configured program returns a
  2334.                non-zero exit code (causing the conversion of the current
  2335.                archive to be aborted).  Note that this message is only used
  2336.                when you have activity logging turned on.
  2337.  
  2338.           Aborted: VIRUS! INFECTED!
  2339.                This message occurs when the configured virus scanner
  2340.                returns a non-zero exit code after scanning files contained
  2341.                in an archive.  Note that this message is only used when you
  2342.                have activity logging turned on.
  2343.  
  2344.           ShapeShifter - User's Guide                                    41
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.           <ext>: Already defined for archiver (<archiver name>).  Replace?
  2353.                This message is displayed by SSCFG when you save archiver
  2354.                information containing an extension already defined for
  2355.                another archiver.  ShapeShifter only supports one archiver
  2356.                per extension, so it isn't possible to have the same
  2357.                extension listed for use with two different archivers
  2358.                (although you may use different archivers for the create and
  2359.                extract commands since you specify the command line to be
  2360.                used!  Typically this is done for programs such as PKZIP
  2361.                that use separate programs to create and extract files).
  2362.  
  2363.           Archiver name must be specified.
  2364.                This message is displayed by SSCFG when you attempt to save
  2365.                information about an archiver with the archiver name listed
  2366.                as blank.  The archiver name is a mandatory field - if you
  2367.                don't want to save the archiver information abort by
  2368.                pressing ESCape instead of using the F10 key.
  2369.  
  2370.           AttrAbort
  2371.                This message is displayed in the work history window for a
  2372.                file that is not converted since it contains attributes, and
  2373.                the archive type you're converting to isn't configured as
  2374.                supporting attributes.  (Use the strip attributes option to
  2375.                overcome this).
  2376.  
  2377.           -AV File
  2378.                This message is displayed next to a file in the work history
  2379.                window to indicate the file wasn't converted because it
  2380.                contained the PKZIP -AV marking (and you have ShapeShifter
  2381.                configured to leave AV files alone).
  2382.  
  2383.           Both the redo & protect options are set - ignoring the redo
  2384.           option
  2385.                This message is displayed when you specify ShapeShifter
  2386.                should redo existing archives AND keep the old files. 
  2387.                (Since redoing a file implies it will be changed, it is not
  2388.                possible to redo the file and keep the old one too.  This
  2389.                message just lets you know that ShapeShifter is protecting
  2390.                the original files and ignoring the request to redo files
  2391.                that are already in the target format).
  2392.  
  2393.           Complete
  2394.                This message is displayed in the work history window (and
  2395.                log file) indicating a file was successfully converted.
  2396.  
  2397.           Configuration not initialized.  Run SSCFG.
  2398.                Before you use ShapeShifter for the first time you *must*
  2399.                run the configuration program.  Run SSCFG and save the
  2400.                configuration to overcome this message.
  2401.  
  2402.           42                                        ShapeShifter Appendices
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.           Corrupt
  2411.                This message is displayed in the work history window (and
  2412.                log file) indicating an archive was corrupt.  ShapeShifter
  2413.                considers the archive corrupt when the archiver used to
  2414.                extract the files returns a non-zero exit code.
  2415.  
  2416.           CreateErr
  2417.                This message is displayed in the work history window.  It
  2418.                occurs when any of the following happen:
  2419.  
  2420.                     Archiver returns a non-zero exit code when ShapeShifter
  2421.                     asks it to create the new archive.
  2422.  
  2423.                     The target file already exists.  (I.E. you're
  2424.                     converting TEST.ZIP to LZH and TEST.LZH already
  2425.                     exists).
  2426.  
  2427.                     The new archive file can't be found after the
  2428.                     conversion is complete.
  2429.  
  2430.           Create command appears to be missing the archive file name
  2431.           specifier.
  2432.                This message is displayed by SSCFG when you save the
  2433.                information about an archiver if the create command doesn't
  2434.                contain one of the substitution fields to specify the
  2435.                filename.  Since an archiver generally requires the name of
  2436.                the file that should be created you probably should add the
  2437.                proper substitution field so ShapeShifter can tell the
  2438.                archiver which file is being worked on.  (It is suggested
  2439.                you use the %1 field, but other fields are also available).
  2440.  
  2441.           DirAbort
  2442.                This message is displayed in the work history window when an
  2443.                archive conversion is aborted because the archive contains
  2444.                dirs (and the archive type you're converting to doesn't
  2445.                support them OR ShapeShifter is configured to not allow
  2446.                conversion of archives containing subdirs).
  2447.  
  2448.           Error:  Invalid option (X)
  2449.                This message occurs when you specify an invalid command line
  2450.                option (the X is replaced by the letter of the invalid
  2451.                option).
  2452.  
  2453.           EXEC Err
  2454.                This message is displayed in the work history window when an
  2455.                error keeps one of the configured commands from being
  2456.                executed (archiver, virus scanner, and user commands are
  2457.                included).  In general this error means the command you
  2458.                specified either doesn't exist in your path, or there isn't
  2459.  
  2460.           ShapeShifter - User's Guide                                    43
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.                enough memory to run the command.  Memory problems for the
  2469.                archivers can be overcome by using the Switch! option.  If
  2470.                you're having memory problems for other commands - please
  2471.                let me know - if there is a need I can add use of Switch!
  2472.                for all commands.
  2473.  
  2474.           EXEC Failure
  2475.                This message means the same as EXEC Err (listed above),
  2476.                except this message is what appears in the activity log.
  2477.  
  2478.           Extension is blank.  Save record anyway?
  2479.                This message is displayed by SSCFG when you ask to save
  2480.                information about an archiver with a blank extension. 
  2481.                Although this isn't really an error, it's brought to your
  2482.                attention because most archivers use a non-blank extension
  2483.                for archives created.
  2484.  
  2485.           Extract command appears to be missing the archive file name
  2486.           specifier.
  2487.                This message is displayed by SSCFG when you save the
  2488.                information about an archiver if the extract command doesn't
  2489.                contain one of the substitution fields to specify the
  2490.                filename.  Since an archiver generally requires the name of
  2491.                the file that should be extracted you should add the proper
  2492.                substitution field so ShapeShifter can tell the archiver
  2493.                which file is being worked on.  (It is suggested you use the
  2494.                %1 field, but other fields are also available).
  2495.  
  2496.           File length too large.
  2497.                This error message is displayed by SSCFG when the file
  2498.                length (for the user defined BBS dir) is too large.  The
  2499.                maximum value ShapeShifter allows is 70.
  2500.  
  2501.           <file>: Has a size bigger than the size field!  <file size>
  2502.                This error occurs when ShapeShifter is asked to update a dir
  2503.                file that contains a file size field that is defined as
  2504.                being smaller than the minimum required for the file.  (For
  2505.                example, the dir type has a file size of 6 associated with
  2506.                it, and the actual file size is over 999,999 bytes).
  2507.  
  2508.           INFECTED!
  2509.                This is the message that is displayed in the work history
  2510.                window when the virus scanner indicates one or more files
  2511.                inside an archive are infected with a virus.
  2512.  
  2513.           Invalid date stamping method:
  2514.                An invalid date stamping method was specified on the command
  2515.                line.
  2516.  
  2517.  
  2518.           44                                        ShapeShifter Appendices
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.           No file(s) specified/found to convert.
  2527.                This occurs when you don't specify filespecs to convert, or
  2528.                if there aren't any files of a configured archive type that
  2529.                match the filespecs you specify.
  2530.  
  2531.           No matching dir files!
  2532.                This occurs when you have the option set to update a BBS dir
  2533.                file, but no DIR files are found matching the filespecs you
  2534.                configured.
  2535.  
  2536.           Pre command returned error:  <9>  Continue conversion?
  2537.                This message is displayed when the external pre command (the
  2538.                one that is ran before any conversions are done) returns a
  2539.                non-zero exit code.
  2540.  
  2541.           <file>: Read error.
  2542.                There was an error encountered when ShapeShifter tried to
  2543.                read the specified file.
  2544.  
  2545.           RedoAbort
  2546.                This message is displayed in the work history window when
  2547.                ShapeShifter is unable to create a unique extension for a
  2548.                file already in the target format that is being redone. 
  2549.                ShapeShifter tries 1000 different extensions before giving
  2550.                up.
  2551.  
  2552.           Size length too large.
  2553.                This message is displayed by SSCFG when the length of the
  2554.                size field (for the user defined BBS type) exceeds the
  2555.                maximum ShapeShifter allows.  The maximum supported is 20
  2556.                characters.
  2557.  
  2558.           Skipped
  2559.                This message is displayed in the work history window when a
  2560.                file is skipped because it's already in the target format
  2561.                and the redo option is turned off.
  2562.  
  2563.           Skipped: (Already in target format)
  2564.                This message is the same as above except it's the one
  2565.                displayed in the activity log.
  2566.  
  2567.           Skipped: -AV File
  2568.                This message is displayed in the activity log when a file is
  2569.                skipped because it contains PKZIPs AV signature (and you
  2570.                have ShapeShifter configured to leave AV files alone).
  2571.  
  2572.           SysError:
  2573.                This message is displayed in the work history window when an
  2574.                internal ShapeShifter or operating system error occurs.
  2575.  
  2576.           ShapeShifter - User's Guide                                    45
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.           Target archiver create command is blank:
  2585.                This message is displayed when you ask ShapeShifter to
  2586.                convert to an extension that doesn't have a create command
  2587.                specified.
  2588.  
  2589.           Unable to create a temp directory.
  2590.                This error means ShapeShifter was unable to create it's temp
  2591.                work directory for conversion of a file.  (ShapeShifter
  2592.                creates a working directory as a child dir of the path
  2593.                containing the original file to be converted).  If you get
  2594.                this error message your file is either in the root directory
  2595.                of a disk with a completely full root, or is likely on a
  2596.                disk that you don't have write capabilities to (i.e. a
  2597.                network security problem).
  2598.  
  2599.           <file>: Unable to open.
  2600.                This error message occurs when SSCFG can't open the
  2601.                configuration file for reading.
  2602.  
  2603.           Unable to open file for converted files list
  2604.                This message is displayed when ShapeShifter is unable to
  2605.                open the file you specified for saving the list of converted
  2606.                files in.
  2607.  
  2608.           Unable to open log file
  2609.                This message is displayed when ShapeShifter is unable to
  2610.                open the file you specified for activity logging in.
  2611.  
  2612.           Unable to read configuration file.
  2613.                This message means that ShapeShifter can't locate the
  2614.                configuration file (or the file is corrupt).
  2615.  
  2616.           Unable to rename to <file>
  2617.                This message is displayed when the attempt to rename the
  2618.                temp file created while an archive of the target type is
  2619.                redone fails.
  2620.  
  2621.           UserAbort
  2622.                This message is displayed in the work history window when
  2623.                conversion of an archive is aborted because one of the user
  2624.                defined commands returned a non-zero exit code.
  2625.  
  2626.           <file>: Version x.x required to read.
  2627.                This message is displayed if your configuration file was
  2628.                created with a later version of ShapeShifter than you're
  2629.                currently using (and the format was changed).  You should
  2630.                use the same version of ShapeShifter (or a later one) than
  2631.                you use to create the configuration file.
  2632.  
  2633.  
  2634.           46                                        ShapeShifter Appendices
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.           You must define some archivers before saving!
  2643.                This message is displayed by SSCFG if you attempt to save
  2644.                the configuration file while no archivers are defined.
  2645.  
  2646.           You must specify what to convert file(s) to.  Use /EXT=xxx
  2647.                This message is displayed when you run ShapeShifter with an
  2648.                invalid extension specified as the target.  (ShapeShifter
  2649.                requires the target extension to be configured as an
  2650.                archive).
  2651.  
  2652.           You probably need to specify *.* in the create command.  
  2653.                This message is displayed by SSCFG when you ask to save the
  2654.                current archiver information and the create command doesn't
  2655.                contain *.* in it.  For most archivers you need to specify
  2656.                the files to add to the newly created archive (which means
  2657.                you should have *.* in your command line).
  2658.  
  2659.           <file>: Write error.
  2660.                This message is displayed by SSCFG when an error occurs
  2661.                writing the configuration file.
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.           ShapeShifter - User's Guide                                    47
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.           Appendix D - Specifying Command Lines
  2701.  
  2702.           Several of ShapeShifter's options are intended to contain a
  2703.           command line.  In ShapeShifter the text you type as the command
  2704.           line is handled to look as if you typed it at the DOS prompt -
  2705.           with an important exception.  Before passing the command line to
  2706.           DOS, ShapeShifter first examines the command line to determine
  2707.           the location of fields such as the current filename.
  2708.  
  2709.           To allow you to specify where things like the filename should go,
  2710.           ShapeShifter supports a type of field substitution.  The
  2711.           following table lists fields that ShapeShifter supports.  When
  2712.           ShapeShifter encounters the text in a command line option it will
  2713.           perform the substitution listed in the table.  (Note that it
  2714.           doesn't matter if there are spaces before or after the field in
  2715.           the command line.  In addition, case is not sensitive.  You may
  2716.           specify the fields using upper or lower case):
  2717.  
  2718.                Field     Value that is substituted
  2719.                -----     -------------------------
  2720.                %1        The full path of the file (includes the filename
  2721.                          and extension).
  2722.  
  2723.                %D        Drive letter of the file currently being
  2724.                          converted.
  2725.  
  2726.                %E        The extension of the file that's being converted.
  2727.  
  2728.                %F        Filename that's being converted (without the
  2729.                          extension).
  2730.  
  2731.                %N        The filename and extension that's being converted.
  2732.  
  2733.                %P        Directory of the file being converted.
  2734.  
  2735.                %%        Sends a single percent sign.  This allows you to
  2736.                          override the substitution that ShapeShifter
  2737.                          normally performs when a field listed above is
  2738.                          required in the command line.  For instance, if
  2739.                          your command line contains %%D, ShapeShifter will
  2740.                          send %D to the command line instead of
  2741.                          substituting the drive for %D.
  2742.  
  2743.  
  2744.           Notes:    The extension that's substituted (for any field that
  2745.                     contains an extension) depends on where in the
  2746.                     conversion process you are.  The extension you're
  2747.                     converting to is substituted in the following commands:
  2748.  
  2749.  
  2750.           48                                        ShapeShifter Appendices
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.                          Archive create command
  2759.  
  2760.                          Command to execute after extracting an archive
  2761.  
  2762.                          Command to execute after creating an archive
  2763.  
  2764.                     For the extract command as well as the command to
  2765.                     execute before extracting an archive, the original file
  2766.                     extension is substituted.
  2767.  
  2768.           Commands that don't appear on the archiver options screen in
  2769.           SSCFG don't have valid values for the fields listed above (i.e.
  2770.           this includes the scanner command, command to execute before
  2771.           beginning the conversion, and the command to execute after all
  2772.           conversions are done).  If any of the fields are specified in
  2773.           these command lines, they will be removed.
  2774.  
  2775.  
  2776.           Example Command Lines
  2777.  
  2778.           The following examples assume that you're converting a file
  2779.           called IC186.ZIP to IC186.LZH.  For the examples, the directory
  2780.           IC186.ZIP is in is:  D:\CATALOG.
  2781.  
  2782.           Command Line        Field This Command Line Is In
  2783.           ------------        -----------------------------
  2784.           mycmd %f %e         Command to execute before extracting the
  2785.                               archive.
  2786.  
  2787.                Resulting command line that's executed: mycmd IC186 ZIP
  2788.           ----------------------------------------------
  2789.           mycmd %f %e         Command to execute after extracting the
  2790.                               archive.
  2791.  
  2792.                Resulting command line that's executed: mycmd IC186 LZH
  2793.           ----------------------------------------------
  2794.           pkunzip %1          Archive extract command
  2795.  
  2796.                Resulting command line that's executed: 
  2797.  
  2798.                     pkunzip D:\CATALOG\IC186.ZIP
  2799.           ----------------------------------------------
  2800.           lha a %1 *.*        Archive create command
  2801.  
  2802.                Resulting command line that's executed:
  2803.  
  2804.                     lha a D:\CATALOG\IC186.LZH *.*
  2805.           ----------------------------------------------
  2806.  
  2807.  
  2808.           ShapeShifter - User's Guide                                    49
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.           mycmd %1 %%1        Command to execute after archive is created
  2817.  
  2818.                Resulting command line that's executed:
  2819.  
  2820.                     mycmd D:\CATALOG\IC186.LZH %1
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.           50                                        ShapeShifter Appendices
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.                                                                       Index
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.           
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.           activity logging                        option  19
  2933.                setting level  24             dir 
  2934.           age of files                            size start,len
  2935.                specifying  25                          option  31
  2936.           archive to convert to              dir file
  2937.                specifying  18                     file start,len
  2938.           archiver                                     options  23
  2939.                create command  18                 option  20
  2940.                extract command  22                r. just option  26
  2941.                support dir option                 update option  33
  2942.                     32                       dir type
  2943.           archiver name                           option  20
  2944.                option  13                    dirs
  2945.           archives                                archiver support  32
  2946.                detecting corrupt             EMS
  2947.                     38                            Switch!ing to  32
  2948.                recursing  27                 equipment
  2949.                redoing  29                        required  6
  2950.           attributes                         error messages  41
  2951.                stripping  31                      work history window 
  2952.           author verification                          38
  2953.                option  14                    extension
  2954.           author verified files                   converting to  18
  2955.                preserving  26                     option  22
  2956.           AV files                           extract command
  2957.                preserving  26                     option  22
  2958.           bad files directory                features  7
  2959.                option  14                    field substitution
  2960.           bbs                                     in command lines  48
  2961.                support  6                    file attributes
  2962.           BBS DIR                                 archiver option  22
  2963.                specifying type  20           file start,len
  2964.                update option  33                  option  23
  2965.           command lines                      i/o redirection  28
  2966.                specifying  48                keep original archive
  2967.           convert archives with                   option  23
  2968.                     subdirs                  license  4
  2969.                option  18                    log filename
  2970.           convert to                              option  24
  2971.                option  18                    logging level
  2972.           converted files                         option  24
  2973.                create list of  19            max age of files to
  2974.           converted list filename                      convert
  2975.                option  29                         option  25
  2976.           corrupt archives                   memory
  2977.                detecting  38                      making available  26
  2978.           create command                     memory to make available
  2979.                option  18                         option  26
  2980.           date stamping                      options
  2981.  
  2982.           
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.                archiver name  13                  subdirs (archiver
  2991.                author verification                     support)  32
  2992.                     14                            Switch! to ems  32
  2993.                bad files directory                Switch! to xms  33
  2994.                     14                            test only  33
  2995.                command line  11                   update bbs dir  33
  2996.                command to execute                 use 43/50 line mode 
  2997.                     before                             34
  2998.                     conversion  16                use Switch!  34
  2999.                convert archives                   use virus scanner 
  3000.                     with subdirs                       36
  3001.                     18                       parameter
  3002.                convert to  18                     types  10
  3003.                converted list                preserve author verified
  3004.                     filename  29                       files
  3005.                create command  18                 option  26
  3006.                create list of                protecting
  3007.                     converted files               original file  23
  3008.                     19                       purchasing  9
  3009.                date stamping  19             r. just
  3010.                dir file  20                       option  26
  3011.                dir type  20                  recurse archives
  3012.                extension (of                      option  27
  3013.                     archiver)  22            recurse subdirs
  3014.                extract command  22                option  27
  3015.                file attributes  22           redirect i/o
  3016.                file start,len  23                 option  28
  3017.                keep original                 redo archives
  3018.                     archive  23                   option  29
  3019.                log filename  24              registering  9
  3020.                logging level  24             required equipment  6
  3021.                max age of files  25          scanner command
  3022.                memory to make                     option  29
  3023.                     available  26            scanner supports dirs
  3024.                overview  10                       option  30
  3025.                preserve author               size start,len
  3026.                     verified files                dir option  31
  3027.                     26                       specifying
  3028.                r. just  26                        age of files   25
  3029.                recurse archives  27               archive to convert
  3030.                recurse subdirs  27                     to  18
  3031.                redirect i/o  28                   BBS dir filename  20
  3032.                redo archives  29                  BBS dir type  20
  3033.                scanner command  29                command lines  48
  3034.                scanner supports                   date stamp method 
  3035.                     dirs  30                           19
  3036.                size start,len  31            Starting ShapeShifter  10
  3037.                specifying  12                strip attributes
  3038.                strip attributes  31               option  31
  3039.  
  3040.           ShapeShifter - User's Guide                                    53
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.           subdirs
  3049.                recursing   27
  3050.                support option  18
  3051.           subdirs (archiver
  3052.                     support)
  3053.                option  32
  3054.           support
  3055.                getting  6
  3056.           Switch! to EMS
  3057.                option  32
  3058.           Switch! to xms
  3059.                option  33
  3060.           test only
  3061.                option  33
  3062.           update bbs dir
  3063.                option  33
  3064.           use 43/50 lines
  3065.                option  34
  3066.           use Switch!
  3067.                option  34
  3068.           use virus scanner
  3069.                option  36
  3070.           virus scanner
  3071.                command  29
  3072.                using  36
  3073.           warranty  5
  3074.           XMS
  3075.                Switch!ing to  33
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.           54
  3099.