home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / ARCHIVE / PKINSV64.ZIP / PKINSERT.DOC < prev    next >
Encoding:
Text File  |  1991-09-22  |  28.8 KB  |  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.4              │
  18.                    │                                       │
  19.                    │   Copyright 7th Illusion, 1990-1991   │
  20.                    │          All Rights Reserved          │
  21.                    │     Released September 22nd, 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, Quebec           │
  41.                    │                 Canada                │
  42.                    │                H3G 2N6                │
  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 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.      Pkinsert  is  released  as  Freeware.  As  such,  there's  no  need to
  75.      register and all features  are active - I'm  well aware of the eternal
  76.      struggle  SysOps  face in  registering  just  a small  portion  of the
  77.      software  they  use.  :-)   I'll  answer  questions  and  work-in most
  78.      features you suggest, just drop off a message on my system.
  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  or  unregistered
  83.      Shareware.
  84.  
  85.  
  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.                               General Requirements
  126.  
  127.      You will need the following software to run Pkinsert.
  128.  
  129.      Pkzip/Pkunzip by PKWare Inc.
  130.      SCAN by McAfee Associates (Optional).
  131.  
  132.      Pkinsert should run from any  Bbs software shell.  Memory requirements
  133.      can be  kept at  a minimum  by Pkinserts  use of  disk swap  files.  A
  134.      ram-disk is highly recommended to optimize speed.
  135.  
  136.                                    Upgrading
  137.  
  138.      No changes  have been made  to the configuration  file structure since
  139.      version 6.0.  Just  drop-in the Pkinsert.Exe file  and you're ready to
  140.      go.  To upgrade from versions prior  to 6.0, you'll have to start from
  141.      scratch.
  142.  
  143.      Adjustments  to  batch  files may  be  necessary.   Please  review the
  144.      Pkinsert.His documentation  file for details  of new  features and bug
  145.      fixes.
  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.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.      
  181.  
  182.      PKinsert Software Documentation                          Page 3  of 14
  183.  
  184.  
  185.                                 Pkinsert Options
  186.  
  187.      Pkinsert options  can be  entered from  the command  line or  using an
  188.      environment  variable.   Environment variable  options  will over-ride
  189.      those  of  the  configuration  file,  and  command  line  options will
  190.      over-ride those of the environment.  Both the environment variable and
  191.      command line parameters  are limited to 128  characters as dictated by
  192.      Dos.  Parameters are not case sensitive.
  193.  
  194.      Options
  195.  
  196.      /C       Pkinsert  configuration file  name  and path.   This variable
  197.               must  be  present  in the  environment  or  command  line for
  198.               Pkinsert to load successfully.
  199.  
  200.               ie.  /CD:\Arc\Pkinsert\Pkinsert.cfg
  201.                    /CConfig.cnf
  202.  
  203.      /D       Pcboard  upload  description  file name  and  path.   Used to
  204.               document test failures.  (optional)
  205.  
  206.               ie.  /DD:\Pcb\Work\Uldesc.1
  207.                    /D%3
  208.  
  209.      /L       Path and file name for standard log file.  (optional)
  210.  
  211.               ie.  /LC:\Arc\Node3.Log
  212.  
  213.      /N       Network  node  number.   Maximum  length  of  three  alpha or
  214.               numeric characters.  (optional)
  215.  
  216.               ie.  /Na1
  217.  
  218.      /S       Version of Scan  you are currently  using.  Maximum length of
  219.               six alpha or numeric characters.  (optional)
  220.  
  221.               ie.  /S7.6v80
  222.  
  223.      /CONFIG  Load Pkinserts configuration module.
  224.  
  225.               ie.  /CPkinsert.Cfg /CONFIG
  226.  
  227.      /TEST    Re-test an archive.  Affects verbose  log file results when a
  228.               virus is located.  (optional)
  229.  
  230.               ie.  /TEST
  231.  
  232.      /UPLOAD  Test  an upload.   Affects verbose  log  file results  when a
  233.               virus is located.  (optional)
  234.  
  235.               ie.  /UPLOAD
  236.  
  237.  
  238.  
  239.  
  240.      
  241.  
  242.      PKinsert Software Documentation                          Page 4  of 14
  243.  
  244.  
  245.                             Putting it all together
  246.  
  247.      As mentioned earlier, these options can be entered on the command line
  248.      or via an  environment variable.  To configure  Pkinsert for the first
  249.      time, follow this first example.
  250.  
  251.               PKINSERT.EXE /CONFIG /CC:\Pkinsert\Pkinsert.Cfg
  252.  
  253.               SET PKINSERT=/Noo1 /S7.6v80 /CCurrent.Cfg /LC:\Pcb\Pkinslog.1
  254.               PKINSERT.EXE /CONFIG /CD:\Diff\Diff.Cnf
  255.  
  256.      This second  example makes use  of the  Pkinsert environment variable.
  257.      The command line configuration  path (D:\Diff\Diff.Cnf) will over-ride
  258.      the environment  setting (Current.Cfg).   When Pkinserts configuration
  259.      module loads, it will  also use any other options  you have set in the
  260.      environment  (node number,  scan version,  log path),  replacing those
  261.      found in the configuration file.
  262.  
  263.                               Configuration Module
  264.  
  265.      The first  time you load  the configuration module,  Pkinsert will ask
  266.      you to verify the  path and name of  the configuration file to create.
  267.      Pressing the (Esc) key will get you  back to Dos.  Note that using the
  268.      previously  outlined  options,   it  is  possible   to  use  a  single
  269.      configuration file for multiple users.
  270.  
  271.      From the main configuration menu you will have three choices available
  272.      to you.  We will start from the  first and explain every item as we go
  273.      along.  All standard editing keys are active.
  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.      ║   Network Node Number              : 0                             ║
  309.      ║   Network Delay Re-Try Attempts    : 5                             ║
  310.      ║   Drive Letter for Work Space      : C:                            ║
  311.      ║   Minimum Extract Space (% of Zip) : 250                           ║
  312.      ║   Test Archives                    : Y                             ║
  313.      ║   Corrupt Archive Rename Extension : BAD                           ║
  314.      ║   Scan Archives for Virii          : N                             ║
  315.      ║   McAfee Associates SCAN Version   : 0.0V00                        ║
  316.      ║   Virused Archive Rename Extension : VIR                           ║
  317.      ║   Rename Corrupt/Virused Archives  : Y                             ║
  318.      ║   Insert Archive Comment           : N                             ║
  319.      ║   Delete Disclaimer File(s)        : N                             ║
  320.      ║   Add File(s) to Archive           : N                             ║
  321.      ║   Make Extended Pass/Fail Log File : N                             ║
  322.      ║   Make Standard Result/Error Log   : N                             ║
  323.      ║   Maximum Standard Log File Size   : 40                            ║
  324.      ║   Nested Archive Array Size        : 4                             ║
  325.      ║   Wildcard Array Size (w/in Zip)   : 50                            ║
  326.      ║                                                                    ║
  327.      ╚═══ 00/00/00 ════════════════════════════════════════ 00:00:00am ═══╝
  328.  
  329.  
  330.                               Network Node Number
  331.  
  332.      This value can be blank or  one to three alpha numeric characters.  It
  333.      may  be  over-ridden  by a  command  line  or  environment parameters.
  334.      Pkinsert will use  the node number when  creating it's work directory.
  335.      Networking or Multitasking environments are detected automatically and
  336.      record locking will be used when possible.
  337.  
  338.                          Network Delay Re-Try Attempts
  339.  
  340.      When Pkinsert tries to open/read/write/etc  a file which is already in
  341.      use by another user, it will  pause for 5 seconds before trying again.
  342.      This value will  dictate how many times  Pkinsert cycles.  If Pkinsert
  343.      fails, it will attempt to continue  when possible or terminate with an
  344.      error level.
  345.  
  346.                           Drive Letter For Work Space
  347.  
  348.      Enter the drive  where Pkinsert will extract  archives for testing and
  349.      virus scanning.  I  would suggest a  ram-disk which improves Pkinserts
  350.      performance.  Pkinsert will not instruct Pkzip and Pkunzip to use this
  351.      drive.  Refer to the PKzip manual for the `PKTMP' environment variable
  352.      or  change the  options in  the  `Command Line  Options' configuration
  353.      menu.
  354.  
  355.                         Minimum Extract Space (% of Zip)
  356.  
  357.      Pkinsert  will  check  for  available  disk  space  before  extracting
  358.      archives.   This value  is  not calculated  like  tax.  250%  would be
  359.  
  360.      
  361.  
  362.      PKinsert Software Documentation                          Page 6  of 14
  363.  
  364.  
  365.      translated to 2.5 times the size of the archive.  If Pkinsert runs out
  366.      of disk space  during processing, it  will rename the  archive or exit
  367.      with an error level.
  368.  
  369.                                  Test Archives
  370.  
  371.      Before  handling an  archive Pkinsert  will call  Pkunzip to  test the
  372.      archive.  Nested archives are also tested.
  373.  
  374.                         Corrupt Archive Rename Extension
  375.  
  376.      If you choose to  have archives renamed (that  option is a bit further
  377.      down), Pkinsert will use this file extension to rename damaged zips.
  378.  
  379.                             Scan Archives for Virii
  380.  
  381.      Pkinsert can use Scan.Exe from McAfee Associates to check archives for
  382.      viral infection.  Although archives are  expanded to check for viruses
  383.      it is  unlikely you  will `catch' anything.   Most virii  which can be
  384.      archived attach  themselves to  executable code.   The files extracted
  385.      are Scaned and  never executed.  I've  successfully tested this option
  386.      several times  with the  Jerusalem Version  B and  1701/1704 Version B
  387.      viruses.   I would  have  tested others  but  virus code  isn't widely
  388.      available.
  389.  
  390.                          McAfee Associates SCAN Version
  391.  
  392.      As of this writing the current  version of scan is 7.8V82.  This field
  393.      can be blank.   If you enter a  value here it will  be used in several
  394.      display  files where  mention  of Scan  is  made.  A  command  line or
  395.      environment option may be used to over-ride this value.
  396.  
  397.                         Virused Archive Rename Extension
  398.  
  399.      If  a  virus  is  detected the  archive  will  be  renamed  using this
  400.      extension (provided renaming is enabled).
  401.  
  402.                         Rename Corrupt/Virused Archives
  403.  
  404.      This encompasses more than just file naming.  If this option is set to
  405.      `Yes'  Pkinsert will  rename archives  using  the file  extensions you
  406.      entered  above.  It  also  assumes you  are  processing archives  on a
  407.      wildcard  such  as `*.Zip'.   When  Pkinsert  runs across  a  virus or
  408.      corrupt  archive it  will rename  the  file and  continue to  the next
  409.      archive in the batch.   This method is not  very selective.  Any error
  410.      reported  by  Pkzip/unzip or  Scan  will  lead Pkinsert  to  rename an
  411.      archive.  These problems could be  caused by a virus, corrupt archive,
  412.      insufficient disk space, memory, etc.
  413.  
  414.      On the other hand  of you have elected not  to rename archives you can
  415.      do  your  own  error checking  when  Pkinsert  exits  using errorlevel
  416.      statements  in a  batch  file.  The  complete  list of  Pkinsert error
  417.      levels is  available in  appendix A.  This  would seem  like the ideal
  418.      solution  except <smile>  when  you are  processing  on a  wildcard as
  419.  
  420.      
  421.  
  422.      PKinsert Software Documentation                          Page 7  of 14
  423.  
  424.  
  425.      above.  When an  error is detected, Pkinsert  must exit immediately to
  426.      report the error, thus skipping the remaining files in the batch.
  427.  
  428.                              Insert Archive Comment
  429.  
  430.      Archives created by Pkzip give us the opportunity to insert an archive
  431.      comment  screen.  If  this  archive is  still  intact by  the  time it
  432.      reaches you,  you should  have seen  a large  `7th Illusion' displayed
  433.      when you extracted it.  This is  an archive comment.  If you select to
  434.      use this option you should create a Dos Ascii file which contains your
  435.      drawing.
  436.  
  437.                            Delete Disclaimer File(s)
  438.  
  439.      Certain  files,  such  as  !History.Dis  are  well  known  to  contain
  440.      advertisements or  disclaimer blurbs.  You  may elect  to delete these
  441.      files automatically  from each  archive Pkinsert  processes.  A sample
  442.      list is included within this archive, which you can edit from the next
  443.      configuration screen.
  444.  
  445.                              Add File(s) to Archive
  446.  
  447.      Same principle as above except this option lets you add files to every
  448.      archive.   I could  go on  for hours  on  the reason  not to  use this
  449.      feature, including the fact that  you are polluting archives, but I'll
  450.      leave it to your better judgment.
  451.  
  452.                         Make Extended Pass/Fail Log File
  453.  
  454.      Aside from loging results, Pkinsert can also create one of two verbose
  455.      log files for every session.  These text files could then be displayed
  456.      to the user.   Pcboard SysOps might recognize  this option as creating
  457.      Pcbfail.Txt  and  Pcbpass.Txt.   The  names  for  these  files  can be
  458.      specified later on.
  459.  
  460.      In order to properly link with  other utilities which use this type of
  461.      result  logging, special  handling is  necessary.  Before  appending a
  462.      Failure report, Pkinsert  will rename the  Pass Log (if  it exists) to
  463.      the Fail Log name.  Therefore an  archive could pass a series of tests
  464.      before calling  Pkinsert and  still keep  those results  when Pkinsert
  465.      fails the archive.
  466.  
  467.      If an  Extended Fail  Log already  exists, it  will be  used to append
  468.      Pkinserts Pass or Fail  reports.  In this way  an archive could Fail a
  469.      series of tests, pass  Pkinserts tests, and overall  you would be left
  470.      with one Fail log file.
  471.  
  472.                          Make Standard Result/Error Log
  473.  
  474.      This is a standard log file.  I would suggest you keep this option set
  475.      to `Yes'.  It's maintenance free thanks to the following option.
  476.  
  477.                          Maximum Standard Log File Size
  478.  
  479.  
  480.      
  481.  
  482.      PKinsert Software Documentation                          Page 8  of 14
  483.  
  484.  
  485.      Before every  session Pkinsert  checks the size  of it's  log.  If the
  486.      size exceeds this value (in Kb), a new one is started.
  487.  
  488.                            Nested Archive Array Size
  489.  
  490.      When Pkinsert is hunting down archives within archives (add infinitum)
  491.      it monitors it's  depth or how  `nested' it is.   During this activity
  492.      Pkinsert also keeps  track of file  names and locations  to know which
  493.      archives it has followed  to the end, and  which haven't been checked.
  494.      Dos machines being what  they are, you only  get so much memory.  This
  495.      value specifies at what point  Pkinsert should start shedding portions
  496.      of itself to disk.  When it comes back from the `deep' it will pick up
  497.      those pieces again and do the archives it missed.
  498.  
  499.      You can experiment and see what value  you prefer.  3 or 4 is probably
  500.      best.  You don't see  nesting past three very  often.  The larger this
  501.      value is, the more memory Pkinsert will need.
  502.  
  503.      Note.  Reading swapped information may take a few moments depending on
  504.      the size of your wildcard array, system and disk access speeds.
  505.  
  506.                             Zip Wildcard Array Size
  507.  
  508.      This value determines the maximum  number of archives a nested archive
  509.      may  contain.   A  value  of  50  is  recommended.   Theoretically the
  510.      wildcard array could  be set for 999,  but this would  chew up tons of
  511.      memory and disk swapping would be excruciatingly slow.
  512.  
  513.      I've tried to  calculate the maximum  number of archives  a single Zip
  514.      could hold,  but I gave  up when I  hit 9  to the power  of 302.  That
  515.      value corresponded to a wildcard array of 101.
  516.  
  517.      There is a glitch  however.  This value also  applies to the wildcards
  518.      you enter on the command line.  Therefore `*.Zip' could not exceed the
  519.      wildcard array size.  An error level on exit is set if it does.
  520.  
  521.      Wildcards  can  be  avoided.  See  the  `Using  Pkinsert'  section for
  522.      details.
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  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.      ║   Standard Log File       : C:\PKINSERT\PKINSERT.LOG               ║
  550.      ║   Extended Pass Log File  : PCBPASS.TXT                            ║
  551.      ║   Extended Fail Log File  : PCBFAIL.TXT                            ║
  552.      ║   Virus Comment (Test)    : C:\PKINSERT\VIRUSTST.CMT               ║
  553.      ║   Virus Comment (Upload)  : C:\PKINSERT\VIRUSULD.CMT               ║
  554.      ║   Archive Comment File    : C:\PKINSERT\PKINSERT.CMT               ║
  555.      ║   Disclaimer(s) Del List  : C:\PKINSERT\PKINSDEL.LST               ║
  556.      ║   Add File(s) List        : C:\PKINSERT\PKINSADD.LST               ║
  557.      ║                                                                    ║
  558.      ╚═══ 00/00/00 ════════════════════════════════════════ 00:00:00pm ═══╝
  559.  
  560.  
  561.                                   Ascii Editor
  562.  
  563.      Ascii editor name and path.  Placing the cursor on a line which can be
  564.      edited, a bar will appear at the bottom of the screen informing you to
  565.      press F2 to edit the file.
  566.  
  567.                                Standard Log File
  568.  
  569.      Path and name of the Standard log file.  This value can be over-ridden
  570.      by using the `/L' environment or command line option.
  571.  
  572.                              Extended Pass Log File
  573.                              Extended Fail Log File
  574.  
  575.      If the  `Extended Pass/Fail Log  File' option is  enabled, these files
  576.      are used to report processing results.  PCBoard SysOps will want these
  577.      fields set to `Pcbpass.Txt' and `Pcbfail.Txt' respectively.
  578.  
  579.                               Virus Comment (Test)
  580.                              Virus Comment (Upload)
  581.  
  582.      These  two are  used when  Pkinsert  has created  the Failed  Log File
  583.      above, and *only* in cases when a virus is found.
  584.  
  585.      The  contents of  Test, are  added to  the Fail  log when  the `/TEST'
  586.      option  is used.   SysOps could  use  this file  to advise  users they
  587.      should leave a Comment asap so this archive can be deleted.
  588.  
  589.      Similarly, The contents of  Upload are added to  the Fail log when the
  590.      `/UPLOAD' option is used.   This second text file  could advise a user
  591.      that his  system might be  contaminated and to  take appropriate steps
  592.      before uploading again.
  593.  
  594.      If one of  these files does not  exist it will not  be used.  This way
  595.      you could have a comment for one function and not the other.
  596.  
  597.  
  598.  
  599.  
  600.      
  601.  
  602.      PKinsert Software Documentation                          Page 10 of 14
  603.  
  604.  
  605.                               Archive Comment File
  606.  
  607.      This  file  should  contain your  archive  comment  or  Ascii drawing.
  608.      Enable this option from the Configuration Options menu.
  609.  
  610.                              Disclaimer(s) Del List
  611.  
  612.      This list is used when the `Delete Disclaimer(s)' option is active.  A
  613.      filespec should  be entered  on each  line.  Archive  contents will be
  614.      compared to this list and matching files will be deleted.
  615.  
  616.                                 Add File(s) List
  617.  
  618.      Same principal as above,  list the files you  would like inserted into
  619.      every archive.   Unlike the  delete list  you should  include paths to
  620.      each file.
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  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.      ║   Archive Test            : /t                                     ║
  669.      ║   Unzip Archive for Scan  : /xn /ojhsr                             ║
  670.      ║   McAfee Associates SCAN  : /a /nobreak /nomem /nopause /sub       ║
  671.      ║   Delete Disclaimer(s)    : /dk                                    ║
  672.      ║   Add File(s) and Comment : /exzk                                  ║
  673.      ║                                                                    ║
  674.      ╚═══ 00/00/00 ════════════════════════════════════════ 00:00:00pm ═══╝
  675.  
  676.  
  677.      If you encounter problems with a new command, please drop me a line so
  678.      I can adjust Pkinsert accordingly.
  679.  
  680.      The options for Scan have been tested with version 7.6V80+ and may not
  681.      work with earlier versions.
  682.  
  683.                               Pkzip Work File Path
  684.  
  685.      When Pkzip handles an archive, it  creates a .!!! temporary work file.
  686.      If you have  a ram-disk installed,  you should edit  the above command
  687.      line parameters instructing Pkzip to use the faster drive.
  688.  
  689.          ie.  Delete Disclaimer(s)    : /dk /bF:\
  690.               Add File(s) and Comment : /exzk /bF:\
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  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.      By now  you should  have a  fairly clear  idea of  what Pkinsert does.
  728.      Using Pkinsert is fairly simple.  From the command line or environment
  729.      variable make  sure Pkinsert  knows where  to find  it's configuration
  730.      file, and call Pkinsert passing it file names or wildcards.
  731.  
  732.      The options,  file names,  etc can  be in  any order.   You could even
  733.      enter file names through the environment variable if you wanted.
  734.  
  735.          ie.  SET PKINSERT=/N1 /S7.8v82
  736.               PKINSERT %1 *.Zip /CD:\Pkinsert\Pkinsert.Cfg *.Exe Abc-?.New
  737.  
  738.               SET PKINSERT=/CC:\Pkinsert\System.Cfg
  739.               PKINSERT *.Zip *.Exe Abc.Bak
  740.  
  741.               SET PKINSERT=/N1 /SVer82 Archive.Zip /C\Arc\Config.Pki
  742.               PKINSERT
  743.  
  744.               PKINSERT /CPkins.Cnf Test.Zip
  745.  
  746.      Undoubtedly most SysOps will want  to test complete directories, which
  747.      may exceed  the Wildcard  Array size.  In  this case,  an advanced Dos
  748.      command line should be used.
  749.  
  750.          ie.  LOOP.BAT
  751.               ~~~~~~~~
  752.               FOR %%A IN (*.Zip) DO PKINSERT %%A
  753.               or
  754.               FOR %%A IN (A*.Zip Dbl*.* Abc-?.Zip) DO PKINSERT %%A
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.      
  781.  
  782.      PKinsert Software Documentation                          Page 13 of 14
  783.  
  784.  
  785.                                   Odds 'n Ends
  786.  
  787.      Tagline Environment Variable
  788.  
  789.      This feature has  stuck around since  Version 3.2 and  I still find it
  790.      fun  to use.   At  one point  I  was using  a  utility to  cycle funny
  791.      taglines, now I've settled on a  standard one.  Pkinsert will grab the
  792.      value assigned to  the Tagline variable  and insert is  as part of the
  793.      archive comment.
  794.  
  795.          ie.  SET TAGLINE=7th Illusion Telecommunication Services
  796.  
  797.                           Locating Tagline Signatures
  798.  
  799.      Pkinsert taglines can  be located within the  archive comment by their
  800.      unique 4 byte signature, immediately following a Cr/Lf sequence.
  801.  
  802.      In HEX the signature is:  FF 08 xx FF [tagline]
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  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.      200  Wildcard Array Exceeded
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.      
  901.