home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / PKINS661.ZIP / PKINSERT.DOC < prev    next >
Text File  |  1991-11-20  |  31KB  |  901 lines
  1.  
  2.  
  3.  
  4.  
  5.                    ┌───────────────────────────────────────┐
  6.                    │                                       │
  7.                    │                                       │
  8.                    │                                       │
  9.                    │                                       │
  10.                    │                                       │
  11.                    │                                       │
  12.                    │                                       │
  13.                    │                                       │
  14.                    │                                       │
  15.                    │                                       │
  16.                    │            P K I N S E R T            │
  17.                    │              Version 6.61             │
  18.                    │                                       │
  19.                    │   Copyright 7th Illusion, 1990-1991   │
  20.                    │          All Rights Reserved          │
  21.                    │      Released November 20th, 1991     │
  22.                    │                                       │
  23.                    │            F R E E W A R E            │
  24.                    │                                       │
  25.                    │                                       │
  26.                    │                                       │
  27.                    │                                       │
  28.                    │                                       │
  29.                    │                                       │
  30.                    │         Software Documentation        │
  31.                    │                                       │
  32.                    │                                       │
  33.                    │                                       │
  34.                    │                                       │
  35.                    │                                       │
  36.                    │                                       │
  37.                    │              7th Illusion             │
  38.                    │          Post Office Box 1334         │
  39.                    │               Station H               │
  40.                    │          Montreal QC, Canada          │
  41.                    │                H3G 2N6                │
  42.                    │                                       │
  43.                    │                                       │
  44.                    │         Node 1: (514)338-1193         │
  45.                    │    USRobotics Courier HST 14400 Bps   │
  46.                    │        1:167/281.0@fidonet.org        │
  47.                    │                                       │
  48.                    │         Node 2: (514)338-1680         │
  49.                    │        GVC Super Modem 2400 Bps       │
  50.                    │                                       │
  51.                    │                                       │
  52.                    │                                       │
  53.                    │                                       │
  54.                    │                                       │
  55.                    │                                       │
  56.                    │                                       │
  57.                    │                                       │
  58.                    └───────────────────────────────────────┘
  59.  
  60.      
  61.  
  62.      PKinsert Software Documentation                          Page 1  of 14
  63.  
  64.  
  65.                                   Introduction
  66.  
  67.      Pkinsert is  an archive manipulation  utility designed  for SysOps and
  68.      end users.  It can  be configured to test  archive integrity, scan for
  69.      viruses, insert and delete disclaimer files within Zip archives, etc.
  70.  
  71.      Pkinsert is  fully network  compatible and when  used as  a Bbs upload
  72.      monitor, can create all the result files a SysOp may need.
  73.  
  74.      Released as Freeware, there's no need to register and all features are
  75.      active.   I'm  well  aware  of the  eternal  struggle  SysOps  face in
  76.      registering just a small portion of  the software they use.  :-)  I'll
  77.      answer questions and work in most  features you suggest, just drop off
  78.      a message on my system (long-distance callback validation available).
  79.  
  80.      If  you use  Pkinsert and  have  authored SysOp  or Telecommunications
  81.      oriented software,  I would  appreciate if you  uploaded me  a copy in
  82.      return.  Please don't bother with Crippleware.
  83.  
  84.      Supplemental  information  on  installing  Pkinsert  with  PCBoard  is
  85.      available from the PkinsPCB.Doc file.
  86.  
  87.  
  88.                                                       J.S. Morisset
  89.                                                       aka Storm Widow
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.      
  121.  
  122.      PKinsert Software Documentation                          Page 2  of 14
  123.  
  124.  
  125.                                 Acknowledgements
  126.  
  127.      The  following  names are  either  trademarks,  registered trademarks,
  128.      and/or efforts of the person and/or company named.
  129.  
  130.      PCBoard            Clark Development Company
  131.      Pkzip/Pkunzip      PKWare Inc.
  132.      SCAN               McAfee Associates
  133.  
  134.                                    Upgrading
  135.  
  136.      Although you may simply 'drop-in' the new Pkinsert.Exe file, I suggest
  137.      you run  the configuration module  to take advantage  of version 6.6's
  138.      new  features.   The first  time  you re-configure  Pkinsert,  it will
  139.      compensate  for any  missing values.   On exit,  a proper  version 6.6
  140.      configuration file will be created.
  141.  
  142.      If you  are upgrading from  a version prior  to 6.0, you  will have to
  143.      start from scratch.
  144.  
  145.      Please review  the PkinsHis.Doc file  for details on  new features and
  146.      bug fixes.
  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.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.      
  181.  
  182.      PKinsert Software Documentation                          Page 3  of 14
  183.  
  184.  
  185.                               Pkinsert Parameters
  186.  
  187.      Parameters  may  be  entered  from  the  command  line  or environment
  188.      variable.   Environment   parameters  will  over-ride   those  of  the
  189.      configuration file, and  command line parameters  will over-ride those
  190.      of the environment.  Parameters are not case sensitive.
  191.  
  192.      Parameter
  193.  
  194.      /C       Marks  Pkinserts  configuration  file  name  and  path.  This
  195.               variable must be  present in the  environment or command line
  196.               for Pkinsert to load successfully.
  197.  
  198.                    ie.  /cD:\Arc\Pkinsert\Pkinsert.cfg
  199.  
  200.      /D       Pcboard  upload  description  file name  and  path.   Used to
  201.               document test failures.  (optional)
  202.  
  203.                    ie.  /dD:\Pcb\Work\Uldesc.1
  204.                         /d%3
  205.  
  206.      /N       Network node  number.  Maximum length  of three alpha-numeric
  207.               characters.  (optional)
  208.  
  209.                    ie.  /n1A
  210.  
  211.      /S       Version of Scan  you are currently  using.  Maximum length of
  212.               six alpha-numeric characters.  (optional)
  213.  
  214.                    ie.  /s7.9V84
  215.  
  216.      /CONFIG  Load Pkinserts configuration module.
  217.  
  218.                    ie.  PKINSERT.EXE /cPkinsert.Cfg /CONFIG
  219.  
  220.      /TEST    Re-test  an  archive  (used  on  Bulletin  Boards).   Affects
  221.               verbose log file results when a virus is located.  (optional)
  222.  
  223.                    ie.  PKINSERT.EXE /TEST %1
  224.  
  225.      /UPLOAD  Process an upload (used on Bulletin Boards).  Affects verbose
  226.               log file results when a virus is located.  (optional)
  227.  
  228.                    ie.  PKINSERT.EXE /UPLOAD %1
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.      
  241.  
  242.      PKinsert Software Documentation                          Page 4  of 14
  243.  
  244.  
  245.                               Configuration Module
  246.  
  247.      To configure Pkinsert for the first time, follow this first example.
  248.  
  249.               PKINSERT.EXE /CONFIG /cC:\Pkinsert\Pkinsert.Cfg
  250.  
  251.      Pkinsert will ask you to verify the path and name of the configuration
  252.      file to create.  Pressing the (Esc) key will get you back to Dos.
  253.  
  254.      Note -   It  is  possible  to  use  a  single  configuration  file for
  255.               multiple users/work stations.
  256.  
  257.      From the main configuration menu you will have three choices available
  258.      to you.  We will start from the  first and explain every item as we go
  259.      along.  All standard editing keys are active.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.      
  301.  
  302.      PKinsert Software Documentation                          Page 5  of 14
  303.  
  304.  
  305.      ╔════════════════════════════════════════════════════════════════════╗
  306.      ║                            Options Menu                            ║
  307.      ║                                                                    ║
  308.      ║   Unzip/Temp Files Drive  : C       Insert Archive Comment  : N    ║
  309.      ║   Req Xtract Space (%Zip) : 250     Delete Disclaimer(s)    : N    ║
  310.      ║                                     Add File(s) to Archive  : N    ║
  311.      ║   Rename Bad/Virused Zips : Y                                      ║
  312.      ║   Held Archive Rename Ext : HLD     Manage Pass/Fail Log    : N    ║
  313.      ║                                     Keep Result/Error Log   : Y    ║
  314.      ║   Test Archive CRC        : Y       Max. Standard Log Size  : 80   ║
  315.      ║   Corrupt Zip Rename Ext  : BAD                                    ║
  316.      ║                                     Nested Zip Array Size   : 3    ║
  317.      ║   Scan Archives for Virii : N       Zip Wildcard Array Size : 60   ║
  318.      ║   Virused Zip Rename Ext  : VIR                                    ║
  319.      ║   McAfee Assoc. SCAN Ver  : 0.0V00                                 ║
  320.      ║                                                                    ║
  321.      ║   Number Taglines to Keep : 10                                     ║
  322.      ║   Identification Tagline?                                          ║
  323.      ║   Generic Tagline                                                  ║
  324.      ║                                                                    ║
  325.      ╚═══ 11/20/91 ════════════════════════════════════════ 06:06:10am ═══╝
  326.  
  327.  
  328.                              Unzip/Temp Files Drive
  329.  
  330.      Enter  the  drive  letter where  Pkinsert  will  extract  archives for
  331.      testing  and  virus scanning.   I  strongly suggest  a  ram-disk which
  332.      improves Pkinserts performance dramatically.
  333.  
  334.                             Req Xtract Space (%Zip)
  335.  
  336.      Pkinsert  will  check  for  available  disk  space  before  extracting
  337.      archives.   This value  is not  calculated  like tax  - 250%  would be
  338.      translated to 2.5 times the size of the archive.  If Pkinsert runs out
  339.      of disk space  during processing, it  will rename the  archive or exit
  340.      with an error level.
  341.  
  342.      Disk space  errors are  also reported  during archive  extraction, but
  343.      verifying disk space before-hand saves time.
  344.  
  345.                             Rename Bad/Virused Zips
  346.  
  347.      This encompasses more than just file naming.  If this option is set to
  348.      (Y)es  Pkinsert will  rename archives  using  the file  extensions you
  349.      entered  above.  It  also  assumes you  are  processing archives  on a
  350.      wildcard  such as  (*.Zip).  When  Pkinsert runs  across a  virused or
  351.      corrupt archive it will rename it and continue to the next file in the
  352.      batch.  This  method is  not very  selective -  Any error  reported by
  353.      Pkzip/unzip  or Scan  will lead  to an  archive being  renamed.  These
  354.      problems could  be caused  by a  virus, corrupt  archive, insufficient
  355.      disk space, memory, etc.
  356.  
  357.      On the other hand, if you have  elected not to rename archives you can
  358.      do  your  own  error checking  when  Pkinsert  exits  using errorlevel
  359.  
  360.      
  361.  
  362.      PKinsert Software Documentation                          Page 6  of 14
  363.  
  364.  
  365.      statements  in a  batch  file.  The  complete  list of  Pkinsert error
  366.      levels is  available in  appendix A.   Pkinsert must  exit immediately
  367.      after an  error occurs  so this  option should  not be  used for batch
  368.      processing.
  369.  
  370.                             Held Archive Rename Ext
  371.  
  372.      An archive will  be renamed (if rename  is enabled) to  .Hld if a file
  373.      measures 0  bytes, disk  space runs out,  or the  file is  not a valid
  374.      archive.  This provides a  method to hold archives  which did not fail
  375.      because of Pkzip/unzip or Scan for later review.
  376.  
  377.                                 Test Archive CRC
  378.  
  379.      Before  handling  an  archive,  Pkinsert  calls  Pkunzip  to  test the
  380.      archive's  integrity.  Nested  archives  (Zips within  Zips)  are also
  381.      tested.
  382.  
  383.                              Corrupt Zip Rename Ext
  384.  
  385.      If you choose  to have archives  renamed, Pkinsert will  use this file
  386.      extension to rename damaged zips.
  387.  
  388.                             Scan Archives for Virii
  389.  
  390.      Pkinsert can use Scan.Exe from McAfee Associates to check archives for
  391.      viral infection.  Although archives are  expanded to check for viruses
  392.      it is unlikely you will 'catch' anything.  Virii which can be archived
  393.      attach themselves to executable code.   The files extracted are Scaned
  394.      and  never executed.   I've  successfully tested  this  option several
  395.      times with the Jerusalem Version B and 1701/1704 Version B viruses.  I
  396.      would have tested others but virus code isn't widely available.
  397.  
  398.                              Virused Zip Rename Ext
  399.  
  400.      When  a virus  is detected,  the  archive will  be renamed  using this
  401.      extension (provided renaming is enabled).
  402.  
  403.                              McAfee Assoc. SCAN Ver
  404.  
  405.      As of this writing the current  version of scan is 7.9V84.  This field
  406.      can be blank.   If you enter a  value here it will  be used in several
  407.      display  files where  mention  of Scan  is  made.  A  command  line or
  408.      environment parameter may be used to over-ride this value.
  409.  
  410.                             Number Taglines to Keep
  411.  
  412.      A  Tagline  is added  to  each archive  comment  containing Pkinsert's
  413.      version number and your personalized information.  Taglines from other
  414.      systems may be kept and appended  to your archive comment.  This value
  415.      determines the maximum  number of past  Taglines to keep.   A value of
  416.      zero may be used to disable this feature.
  417.  
  418.      Note -   The  Test,  Scan, or  Delete  functions must  be  enabled for
  419.  
  420.      
  421.  
  422.      PKinsert Software Documentation                          Page 7  of 14
  423.  
  424.  
  425.               Pkinsert to pick up the Tagline information.
  426.  
  427.                             Identification Tagline?
  428.  
  429.      Your  personalized Tagline.   Usually this  includes your  BBS's name,
  430.      phone number,  and special  system features.   As the  archive travels
  431.      through various systems, your tagline  will remain within the 'Tagline
  432.      History' (providing other systems keep previous Taglines).
  433.  
  434.      Once a system tagline  has been embedded into  the archive comment, it
  435.      is still possible to  alter it slightly.  Pkinsert  does not take into
  436.      account case,  spacing, or  any non  alpha-numeric character.  Adding,
  437.      erasing, or  changing the  positions of  alpha-numeric characters will
  438.      cause your old  tagline to be used  in the Tagline  History bloc if an
  439.      archive is re-processed.
  440.  
  441.      Note -   A Tagline environment  variable may be  used to over-ride the
  442.               configuration file value.
  443.  
  444.               ie.  SET TAGLINE=7th Illusion Telecommunication Services
  445.  
  446.                              Insert Archive Comment
  447.  
  448.      Archives created by Pkzip give us the opportunity to insert an archive
  449.      comment screen.  If you  elect to use this  option, create a Dos Ascii
  450.      file which contains your drawing.
  451.  
  452.                               Delete Disclaimer(s)
  453.  
  454.      Certain  files,  such  as  !History.Dis  are  well  known  to  contain
  455.      advertisements or  disclaimer blurbs.  You  may elect  to delete these
  456.      files automatically  from each  archive Pkinsert  processes.  A sample
  457.      list is included within this archive  which you can edit from the next
  458.      configuration screen.
  459.  
  460.                              Add File(s) to Archive
  461.  
  462.      Same principle as above except this option lets you add files to every
  463.      archive.   I could  go on  for hours  on  the reason  not to  use this
  464.      feature, including the fact that  you are polluting archives, but I'll
  465.      leave it to your better judgment.
  466.  
  467.                               Manage Pass/Fail Log
  468.  
  469.      Aside from loging results, Pkinsert can also create one of two verbose
  470.      log files for every session.  These text files could then be displayed
  471.      to the user.  The names for these files can be specified later on.
  472.  
  473.      In order to properly link with  other utilities which use this type of
  474.      result  logging, special  handling is  necessary.  Before  appending a
  475.      Failure report, Pkinsert  will rename the  Pass Log (if  it exists) to
  476.      the Fail Log name.  Therefore an  archive could pass a series of tests
  477.      before calling  Pkinsert and  still keep  those results  when Pkinsert
  478.      fails the archive.
  479.  
  480.      
  481.  
  482.      PKinsert Software Documentation                          Page 8  of 14
  483.  
  484.  
  485.  
  486.      If an  Extended Fail  Log already  exists, it  will be  used to append
  487.      Pkinserts Pass or Fail  reports.  In this way  an archive could Fail a
  488.      series of tests, pass  Pkinserts tests, and overall  you would be left
  489.      with one Fail log file.
  490.  
  491.                              Keep Result/Error Log
  492.  
  493.      This is a standard log file.  I would suggest you keep this option set
  494.      to (Y)es.  It's maintenance free thanks to the following option.
  495.  
  496.                              Max. Standard Log Size
  497.  
  498.      Before every  session Pkinsert  checks the size  of it's  log.  If the
  499.      size exceeds this value (in Kb), a new one is started.
  500.  
  501.                              Nested Zip Array Size
  502.  
  503.      When Pkinsert is hunting down archives within archives (add infinitum)
  504.      it monitors it's  depth or how  'nested' it is.   During this activity
  505.      Pkinsert also keeps  track of file  names and locations  to know which
  506.      archives it has followed  to the end, and  which haven't been checked.
  507.      Dos machines being what  they are, you only  get so much memory.  This
  508.      value specifies at what point  Pkinsert should start shedding portions
  509.      of itself to disk.  When it comes back from the 'deep' it will pick up
  510.      these pieces again and process the archives it missed.
  511.  
  512.      You can experiment and see what value  you prefer.  3 or 4 is probably
  513.      best.  You don't see  nesting past three very  often.  The larger this
  514.      value is, the more memory Pkinsert will need.
  515.  
  516.      Note -   Reading swapped information may  take a few moments depending
  517.               on the  size of your  wildcard array, system  and disk access
  518.               speeds.
  519.  
  520.                             Zip Wildcard Array Size
  521.  
  522.      This value determines the maximum  number of archives a nested archive
  523.      may contain.   Theoretically the wildcard  array could be  set for 999
  524.      (max tested was 600),  but this would chew up  tons of memory and disk
  525.      swapping would be excruciatingly slow.
  526.  
  527.      I've tried to  calculate the maximum  number of archives  a single Zip
  528.      could hold,  but I gave  up when I  hit 9  to the power  of 302.  That
  529.      value corresponded to a wildcard array of 101.
  530.  
  531.      Unfortunately, this value  also applies to the  wildcards you enter on
  532.      the command  line.  Therefore  (*.Zip) could  not exceed  the wildcard
  533.      array size.  An error level on exit is set if it does.
  534.  
  535.      Wildcards can be avoided easily.  See the 'Using Pkinsert' section for
  536.      details.
  537.  
  538.  
  539.  
  540.      
  541.  
  542.      PKinsert Software Documentation                          Page 9  of 14
  543.  
  544.  
  545.      ╔════════════════════════════════════════════════════════════════════╗
  546.      ║                         File Location Menu                         ║
  547.      ║                                                                    ║
  548.      ║   Ascii Editor            : C:\QEDIT\Q.EXE                         ║
  549.      ║                                                                    ║
  550.      ║   Standard Log File       : C:\PKINSERT\NODE-#.LOG                 ║
  551.      ║   Extended Pass Log File  : PCBPASS.TXT                            ║
  552.      ║   Extended Fail Log File  : PCBFAIL.TXT                            ║
  553.      ║                                                                    ║
  554.      ║   Virus Comment (Test)    : C:\PKINSERT\VIRUSTST.CMT               ║
  555.      ║   Virus Comment (Upload)  : C:\PKINSERT\VIRUSULD.CMT               ║
  556.      ║                                                                    ║
  557.      ║   Archive Comment File    : C:\PKINSERT\PKINSERT.CMT               ║
  558.      ║                                                                    ║
  559.      ║   Disclaimer(s) Del List  : C:\PKINSERT\PKINSDEL.LST               ║
  560.      ║   Add File(s) List        : C:\PKINSERT\PKINSADD.LST               ║
  561.      ║                                                                    ║
  562.      ╚═══ 11/20/91 ════════════════════════════════════════ 06:06:10am ═══╝
  563.  
  564.  
  565.                                   Ascii Editor
  566.  
  567.      Ascii editor file name  and path.  Placing the  cursor on a line which
  568.      can be edited, a bar will appear at the bottom of the screen informing
  569.      you to press F2 to edit the file.
  570.  
  571.                                Standard Log File
  572.  
  573.      File name and path of the Standard log file.
  574.  
  575.      Note -   Pound (#)  signs within  TEXT ENTRIES  are replaced  with the
  576.               current  node number  (except  in the  Tagline  field).  Node
  577.               numbers are  retrieved from  the Pcboard.Sys  and/or Door.Sys
  578.               file in  the current  directory.  If  none is  available, the
  579.               node number defaults to zero (0).
  580.  
  581.               If you wish to retain  ONE configuration file in a MULTI-USER
  582.               environment,  and  do not  have  Pcboard.Sys  and/or Door.Sys
  583.               available, you may  configure node numbers  using the (/N)ode
  584.               parameter.
  585.  
  586.                         Extended Pass and Fail Log Files
  587.  
  588.      If the  'Manage Pass/Fail  Log' option  (1st configuration  screen) is
  589.      enabled, these file names are used to report processing results.
  590.  
  591.                        Virus Comment (Test) and (Upload)
  592.  
  593.      These two text files are used when Pkinsert has created the Failed Log
  594.      File above and *only* in cases when a virus is found.
  595.  
  596.      The contents  of (Test)  are added  to the  Fail log  when the (/TEST)
  597.      parameter is used.   SysOps could use  this file to  advise users they
  598.      should leave a  Comment to the  SysOp a.s.a.p. so  this archive may be
  599.  
  600.      
  601.  
  602.      PKinsert Software Documentation                          Page 10 of 14
  603.  
  604.  
  605.      deleted.
  606.  
  607.      Similarly, the contents of (Upload) are added to the Fail log when the
  608.      (/UPLOAD) parameter  is used.   This second  text file  could advise a
  609.      user that  his system  might be  contaminated and  to take appropriate
  610.      steps before uploading again.
  611.  
  612.      If these  files do  not exist, they  will not  be used.   This way you
  613.      could have a comment for one function and not the other.
  614.  
  615.                               Archive Comment File
  616.  
  617.      This file should contain your archive comment (Ascii drawing).  Enable
  618.      this feature from the 'Configuration Options' menu.
  619.  
  620.                              Disclaimer(s) Del List
  621.  
  622.      This list is  used when the 'Delete  Disclaimer(s)' option is enabled.
  623.      A single  filespec should be  entered on each  line.  Archive contents
  624.      will be compared to this list and matching files will be deleted.
  625.  
  626.                                 Add File(s) List
  627.  
  628.      Same principal as above, this file  should contain a list of filespecs
  629.      to insert in every archive.  Unlike  the delete list, you must include
  630.      paths for each file.
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.      
  661.  
  662.      PKinsert Software Documentation                          Page 11 of 14
  663.  
  664.  
  665.      ╔════════════════════════════════════════════════════════════════════╗
  666.      ║                    Command Line Parameters Menu                    ║
  667.      ║                                                                    ║
  668.      ║   Pkzip Del Disclaimer(s) : /dk                                    ║
  669.      ║   Pkzip Add Files/Comment : /exzk                                  ║
  670.      ║                                                                    ║
  671.      ║   Pkunzip Test Archive    : /t                                     ║
  672.      ║   Pkunzip Extract Files   : /xn /ojhsr                             ║
  673.      ║                                                                    ║
  674.      ║   McAfee Associates SCAN  : /a /nobreak /nomem /nopause /sub       ║
  675.      ║                                                                    ║
  676.      ╚═══ 11/20/91 ════════════════════════════════════════ 06:06:10am ═══╝
  677.  
  678.  
  679.      These parameters are  passed by Pkinsert when  shelling to third party
  680.      software.  If you encounter problems  with a new parameter set, please
  681.      drop me a line so I  can adjust Pkinsert accordingly.  The options for
  682.      Scan  have been  tested  with version  7.9V84  and may  not  work with
  683.      earlier versions.
  684.  
  685.                               Pkzip Work File Path
  686.  
  687.      When  Pkzip handles  an archive,  it creates  a (.!!!)  temporary work
  688.      file.  If  you have  a ram-disk installed,  you should  edit the above
  689.      command line parameters instructing Pkzip to use the faster drive.
  690.  
  691.          ie.  Pkzip Del Disclaimer(s) : /dk /bF:\
  692.               Pkzip Add Files/Comment : /exzk /bF:\
  693.  
  694.                                  Date Stamping
  695.  
  696.      Using the  (k) parameter, Pkzip  will NOT  change the file  date of an
  697.      archive.  An (o)  will set the  archive date to  the oldest file found
  698.      within the archive.  Eliminating these  date parameters will cause the
  699.      archive date to be updated to the current one.
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.      
  721.  
  722.      PKinsert Software Documentation                          Page 12 of 14
  723.  
  724.  
  725.                                  Using Pkinsert
  726.  
  727.      Using Pkinsert is fairly simple.  From the command line or environment
  728.      variable make  sure Pkinsert  knows where  to find  it's configuration
  729.      file.  Then call Pkinsert passing it file names (or wildcards).
  730.  
  731.      The parameters, file names,  etc can be in  any order.  You could even
  732.      enter file names through the environment variable if you wanted.  Some
  733.      examples follow.
  734.  
  735.          ie.  SET PKINSERT=/cD:\Pkinsert\Pkinsert.Cfg /s7.9V84
  736.               PKINSERT.EXE Abc.Zip
  737.  
  738.               SET PKINSERT=/n1 /s7.8v82
  739.               PKINSERT %1 /cD:\Pkinsert\Pkinsert.Cfg *.Exe Abc-?.New
  740.  
  741.               SET PKINSERT=/cC:\Pkinsert\System.Cfg
  742.               PKINSERT *.Zip *.Exe Abc.Bak
  743.  
  744.               SET PKINSERT=/n1 /sVer82 Archive.Zip /c\Arc\Config.Pki
  745.               PKINSERT
  746.  
  747.               PKINSERT /cThisDir.Cnf Test.Zip
  748.  
  749.      Undoubtedly most users will want  to test complete directories at some
  750.      point, which  may exceed  the Wildcard Array  size.  In  this case, an
  751.      advanced Dos command line could be used.
  752.  
  753.          ie.  LOOP.BAT
  754.               ~~~~~~~~
  755.               FOR %%A IN (*.Zip) DO PKINSERT %%A
  756.               or
  757.               FOR %%A IN (A*.Zip Dbl*.* Abc-?.Zip) DO PKINSERT %%A
  758.  
  759.      Any  filename preceded  with  an AT  (@)  symbol will  be  expected to
  760.      contain a list of  files to process.  Each  file specification in this
  761.      list must occupy a separate line.  Wildcarding is accepted.
  762.  
  763.          ie.  Files.Lst
  764.               ~~~~~~~~~
  765.               D:\Arc\*.Zip
  766.               Archive.Zip
  767.               E:\Main\Files\Backup.Z??
  768.               \Work\A*.Tmp
  769.  
  770.          You may also use a combination of directory pipes.
  771.  
  772.          ie.  C:\> Dir D:\Arc >>Files.Lst
  773.               C:\> Dir E:\Main\Files\*.Zip >>Files.Lst
  774.  
  775.          Instead of entering  redundant directory information  you can tell
  776.          Pkinsert to change  drives and directories.   Use the (Cd) command
  777.          followed by a space, or back-slash, and the directory name.
  778.  
  779.  
  780.      
  781.  
  782.      PKinsert Software Documentation                          Page 13 of 14
  783.  
  784.  
  785.          ie.  Files.Lst
  786.               ~~~~~~~~~
  787.               Archive.Zip
  788.               Cd\Arc
  789.               *.Zip
  790.               Cd E:\Main\Files
  791.               Good*.Zip
  792.               Bad*.Old
  793.               Ugly*.$$$
  794.               Cd\C:\Temp
  795.               Backup.Z??
  796.  
  797.          These techniques can be used together for greatest versatility.
  798.  
  799.          Note -    Normal  array size  boundaries  apply ONLY  to wildcards
  800.                    within this  list.  There is  NO LIMIT to  the number of
  801.                    filespecs contained  in the  file list.   If you  have a
  802.                    directory of several  thousand archives you  could use a
  803.                    command sequence along these lines:
  804.  
  805.                    C:\> Dir J:\Uploads\*.Zip >>Files.Lst
  806.                    C:\> Pkinsert @*.Lst
  807.  
  808.                    Wildcarding is also acceptable for filelist names.
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.      
  841.  
  842.      PKinsert Software Documentation                          Page 14 of 14
  843.  
  844.  
  845.                                    Appendix A
  846.                               Pkinsert Exit Codes
  847.  
  848.           Virus Scan
  849.  
  850.      10   One or More Virii Found
  851.      11   Abnormal Termination
  852.           (Usually Lack of Memory)
  853.  
  854.           Pkunzip
  855.  
  856.      20   Zip Failed CRC Check
  857.      21   Error in Zip File
  858.      22   Insufficient Memory
  859.      23   Archive File Missing
  860.      24   Illegal Parameters Specified
  861.      25   No Files in Archive to Test
  862.      26   Disk Full
  863.      27   Unexpected EOF in Zip
  864.  
  865.           Pkzip
  866.  
  867.      40   Bad File Name or File Specification
  868.      41   Error in Zip File
  869.      42   Insufficient Memory
  870.      43   No Files Found To Delete
  871.      44   File Not Found
  872.      45   Disk Full
  873.      46   Archive Is Read-Only - Cannot Modify
  874.      47   Bad or Illegal Parameters
  875.      48   Too Many Files in Zip
  876.  
  877.           Pkinsert
  878.  
  879.      100  Incorrect Parameters
  880.      101  Configuration File Missing
  881.      103  Unable To Create Work Directory
  882.      104  Invalid Path or No Matching Files
  883.      105  Insufficient Drive Space Available
  884.      106  Unable To Remove Work Directory
  885.      107  Insufficient DOS File Handles
  886.      108  Network Delay Timed-Out
  887.      109  Unable to Remove Nest Directories
  888.      110  Illegal Configuration File Value
  889.      111  Illegal Compression Method Used
  890.      112  Zero Byte File
  891.      113  Unknown Configuration File Format
  892.      114  Unable to Locate File; Pkzip/Unzip or Scan
  893.      200  Wildcard Array Exceeded
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.      
  901.