home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / ACAD / PURGECL.ZIP / PURGECL.DOC < prev    next >
Text File  |  1994-02-01  |  61KB  |  2,119 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                            ----------------------
  10.  
  11.                            ---     PurgeCL    ---
  12.  
  13.                            -     Version 2.0    -
  14.  
  15.                            ----------------------
  16.  
  17.  
  18.  
  19.  
  20.                 Copyright (c) 1994 by Blue Ridge Software, Inc.
  21.                              All Rights Reserved
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                            Blue Ridge Software, Inc.
  30.                               235 Southport Drive
  31.                              Lexington, KY  40503
  32.                                  606-276-5148
  33.  
  34.                           ----------------------------
  35.                           ORDERS: 800-707-5148 (voice)
  36.                                   800-431-2558 (fax)
  37.                           ----------------------------
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                    Blue Ridge Software, Inc. is a Registered
  46.                      AutoCAD Developer and a Member of the
  47.                   Association of Shareware Professionals (ASP)
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                            SHAREWARE VERSION MANUAL
  59.  
  60.  
  61.  
  62.    TABLE OF CONTENTS
  63.    -----------------
  64.  
  65.    SECTION                                     PAGE
  66.    -----------------------------------------------
  67.    ONE:  GETTING STARTED                      1
  68.       1 - Introduction                        2
  69.       2 - What is PurgeCL?                    3
  70.       3 - Why use PurgeCL?                    4-5
  71.       4 - Installation                        6
  72.  
  73.    TWO:  USING PURGECL                        7
  74.       1 - Commands and Switches               8
  75.          <filen>                              8
  76.          Alarm             -alarm             9
  77.          Bell              -bell              9
  78.          Blocks            -bl                9
  79.          Defaults          -df                10
  80.          Destination Path  -dp=               11
  81.          Registration Info -?                 11
  82.          Dimstyles         -ds                12
  83.          Date/Time Switch  -dt                12
  84.          Date/Time Filter  -filter:           13
  85.          Layers            -la                14
  86.          Log Name          -ln=               14
  87.          Log Off           -loff              15
  88.          Log Path          -lp=               15
  89.          Linetypes         -lt                16
  90.          Script File       -scr=              16
  91.          Shapes            -sh                16
  92.          Styles            -st                17
  93.          Verbose Mode      -v                 17
  94.          Exclusion Path    -xp=               17
  95.       2 - Using Exclusion Files               18-20
  96.       3 - Using Purge Script Files            21-22
  97.       4 - Using Date/Time Filters             23-24
  98.       5 - Using Environment Variables         25
  99.       6 - Important Notes                     26
  100.  
  101.    THREE:  REGISTERING PURGECL                27
  102.       1 - Registration Benefits               28
  103.       2 - Pricing Policies                    28
  104.       3 - Ordering PurgeCL                    29
  105.       4 - Customer Comment Form               30
  106.  
  107.    FOUR: APPENDICES                           31
  108.       A - If you have problems or questions   32
  109.       B - Warranty - Agreement                33
  110.       C - Acknowledgements                    34
  111.       D - The ASP Ombudsman                   34
  112.  
  113.  
  114. ===================================================================
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                            SECTION ONE:
  127.  
  128.  
  129.                           GETTING STARTED
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.    ________________________________________________________________
  171.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 1
  172.  
  173.  
  174.  
  175.    1 - INTRODUCTION
  176.    ----------------
  177.  
  178.    Thanks for trying PurgeCL!
  179.  
  180.       Before diving in, at a minimum please read the following
  181.    sections:
  182.  
  183.        Warranty - Agreement (in the Appendices of this manual),
  184.        Important Notes (in section 2),
  185.        Skim the command-line commands and switches.
  186.  
  187.       After installation, be sure to check for any files called
  188.    'readme.1st' in the directory PurgeCL was installed in.  This
  189.    file may not appear but, if it does, will contain any last-minute
  190.    items that were not included in this manual.
  191.  
  192.       The information in these sources will save headaches if
  193.    you familiarize yourself with their contents before proceeding.
  194.  
  195.       That's it!  Follow the instructions in the installation
  196.    section to get going.  It'll literally take a few minutes before
  197.    you purge your first file.  After you've played with PurgeCL a
  198.    little while, be sure to read the other sections in this manual
  199.    to make it easier to integrate PurgeCL into your daily routine.
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.    ________________________________________________________________
  230.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 2
  231.  
  232.  
  233.    2 - WHAT IS PURGECL?
  234.    --------------------
  235.  
  236.       PurgeCL is an industrial-strength AutoCAD utility which allows
  237.    for purging multiple drawing files from the DOS command line.
  238.    It operates directly on the .DWG file - no .DXFs are involved.
  239.    PurgeCL was designed for both the casual and heavy-duty AutoCAD
  240.    user and is flexible enough to let you select what options will
  241.    meet your individual needs.  Options are provided for switching
  242.    on and off which table entry types and blocks to purge as well
  243.    as redirecting where files should be stored.
  244.  
  245.       PurgeCL is network friendly and was designed with batch
  246.    processes in mind, making it very understanding of errors.  If
  247.    an error occurs on any drawing file, PurgeCL will simply bypass
  248.    that file, enter the error into a logfile and continue on.
  249.    This avoids a lost batch in case an invalid file is encountered
  250.    early in the process.  An extensive logging facility is included
  251.    for those users who wish to run batches unattended and have a
  252.    comprehensive summary of the results of the process.
  253.  
  254.       Also included is an exclusion file provision for specifying
  255.    certain table entries which should not be purged.  This
  256.    information is stored in a regular text file and can be specified
  257.    for any drawing.
  258.  
  259.       For users who have a standard directory setup, a script
  260.    capability is provided.  The script file is a standard text
  261.    file which contains a sequential list of drawings and switches
  262.    which PurgeCL will follow.  Both the exclusion and script files
  263.    have provisions for entering comments.
  264.  
  265.       Files may be selected through the use of a powerful date/time
  266.    filter.  This option allows for selecting ranges of dates for
  267.    accepting or rejecting files to be processed.  For example, all
  268.    drawings that have been created or modified in a single week may
  269.    be selected for a weekend purge.  Many combinations can be
  270.    specified for maximum flexibility.
  271.  
  272.       PurgeCL should prove to be an invaluable tool in your
  273.    day-to-day work.
  274.  
  275.    Highlights:
  276.       - No DXFs; all processing is done directly with .DWG files
  277.       - Designed for use with batch files for purging of an
  278.          unlimited number of files
  279.       - Log file generation describing all aspects of the process
  280.       - Wildcard Capability
  281.       - Do any of: Blocks, Layers, Styles, Dimstyles, Ltypes, Shapes
  282.       - High Speed
  283.       - Purge files in a SINGLE pass
  284.       - Complete Before-and-After Size Reports
  285.       - Compatible with Versions 2.5 - 12
  286.       - International Date/Time formats
  287.       - Filter drawings by date/time stamps
  288.    ________________________________________________________________
  289.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 3
  290.  
  291.  
  292.  
  293.    3 - WHY USE PURGECL?
  294.    --------------------
  295.       The AutoCAD purge command provides a reliable means for
  296.    removing unused information from .DWG files.  However,
  297.    it is not the most efficient tool for trimming down your
  298.    drawing files.
  299.  
  300.       Many times a block or layer is created for temporary
  301.    use but then becomes useless when it's not needed anymore.
  302.    These extraneous tables, definitions and entity entries
  303.    remain in the drawing since there is no "delete block
  304.    definition" or "delete layer" function in AutoCAD.
  305.    Drawings can grow to 2 or 3 times the size that they should
  306.    be if completely purged.  The purge command will reliably
  307.    detect these unwanted entries but at a price.
  308.  
  309.       First, multiple purge commands must be entered to handle
  310.    any nested blocks.  As each layer of nesting is stripped
  311.    away, further layer, linetype, style and dimstyle entries
  312.    may be revealed that are unused.  The only time a drawing
  313.    is truly purged is when the purge command says that there
  314.    are no more entries to be purged.  Getting to this point
  315.    can take numerous tries.
  316.  
  317.       Accessing the purge command requires that each drawing
  318.    will be brought up in AutoCAD.  This can be prohibitive for
  319.    most users since drawing files may number in the hundreds or
  320.    thousands with an average size of 100K to 1Meg.  An AutoCAD
  321.    script file can be used to automate this process but the time
  322.    involved in bringing up each drawing can be excessive.
  323.  
  324.       Lastly, many users create a Wblock of each drawing to
  325.    perform a complete purge.  Although this technique does not
  326.    involve the actual purge command, it does result in a completely
  327.    purged drawing.  However, again, the time involved in bringing
  328.    each drawing up in AutoCAD can be extensive.
  329.  
  330.       PurgeCL removes these obstacles by duplicating the purge
  331.    command from DOS.  Not only does AutoCAD not have to be run,
  332.    but a complete, single-pass purge is performed on each drawing.
  333.    PurgeCL uses a highly reliable and efficient algorithm to search
  334.    through all blocks and entities in a drawing to determine
  335.    what is and is not necessary in a single pass.  This eliminates
  336.    any need to purge a drawing multiple times to truly clean it up.
  337.    It's fast and uses NO DXF files (all operations are performed on
  338.    the .DWG file).  Therefore, an entire drive of .DWG files can
  339.    be cleaned up quickly and easily without the use of AutoCAD.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.    ________________________________________________________________
  348.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 4
  349.  
  350.  
  351.  
  352.       A purged drawing not only uses less space on a hard drive
  353.    (most users report a 20-30% savings), but also reduces the
  354.    time required to bring the drawing up in AutoCAD.  Since all
  355.    unused blocks and table entries are essentially excess baggage
  356.    on a drawing, PurgeCL lightens the load by stripping the chaff
  357.    from the wheat.  This lets AutoCAD run faster when a drawing
  358.    is opened.
  359.  
  360.       Many users modem drawings on a regular basis, but unpurged
  361.    drawings are generally 20-50% "heavier" than their purged
  362.    counterparts and take longer to transmit.  Money spent on
  363.    transmissions is directly proportional to time,  If you shorten 
  364.    the transmission time, you can minimize costs.  
  365.    
  366.       Jump in and decrease the size of your files by running PurgeCL
  367.    so you can enjoy the savings of time, money and disk space.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.    ________________________________________________________________
  407.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 5
  408.  
  409.  
  410.  
  411.    4 - INSTALLATION
  412.    ----------------
  413.  
  414.    Installation and Checkout:
  415.  
  416.    1)  Simply run the Install program included on the master disk.
  417.          This program will copy the PurgeCL system into a directory 
  418.          of your choice and optionally add this directory to your 
  419.          path statement.  The default setting of installing PurgeCL 
  420.          off of your AutoCAD directory is optional but recommended.
  421.          Directories for the exclusion and script files can then be 
  422.          added after installation to keep the system neat and
  423.          organized.
  424.  
  425.    2)  After installation, reboot your system to allow the changes 
  426.          that install made to the Autoexec.bat file to take effect.
  427.  
  428.    3)  To test the installation, go to the root directory and then
  429.          type 'PurgeCL'.  PurgeCL will display the options available
  430.          and return to the DOS prompt.
  431.  
  432.    4)  For a quick start, go to a directory that contains some 
  433.          drawing files.  Type 'PurgeCL filename.dwg' where 
  434.          filename.dwg is the name of a drawing in the directory.
  435.          PurgeCL will start and describe everything it's doing.
  436.  
  437.       PurgeCL is by no means limited to this.  Be sure to read (or 
  438.    at least skim) the "Using PurgeCL" section in this manual.  
  439.    PurgeCL has 17 different command line options so chances are 
  440.    you'll find a way of doing what you want by using these switches.
  441.  
  442.    Troubleshooting:
  443.  
  444.       If PurgeCL doesn't run when you type PurgeCL at the DOS prompt, 
  445.    try the following:
  446.  
  447.       Go to the directory where PurgeCL was installed.  
  448.       Check to see that PurgeCL is there by executing the directory 
  449.       command.  
  450.          If not, try reinstalling PurgeCL to the directory again.  
  451.          If it is there, make sure that this directory is actually 
  452.             in your path.  You can do this by typing "PATH" at the 
  453.             DOS prompt and checking to see if this directory shows 
  454.             up in the path statement.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.    ________________________________________________________________
  466.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 6
  467.  
  468. ================================================================
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.                            SECTION TWO
  483.  
  484.                           USING PURGECL
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.    ________________________________________________________________
  525.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 7
  526.  
  527.  
  528.    1 - COMMANDS AND SWITCHES
  529.    -------------------------
  530.  
  531.       The following is a detailed description of each command-line
  532.    option available for PurgeCL.  These switches may be included 
  533.    in any order; including between filenames.  However, if a switch
  534.    is set, it applies to all files specified on the line.  Just 
  535.    because a switch is specified after a filename is specified does
  536.    not mean that the switch won't affect that file.  In any case, 
  537.    the default settings should be sufficient for most users.
  538.  
  539.  
  540.    Usage:
  541.  
  542.    PurgeCL [-alarm] [-bell] [-v] [-bl] [-sh] [-lt] [-la] [-ds] [-st]
  543.       [-df] [-dt] [-loff] 
  544.       [-lp<logfilepath>] [-ln<logfilename>] [-dp<destinationpath>]
  545.       ["-filter:<filter>"]    file1.dwg file2.dwg ...
  546.  
  547.    Note: 
  548.       Items in brackets are optional.
  549.  
  550. -----------------------------------------------------------------
  551.  
  552.    <filen>
  553.  
  554.    Name:    File Name
  555.  
  556.    Purpose:    Drawing files may be specified in just about any manner 
  557.       you wish.  Any extension may be used and wildcards (*,?) are
  558.       fine.  Any number of files may be specified up to the maximum
  559.       number of characters that DOS will allow on a single line.  
  560.       If desired, a path may be included with the filename.
  561.  
  562.    Notes:    Caution should be used if wildcards (*,?) are used in 
  563.       the extension since non-drawing files could reside in the 
  564.       directory you wish to purge.  If *.* is specified, PurgeCL
  565.       will attempt to purge any file in the specified directory,
  566.       including non-drawing files.  No harm will be done but each
  567.       attempt at purging a non-drawing file will result in an error
  568.       generated in the logfile which could be extensive and quite
  569.       messy.
  570.  
  571.    Example:    PurgeCL structsteel.dwg *.dwg c:\work\a?1243.143 
  572.                   d:\work\*.* x:\job152\arch\plan*.*
  573.  
  574.    Default:    N/A (a file specification must be included)
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.    ________________________________________________________________
  584.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 8
  585.  
  586. -----------------------------------------------------------------
  587.  
  588.    -alarm
  589.  
  590.    Name:    ALARM
  591.  
  592.    Purpose:    If set, this option will instruct PurgeCL to sound a 
  593.       continuous alarm when a batch is finished.
  594.  
  595.    Notes:    This option is useful to warn when a batch is finished.
  596.       The beeping will continue until a key is pressed.  Do not 
  597.       use this option if you are call PurgeCL repeatedly from a 
  598.       batch file (the alarm will sound each time PurgeCL is called).
  599.  
  600.    Example:    PurgeCL -alarm ...
  601.  
  602.    Default:    OFF (no alarm will sound when PurgeCL is finished)
  603.  
  604. -----------------------------------------------------------------
  605.  
  606.    -bell
  607.  
  608.    Name:    BELL
  609.  
  610.    Purpose:    If set, this option will instruct PurgeCL to sound a 
  611.       single beep (bell) when a batch is finished.
  612.  
  613.    Notes:    This option is similar to the alarm switch except only 
  614.       a single bell is issued.  After sounding the bell, PurgeCL 
  615.       will continue with no user intervention required.  This option
  616.       is useful to warn when a single process is finished.  It is 
  617.       not recommended to  use this option if you are calling PurgeCL
  618.       repeatedly from a batch file (the bell will sound each time).
  619.  
  620.    Example:    PurgeCL -bell ...
  621.  
  622.    Default:    OFF (no bell will sound when PurgeCL is finished) 
  623.  
  624. -----------------------------------------------------------------
  625.  
  626.    -bl
  627.  
  628.    Name:    BLOCKS
  629.  
  630.    Purpose:    Include this switch on the command line if you DO NOT 
  631.       wish to purge blocks.  Otherwise, unused blocks will be 
  632.       purged.
  633.  
  634.    Notes:    PurgeCL will perform a complete, single-pass purge on 
  635.       blocks nested up to 128 levels.  Any blocks that have been 
  636.       marked by AutoCAD as purged will be automatically removed 
  637.       whether or not this switch is active.
  638.  
  639.    Example:    PurgeCL -bl filename.dwg
  640.  
  641.    Default:    ON (unused blocks will be purged)
  642.    ________________________________________________________________
  643.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 9
  644.  
  645. -----------------------------------------------------------------
  646.  
  647.    -df
  648.  
  649.    Name:    DEFAULTS
  650.  
  651.    Purpose:    If the defaults option is off (-df), the current layer, 
  652.       linetype and style will not be purged (whether or not any 
  653.       entities use these current settings). 
  654.  
  655.    Notes:    If the defaults option is on and no entities use the
  656.       current default settings, the current defaults will be changed
  657.       to the base settings (layer 0, linetype continuous, style 
  658.       standard) and the default settings will be purged.  This 
  659.       option is included in case you don't want to purge any layers,
  660.       linetypes or styles that are not used but are the current 
  661.       defaults.
  662.  
  663.          This may sound confusing at first but consider if you had a
  664.       layer called 'IBEAMS' and it was set to the current layer and 
  665.       there weren't any entities on this layer.  Chances are you'd 
  666.       want to get rid of it.  If you do, don't worry; PurgeCL is set 
  667.       to purge that layer and set the current layer to 0 by default.
  668.       Otherwise, include this switch to tell PurgeCL to leave it 
  669.       alone.
  670.  
  671.          This option is included strictly for those users who wish 
  672.       to keep their drawing settings exactly as the original and
  673.       should not be used if you wish to have a truly complete purge 
  674.       performed.
  675.  
  676.    Example:    PurgeCL -df ...
  677.  
  678.    Default:    ON (default settings will be purged)
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.    ________________________________________________________________
  702.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 10
  703.  
  704. -----------------------------------------------------------------
  705.  
  706.    -dp=
  707.  
  708.    Name:    DESTPATH
  709.  
  710.    Purpose:    Use this parameter to specify a different destination 
  711.       directory than the original directory to store the purged 
  712.       files.
  713.  
  714.    Notes:    
  715.       1) Note that this option is not for backup files; backup files
  716.           will always be saved in the original directory.  This 
  717.           option is provided for users that either don't have 
  718.           enough space on their current drive or wish to save the
  719.           drawings to a network.
  720.       2) If a drawing of the same name that is currently being 
  721.           processed exists in the destination directory specified,
  722.           PurgeCL will issue an error and automatically save the
  723.           drawing to its original directory.  This will prevent 
  724.           drawings from being overwritten inadvertently.  
  725.           Therefore, be sure that the destination directory does
  726.           not contain any drawings of the same name as the 
  727.           drawings you want to purge.
  728.  
  729.    Example:    PurgeCL -dp=x:\work ...
  730.  
  731.    Default:    OFF (purged .DWGs are saved to the same directory) 
  732.  
  733. -----------------------------------------------------------------
  734.  
  735.    -?
  736.  
  737.    Name:    REGISTRATION INFO
  738.  
  739.    Purpose:    Prints information for how to register your copy
  740.       of PurgeCL
  741.  
  742.    Notes:   Use this switch after your trial period is finished
  743.       so you can get your registered copy, printed user's manual
  744.       and unlimited support.  Since you're reading this anyway,
  745.       here's the TOLL-FREE NUMBER: 800-707-5148 to order.
  746.  
  747.    Example:    PurgeCL -?
  748.  
  749.    Default:    OFF (registration information is not printed) 
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.    ________________________________________________________________
  761.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 11
  762.  
  763. -----------------------------------------------------------------
  764.  
  765.    -ds
  766.  
  767.    Name:    DIMSTYLES
  768.  
  769.    Purpose:    Include this switch on the command-line if you DO NOT 
  770.       wish to purge dimstyles.  Otherwise, unused dimstyles will 
  771.       be purged.
  772.  
  773.    Notes:    None
  774.  
  775.    Example:    PurgeCL -ds ...
  776.  
  777.    Default:    ON (unused dimstyles will be purged)
  778.  
  779. -----------------------------------------------------------------
  780.  
  781.    -dt
  782.  
  783.    Name:    DATETIME
  784.  
  785.    Purpose:    The datetime option is provided to change the date/time
  786.       of the drawing file to the date/time that the file was purged.
  787.       Otherwise, do not include this switch if you want the original
  788.       date/time stamp to be preserved on the purged file.
  789.  
  790.    Notes:    This option should be used with caution since all date/
  791.       time information about the drawing file will be lost.  The 
  792.       only recourse to determining the age of a file is to bring it
  793.       up in AutoCAD and check the date/time stamp system variable.
  794.  
  795.    Example:    PurgeCL -dt ...
  796.  
  797.    Default:    OFF (original date is preserved)
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.    ________________________________________________________________
  820.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 12
  821.  
  822. -----------------------------------------------------------------
  823.  
  824.    -filter:
  825.  
  826.    Name:    DATE/TIME FILTER
  827.  
  828.    Purpose:    This option provides the ability to select which files
  829.       to purge based on each file's date/time stamp.
  830.  
  831.    Notes:    The syntax for this switch is as follows:
  832.        -filter:<comp1><date1>[@<time1>][<operator>]
  833.                                   [<comp2>][<date2>][@<time2>]
  834.  
  835.        (items in brackets are optional)
  836.        where:
  837.            - comp1 or comp2 is any of 
  838.                <<    (less than)
  839.                >>    (greater than)
  840.                <=    (less than or equal to)
  841.                >=    (greater than or equal to)
  842.                ==    (equal to)
  843.                !=    (not equal to)
  844.            - operator is either
  845.                .&.    (AND)
  846.                .|.    (OR)
  847.            - date1 and date2 are expressed as MM/DD/YY.  Leading
  848.               zeroes must be used (i.e. "01" vs. "1").
  849.            - time1 and time2 are expressed as HH/MM in military time 
  850.               (24 hour clock).  Leading zeroes must be used (i.e. 
  851.               "01" vs. "1").  The "@" symbol must precede each time 
  852.               specification.
  853.  
  854.        If this option is used on the command line, quote marks (")
  855.           must be used around the expression ("-filter:...").  This
  856.           is due to the fact that DOS will interpret any "<" or ">"
  857.           characters as redirection operators and not pass the filter
  858.           string to PurgeCL (unexpected results will occur).  If 
  859.           filter is used in a script file then surrounding quotes 
  860.           are not required and will generate an error if used.
  861.  
  862.    Example:    
  863.       PurgeCL "-filter:>>10/01/98" ...
  864.         Meaning: From the command line, purge those files that have 
  865.            a date greater than 10/01/98.
  866.  
  867.        PurgeCL "-filter:!=10/01/98@15:32.&.>>09/23/98" ...
  868.         Meaning: From the command line, purge those files that have 
  869.            a date stamp greater than 09/23/98 but are not equal to 
  870.            10/01/98 at 15:32 (3:32 in the afternoon).
  871.  
  872.     See the section on Using PurgeCL Filters for a more detailed 
  873.        explanation and examples.
  874.  
  875.    Default:    OFF (all files matching the file specification will be 
  876.       purged regardless of each file's date/time stamp)
  877.  
  878.    ________________________________________________________________
  879.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 13
  880.  
  881. -----------------------------------------------------------------
  882.  
  883.    -la
  884.  
  885.    Name:    LAYERS
  886.  
  887.    Purpose:    Include this switch on the command line if you DO NOT 
  888.       wish to purge layers.  Otherwise, unused layers will be 
  889.       purged.
  890.  
  891.    Notes:    PurgeCL will not disturb any Xref layer settings 
  892.       (visretain has no bearing on PurgeCL).
  893.  
  894.    Example:    PurgeCL -la ...
  895.  
  896.    Default:    ON (unused layers will be purged)
  897.  
  898. -----------------------------------------------------------------
  899.  
  900.    -ln=
  901.  
  902.    Name:    LOGNAME
  903.  
  904.    Purpose:    This parameter allows for specifying a different logfile
  905.       name than the default.
  906.  
  907.    Notes:    By default, PurgeCL will use a concatenation of 'PLOG' 
  908.       and the current month/day.  For example, if today is 
  909.       December 15, the logfile will be saved as: PLOG1215.LOG.  
  910.       You may specify either the filename alone or both a filename 
  911.       and extension.  If no extension is specified, ".LOG" will be 
  912.       used.  Note that the path should NOT be specified (use "-lp" 
  913.       described below)
  914.  
  915.    Example:    PurgeCL -ln=mylog.abc ...
  916.  
  917.    Default:    OFF (log files will be saved as "PLOG<date>.LOG")
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.    ________________________________________________________________
  938.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 14
  939.  
  940. -----------------------------------------------------------------
  941.  
  942.    -loff
  943.  
  944.    Name:    LOGOFF
  945.  
  946.    Purpose:    Use this switch if you DO NOT want a log file to be 
  947.       generated.
  948.  
  949.    Notes:    It is strongly recommended that this option not be used.
  950.       The log file contains lots of vital information to track down 
  951.       any problems that might have occurred during an unattended 
  952.       batch.  However, for simple purges, this switch may be used
  953.       to eliminate extraneous log files.
  954.  
  955.    Example:    PurgeCL -loff ...
  956.  
  957.    Default:    ON (log file will be generated)
  958.  
  959. -----------------------------------------------------------------
  960.  
  961.    -lp=
  962.  
  963.    Name:    LOGPATH
  964.  
  965.    Purpose:    This parameter allows for the specification of a 
  966.       different path where log files will be generated to.  Do not
  967.       include any spaces between '-lp=' and the path.
  968.  
  969.    Notes:    This is a real handy switch to keep your log files from 
  970.       getting scattered around your hard disk.  Simply create a 
  971.       directory off of the ACAD or PurgeCL directory and set this 
  972.       switch to point there.  This option is available as an 
  973.       environment variable setting as well which may be set in the 
  974.       AUTOEXEC.BAT file to permanently direct log files to a 
  975.       standard log file directory.
  976.  
  977.    Example:    PurgeCL -lp=c:\acad12\purgecl\logs ...
  978.  
  979.    Default:    OFF (log files are stored in the current directory)
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.    ________________________________________________________________
  997.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 15
  998.  
  999. -----------------------------------------------------------------
  1000.  
  1001.    -lt
  1002.  
  1003.    Name:    LINETYPES
  1004.  
  1005.    Purpose:    Include this switch on the command line if you DO NOT 
  1006.       wish to purge linetypes.  Otherwise, unused linetypes  will
  1007.       be purged.
  1008.  
  1009.    Notes:    None
  1010.  
  1011.    Example:    PurgeCL -lt ...
  1012.  
  1013.    Default:    ON (unused linetypes will be purged).
  1014.  
  1015. -----------------------------------------------------------------
  1016.  
  1017.    -scr=
  1018.  
  1019.    Name:    SCRIPT File  
  1020.  
  1021.    Purpose:    Specify the path and file name for PurgeCL to open to 
  1022.       begin script processing.  When this switch is set, all other 
  1023.       switches on the line are ignored.
  1024.  
  1025.    Notes:    (see chapter on Using PurgeCL Script Files)
  1026.  
  1027.    Example:    PurgeCL -scr=c:\acad10\scr\all.psr
  1028.  
  1029.    Default:    OFF (script file will not be used)
  1030.  
  1031. -----------------------------------------------------------------
  1032.  
  1033.    -sh
  1034.  
  1035.    Name:    SHAPES
  1036.  
  1037.    Purpose:    Include this switch on the command line if you DO NOT 
  1038.       wish to purge shapes.  Otherwise, unused shapes will be 
  1039.       purged.
  1040.  
  1041.    Notes:    Shapes are stored in shape files that may contain more 
  1042.       than one shape per file.  Only if no shapes from a shape file
  1043.       reference are used in the drawing will its reference be 
  1044.       removed.
  1045.  
  1046.          Therefore, don't be surprised if PurgeCL doesn't remove a 
  1047.       shape reference that you thought should be removed; there's
  1048.       probably another shape in the drawing that uses that shape
  1049.       file.
  1050.  
  1051.    Example:    PurgeCL -sh ...
  1052.  
  1053.    Default:    ON (unused shapes will be purged)
  1054.  
  1055.    ________________________________________________________________
  1056.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 16
  1057.  
  1058. -----------------------------------------------------------------
  1059.  
  1060.    -st
  1061.  
  1062.    Name:    STYLES
  1063.  
  1064.    Purpose:    Include this switch on the command line if you do NOT 
  1065.       wish to purge styles.  Otherwise, unused styles will be 
  1066.       purged.
  1067.  
  1068.    Notes:    None
  1069.  
  1070.    Example:    PurgeCL -st ...
  1071.  
  1072.    Default:    ON (unused styles will be purged)
  1073.  
  1074. -----------------------------------------------------------------
  1075.  
  1076.    -v
  1077.  
  1078.    Name:    VERBOSE mode
  1079.  
  1080.    Purpose:    This switch will "quiet" the screen while processing.  
  1081.       Only error messages and the bare minimum of status messages 
  1082.       will appear on the screen.  Otherwise, all messages will 
  1083.       print to screen.  
  1084.  
  1085.    Notes:    This option is useful for "semi-attended" operation 
  1086.       where it would be useful to have any errors stand out.  In 
  1087.       non-verbose mode, too much information might be printed to 
  1088.       the screen.  A non-verbose description will always be entered
  1089.       in the log file so no information is ever lost.
  1090.  
  1091.    Example:    PurgeCL -v ...
  1092.  
  1093.    Default:    OFF (all information will be printed to screen)
  1094.  
  1095. -----------------------------------------------------------------
  1096.  
  1097.    -xp=
  1098.  
  1099.    Name:    EXCLUSION file
  1100.  
  1101.    Purpose:    Specify the path and file name for PurgeCL to open for
  1102.       reading which table entries should be excluded from purging.
  1103.  
  1104.    Notes:    (see chapter on Using Exclusion Files)
  1105.  
  1106.    Example:    PurgeCL -xp=c:\acad12\xcl\archtect.xcl ...
  1107.  
  1108.    Default:    OFF (exclusion file will not be used)
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.    ________________________________________________________________
  1115.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 17
  1116.  
  1117.  
  1118.  
  1119.    2 - USING EXCLUSION FILES
  1120.    -------------------------
  1121.    
  1122.       The exclusion file option is provided for those users who use
  1123.    a standard drawing environment and wish to ensure that certain 
  1124.    table entries are not disturbed.  Although many drawing packages 
  1125.    provide a facility to recreate the standard layers, linetypes, 
  1126.    etc. very easily, PurgeCL is designed to be as transparent as
  1127.    possible.
  1128.  
  1129.       This file is a standard ASCII text file that can be created 
  1130.    and edited with any text editor.  EDIT.EXE, which comes with 
  1131.    DOS 5 and above, is probably the easiest to use.  A sample 
  1132.    exclusion file is included under the name XCLSAMP.XCL with the 
  1133.    PurgeCL standard package.
  1134.  
  1135.       Comments, leading whitespace and blank lines are acceptable.
  1136.    This free format allows for a more readable text so it's highly
  1137.    recommended that you use comments liberally.  A comment is 
  1138.    denoted by placing a '//' (two forward slashes) at the beginning
  1139.    of any line; it is not legal to place a comment on the same line
  1140.    as a statement.
  1141.  
  1142.       The structure of the exclusion file is relatively simple.  
  1143.    Each table type is placed as a marker with the associated table 
  1144.    entries listed after them:
  1145.  
  1146.  
  1147.       // This is a comment because of the leading "//" marks
  1148.       //
  1149.  
  1150.       :LAYER
  1151.          structsteel01
  1152.          structsteel02
  1153.  
  1154.       :LINETYPE
  1155.          customdashed01
  1156.          customdashed02
  1157.  
  1158.       :STYLE
  1159.          mystyle1
  1160.          mystyle2
  1161.  
  1162.       :SHAPE
  1163.          c:\acad\sample\es.shx
  1164.  
  1165.       :BLOCK
  1166.          savethisblock01
  1167.          pleasesavemeblock01
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.    ________________________________________________________________
  1174.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 18
  1175.  
  1176.  
  1177.  
  1178.       Each table type must be prefixed by a colon (:) and should be
  1179.    capitalized.  The table types may be specified in any order but
  1180.    it is safer to include all of the table markers to prevent 
  1181.    entries from "filtering" through due to missing markers:
  1182.  
  1183.       // Whoops, customdashed01 and customdashed02 will be treated
  1184.       //  as layers; as a result, no linetypes will be preserved 
  1185.       //  (we intended customdashed01 and customdashed02 to be
  1186.       //  spared)
  1187.  
  1188.       :LAYER
  1189.          structsteel01
  1190.          structsteel02
  1191.  
  1192.          customdashed01
  1193.          customdashed02
  1194.  
  1195.       :STYLE
  1196.          ... 
  1197.  
  1198.       It is perfectly fine to include a marker and not have any 
  1199.    entries for it:
  1200.  
  1201.       // Go ahead and purge any linetypes that aren't used...
  1202.  
  1203.       :LAYER
  1204.          structsteel01
  1205.          structsteel02
  1206.  
  1207.       :LINETYPE
  1208.  
  1209.       :STYLE
  1210.          mystyle01
  1211.          ...
  1212.  
  1213.  
  1214.       Any entries that were bound from an xref must be entered with
  1215.    its full name.  Consider layer IBEAMS bound from xref file 
  1216.    STRUCT35.DWG.  The layer entry must be STRUCT35$0$IBEAMS; 
  1217.    not IBEAMS.  The actual names can be determined by performing
  1218.    (for example)  LAYERS ? inside AutoCAD.
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.    ________________________________________________________________
  1233.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 19
  1234.  
  1235.  
  1236.  
  1237.       The location of this file can be set by setting the PG_XPATH
  1238.    environment variable or by using the -xp= switch on the 
  1239.    command line:
  1240.  
  1241.       Environment Variable:
  1242.  
  1243.         c:> set PG_XPATH=C:\ACAD12\PURGECL\XCL\XCLSAMP.XCL or
  1244.         c:> set PG_XPATH=XCLSAMP.XCL   (current directory)
  1245.  
  1246.       Command Line:
  1247.  
  1248.         PURGECL -xp=C:\ACAD12\PURGECL\XCL\XCLSAMP.XCL ...
  1249.  
  1250.       However, if a script file is being used, both the environment
  1251.    variable setting and the command-line -xp= switch will be 
  1252.    ignored.  The path must be specified in the script file using
  1253.    the -xp= switch.  This is described in the next section on script
  1254.    files.
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.    ________________________________________________________________
  1292.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 20
  1293.  
  1294.  
  1295.  
  1296.    3 - USING PURGE SCRIPT FILES
  1297.    ----------------------------
  1298.  
  1299.       The script file option is provided for those users who have a 
  1300.    standard directory structure for their jobs and need the 
  1301.    capability of purging the directories on a regular basis.  This
  1302.    option allows for a standardized batch processing environment.
  1303.  
  1304.       Like the exclusion file, the script file is a standard ASCII
  1305.    text file that can be created and edited with any text editor.
  1306.    Note, however, that script file is NOT the same as an AutoCAD 
  1307.    script file.  A sample script file is included under the name 
  1308.    PSRSAMP.PSR with the PurgeCL standard package.
  1309.  
  1310.       Again, similar to the exclusion file, comments, leading 
  1311.    whitespace and blank lines are acceptable.  This free format
  1312.    allows for a more readable text so it's highly recommended 
  1313.    that you use comments liberally.  A comment is denoted by 
  1314.    placing a '//' (two forward slashes) at the beginning of any 
  1315.    line; it is not legal to place a comment on the same line as 
  1316.    a statement.
  1317.  
  1318.       The structure of the script file is straightforward.  There
  1319.    are two sections to the script file: initial and the body.  The
  1320.    initial section is used to set the log file parameters, verbose
  1321.    mode and whether the bell or alarm should be on.  These switches
  1322.    are only allowed in this initial section.  Likewise, no other
  1323.    switches are allowed here.  The body of the script begins when
  1324.    the first :START marker is  encountered.  Each set of similar
  1325.    purge tasks are surrounded by a :START and :END marker.  A pair
  1326.    of these markers will be referred to as a task block.  With the
  1327.    exception of the switches set in the initial section, all 
  1328.    switches are reset to their default setting when a new task 
  1329.    block is encountered.  Within each task block reside the switches
  1330.    and drawing file names that should be processed.  An example will 
  1331.    clear up any confusion:
  1332.  
  1333.  
  1334.       // This is a sample script file...
  1335.       //
  1336.       // Let's set some switches in the initial section (these are
  1337.       //  the only ones allowed here and may be omitted):
  1338.  
  1339.       -ln=archlog.plg
  1340.       -lp=c:\acad\purgecl\logs
  1341.       // -loff
  1342.       //-alarm
  1343.       -bell
  1344.       -v
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.    ________________________________________________________________
  1351.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 21
  1352.  
  1353.  
  1354.       // Now let's start processing some files.  We're entering the 
  1355.       //  body of the script.  Don't purge blocks or styles from 
  1356.       //  the drawings in c:\work\job001...
  1357.       :START
  1358.          -bl
  1359.          -st
  1360.          c:\work\job001\*.dwg
  1361.       :END
  1362.  
  1363.  
  1364.       // Ready for the next set of files.  At this point, all body
  1365.       //  switches have been reset to their default settings.  Note
  1366.       //  that styles will not be purged from the files in job002.
  1367.       //  Only blocks will be purged in the job002 directory.  Both
  1368.       //  blocks and styles will be purged from the job003 directory
  1369.       //  if the files were created or modified during the week of
  1370.       //  January 15, 1998 or February 21, 1997.
  1371.       :START
  1372.          -bl
  1373.          c:\work\job002\*.dwg
  1374.  
  1375.          -st
  1376.          -filter:>=01/15/98.&.<<01/22/98
  1377.          -filter:>=02/21/97.&.<<02/28/97
  1378.  
  1379.          c:\work\job003\*.dwg
  1380.       :END
  1381.  
  1382.       Each task block must begin and end with a :START and :END
  1383.    marker, respectively.  In general, there should never be any
  1384.    statements between an :END and :START marker since all switches
  1385.    are reset when starting a new task block.
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.    ________________________________________________________________
  1410.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 22
  1411.  
  1412.  
  1413.  
  1414.    4 - USING DATE/TIME FILTERS
  1415.    ---------------------------
  1416.    
  1417.       Since most drawing files on an average system are not active, 
  1418.    there's no need to purge them again and again.  PurgeCL includes
  1419.    a powerful facility for selecting which files you wish to purge
  1420.    based on a date/time stamp.  The filter option allows you to 
  1421.    select a cut-off date and only purge those files that are likely
  1422.    to have been accessed.  This option includes the capability for
  1423.    selections of the "less-than/greater-than" type as well as within
  1424.    a range of dates.  This latter type is implemented by using two
  1425.    Boolean operators, AND (.&.) and OR (.|.), between two comparison
  1426.    functions.  
  1427.  
  1428.       For example, it's Friday afternoon, November 13, 1998 and you
  1429.    want to Purge all drawings that have a stamp of this week.  You
  1430.    could either say "Purge everything from November 6th on" or 
  1431.    "Purge everything between November 6th and November 13th".  The
  1432.    following two commands could be used to do this:
  1433.  
  1434.        -filter:>>11/06/98
  1435.        -filter:>>11/06/98.&.<<11/13/98
  1436.  
  1437.       These two examples are probably the most common uses of the 
  1438.    filter option but certainly not the only ones.   Six comparison
  1439.    operators (<<, >>, <=, >=, ==, !=) are provided as well as two
  1440.    join operators (AND and OR).  Also, a time condition may be added
  1441.    as an additional qualification to either date.  For example,
  1442.    let's say you know that the only drawings worked on today 
  1443.    (October 19, 1996) were in the afternoon so there's no need to
  1444.    purge anything with a date less than 12:00 noon.  This can be 
  1445.    handled very easily with the following statement:
  1446.  
  1447.        PurgeCL "-filter:>>10/19/96@12:00"
  1448.  
  1449.       Remember that surrounding quotes are absolutely necessary when
  1450.    using the filter option on the command line.  Expanding on the 
  1451.    previous example, consider if you wanted to purge only files 
  1452.    that have a stamp between 1:00pm and 3:00pm:
  1453.  
  1454.        PurgeCL "-filter>>10/19/96@13:00.&.<<10/19/96@15:00"
  1455.  
  1456.       Note that military time is mandatory when using the time
  1457.    option and that the "@" symbol is also required.  Do not include
  1458.    pm or am since this is implied by using military time.  Any
  1459.    operator and any join condition may be used together but 
  1460.    generally the simpler an expression is the better.  The 
  1461.    flexibility offered by the filter option should allow you to 
  1462.    select drawings by any combination you can come up with.
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.    ________________________________________________________________
  1469.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 23
  1470.  
  1471.  
  1472.       The filter option may also be "cascaded" to provide an 
  1473.    unlimited number of conditions.  For example, if you wanted to 
  1474.    purge all drawings during the weeks of January 15, 1997 and 
  1475.    February 21, 1998, simply enter multiple statements:
  1476.  
  1477.        -filter:>=01/15/97.&.<=01/22/97
  1478.        -filter:>=02/21/98.&.<=02/28/97
  1479.  
  1480.       These statements may be entered consecutively on the command 
  1481.    line or directly into a purge script file (no quotes are needed
  1482.    if used in a script file).  Note that it is implied that each
  1483.    condition is considered independently as an OR condition; i.e. 
  1484.    if any condition is met then the file will be purged.
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.    ________________________________________________________________
  1528.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 24
  1529.  
  1530.  
  1531.  
  1532.    5 - USING PURGECL'S ENVIRONMENT VARIABLES
  1533.    -----------------------------------------
  1534.  
  1535.       Four environment variables are provided for setting constant 
  1536.    path settings outside of PurgeCL.  These are very handy for 
  1537.    directing PurgeCL to save files in a particular directory 
  1538.    without having to specify the directory every time a batch is
  1539.    run.  Available environment variables are:
  1540.  
  1541.        1)  PG_LPATH=    same as -lp=, sets the Log path
  1542.        2)  PG_LNAME=    same as -ln=, sets the Log name
  1543.        3)  PG_DPATH=    same as -dp=, sets the Destination Path
  1544.        4)  PG_XPATH=    same as -xp=, sets the Exclusion Path
  1545.  
  1546.       To set a variable, simply type 'SET' and the variable desired
  1547.    from the DOS command line, followed by the path you'd like 
  1548.    PurgeCL to use for the setting.  For example, If you'd like 
  1549.    to have all of your purged drawings saved to x:\work\job001,
  1550.    type the following on the DOS command line before running
  1551.    PurgeCL:
  1552.  
  1553.        SET PG_DPATH=X:\WORK\JOB001
  1554.  
  1555.       Be sure to include a valid path and always enter the 
  1556.    environment variable name exactly as shown above.  Environment 
  1557.    variables may be cleared by typing SET followed by the variable
  1558.    name and an equal sign.  By omitting any information after the
  1559.    equal sign, the variable will be cleared:
  1560.  
  1561.        SET PG_LNAME=
  1562.  
  1563.       Also, the settings may be changed just by entering a new set
  1564.    statement.  This will replace the old setting with the new.
  1565.  
  1566.       PurgeCL's command line switches always take precedence over 
  1567.    environment variable settings.  Therefore, even if an environment
  1568.    variable is set, you can temporarily redirect the setting by 
  1569.    entering its equivalent switch on the command line (i.e. entering
  1570.    -lp=c:\acad\log will ignore what the PG_LPATH setting is and 
  1571.    write log files to the c:\acad\log directory).
  1572.  
  1573.       In general, only the PG_LPATH and PG_LNAME variables should 
  1574.    be set in your Autoexec.bat file.  Undesired results could occur
  1575.    if PG_DPATH or PG_XPATH are left set and forgotten about.  
  1576.    Remember that PurgeCL will always use the settings specified in
  1577.    the environment variables unless a switch is used on the command
  1578.    line to override it.
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.    ________________________________________________________________
  1587.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 25
  1588.  
  1589.  
  1590.  
  1591.    6 - IMPORTANT NOTES
  1592.    -------------------
  1593.    
  1594.       This section includes a variety of tips and hints that should 
  1595.    be read before using PurgeCL.  They will save you many headaches
  1596.    if adhered to and should be understood.
  1597.  
  1598.    - If ESC is pressed while a drawing is being processed, 
  1599.       PurgeCL will finish purging the current file, then rewrite
  1600.       the finished file with the .BAK file.  Therefore, no changes
  1601.       will have been made to the file that was being purged.
  1602.  
  1603.    - Although PurgeCL uses a highly-optimized and efficient 
  1604.       algorithm for purging, large drawings can take a long time
  1605.       to purge.  Please don't reboot while PurgeCL is running -
  1606.       if you need to stop purging in the middle of a number of 
  1607.       files, hit ESCAPE or Ctrl-C.  This will avoid any problems
  1608.       with lost or corrupt drawings.
  1609.  
  1610.    - .BAK files are generated automatically.  To prevent losing
  1611.       the original drawing in case there is a power outage or 
  1612.       hard-disk crash while PurgeCL is running, there is no option
  1613.       to not generate backup files.  We suggest that the purged 
  1614.       drawings be tested in AutoCAD before erasing the .BAK files
  1615.       to verify that an undetectable "brown-out" or "kicked-disk"
  1616.       did not corrupt the purged drawing.  If you wish to have 
  1617.       the backup files stored in a location different than the
  1618.       current directory, use the -dp= switch described above. 
  1619.       If proper precautions are observed, PurgeCL will provide 
  1620.       reliable operation consistently.
  1621.  
  1622.    - Switches are not case sensitive either on the command-line 
  1623.       or in a script file.
  1624.  
  1625.    - Press the Pause button or Ctrl-S at any time to pause the 
  1626.       process.  Resume processing by pressing Enter.
  1627.  
  1628.    - If you wish to stop a process, press Ctrl-BREAK or Ctrl-C.
  1629.       A prompt will appear asking if you really wish to quit.
  1630.       Once a process is stopped, there is no way to pick up where
  1631.       it left off unless the batch or script file is manually 
  1632.       edited to remove the items already purged.  This can be 
  1633.       easily determined by referring to the log file.
  1634.  
  1635.    - Network users must use standard drive letters instead of 
  1636.       a "vol1:" or "sys:" nomenclature for designating volumes.
  1637.       For example, if you wish to refer to the vol1: volume, 
  1638.       use a mapped drive (like x:) to specify that drive:  
  1639.       -dp=x:\work\bak  instead of -dp=vol1:\work\bak.
  1640.  
  1641.    - To avoid any problems with interruptions while PurgeCL is 
  1642.       writing files, the BREAK setting is turned off while purging.
  1643.       If having BREAK on is important to your system, please be 
  1644.       sure to turn it on after purging.
  1645.    ________________________________________________________________
  1646.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 26
  1647.  
  1648. ================================================================
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.                            SECTION THREE
  1663.  
  1664.                         REGISTERING PURGECL
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.    ________________________________________________________________
  1705.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 27
  1706.  
  1707.  
  1708.  
  1709.    1 - REGISTRATION BENEFITS
  1710.    -------------------------
  1711.  
  1712.    When you register, you'll be entitled to the following:           
  1713.       - A Printed User's Manual
  1714.       - Notification of minor upgrades 
  1715.       - An executable for each machine registered (except for
  1716.          network users running a single copy of PurgeCL from a
  1717.          server)
  1718.       - Your registered copy of PurgeCL will perform IDENTICALLY
  1719.          to the shareware version you've been using except that 
  1720.          the register screen won't appear. 
  1721.       - Unlimited support by Cserve, telephone, US mail, etc. 
  1722.  
  1723.         The documentation that you'll receive will be pretty much
  1724.      identical to this document except the ordering instructions,
  1725.      etc. won't appear.
  1726.  
  1727.    2 - PRICING POLICIES
  1728.    --------------------
  1729.         Our pricing policy is pretty straightforward:
  1730.  
  1731.            1)  We accept the following:
  1732.                  - Check
  1733.                  - Money Order
  1734.                  - Visa
  1735.                  - Mastercard
  1736.                  - American Express
  1737.                  - Invoiced Orders (Purchase Order)
  1738.            2) Pricing: 
  1739.                  Single or Dual machine users:
  1740.                     Each machine should be registered for $69.95
  1741.  
  1742.                  More-than-two machine users:
  1743.                     2 copies times $69.95 plus
  1744.                     $19.95 each for copies 3,4,...
  1745.                     
  1746.                  Site-License:
  1747.                     An Unlimited use site-license may be purchased
  1748.                      for a flat fee of $495
  1749.  
  1750.                  Network Users:
  1751.                     Same as "More-than-two" machine users whether
  1752.                      PURGECL will be installed on each machine 
  1753.                      or a single copy will be run off of a server
  1754.  
  1755.                  Tax:
  1756.                     6% Kentucky Sales Tax for Kentucky residents
  1757.                      only
  1758.  
  1759.                  =======================================
  1760.                  TO ORDER: CALL TOLL-FREE 1-800-707-5148
  1761.                  =======================================
  1762.  
  1763.    ________________________________________________________________
  1764.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 28
  1765.  
  1766.      3 - ORDERING PURGECL   TO ORDER: CALL TOLL-FREE 1-800-707-5148
  1767.      --------------------   =======================================
  1768.                        INVOICE/REGISTRATION FORM
  1769.                          PURGECL - VERSION 2.0
  1770.         
  1771.         For mail orders, please include this form.    
  1772.      a) Total number of copies = ___
  1773.  
  1774.      b) Enter number of copies (2 OR LESS)   ___ x $69.95 = _____ 
  1775.  
  1776.      c) Enter number of copies (MORE THAN 2) ___ x $19.95 = _____ 
  1777.  
  1778.      d) Unlimited-use Site License                $495.00 = _____
  1779.  
  1780.      e)                                          Subtotal = _____
  1781.                                                
  1782.      f)                 KY residents: add 6% KY sales tax = _____
  1783.                                          
  1784.      g)                                         Total Due = _____
  1785.  
  1786.      Please make your check or MO payable to: Blue Ridge Software
  1787.      NON-US CUSTOMERS MAY PAY IN CASH (FOREIGN CURRENCY) OR MO
  1788.      Mail to:
  1789.         Blue Ridge Software, Inc.
  1790.         235 Southport Drive
  1791.         Lexington, KY  40503
  1792.   
  1793.      Credit Card Customers:   
  1794.      ----------------------        
  1795.         VISA / Mastercard / AMEX (circle one)     
  1796.  
  1797.         Card number: ___________________________ Exp. Date _________
  1798.  
  1799.         Signature: ________________________________ (Must be signed)
  1800.  
  1801.      Shipping Address:
  1802.      -----------------
  1803.      Name:_________________________________________________________
  1804.  
  1805.      Company name:_________________________________________________
  1806.  
  1807.      Address:______________________________________________________
  1808.  
  1809.      City/State/Zip/Country:_______________________________________
  1810.      
  1811.      Billing Address (if different from shipping address):
  1812.      -----------------
  1813.      Name:_________________________________________________________
  1814.  
  1815.      Company name:_________________________________________________
  1816.  
  1817.      Address:______________________________________________________
  1818.  
  1819.      City/State/Zip/Country:_______________________________________
  1820.  
  1821.                          THANKS FOR YOUR ORDER...
  1822.    ________________________________________________________________
  1823.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 29
  1824.  
  1825.  
  1826.  
  1827.      4 - COMMENT FORM
  1828.      ----------------
  1829.  
  1830.      1) Did you find PURGECL easy to use?  Yes__  No__ Somewhat__
  1831.  
  1832.      2) What would make PURGECL a more "usable" product?
  1833.  
  1834.         ___________________________________________________________
  1835.  
  1836.         ___________________________________________________________
  1837.  
  1838.         ___________________________________________________________
  1839.  
  1840.      3) Does PURGECL have all of the features that you need? 
  1841.             Yes__ No__ Somewhat__
  1842.  
  1843.      4) What else would you like to see added to PURGECL? _________
  1844.  
  1845.         ___________________________________________________________
  1846.  
  1847.         ___________________________________________________________
  1848.   
  1849.      5) Any wishes for future AutoCAD add-on products (preferably 
  1850.         DOS-level utilities like PURGECL)?
  1851.  
  1852.         ___________________________________________________________
  1853.  
  1854.         ___________________________________________________________
  1855.  
  1856.         ___________________________________________________________
  1857.  
  1858.      7) What version(s) of AutoCAD do you use? <=10__ 11__ 12__
  1859.  
  1860.      8) From your experience with using Shareware products, how do
  1861.         you feel about the "Register screen" concept?
  1862.          ___ a) I don't like them 
  1863.          ___ b) Doesn't bother me at all.
  1864.          ___ c) It is a fair way of reminding me to register.
  1865.          ___ d) If the product is worth paying for, I'll register 
  1866.                 whether it's there or not
  1867.          ___ e) It disturbs the evaluation process
  1868.          ___ f) Other: ________________________________________
  1869.         
  1870.      9) If you have registered with a Shareware author, why did you
  1871.         feel it was worth doing?
  1872.  
  1873.          ___ a) The program was not available "off-the-shelf"
  1874.          ___ b) The program is better than "off-the-shelf"
  1875.          ___ c) "It's the right thing to do legally/morally" 
  1876.          ___ d) Other: __________________________________________
  1877.         
  1878.  
  1879.  
  1880.  
  1881.    ________________________________________________________________
  1882.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 30
  1883.  
  1884. ================================================================
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.                            SECTION FOUR
  1899.  
  1900.                             APPENDICES
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.    ________________________________________________________________
  1941.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 31
  1942.  
  1943.  
  1944.  
  1945.    A - IF YOU HAVE PROBLEMS OR QUESTIONS...
  1946.    ----------------------------------------
  1947.    
  1948.       The quickest response will be through the use of Compuserve
  1949.    since we check for mail every night and will usually post 
  1950.    responses before 8:00 EST.  If you have a Compuserve, direct 
  1951.    your mail to: Compuserve: 70353,1604
  1952.  
  1953.       If you don't have access to Compuserve, we can be reached
  1954.    at the following address and phone # between 8AM and 5PM EST,
  1955.    Monday through Friday:
  1956.  
  1957.       Blue Ridge Software, Inc.
  1958.       235 Southport Drive
  1959.       Lexington, KY, 40503
  1960.       (606) 276-5148
  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.  
  1997.  
  1998.  
  1999.    ________________________________________________________________
  2000.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 32
  2001.  
  2002.  
  2003.  
  2004.    B - WARRANTY - AGREEMENT
  2005.    ------------------------
  2006.  
  2007.    Copyright:
  2008.       The PurgeCL software and PurgeCL user's manual are Copyright 
  2009.    1991-1994 by Blue Ridge Software, Inc., All Rights Reserved 
  2010.    worldwide.
  2011.  
  2012.       Users of PurgeCL must accept this disclaimer of warranty:
  2013.    "PurgeCL is supplied as is.  The author disclaims all
  2014.    warranties, expressed or implied, including, without limitation,
  2015.    the warranties of merchantability and of fitness for any purpose.
  2016.    The author assumes no liability for damages, direct or conse-
  2017.    quential, which may result from the use of PurgeCL."
  2018.  
  2019.       PurgeCL is a "shareware program" and is provided at no charge
  2020.    to the user for evaluation.  Feel free to share it with your
  2021.    friends, but please do not give it away altered or as part of
  2022.    another system.  The essence of "user-supported" software is to
  2023.    provide personal computer users with quality software without
  2024.    high prices, and yet to provide incentive for programmers to
  2025.    continue to develop new products.  If you find this program
  2026.    useful and find that you are using PurgeCL and continue to use
  2027.    PurgeCL after a reasonable trial period, you must make a reg-
  2028.    istration payment of $69.95 + applicable tax to Blue Ridge 
  2029.    Software, Inc.  The $69.95 + applicable tax registration 
  2030.    fee will license one copy for use on any one computer at any one 
  2031.    time.  You must treat this software just like a book.  An example 
  2032.    is that this software may be used by any number of people and 
  2033.    may be freely moved from one computer location to another, so 
  2034.    long as there is no possibility of it being used at one location
  2035.    while it's being used at another.  Just as a book cannot be read
  2036.    by two different persons at the same time.
  2037.  
  2038.       Commercial users of PurgeCL must register and pay for their
  2039.    copies of PurgeCL within 30 days of first use or their license
  2040.    is withdrawn.  Site-License arrangements may be made by con-
  2041.    tacting Blue Ridge Software, Inc.
  2042.  
  2043.       Anyone distributing PurgeCL for any kind of remuneration must
  2044.    first contact Blue Ridge Software, Inc. at the address below for 
  2045.    authorization.  This authorization will be automatically granted 
  2046.    to distributors recognized by the (ASP) as adhering to its 
  2047.    guidelines for shareware distributors, and such distributors may
  2048.    begin offering PurgeCL immediately (However Blue Ridge Software, 
  2049.    Inc. must still be advised so that the distributor can be kept
  2050.    up-to-date with the latest version of PurgeCL.).
  2051.    
  2052.       You are encouraged to pass a copy of PurgeCL along to your
  2053.    friends for evaluation.  Please encourage them to register their
  2054.    copy if they find that they can use it.  All registered users
  2055.    will receive a copy of the latest version of the PurgeCL
  2056.    system.
  2057.  
  2058.    ________________________________________________________________
  2059.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 33
  2060.  
  2061.  
  2062.  
  2063.    C - ACKNOWLEDGEMENTS
  2064.    --------------------
  2065.    
  2066.       The following trademarks are registered in the U.S. Patent
  2067.    and Trademark Office by Autodesk, Inc.: ADI, AutoCAD, AutoCAD
  2068.    AEC, ATC, AutoCAD Training Center, Autodesk, the Autodesk logo,
  2069.    AutoLISP, AutoShade, and AutoSketch.
  2070.  
  2071.  
  2072.    D - THE ASP OMBUDSMAN 
  2073.    ---------------------
  2074.    
  2075.       This program is produced by a member of the Association of
  2076.    Shareware Professionals (ASP).  ASP wants to make sure that
  2077.    the shareware principle works for you.  If you are unable to
  2078.    resolve a shareware-related problem with an ASP member by
  2079.    contacting the member directly, ASP may be able to help.
  2080.    The ASP Ombudsman can help you resolve a dispute or problem 
  2081.    with an ASP member, but does not provide technical support 
  2082.    for members' products.  Please write to the ASP Ombudsman 
  2083.    at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe
  2084.    message via CompuServe Mail to ASP Ombudsman 70007,3536.
  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.    PURGECL V2.0 Documentation - Blue Ridge Software, Inc.  Page 34
  2119.