home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / os2 / insp110p.zip / INSPECT.MAN < prev    next >
Text File  |  1993-05-05  |  330KB  |  8,058 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.             InspectA
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.             File & Archive Manager
  16.  
  17.  
  18.             Version 1.10
  19.  
  20.  
  21.             For MSDOS(R) and OS/2(R)
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.             User's Guide
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.             Copyright (C) 1992-93  All Rights Reserved
  49.             David L. Nugent & Unique Computing Pty Limited
  50.             May, 1993
  51.  
  52.  
  53.  
  54.             Disclaimer
  55.  
  56.             You use this software entirely at your own risk. The  author
  57.             and/or distributors  are not  responsible  for any  loss  or
  58.             damage as a result  of using this product  and will take  no
  59.             responsibility, consequential  or  otherwise  for  any  use,
  60.             abuse or misuse.
  61.  
  62.  
  63.  
  64.             Versions
  65.  
  66.             InspectA is distributed both  commercially and in  shareware
  67.             form. The commercial (registered) version is identifiable by
  68.             the letter 'R' following the  version number in the  program
  69.             identification displayed  when executing  the main  program.
  70.             Unregistered shareware  versions show  no additional  letter
  71.             after the version number or the letter 'S', no licensee name
  72.             or  registration   serial  number,   and  during   operation
  73.             occasionally displays  a  reminder  that the  program  is  a
  74.             shareware product. While  the fully  commercial version  may
  75.             include   various    enhancements    and    site    specific
  76.             modifications,  both   the   registered   and   unregistered
  77.             shareware versions are otherwise functionally identical.
  78.  
  79.  
  80.  
  81.             Licence of Use
  82.  
  83.             InspectA is the intellectual property of David L. Nugent and
  84.             Unique Computing Pty  Limited and  as such  is protected  by
  85.             international copyright laws. InspectA is distributed with a
  86.             non-transferable licence  of  use  - title  and  all  rights
  87.             attached to the software itself is retained by the author(s)
  88.             and copyright holder(s).  With the non-registered  shareware
  89.             version ONLY, you are allowed under this licence to copy the
  90.             software and give it to others so that they may evaluate it,
  91.             provided that  it  is given  in  exactly the  same  form  as
  92.             distributed -  with all  files intact  and no  files  added.
  93.             Uploading  to  or  posting  of  the  unregistered  shareware
  94.             version on a BBS or other  software archive site for  others
  95.             for download is expressly allowed, including distribution on
  96.             CD-ROM in a form ultimately intended for use by BBS systems.
  97.             Renting  or  sub-licensing  of  this  product  is   strictly
  98.             prohibited.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.             The maximum period  for which you  are entitled  to use  the
  108.             unregistered  shareware   version   for  the   purposes   of
  109.             determining whether  you wish  to  register may  not  exceed
  110.             thirty  (30)  days.  After  this  period  expires,  you  are
  111.             required by  this licence  to  either register  InspectA  or
  112.             delete your working  copy and  cease using  it. Support  the
  113.             shareware concept  by  registering  this product  -  it  all
  114.             depends on your honesty!
  115.  
  116.             You are restricted under this  licence to using InspectA  on
  117.             single  CPU  only.  Versions  other  than  the  unregistered
  118.             shareware version  are not  transferable,  nor may  they  be
  119.             copied for  any  reason  other than  for  legitimate  backup
  120.             purposes. Operation on  a LAN  or other  network requires  a
  121.             site licence agreement.
  122.  
  123.             Reverse engineering, patching or  other modification of  any
  124.             of the InspectA  components is  specifically prohibited  and
  125.             automatically  revokes  any  licence  of  use,  implied   or
  126.             otherwise. Reproduction,  copying  or modification  of  this
  127.             documentation  is  also   specifically  protected  by   this
  128.             licence.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.             Contents
  140.  
  141.  
  142.             Introduction .............................................1
  143.  
  144.                  New Features in Version 1.10 ........................2
  145.  
  146.                  Documentation Overview ..............................5
  147.  
  148.                  Document Conventions ................................7
  149.  
  150.             Installing InspectA ......................................9
  151.  
  152.                  Before you Begin ....................................9
  153.  
  154.                       System Requirements ............................9
  155.  
  156.                       Package Contents ...............................10
  157.  
  158.                       Running INSTALL ................................11
  159.  
  160.                  Running INSPECT .....................................12
  161.  
  162.                       How To Start ...................................12
  163.  
  164.                       Help! ..........................................13
  165.  
  166.                       Using the Mouse ................................14
  167.  
  168.                       Viewing & Editing ..............................15
  169.  
  170.                       Basic Functions ................................15
  171.  
  172.                       Selecting Items ................................17
  173.  
  174.                       Multiple Windows ...............................17
  175.  
  176.             Configuration ............................................19
  177.  
  178.                       Command Line ...................................20
  179.  
  180.                  General .............................................22
  181.  
  182.                       Options ........................................22
  183.  
  184.                       Programs .......................................26
  185.  
  186.  
  187.  
  188.  
  189.                                                                        i
  190.  
  191.  
  192.             Contents
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                       Swapping .......................................27
  199.  
  200.                       Video ..........................................28
  201.  
  202.                       Mouse ..........................................30
  203.  
  204.                       Colours ........................................32
  205.  
  206.                       Filelist .......................................33
  207.  
  208.                       Lists ..........................................38
  209.  
  210.                  Archive .............................................39
  211.  
  212.                       Macros .........................................43
  213.  
  214.                  Mailer ..............................................45
  215.  
  216.                       Mailer Type ....................................45
  217.  
  218.                       Address ........................................47
  219.  
  220.                       Domain Equivalents .............................48
  221.  
  222.                       Products .......................................49
  223.  
  224.                  Paths ...............................................50
  225.  
  226.                  Keys ................................................52
  227.  
  228.                       Key Descriptions ...............................56
  229.  
  230.                       Macros .........................................56
  231.  
  232.                  File Associations ...................................59
  233.  
  234.                  Text ................................................61
  235.  
  236.                       Import .........................................62
  237.  
  238.                       Export .........................................63
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.             ii
  251.  
  252.  
  253.                                                                 Contents
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                  Quit ................................................63
  260.  
  261.             InspectA Functions .......................................64
  262.  
  263.                  File Manager ........................................64
  264.  
  265.                       Files display ..................................65
  266.  
  267.                       Functions ......................................68
  268.  
  269.                  Archive Manager .....................................79
  270.  
  271.                  FidoNet Related Functions ...........................82
  272.  
  273.                  FTSC Type 2 Packet Manager ..........................85
  274.  
  275.                  Message View ........................................91
  276.  
  277.             Common Features ..........................................93
  278.  
  279.                  Path Selection ......................................93
  280.  
  281.                  Files List Selection ................................94
  282.  
  283.                  Directory Tree ......................................95
  284.  
  285.                  Drive Selection .....................................97
  286.  
  287.             Networks & CD-ROM ........................................99
  288.  
  289.                       User Configuration .............................99
  290.  
  291.                       Disk Index Files ...............................100
  292.  
  293.                       Description Files ..............................101
  294.  
  295.             External Commands ........................................102
  296.  
  297.                       Environment ....................................103
  298.  
  299.                       Environment Variables ..........................104
  300.  
  301.                       Redirection ....................................105
  302.  
  303.                       Stacked Commands ...............................105
  304.  
  305.                       Current Directory ..............................105
  306.  
  307.  
  308.  
  309.  
  310.  
  311.                                                                      iii
  312.  
  313.  
  314.             Contents
  315.  
  316.  
  317.  
  318.  
  319.  
  320.             Prompts ..................................................107
  321.  
  322.             Import/Export ............................................109
  323.  
  324.                       [general] ......................................110
  325.  
  326.                       [video] ........................................115
  327.  
  328.                       [archive] ......................................118
  329.  
  330.                       [mailer] .......................................119
  331.  
  332.                       [paths] ........................................121
  333.  
  334.                       [externals] ....................................121
  335.  
  336.             Miscellaneous ............................................124
  337.  
  338.                       Screenblanker ..................................124
  339.  
  340.             Copyrights & Trademarks ..................................125
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.             iv
  373.  
  374.  
  375.                                                             Introduction
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.             Introduction
  387.  
  388.  
  389.                            InspectA is a powerful and configurable  file
  390.                            management tool  with  enhanced  capabilities
  391.                            when dealing with various types of files.  It
  392.                            is also includes extensive program  launching
  393.                            capabilities. Its definable keyboard and file
  394.                            associations make  it a  convenient means  of
  395.                            both navigating the  file system and  running
  396.                            applications, and is  a superior  alternative
  397.                            to   the   more   traditional   clumsy    and
  398.                            restrictive  menu  systems.  The  amount   of
  399.                            memory used  by InspectA  when running  other
  400.                            programs is  negligible  when  program  image
  401.                            swapping is enabled.
  402.  
  403.                            InspectA  also  provides  a  way  of  viewing
  404.                            various  types  of  special  files,  such  as
  405.                            compressed file archives of various  formats,
  406.                            FTSC "type-2"  packets, FidoNet  *.MSG  files
  407.                            and may be  configured to use  any number  of
  408.                            other external viewing utilities to view PCX,
  409.                            GIF, JPG,  TIF,  dBase, worksheet  and  other
  410.                            types of files.
  411.  
  412.                            InspectA   incorporates    many    individual
  413.                            utilities  into  the  one  tool,  such  as  a
  414.                            multiple volume or drive search by file name,
  415.                            maintenance of  file descriptions  compatible
  416.                            with 4DOS,  file  editing  and  viewing.  Its
  417.                            built  in  command   line  execute   function
  418.                            provides command history of up to the last 64
  419.                            commands used.
  420.  
  421.                            InspectA is  easy to  use. All  commands  and
  422.                            functions  are  available   from  an   easily
  423.                            accessible pull-down menu system, as are  all
  424.                            user-defined  commands.   The   configuration
  425.                            utility provides  a straight-forward  way  of
  426.                            changing settings to taste.
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.             InspectA                                                   1
  434.  
  435.  
  436.             Introduction
  437.  
  438.  
  439.  
  440.  
  441.  
  442.             New Features in Version 1.10
  443.  
  444.                            The  following  list  contains  most  of  the
  445.                            important changes, additions and enhancements
  446.                            added since version 1.0:
  447.  
  448.                               Support for SQZ compressed  archive format
  449.                               has been added.
  450.  
  451.                               The Files Manager interface  was enhanced;
  452.                               InspectA now  has  a  "desktop"  interface
  453.                               that  provides   multiple   file   manager
  454.                               windows open  on  multiple directories  at
  455.                               once, and the  ability to  iconise windows
  456.                               for later access.
  457.  
  458.                               The ability  to save  the current  windows
  459.                               setup was added to automatically restore a
  460.                               particular  desktop   layout  with   auto-
  461.                               rescaling to current screen size.
  462.  
  463.                               A pull-down menu system has been added for
  464.                               easy access of both  pre-defined and user-
  465.                               defined commands.
  466.  
  467.                               The format of  the list presented  in file
  468.                               windows can  now be  defined  and set  for
  469.                               each window. Multiple (an unlimited number
  470.                               of) formats  may  be  defined and  toggled
  471.                               using a keyboard mappable function.
  472.  
  473.                               The interactive  configuration  utility  -
  474.                               ICONFIG  -  was  added,   making  changing
  475.                               settings  much  easier  and  simpler  than
  476.                               maintaining and  "compiling"  an  external
  477.                               text based configuration file.
  478.  
  479.                               File manager  windows may  now be  resized
  480.                               and moved interactively.
  481.  
  482.                               Mouse support was added, greatly enhancing
  483.                               the ability to use the windowed desktop to
  484.                               its  fullest.  Windows  may  be  selected,
  485.                               closed,  iconised,   zoomed,   moved   and
  486.                               resized using the mouse pointer. Lists may
  487.                               be  scrolled,  items  selected   and  menu
  488.                               selections made - virtually  all functions
  489.  
  490.  
  491.  
  492.  
  493.  
  494.             2                                                   InspectA
  495.  
  496.  
  497.                                                             Introduction
  498.  
  499.  
  500.  
  501.  
  502.  
  503.                               available from the keyboard may be carried
  504.                               out using the mouse.
  505.  
  506.                               Network/multiuser   support    has    been
  507.                               enhanced by adding  support for  a default
  508.                               configuration directory  as determined  by
  509.                               the HOME  environment  variable.  If  set,
  510.                               this  directory  is  used  to  store  user
  511.                               specific defaults  and the  windows layout
  512.                               file.
  513.  
  514.                               Various problems in  the handling  of copy
  515.                               and move  operations  of  read-only  files
  516.                               were solved.
  517.  
  518.                               Handling   of   the   pre-defined   "view"
  519.                               directory has  been improved.  Also, files
  520.                               within archives  with directories  are now
  521.                               handled seemlessly. If  multiple instances
  522.                               of a file  are extracted by  selecting one
  523.                               (this is unavoidable in some formats), all
  524.                               extracted files are correctly deleted.
  525.  
  526.                               Improved default archive handling commands
  527.                               have been added to the default setup.
  528.  
  529.                               When files  extracted  from  archives  are
  530.                               being viewed, the default directory is now
  531.                               set to the original  directory rather than
  532.                               the one in which the file was extracted.
  533.  
  534.                               The following commands  were added  to the
  535.                               Files   Manager:    Configuration    (runs
  536.                               ICONFIG), Open, Close, Zoom,  Resize, Move
  537.                               and Iconise  Window,  Select Directory  by
  538.                               name, Toggle Format of  file list, Command
  539.                               Menu and User Command selector.
  540.  
  541.                               The ability to  write marked  messages (or
  542.                               current message) to  text format  from the
  543.                               packet viewer was added.
  544.  
  545.                               Sorting a list of files lexically (by word
  546.                               length by  ascii order)  was added,  which
  547.                               provides the  ability to  sort  a list  of
  548.                               numeric file  names  in  a more  intuitive
  549.                               order.
  550.  
  551.  
  552.  
  553.  
  554.  
  555.             InspectA                                                   3
  556.  
  557.  
  558.             Introduction
  559.  
  560.  
  561.  
  562.  
  563.  
  564.                               Sort by file description added.
  565.  
  566.                               Fully  interactive  and  straight  forward
  567.                               installation/upgrade procedure added.
  568.  
  569.                               Support for FTSCPROC product code listings
  570.                               instead of  using  a  hard-coded table  of
  571.                               known FTSC products and capabilities.
  572.  
  573.                               Path  designations   in  LHA   files  with
  574.                               extended headers now works correctly.
  575.  
  576.                               All previously  "registered-only" features
  577.                               are  now   available   on  the   shareware
  578.                               version.   However,   as    incentive   to
  579.                               register, a  shareware  "nag"  prompt  has
  580.                               been  added  and  will  appear  at  random
  581.                               intervals.
  582.  
  583.                               Support    for     command    input/output
  584.                               redirection  using  the  '<',   '>',  '>>'
  585.                               symbols has  been added.  This applies  to
  586.                               all instances  of where  InspectA runs  an
  587.                               external command.
  588.  
  589.                               Support  for   HPACK  archives   has  been
  590.                               updated to the  0.78 release and  that the
  591.                               earlier format  of  0.75  and  earlier  is
  592.                               incompatible, is no longer supported.
  593.  
  594.                               Support for  self-extracting archives  has
  595.                               been integrated into the  archive manager;
  596.                               InspectA will now check .EXE  files to see
  597.                               if they are archive  extraction envelopes.
  598.                               Self-extractors for  all  compress  except
  599.                               HPACK are supported (HPACK does not have a
  600.                               self-extractor feature).
  601.  
  602.                               Global "hot-keys" for  file view  and edit
  603.                               have been added; unlike  the standard view
  604.                               and edit  functions,  these are  available
  605.                               from anywhere  in  InspectA (both  INSPECT
  606.                               and  ICONFIG  via  SHIFT-F3  and  SHIFT-F4
  607.                               respectively).
  608.  
  609.                               InspectA now provides  the ability  to re-
  610.                               pack archives,  both  standard  and  self-
  611.                               extracting types, into a  different format
  612.  
  613.  
  614.  
  615.  
  616.             4                                                   InspectA
  617.  
  618.  
  619.                                                             Introduction
  620.  
  621.  
  622.  
  623.  
  624.  
  625.                               or the  same  format. Archives  containing
  626.                               sub-directories   are    fully   supported
  627.                               provided that  the compression  program to
  628.                               which archives are converted  knows how to
  629.                               handle them.
  630.  
  631.                               A Virus  Scan capability  has been  added,
  632.                               either stand  alone to  scan files  in the
  633.                               current directory  and below,  or used  to
  634.                               scan  files  contained  in   one  or  more
  635.                               archives.  Virus  scanning  can   also  be
  636.                               carried out during archive repacking.
  637.  
  638.                               Support for PKZIP 2.0 or compatible method
  639.                               (ZI2) has  been  enhanced  to provide  the
  640.                               ability  to  handle,  create  and  extract
  641.                               version 1.10 and 2.0 files separately.
  642.  
  643.                               Support for  DWC archive  format has  been
  644.                               added.
  645.  
  646.                               This release  features  the  debut of  the
  647.                               OS/2 version  of  InspectA, is  compatible
  648.                               with OS/2 versions  1.2 or  greater, fully
  649.                               supporting HPFS  and NetWare  filesystems,
  650.                               and may be  run in a  Vio window  or full-
  651.                               screen session.
  652.  
  653.                               The OS/2  version  supports OS/2  specific
  654.                               filesystem information, including Extended
  655.                               Attributes, view and sorting files by date
  656.                               of creation and last access.
  657.  
  658.  
  659.  
  660.             Documentation Overview
  661.  
  662.                            Information on using InspectA may be found in
  663.                            two places; the  InspectA User's Guide  (part
  664.                            of  which  you  are  now  reading)  and   the
  665.                            InspectA On-line Help facility, accessible at
  666.                            almost any time  when running InspectA  using
  667.                            the  F1  key.  The   User's  Guide  provides
  668.                            instructions   on   installing   and    using
  669.                            InspectA,  advice   on  how   to  take   best
  670.                            advantage of the  powerful features  offered,
  671.                            and reference information on specific  topics
  672.                            in the appendixes.  The On-line Help function
  673.  
  674.  
  675.  
  676.  
  677.             InspectA                                                   5
  678.  
  679.  
  680.             Introduction
  681.  
  682.  
  683.  
  684.  
  685.  
  686.                            provides instant access to information  about
  687.                            the current prompt,  screen or process  while
  688.                            using InspectA. For most uses, you will  only
  689.                            need  to   read   the  printed   or   on-disk
  690.                            documentation  if  you  wish  to  take   full
  691.                            advantage of  the  more  advanced  facilities
  692.                            offered  by   InspectA.  The   on-line   help
  693.                            facility  will  provide  all  the   necessary
  694.                            information to assist in using all the built-
  695.                            in facilities of the program itself, and  the
  696.                            program has  been  constructed  with  a  user
  697.                            interface intended  to  be  as  intuitive  as
  698.                            possible.
  699.  
  700.                            The  User's  Guide  itself  is  divided  into
  701.                            several sections:
  702.  
  703.                               Introduction & Installation; the first two
  704.                               chapters provide  an overview  of InspectA
  705.                               and contain instructions on installation.
  706.  
  707.                               Using InspectA;  this is  a "quick  start"
  708.                               guide, and  gets the  program working  for
  709.                               you quickly, so that  you can make  use of
  710.                               it  and  explore  all  it   has  to  offer
  711.                               immediately.
  712.  
  713.                               Configuration;  this  chapter  covers  all
  714.                               aspects of configuration according to your
  715.                               requirements and taste.
  716.  
  717.                               Functions;  this  section   provides  more
  718.                               detailed   descriptions   of   the   major
  719.                               functions available in InspectA, including
  720.                               the File Manager, Archive Viewer, Packet &
  721.                               Message Viewers  and  the  pull-down  menu
  722.                               system.
  723.  
  724.                               Appendices;   these    provide   reference
  725.                               material  for  functions   and  facilities
  726.                               available  throughout  various   parts  of
  727.                               InspectA  and   covers  some   aspects  of
  728.                               operation and  configuration  not  covered
  729.                               elsewhere.
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.             6                                                   InspectA
  739.  
  740.  
  741.                                                             Introduction
  742.  
  743.  
  744.  
  745.  
  746.  
  747.             Document Conventions
  748.  
  749.                            This document uses the following  typographic
  750.                               conventions:
  751.  
  752.                       Examples       Description
  753.  
  754.  
  755.  
  756.                       README.TXT     Uppercase     (capital)     letters
  757.                                      indicate file names.
  758.  
  759.                       ICONFIGP, ICONFIG   Bold     uppercase     letters
  760.                                      indicate MSDOS or OS/2 commands.
  761.  
  762.                       text           Words  in  italic  indicate   place
  763.                                      holders for  information  that  you
  764.                                      must supply,  for example,  program
  765.                                      arguments or an entry in a field or
  766.                                      at a prompt.
  767.  
  768.                       [[ option ]]   Items inside double square brackets
  769.                                      are optional.
  770.  
  771.                       [ choice1 | choice2 ]    Braces and a vertical bar
  772.                                      indicate a  choice between  two  or
  773.                                      more items. You must choose one  of
  774.                                      the items unless all the items  are
  775.                                      also  enclosed  in  double   square
  776.                                      brackets  indicating  that  it   is
  777.                                      optional.
  778.  
  779.                       Example text   This  font  is  used  for   program
  780.                                      examples,   user   input,   program
  781.                                      output, information  in text  files
  782.                                      and error messages within the text.
  783.  
  784.                       Repeating ...  Three ellipses  following  an  item
  785.                                      indicate that more items having the
  786.                                      same form may be entered.
  787.  
  788.                       F1, ALT-A      Small capital letters indicate  the
  789.                                      names of  keys and  key  sequences,
  790.                                      such as ENTER and  CTRL-C. A hyphen
  791.                                      between a shift key (SHIFT, CTRL or
  792.                                      ALT) and  a letter  indicates  that
  793.                                      the key must be held down while the
  794.  
  795.  
  796.  
  797.  
  798.  
  799.             InspectA                                                   7
  800.  
  801.  
  802.             Introduction
  803.  
  804.  
  805.  
  806.  
  807.  
  808.                                      corresponding   letter    key    is
  809.                                      pressed.
  810.  
  811.                                      The  cursor-movement  keys  on  the
  812.                                      numeric  keypad  are  called  ARROW
  813.                                      keys.  Individual  ARROW  keys  are
  814.                                      referred to by the direction of the
  815.                                      arrow on the  top of  the key  (ie.
  816.                                      LEFT, RIGHT, UP,  DOWN) or the name
  817.                                      on top of the key ( PGUP, PGDN, END
  818.                                      and HOME).
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.             8                                                   InspectA
  861.  
  862.  
  863.                                                      Installing InspectA
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.             Installing InspectA
  875.  
  876.  
  877.                            This  chapter   explains   how   to   install
  878.                            InspectA.
  879.  
  880.                            InspectA  is  distributed  in  a   compressed
  881.                            format, and  should  be installed  using  the
  882.                            supplied installation batch file.
  883.  
  884.                            Before   running   INSTALL,   back   up   the
  885.                            distribution archive and  make sure you  have
  886.                            enough   free   disk   space   (roughly   400
  887.                            kilobytes) to contain the distribution files.
  888.  
  889.                            Floppy disk installation  is not supported  -
  890.                            you must  install  InspectA on  a  hard  disk
  891.                            drive or network volume.
  892.  
  893.  
  894.  
  895.             Before you Begin
  896.  
  897.                            Before installing InspectA on your hard disk,
  898.                            take a  few minutes  to make  sure that  your
  899.                            computer meets the  minimum requirements  and
  900.                            that the package is complete.
  901.  
  902.  
  903.                System Requirements
  904.  
  905.                            InspectA for  MSDOS  requires  at  least  the
  906.                            following configuration:
  907.  
  908.                               An   IBM   Personal   Computer   or   100%
  909.                               compatible running  MSDOS  version 3.3  or
  910.                               later
  911.  
  912.                               At least  384K  (kilobytes)  of  available
  913.                               memory at the MSDOS prompt.
  914.  
  915.                               A hard-disk drive with 400K of free space.
  916.  
  917.  
  918.  
  919.  
  920.  
  921.             InspectA                                                   9
  922.  
  923.  
  924.             Installing InspectA
  925.  
  926.  
  927.  
  928.  
  929.  
  930.                               InspectA   will    give   much    improved
  931.                               performance on an 80286 or later processor
  932.                               and a fast hard disk sub-system. These are
  933.                               not, however, a prerequisite.
  934.  
  935.                               InspectA is capable of using extended text
  936.                               modes available on many EGA, VGA, SVGA and
  937.                               XVGA screens.  These also  are not  a pre-
  938.                               requisite for use, but will enhance use.
  939.  
  940.                               For  better   performance   in   launching
  941.                               external   applications   and   utilities,
  942.                               extended  or  expanded  memory   with  the
  943.                               appropriate   extended   (XMS   2.0+)   or
  944.                               expanded (LIMS 3.2  or 4.0)  memory driver
  945.                               is   highly   recommended.   Most   memory
  946.                               managers  for  Intel  80386  systems  have
  947.                               these facilities built-in.
  948.  
  949.                            InspectA  for  OS/2  requires  at  least  the
  950.                               following configuration:
  951.  
  952.                               An   IBM   Personal   Computer   or   100%
  953.                               compatible  running  OS/2  1.2  or  later.
  954.                               INSPECTP.EXE and  ICONFIGP.EXE are  16-bit
  955.                               applications, compatible with the 80286.
  956.  
  957.                               Sufficient free memory to  run (around 450
  958.                               kilobytes).
  959.  
  960.                               A hard-disk  drive with  400K  or more  of
  961.                               free space.
  962.  
  963.                               InspectA is capable of using extended (132
  964.                               column) text modes  available on  SVGA and
  965.                               XVGA screens. In order to use these modes,
  966.                               you  must  have  the  appropriate  display
  967.                               drivers installed and functioning.
  968.  
  969.  
  970.                Package Contents
  971.  
  972.                            Check  your  InspectA   package  to  see   if
  973.                            everything is there. If any of the components
  974.                            are missing,  contact  the  distributor  from
  975.                            whom you purchased the package, or - if it is
  976.                            the unregistered  shareware package  -  check
  977.                            with the source from which you obtained it.
  978.  
  979.  
  980.  
  981.  
  982.             10                                                  InspectA
  983.  
  984.  
  985.                                                      Installing InspectA
  986.  
  987.  
  988.  
  989.  
  990.  
  991.                            The only  difference between  the  commercial
  992.                            version  of  InspectA   and  the   registered
  993.                            shareware version  is  the  packaging.    The
  994.                            commercial version  is provided  on  diskette
  995.                            (3.5" 720K  or 5.25"  360K formats),  and  is
  996.                            accompanied  by  a  bound  manual  with   the
  997.                            following files on the diskette:
  998.  
  999.                               ERRATA.TXT (may  or  may  not be  present)
  1000.                               contains  additions  and  errata  to  this
  1001.                               document
  1002.  
  1003.                               INSTALL.BAT  is  the  install  batch  file
  1004.                               (this is INSTALL.CMD in the OS/2 version).
  1005.  
  1006.                               INSPECT.HLP is the  combined help  and key
  1007.                               file, registered to you  or your company's
  1008.                               name
  1009.  
  1010.                               INSPECTA.110  is   a  compressed   archive
  1011.                               containing  the  software   itself,  which
  1012.                               includes INSPECT.EXE (INSPECTP.EXE in  the
  1013.                               OS/2  release)   the   file  manager   and
  1014.                               ICONFIG.EXE (ICONFIGP.EXE) the interactive
  1015.                               configuration  utility.      Other   files
  1016.                               containing default  or suggested  InspectA
  1017.                               settings are also included. One or more of
  1018.                               these may be used by the INSTALL script to
  1019.                               set up a default configuration.
  1020.  
  1021.                            The shareware version includes an  additional
  1022.                            file,  INSPECT.MAN,  inside  the  compressed
  1023.                            archive. This  is  the on-disk  manual.    In
  1024.                            addition, these  instructions  are  added  to
  1025.                            README.TXT.
  1026.  
  1027.  
  1028.                Running INSTALL
  1029.  
  1030.                            If you are upgrading from a previous version,
  1031.                            you should first backup  and delete your  old
  1032.                            INSPECT.INI.
  1033.  
  1034.                            To install, copy the contents of the InspectA
  1035.                            distribution disk or archive into a directory
  1036.                            on your hard disk.  If you have the shareware
  1037.                            version, unpack the distribution archive to a
  1038.                            temporary directory of your choice, including
  1039.  
  1040.  
  1041.  
  1042.  
  1043.             InspectA                                                  11
  1044.  
  1045.  
  1046.             Installing InspectA
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.                            the inner  INSPECTA.110 archive  which is  in
  1053.                            ZIP format, using the command:
  1054.  
  1055.                                 PKUNZIP INSPECTA.110.         (MS-DOS)
  1056.                                 unzip INSPECTA.110            (OS/2)
  1057.  
  1058.                            On MS-DOS, please ensure that you are using a
  1059.                            version of PKZIP greater than 1.10. On  OS/2,
  1060.                            you will need zip 1.9 or greater.
  1061.  
  1062.                            Make the  temporary  directory  the  default.
  1063.                            Type "INSTALL -H" and press  ENTER to display
  1064.                            the options available to you when installing.
  1065.                            After    running    INSTALL,    a     default
  1066.                            configuration is created, and InspectA is run
  1067.                            automatically to allow you to copy the  files
  1068.                            to a  convenient  place on  your  hard  drive
  1069.                            using F5 (COPY).  All settings  may be  later
  1070.                            customised using the ICONFIG utility.
  1071.  
  1072.  
  1073.  
  1074.             Running INSPECT
  1075.  
  1076.                            This section is  a "quick  start" in  getting
  1077.                            INSPECT  up  and  running  on  your   system.
  1078.                            Information on how  to configure  it to  your
  1079.                            requirements and taste  can be  found in  the
  1080.                            following section entitled Configuration.
  1081.  
  1082.  
  1083.                How To Start
  1084.  
  1085.                            After INSTALL has been run, you will find the
  1086.                            files    INSPECT(P).EXE,         INSPECT.HLP,
  1087.                            ICONFIG(P).EXE  and  INSPECT(P).INI  in   the
  1088.                            directory used when installing.
  1089.  
  1090.                            Note   that   the    OS/2   executable    and
  1091.                            configuration file names have the letter  'P'
  1092.                            (for "Protected Mode") added. This avoids any
  1093.                            confusion as to which  version is being  run,
  1094.                            and allows the two versions to be present and
  1095.                            run on the same machine without requiring any
  1096.                            special considerations. This manual refers to
  1097.                            the MSDOS names,  and if  you have  installed
  1098.                            the OS/2  version, you  should translate  the
  1099.                            names as follows:
  1100.  
  1101.  
  1102.  
  1103.  
  1104.             12                                                  InspectA
  1105.  
  1106.  
  1107.                                                      Installing InspectA
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.                                 INSPECT.EXE         to   inspectP.exe
  1114.                                 ICONFIG.EXE         to   iconfigP.exe
  1115.                                 INSPECT.INI         to   inspectp.ini
  1116.  
  1117.                            Only the window state file, INSPECT.SAV,  may
  1118.                            be shared by both versions. The configuration
  1119.                            file used  by  both  versions  is  compatible
  1120.                            (they may read  each other's  config file  if
  1121.                            renamed) - however, each contains information
  1122.                            specific to the operating system under  which
  1123.                            it was created.
  1124.  
  1125.                            The directory  in which  the executables  are
  1126.                            placed must be named in the search path  used
  1127.                            by the operating system. You may also find it
  1128.                            helpful to add the HOME environment  variable
  1129.                            to your DOS AUTOEXEC.BAT or OS/2  CONFIG.SYS,
  1130.                            because this will force  InspectA to use  the
  1131.                            directory to which it points for  INSPECT.INI
  1132.                            (the configuration file) and INSPECT.SAV (the
  1133.                            window state save file).
  1134.  
  1135.                            At this  point, you  should be  able to  type
  1136.                            INSPECT to run INSPECT. If not, check to make
  1137.                            sure that INSPECT.INI  exists, either in  the
  1138.                            current directory or  the directory named  by
  1139.                            the HOME  environment variable  (if set),  or
  1140.                            the directory containing  INSPECT.EXE. If  it
  1141.                            doesn't exist, run ICONFIG to create it. Note
  1142.                            that   all   three   files   -    ICONFIG.EXE
  1143.                            (iconfigP.exe) INSPECT.EXE (inspectP.exe) and
  1144.                            INSPECT.HLP  -  must   reside  in  the   same
  1145.                            directory.
  1146.  
  1147.                            On startup,  the  screen first  presented  is
  1148.                            InspectA's File Manager.
  1149.  
  1150.  
  1151.                Help!
  1152.  
  1153.                            When using InspectA, the following lists some
  1154.                            important things to remember:
  1155.  
  1156.                       /              If  you  get  "lost"  in  the  File
  1157.                                      Manager,  the  forward  slash   key
  1158.                                      invokes the pull-down menus,  where
  1159.                                      all InspectA functions are  readily
  1160.                                      accessible. (Pressing and releasing
  1161.  
  1162.  
  1163.  
  1164.  
  1165.             InspectA                                                  13
  1166.  
  1167.  
  1168.             Installing InspectA
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.                                      the  Alt  key  -  unless  this   is
  1175.                                      disabled in ICONFIG  - will have  a
  1176.                                      similar effect.  If your  mouse  is
  1177.                                      active, clicking  anywhere  on  the
  1178.                                      top line  of the  screen will  also
  1179.                                      activate the menus.)
  1180.  
  1181.                       ESC            This key  always means  "exit".  In
  1182.                                      some cases, this may also abort  an
  1183.                                      operation. Think of it as "ESCaping
  1184.                                      from" what you are currently doing.
  1185.  
  1186.                       F1             If you  are unsure  of what  to  do
  1187.                                      next,  or   what  information   the
  1188.                                      program is requesting from you, the
  1189.                                      F1 key may provide all the  answers
  1190.                                      you  may  seek.  Pressing  it  once
  1191.                                      invokes the  on-line  help  system,
  1192.                                      which  pops   up  a   window   with
  1193.                                      information relating  to  what  you
  1194.                                      are currently doing. If you need to
  1195.                                      find more information, you can  use
  1196.                                      the  PGDN and   PGUP keys  to read
  1197.                                      related information,  or  press  F1
  1198.                                      again to view the help index.
  1199.  
  1200.  
  1201.                Using the Mouse
  1202.  
  1203.                            InspectA is  able  to  take  advantage  of  a
  1204.                            MicroSoft  compatible   mouse,  if   one   is
  1205.                            installed. If you wish to use the mouse,  you
  1206.                            must make  sure  that  the  mouse  driver  is
  1207.                            loaded prior to running INSPECT.
  1208.  
  1209.                            With the  obvious  exception of  typing  data
  1210.                            into entry  fields, almost  all functions  in
  1211.                            InspectA can  be  performed using  the  mouse
  1212.                            either directly using screen controls, or via
  1213.                            the pulldown menu system.  In lists, you  can
  1214.                            move the highlight bar by either clicking  on
  1215.                            the entry you wish to highlight, or using the
  1216.                            SCROLL  BAR  to  randomly  access  and  scan
  1217.                            entries in the list. In forms, you can select
  1218.                            the field to  enter by  clicking anywhere  on
  1219.                            the field,  and  you can  adjust  the  cursor
  1220.                            position within a  field by  clicking on  the
  1221.                            point to place  the cursor. Menus  work in  a
  1222.  
  1223.  
  1224.  
  1225.  
  1226.             14                                                  InspectA
  1227.  
  1228.  
  1229.                                                      Installing InspectA
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.                            manner similar to lists; move the selector to
  1236.                            an item  on the  menu  by clicking  the  left
  1237.                            button once with the mouse cursor on it,  and
  1238.                            clicking it again when the selector has moved
  1239.                            to select the item.
  1240.  
  1241.  
  1242.                Viewing & Editing
  1243.  
  1244.                            This  version  of   InspectA  uses   external
  1245.                            programs to view and edit files, and  neither
  1246.                            is supplied with InspectA itself. You  should
  1247.                            either obtain  suitable  programs  for  these
  1248.                            purposes,  or  use  the  editor  and  viewing
  1249.                            program that you currently use.
  1250.  
  1251.                            As a  text editor,  we can  highly  recommend
  1252.                            SemWare's QEDIT, which  can be  found on  any
  1253.                            quality BBS. For viewing files, we  recommend
  1254.                            Vernon  D.  Buerg's   LIST.  Both  of   these
  1255.                            programs are used  by default, if  available.
  1256.                            OS/2 versions are available for purchase, but
  1257.                            neither  supports   HPFS,  and   neither   is
  1258.                            available as shareware.
  1259.  
  1260.                            A future version of InspectA will feature its
  1261.                            own internal editor and file viewer.
  1262.  
  1263.  
  1264.                Basic Functions
  1265.  
  1266.                            INSPECT is a list-based viewer which provides
  1267.                            a "point  and  shoot"  interface  to  objects
  1268.                            being viewed. The File Manager views the file
  1269.                            system, and allows selection  of one or  more
  1270.                            files from a list which displays the contents
  1271.                            of the current directory. InspectA recognises
  1272.                            certain types of files; including  compressed
  1273.                            archives (ARC,  ZIP,  LZH,  ZOO,  ARJ  etc.),
  1274.                            FidoNet mail packets and messages, and  files
  1275.                            which  may  be  executed.  You  can  navigate
  1276.                            through directories by placing the  highlight
  1277.                            bar on a directory name (including ".." which
  1278.                            moves to the parent directory of the  current
  1279.                            one) and pressing  ENTER, or by  placing the
  1280.                            mouse cursor over it  and clicking once  with
  1281.                            the left mouse button. Alternatively, you can
  1282.                            navigate through many directories very easily
  1283.  
  1284.  
  1285.  
  1286.  
  1287.             InspectA                                                  15
  1288.  
  1289.  
  1290.             Installing InspectA
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.                            using the  directory  tree, by  pressing  F9.
  1297.                            Selecting  other  types  of  files  will,  by
  1298.                            default, view  the file,  but this  behaviour
  1299.                            can be  modified  by  overriding  this  using
  1300.                            ICONFIG.
  1301.  
  1302.                            The Archive Manager  presents a  list of  its
  1303.                            members,  which  can  also  be  selected  and
  1304.                            actions performed on  them in  the same  way.
  1305.                            All other  built-in managers  offer the  same
  1306.                            types of  facility, other  options  available
  1307.                            dependant on  what  type  of  file  is  being
  1308.                            viewed.
  1309.  
  1310.                            The cursor movement keys can be used to  move
  1311.                            around the  list of  files;  UP moves  up one
  1312.                            file,  DOWN moves  down,  PGUP moves  up  one
  1313.                            window (or to  the top  of the  list, if  the
  1314.                            first   screen   of   files   is    currently
  1315.                            displayed), PGDN moves down one window,  HOME
  1316.                            moves to the top of  the list, and  END moves
  1317.                            to the bottom.
  1318.  
  1319.                            If you are using the mouse, you can move  the
  1320.                            highlight bar to  any item on  the screen  by
  1321.                            moving  the  highlight   cursor  to  it   and
  1322.                            clicking once  with  the  left  mouse  button
  1323.                            (clicking   an   item   which   is    already
  1324.                            highlighted selects it for viewing). To  move
  1325.                            beyond the current list of files, you need to
  1326.                            use the SCROLL BAR which is at the right hand
  1327.                            side of the  list. At the  top and bottom  of
  1328.                            the  SCROLL BAR  are  icons  which  move  the
  1329.                            cursor up and  down one line  at a time,  and
  1330.                            will  cause  the  list  to  scroll  when  the
  1331.                            beginning or  end  of the  list  is  reached.
  1332.                            Clicking anywhere on  the SCROLL BAR  between
  1333.                            these  two  icons  will  cause  the  list  to
  1334.                            reposition itself  in the  list according  to
  1335.                            the position  of  the  mouse  cursor  on  the
  1336.                            SCROLL BAR. The position  marker on  the bar
  1337.                            indicates the  currently  highlighted  item's
  1338.                            position in  the list.  As a  rule,  clicking
  1339.                            above the marker  moves up,  and below  moves
  1340.                            down.
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.             16                                                  InspectA
  1349.  
  1350.  
  1351.                                                      Installing InspectA
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.                Selecting Items
  1358.  
  1359.                            Selection  of  multiple  items  in  any  list
  1360.                            provides  the   facility  to   carry  out   a
  1361.                            particular action on all of them. The current
  1362.                            item is  highlighted  by pressing  the  SPACE
  1363.                            key; or  -  to  make marking  of  many  items
  1364.                            easier - you  can move and  mark at the  same
  1365.                            time, by holding down  either SHIFT key, and
  1366.                            use any  of the  cursor movement  keys  (UP,.
  1367.                            DOWN, PGUP, PGDN, END or  HOME). These toggle
  1368.                            the mark on all items starting and  including
  1369.                            the current one up to  the item to which  the
  1370.                            highlight bar  is moved.  The  F2 key  may be
  1371.                            used to  mark and  un-mark all  items in  the
  1372.                            list (or remark all  items which were  marked
  1373.                            prior the last operation).
  1374.  
  1375.                            Marking items with the mouse is also done  by
  1376.                            holding down the  SHIFT key and  clicking on
  1377.                            the item to mark  with the mouse cursor.  The
  1378.                            global mark/remark  function is  executed  by
  1379.                            holding down  the  ALT key  and clicking  the
  1380.                            left mouse button anywhere on the list.
  1381.  
  1382.  
  1383.                Multiple Windows
  1384.  
  1385.                            One of InspectA's  most powerful features  is
  1386.                            the ability to  log more  than one  directory
  1387.                            and  display   them  at   once  in   multiple
  1388.                            overlapping  windows.  While  the  only  real
  1389.                            limitation on the number of windows that  can
  1390.                            be open at any  particular time is  available
  1391.                            memory, it  may be  too confusing  and  quite
  1392.                            clumsy to have too  many windows open at  the
  1393.                            same time on the  desktop. If you enjoy  this
  1394.                            feature, learn to use the Iconise function to
  1395.                            temporarily "put away" windows until you need
  1396.                            them.
  1397.  
  1398.                            To Open a window, press SHIFT-INS. Select the
  1399.                            directory you wish to view in the new  window
  1400.                            by typing the name in, or by using any of the
  1401.                            other interactive search facilities  provided
  1402.                            by the directory selection prompt.
  1403.  
  1404.                            Switch between windows by using the TAB key.
  1405.  
  1406.  
  1407.  
  1408.  
  1409.             InspectA                                                  17
  1410.  
  1411.  
  1412.             Installing InspectA
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.                            Close the current  window by pressing  SHIFT-
  1419.                            DEL. This  does not  work  on the  last  non-
  1420.                            iconised window (at least one window must  be
  1421.                            open at all times).
  1422.  
  1423.                            Iconise the  current window  by using  SHIFT-
  1424.                            NUMPAD-5 (this is the  centre key marked  "5"
  1425.                            on the numeric  keypad). As  with Close,  you
  1426.                            cannot iconise the only open window.
  1427.  
  1428.                            CTRL-ENTER "zooms" or "un-zooms" a window.
  1429.  
  1430.                            Except with  Open  Window.,  these  functions
  1431.                            also have mouse control equivalents; click on
  1432.                            the top left corner of a window to close, top
  1433.                            right to maximise  (zoom),  left  of the  top
  1434.                            right corner to iconise.
  1435.  
  1436.                            Iconised windows can be restored by using the
  1437.                            SHIFT-TAB key  (list windows)  and  selecting
  1438.                            from the list presented.  Using a mouse,  you
  1439.                            can also click  with the left  button on  the
  1440.                            icon.
  1441.  
  1442.                            Windows can also be resized using either  the
  1443.                            keyboard or mouse. Using the keyboard,  press
  1444.                            the  GREY-* key  and use  the  ARROW keys  to
  1445.                            adjust. If using  the mouse, you  can move  a
  1446.                            window by clicking and holding down the  left
  1447.                            mouse button when the cursor is on any  point
  1448.                            on the title  bar at the  top of the  window.
  1449.                            Resize by holding down  the same button  with
  1450.                            the mouse  cursor on  the bottom  right  hand
  1451.                            corner of the window.
  1452.  
  1453.                            It is  possible to  save your  window  layout
  1454.                            using  ALT-F9.  This  saves  both  open  and
  1455.                            iconised windows, so it may be convenient for
  1456.                            saving a  list of  directories that  you  use
  1457.                            often, and selecting the icons needed at  the
  1458.                            start of each  session. InspectA's -u  switch
  1459.                            also allows you to explicitly set the name of
  1460.                            the path  and file  used to  save and  recall
  1461.                            window information, so  it may be  convenient
  1462.                            in some cases to  set up windows for  various
  1463.                            uses and save  them as  profiles in  separate
  1464.                            files.
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.             18                                                  InspectA
  1471.  
  1472.  
  1473.                                                            Configuration
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.             Configuration
  1485.  
  1486.  
  1487.  
  1488.                            This section describes the use of  InspectA's
  1489.                            configuration utility, ICONFIG. This  program
  1490.                            may be  executed  either  directly  from  the
  1491.                            command  prompt,  from  InspectA  itself,  by
  1492.                            selection from  the File  pull-down menu,  or
  1493.                            directly by using ALT-C.
  1494.  
  1495.  
  1496.                            NOTE:  Because all  keys  available from  the
  1497.                            File Manager may  be redefined, any  keyboard
  1498.                            bindings given are those  which are bound  by
  1499.                            default. The user  should remember this  when
  1500.                            reading this documentation.
  1501.  
  1502.  
  1503.                            When run, ICONFIG displays  the full path  to
  1504.                            the configuration (.INI)  file being  editing
  1505.                            on the top line, and below, the configuration
  1506.                            menu horizontally along the upper part of the
  1507.                            screen. Each  of  the  main  items  links  to
  1508.                            either a pull-down menu with sub-options,  or
  1509.                            a  picklist  containing  items  that  may  be
  1510.                            added,  deleted  or  modified.  For  ease  of
  1511.                            reference,  most  of  the  headings  in  this
  1512.                            chapter reflect  the menu  structure used  in
  1513.                            the program itself.
  1514.  
  1515.  
  1516.                            The LEFT, RIGHT, UP and DOWN keys may be used
  1517.                            to navigate the menu system, or the mouse can
  1518.                            be used  to select  an item  either from  the
  1519.                            main configuration menu or  any of the  items
  1520.                            on the pull-down menu.
  1521.  
  1522.  
  1523.                            Unless overridden  by a  command line  option
  1524.                            (see below), ICONFIG uses the same method  to
  1525.                            search for its configuration file as is  used
  1526.                            by InspectA itself.   It first  looks in  the
  1527.  
  1528.  
  1529.  
  1530.  
  1531.             InspectA                                                  19
  1532.  
  1533.  
  1534.             Configuration
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.                            directory nominated by  the HOME  environment
  1541.                            variable, and  if none  is found  there,  the
  1542.                            current  directory  and  then  the  directory
  1543.                            where  ICONFIG.EXE  resides  in  that  order.
  1544.                            However, if the HOME environment variable  is
  1545.                            set, and no configuration file is found there
  1546.                            but is obtained elsewhere, ICONFIG will still
  1547.                            write it  out  to the  HOME  directory.  This
  1548.                            provides the facility to place a default .INI
  1549.                            file in the same directory as ICONFIG.EXE  on
  1550.                            a network,  and  have users  run  ICONFIG  to
  1551.                            create their own, modelled after the  network
  1552.                            default.
  1553.  
  1554.  
  1555.                Command Line
  1556.  
  1557.  
  1558.                            ICONFIG  accepts  the  same  set  of  command
  1559.                            parameters as INSPECT itself. Like  InspectA,
  1560.                            it  also   reads  the   INSPECT   environment
  1561.                            variable before examining the actual  command
  1562.                            line.
  1563.  
  1564.  
  1565.                            Command switches used by ICONFIG are:
  1566.  
  1567.                       Switch         Description
  1568.  
  1569.  
  1570.  
  1571.                       -c dir         Nominate   the   directory    where
  1572.                                      INSPECT.INI should be read from and
  1573.                                      saved. If this  directory does  not
  1574.                                      contain INSPECT.INI on startup, the
  1575.                                      current  and  executable  directory
  1576.                                      are searched, and if found, will be
  1577.                                      read  from  there.    However,   on
  1578.                                      saving  changes  to  disk,  ICONFIG
  1579.                                      will save to the new  configuration
  1580.                                      file to this directory.
  1581.  
  1582.                       -smethod       Selects the method used for program
  1583.                                      image swapping.  This overrides the
  1584.                                      method configured in the .INI file.
  1585.                                      Within ICONFIG,  this only  affects
  1586.                                      the Shell function ( ALT-Z from any
  1587.                                      menu, list or prompt).
  1588.  
  1589.  
  1590.  
  1591.  
  1592.             20                                                  InspectA
  1593.  
  1594.  
  1595.                                                            Configuration
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.                                      Valid methods are:
  1602.  
  1603.                                      X    swap to XMS
  1604.  
  1605.                                      E    for swap to EMS
  1606.  
  1607.                                      D    for swap to disk
  1608.  
  1609.                                      N    suppress swapping.
  1610.  
  1611.                       -voptions      Sets default video options.
  1612.  
  1613.                               m      select monochrome palette
  1614.  
  1615.                               c      select colour palette
  1616.  
  1617.                               n      suppress 'snow' on CGA (MSDOS only)
  1618.  
  1619.                               d      disable  CGA   'snow'   suppression
  1620.                                      (MSDOS only)
  1621.  
  1622.                               b      allow  blinking   background   (not
  1623.                                      intense)
  1624.  
  1625.                               h      allow   intense   background   (not
  1626.                                      blinking)
  1627.  
  1628.                               x      use current  background intense  or
  1629.                                      blinking state
  1630.  
  1631.                               s      do not restore mode (see v, 2, 4  &
  1632.                                      5 options)
  1633.  
  1634.                               z      forces mode restore (overrides 's')
  1635.  
  1636.                               2      force  25  line   mode  on  EGA   &
  1637.                                      VGA/SVGA/XVGA
  1638.  
  1639.                               4 or 5 force 43  (EGA)  or 50  (VGA)  line
  1640.                                      mode
  1641.  
  1642.                               vmode  set a specific mode number (MSDOS)
  1643.  
  1644.                               vRxC   set  display  size,  where  R=rows,
  1645.                                      C=columns. If  missing, columns  is
  1646.                                      assumed to be 80 (OS/2)
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.             InspectA                                                  21
  1654.  
  1655.  
  1656.             Configuration
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.                            All other options  available in InspectA  are
  1663.                            simply ignored.  The following  two  switches
  1664.                            are specific to ICONFIG.
  1665.  
  1666.                       -i file        Import configuration from text file
  1667.  
  1668.                       -x file        Export configuration to text file.
  1669.  
  1670.                            These correspond  to  the Import  and  Export
  1671.                            items on the  Text menu and  are provided  as
  1672.                            command  line  options  to  allow  for   non-
  1673.                            interactive  use.  All  items  which  can  be
  1674.                            configured in ICONFIG can also be manipulated
  1675.                            by  exporting   an  existing   configuration,
  1676.                            editing  the   resulting   text   file,   and
  1677.                            importing the modified file.
  1678.  
  1679.  
  1680.  
  1681.             General
  1682.  
  1683.                            This section covers most of the general items
  1684.                            that may be set according to preference.
  1685.  
  1686.  
  1687.                Options
  1688.  
  1689.                            Selecting this item displays a form on  which
  1690.                            general operational options can be set:
  1691.  
  1692.                       Option         Description
  1693.  
  1694.  
  1695.  
  1696.                       Kbd Delay      If you  are using  an AT  or  later
  1697.                                      model computer (286, 386, 486 etc),
  1698.                                      then the two Kbd fields may be used
  1699.                                      to  set   the  keyboard   typomatic
  1700.                                      response speeds. Earlier models  of
  1701.                                      computer   do    not   have    this
  1702.                                      capability and  any  settings  here
  1703.                                      will have no effect.
  1704.  
  1705.                                      Delay is  the amount  of time  from
  1706.                                      when a key  is pressed  to when  it
  1707.                                      starts   automatically    repeating
  1708.                                      while held  down. A  shorter  delay
  1709.                                      increases the  sensitivity  of  key
  1710.  
  1711.  
  1712.  
  1713.  
  1714.             22                                                  InspectA
  1715.  
  1716.  
  1717.                                                            Configuration
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.                                      repeat. Options  range  from  250ms
  1724.                                      through  1000ms  (1/4  second  -  1
  1725.                                      second).
  1726.  
  1727.                       Kbd Speed      Speed is the rate at which keyboard
  1728.                                      repeat generates characters.
  1729.  
  1730.                                      If either of the Kbd fields is  set
  1731.                                      to Auto (the  default), repeat  key
  1732.                                      settings will  not  be  changed  by
  1733.                                      InspectA. Because there  is no  way
  1734.                                      to determine and save the  original
  1735.                                      typomatic settings are at  startup,
  1736.                                      InspectA will not attempt to  reset
  1737.                                      the  typomatic  rate  on  exit   or
  1738.                                      Shell.
  1739.  
  1740.                       View Path      This is used as a temporary holding
  1741.                                      area  for   files   extracted   for
  1742.                                      viewing from  compressed  archives.
  1743.                                      Only the drive  letter needs to  be
  1744.                                      valid in  the  given path,  as  the
  1745.                                      view path  itself will  be  created
  1746.                                      and deleted  as  required.  If  the
  1747.                                      path already exists when needed, it
  1748.                                      will not be deleted.
  1749.  
  1750.                       Dir Index      If enabled, this switch causes  the
  1751.                                      disk directory index to be  written
  1752.                                      to disk  and automatically  updated
  1753.                                      whenever a  directory  is  deleted,
  1754.                                      added or  renamed within  InspectA.
  1755.                                      See   Directory   Index   in    the
  1756.                                      Appendices for details.
  1757.  
  1758.                                      Enabling this option is  equivalent
  1759.                                      to  specifying   -m  on   INSPECT's
  1760.                                      command line.
  1761.  
  1762.                                      Irrespective of  this  setting,  or
  1763.                                      the   -m   command   line   switch,
  1764.                                      InspectA will still use a directory
  1765.                                      index if one  exists for the  drive
  1766.                                      being read.
  1767.  
  1768.                       Index File     This field  specifies the  name  of
  1769.                                      the  file  used  as  the  directory
  1770.                                      index.   The   default   name    is
  1771.  
  1772.  
  1773.  
  1774.  
  1775.             InspectA                                                  23
  1776.  
  1777.  
  1778.             Configuration
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.                                      DISKMAP.IND. If  you run  both  the
  1785.                                      MSDOS and OS/2 versions on the same
  1786.                                      machine, and  the filesystem  being
  1787.                                      used supports  long nams  (HPFS  or
  1788.                                      NetWare), it  is  better to  use  a
  1789.                                      different set  of index  files  for
  1790.                                      use in each mode.
  1791.  
  1792.                       Index Path     This specifies a subdirectory  name
  1793.                                      in which  the directory  files  are
  1794.                                      stored. If  left  blank,  the  root
  1795.                                      (top level) directory  is used.  If
  1796.                                      no drive letter is given, then  the
  1797.                                      subdirectory  on  the  drive  being
  1798.                                      read is  used -  it is  created  if
  1799.                                      necessary. If  a  drive  letter  is
  1800.                                      specified, then all directory index
  1801.                                      files  are  stored  in  the   named
  1802.                                      directory on  the nominated  drive,
  1803.                                      with the first  letter of the  file
  1804.                                      being  substituted  for  the  drive
  1805.                                      letter. This is useful for  storing
  1806.                                      and updating directory index  files
  1807.                                      on read-only network drives or  CD-
  1808.                                      ROM.
  1809.  
  1810.                       Net Path Only  If this switch is enabled, InspectA
  1811.                                      will only use the given Index  Path
  1812.                                      for  network  and  CD-ROM   drives.
  1813.                                      Local  logical  drive  indices  are
  1814.                                      stored  in  the  index  file   name
  1815.                                      nominated in the root directory  of
  1816.                                      the drive.
  1817.  
  1818.                       Archiver       This selects the archive type  used
  1819.                                      by  default  when   adding  to   or
  1820.                                      creating archives.
  1821.  
  1822.                       Filedesc       These  fields  determine  how  file
  1823.                                      descriptions are stored on disk  in
  1824.                                      description files.  The Fill  entry
  1825.                                      determines   which    column    the
  1826.                                      description starts in. A value of 0
  1827.                                      causes  only   one  space   to   be
  1828.                                      inserted between  the filename  and
  1829.                                      description  irrespective  of   the
  1830.                                      filename  length.  You  can   force
  1831.                                      upper-  or  lower-  case  for   the
  1832.  
  1833.  
  1834.  
  1835.  
  1836.             24                                                  InspectA
  1837.  
  1838.  
  1839.                                                            Configuration
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.                                      filename by selection  in the  Case
  1846.                                      field.  If  Default  is   selected,
  1847.                                      InspectA uses uppercase under MSDOS
  1848.                                      and under OS/2 uses the filename as
  1849.                                      it appears on disk.
  1850.  
  1851.                       Filename       These    fields    determine    the
  1852.                                      appearance of filenames in the File
  1853.                                      Manager  display.  Cols  determines
  1854.                                      the maximum width of filenames, and
  1855.                                      Case forces upper-,  lower- or  the
  1856.                                      default   case   (uppercase   under
  1857.                                      MSDOS,   and   according   to   the
  1858.                                      filesystem under OS/2).
  1859.  
  1860.                       Desc Cols      This determines the  length of  the
  1861.                                      description item  in the  displayed
  1862.                                      files list.  If  set to  zero,  the
  1863.                                      description is considered to be  of
  1864.                                      unlimited length.
  1865.  
  1866.                       Dirname Case   Allows upper- or lower- case to  be
  1867.                                      forced  for   directory  names   as
  1868.                                      displayed in the files list.
  1869.  
  1870.                       Hide Menus     By  default,  InspectA  displays  a
  1871.                                      menu bar  on the  top line  of  the
  1872.                                      screen. This menu  can be  selected
  1873.                                      using  the  Alt   key  (press   and
  1874.                                      release) or the forward slash  key.
  1875.                                      This  menu  can  be  hidden   until
  1876.                                      selected by enabling this option.
  1877.  
  1878.                       Title Justify  This determines  placement  of  the
  1879.                                      directory title on windows.
  1880.  
  1881.                       Title Fill     The entry in this field is used  as
  1882.                                      a fill character on the title  bar.
  1883.                                      This is  an ASCII  code, between  0
  1884.                                      and 255;  the default  of 0  causes
  1885.                                      spaces   to    be   used.    Likely
  1886.                                      candidates are  176, 177,  178  and
  1887.                                      219.
  1888.  
  1889.                       No 'Hot' Alt   This disables the default action of
  1890.                                      the    ALT   key.    In    windowed
  1891.                                      environments  (OS/2   PM  or   WPS,
  1892.                                      DESQview,  Windows)   the   default
  1893.  
  1894.  
  1895.  
  1896.  
  1897.             InspectA                                                  25
  1898.  
  1899.  
  1900.             Configuration
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.                                      action on  pressing  and  releasing
  1907.                                      the ALT key may cause problems.
  1908.  
  1909.                       Enable Stats   InspectA  may  optionally   display
  1910.                                      disk  statistics  on  a  background
  1911.                                      window when  the  File  Manager  is
  1912.                                      active.  There  is  a   performance
  1913.                                      penality in doing so, however,  and
  1914.                                      on  slower   systems   or   systems
  1915.                                      running multitasking software,  the
  1916.                                      refresh  required   to  keep   this
  1917.                                      display  up  to   date  may   cause
  1918.                                      InspectA to appear  to run  slowly.
  1919.                                      This is particularly noticable when
  1920.                                      accessing a remote (network) drive.
  1921.  
  1922.                                      Even if  disabled, disk  statistics
  1923.                                      can still be toggled on and off  by
  1924.                                      using ALT-F5, or viewed with  CTRL-
  1925.                                      BACKSPACE.
  1926.  
  1927.  
  1928.                Programs
  1929.  
  1930.                            These fields determine the external edit  and
  1931.                            view programs used by  INSPECT. If the  Edit,
  1932.                            View and Scan program fields are left  blank,
  1933.                            InspectA uses Q as editor (this is the  usual
  1934.                            name used by  SemWare's QEDIT program),  LIST
  1935.                            (by Vernon D. Buerg) as file viewer and  SCAN
  1936.                            /NOMEM /SUB (by McAfees & Assoc) as the virus
  1937.                            scan program.
  1938.  
  1939.                            DOS version only: The Edit mem, View mem  and
  1940.                            Scan  mem  fields  determine  how  memory  is
  1941.                            managed  when  the  editor,  view  and   scan
  1942.                            programs  are  invoked.  These  are  used  to
  1943.                            specify the  maximum amount  of memory  -  in
  1944.                            kilobytes  -  used  by  each  program.  These
  1945.                            optimise  program  image  swapping,  so  that
  1946.                            InspectA will  only  swap when  necessary  to
  1947.                            make sure sufficient memory will be free. Two
  1948.                            special values may also  be used; '0'  causes
  1949.                            InspectA to unconditionally swap when program
  1950.                            image swapping  has  been enabled,  and  '-1'
  1951.                            will   prevent    InspectA   from    swapping
  1952.                            irrespective of that setting.
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.             26                                                  InspectA
  1959.  
  1960.  
  1961.                                                            Configuration
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.                            Note that swapping must  be enabled for  this
  1968.                            to work correctly (see next section).
  1969.  
  1970.  
  1971.                Swapping
  1972.  
  1973.                            This item applies only the the MSDOS version.
  1974.  
  1975.                            The  items   under   this   heading   control
  1976.                            InspectA's program image swapping capability.
  1977.                            Using this technique, InspectA removes itself
  1978.                            almost completely  from memory  when  running
  1979.                            external programs, consuming less than 2K  of
  1980.                            memory,  and  providing  as  much  memory  as
  1981.                            possible to the program being run.
  1982.  
  1983.                            The Swap Path field should specify where  the
  1984.                            program image  file  is  to  be  placed  when
  1985.                            attempting to swap to disk. This will be used
  1986.                            whenever swap to  disk is selected,  or as  a
  1987.                            fall-back if insufficient  XMS or EMS  memory
  1988.                            is available  to contain  the entire  program
  1989.                            image. This should  be a valid  path, and  be
  1990.                            guaranteed to have at least 350K free at  all
  1991.                            times,   otherwise    swapping   will    fail
  1992.                            preventing  execution  of  external  programs
  1993.                            with swapping. InspectA will never execute an
  1994.                            external program unless sufficient memory  is
  1995.                            available, and if  swapping is enabled,  that
  1996.                            also means  that sufficient  space should  be
  1997.                            available for program image swapping.
  1998.  
  1999.                            If swap to disk is enabled by default, or  if
  2000.                            you have less than one megabyte of EMS or XMS
  2001.                            free, then for performance reasons, the  path
  2002.                            specified would be best placed on a fast disk
  2003.                            drive or RAM disk (virtual disk drive created
  2004.                            in memory). If you have  a choice of using  a
  2005.                            RAM disk or allocating that memory to XMS, it
  2006.                            is usually much better used as XMS.
  2007.  
  2008.                            Swap Type  allows  you to  select  where  the
  2009.                            program image is  to be stored.  This is  one
  2010.                            of:
  2011.  
  2012.                            XMS       Extended memory; requires an XMS
  2013.                                      2.0+ driver
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.             InspectA                                                  27
  2020.  
  2021.  
  2022.             Configuration
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.                            EMS       Expanded memory; requires a LIMS
  2029.                                      3.2 or 4.0 compatible EMS driver
  2030.                            Disk      Uses a disk file to store the
  2031.                                      program image This is the slowest
  2032.                                      of the three swapping methods
  2033.                            None      Selecting this (the default)
  2034.                                      disables program image swapping
  2035.                                      completely
  2036.                            Selecting XMS or EMS will cause disk swapping
  2037.                            to be used as  a fall-back. Because of  this,
  2038.                            you should ensure that the path nominated  in
  2039.                            the Swap Path field is valid.
  2040.  
  2041.  
  2042.                Video
  2043.  
  2044.                            These options  relate to  video handling.  On
  2045.                            some hardware, these may cause strange  side-
  2046.                            effects,  so   you  should   be  careful   in
  2047.                            specifying   or   overriding   any   of   the
  2048.                            standards.  While  highly  unlikely,  it   is
  2049.                            remotely possible that  you can cause  damage
  2050.                            to your video hardware by selecting the wrong
  2051.                            options. Be sure to  consult the manuals  for
  2052.                            your   video   card   and   monitor    before
  2053.                            experimenting.
  2054.  
  2055.                       Entry          Description
  2056.  
  2057.  
  2058.  
  2059.                       Video Mode     Selects the default  video mode  to
  2060.                                      use:
  2061.  
  2062.                            Auto      Use the video mode and screen  size
  2063.                                      current when  InspectA is  started.
  2064.                                      This causes InspectA not to  change
  2065.                                      screen mode,  but to  adapt to  the
  2066.                                      existing one (this is the default).
  2067.  
  2068.                            25        Force 25 line mode. If InspectA  is
  2069.                                      started when in 43/50 line mode, it
  2070.                                      sets 25 line mode before.
  2071.  
  2072.                            43/50     Sets 43 (EGA) or 50 (VGA) line mode
  2073.                                      if not  already in  those modes  on
  2074.                                      startup
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.             28                                                  InspectA
  2081.  
  2082.  
  2083.                                                            Configuration
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.                            Custom    This provides the ability to switch
  2090.                                      Super-VGA  and  other  video  cards
  2091.                                      with  special  mode  support   into
  2092.                                      "extended"  mode  as  InspectA   is
  2093.                                      invoked, offering  the  ability  to
  2094.                                      run the program in 132 column  mode
  2095.                                      or make use  of some other  unusual
  2096.                                      text mode.
  2097.  
  2098.                       Custom Mode    [MSDOS] When Custom is selected  in
  2099.                                      the video mode  field, this is  the
  2100.                                      mode number (in  decimal) used.  Be
  2101.                                      sure to  consult the  documentation
  2102.                                      for you  video  card  before  using
  2103.                                      this option.
  2104.  
  2105.                                      As an indication, SVGA cards  based
  2106.                                      on the ET-4000  chip use modes  52,
  2107.                                      54 and 56 for various types of  132
  2108.                                      column mode, and those based on the
  2109.                                      Trident 8900 series chip use  modes
  2110.                                      82, 84 and 86.
  2111.  
  2112.                       Custom Rows / Cols  [OS/2] This option allows  you
  2113.                                      to select  the number  of rows  and
  2114.                                      columns  to  use  on  startup.  The
  2115.                                      entries supplied here must be valid
  2116.                                      for your display adaptor - for full
  2117.                                      screen use, 80  or 132 columns  may
  2118.                                      be  used   with   SVGA   and   XVGA
  2119.                                      hardware, and the number of  colums
  2120.                                      according to what  is supported  by
  2121.                                      the display  adaptor (this  depends
  2122.                                      on the availability of text display
  2123.                                      fonts). In PM or WPS windows on the
  2124.                                      desktop, only  80  columns  may  be
  2125.                                      used (but rows  may be  set to  any
  2126.                                      number 1 to 255.
  2127.  
  2128.                                      Note  that  in  order  to  use  132
  2129.                                      columns, you  must  have  installed
  2130.                                      the appropriate display drivers and
  2131.                                      used the  SVGA  utility to  set  up
  2132.                                      SVGADATA.PMI    in    your     OS/2
  2133.                                      directory.
  2134.  
  2135.                       Set Mode       This  option   is   the   same   as
  2136.                                      specifying -vs on the command line.
  2137.  
  2138.  
  2139.  
  2140.  
  2141.             InspectA                                                  29
  2142.  
  2143.  
  2144.             Configuration
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.                                      It causes any mode changes made  as
  2151.                                      a result of  setting the Video  and
  2152.                                      Custom  Mode   fields   to   become
  2153.                                      'permanent', so that InspectA  will
  2154.                                      leave the  screen in  the  selected
  2155.                                      mode on  exist,  and  when  running
  2156.                                      external programs.
  2157.  
  2158.                       Background     This   field   selects   background
  2159.                                      intensity or blinking.
  2160.  
  2161.                       Dir Window     Determines the default size of  the
  2162.                                      directory  window   (this  can   be
  2163.                                      changed  in  InspectA  using  CTRL-
  2164.                                      ENTER.
  2165.  
  2166.                       Screenblank    This is  the number  of minutes  of
  2167.                                      inactivity  before  InspectA   will
  2168.                                      blank the screen. The default entry
  2169.                                      of zero disables this feature.
  2170.  
  2171.                       Rescan Time    On   multituser   or   multitasking
  2172.                                      systems, the disk may be changed by
  2173.                                      other  tasks.   To  have   InspectA
  2174.                                      periodically  rescan  the   current
  2175.                                      directory
  2176.  
  2177.                       Frame (A)      Sets the frame type for the  active
  2178.                                      (current)  window   in  the   Files
  2179.                                      Manager.
  2180.  
  2181.                       Frame (B)      Sets  the   frame  type   for   all
  2182.                                      inactive  (non-current)  window  in
  2183.                                      the Files Manager.
  2184.  
  2185.  
  2186.                Mouse
  2187.  
  2188.                            This set of fields controls InspectA's use of
  2189.                            a MicroSoft  or  compatible  mouse.  For  the
  2190.                            mouse to become active and available for use,
  2191.                            InspectA requires that a mouse driver also be
  2192.                            present; these  are typically  supplied  with
  2193.                            the mouse itself, and you should ensure  that
  2194.                            this is loaded  in your  AUTOEXEC.BAT, or  at
  2195.                            some  point  when  you  computer  starts  and
  2196.                            before running InspectA.
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.             30                                                  InspectA
  2203.  
  2204.  
  2205.                                                            Configuration
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.                            Under OS/2, you  should have the  appropriate
  2212.                            pointer device drivers loaded in CONFIG.SYS.
  2213.  
  2214.                            Fields on the mouse controls window are:
  2215.  
  2216.                       Entry          Description
  2217.  
  2218.  
  2219.  
  2220.                       Use Mouse      This is  an  enable/disable  switch
  2221.                                      for the  mouse. To  enable,  select
  2222.                                      Yes, to disable, select No.
  2223.  
  2224.                       Mouse Pointer  This field provides the ability  to
  2225.                                      select the  type of  mouse  pointer
  2226.                                      that InspectA  uses.  The  Standard
  2227.                                      mouse pointer  is a  simple  block,
  2228.                                      with the background and  foreground
  2229.                                      colours    reversed    from     the
  2230.                                      surrounding  text.  Other  pointers
  2231.                                      available   are   Diamond    (white
  2232.                                      diamond)   and   Triangle   (yellow
  2233.                                      triangle).   Chose   according   to
  2234.                                      preference.
  2235.  
  2236.                       Mouse Speed    This sets  the  mouse  sensitivity;
  2237.                                      Auto leaves the current sensitivity
  2238.                                      unchanged  (this  is  usually   the
  2239.                                      mouse  driver  default),  and  Slow
  2240.                                      through  V.Fast  set  the  movement
  2241.                                      ratio (the  ratio between  distance
  2242.                                      that the mouse physically moves and
  2243.                                      the distance the  pointer moves  on
  2244.                                      the screen). Use the speed that you
  2245.                                      feel most comfortable with.
  2246.  
  2247.                       SVGA Mouse     Under MSDOS, most  versions of  the
  2248.                                      MicroSoft mouse  driver  (MOUSE.COM
  2249.                                      or  MOUSE.SYS)  do  not   correctly
  2250.                                      support 132 column mode.   Logitech
  2251.                                      mouse drivers, which  do work  with
  2252.                                      MicroSoft compatible mouse devices,
  2253.                                      do seem to support 132 column  mode
  2254.                                      correctly.
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.             InspectA                                                  31
  2264.  
  2265.  
  2266.             Configuration
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.                Colours
  2273.  
  2274.                            This selection provides  the facility to  re-
  2275.                            define InspectA's colour scheme.
  2276.  
  2277.                            Internally, InspectA  contains two  attribute
  2278.                            "palettes". The first is used if the  monitor
  2279.                            being used supports colour, and the second is
  2280.                            used if it supports only monochrome or  black
  2281.                            and white.  Since it  is  possible to  use  a
  2282.                            graphics  adaptor  that  supports  colour  to
  2283.                            display on  a  monochrome  or  at  least  two
  2284.                            colour only display, both INSPECT and ICONFIG
  2285.                            support -vm  (monochrome)  and  -vc  (colour)
  2286.                            switches to force the  program to use  either
  2287.                            one of the two palettes.
  2288.  
  2289.                            ICONFIG provides  the  ability to  edit  both
  2290.                            attribute palettes, irrespective of the  type
  2291.                            of  display  being  used.  On  selecting  the
  2292.                            Colours option from the General menu, you are
  2293.                            requested to  select  either  the  Colour  or
  2294.                            Black & White palette.
  2295.  
  2296.                            After the  palette  has  been  selected,  the
  2297.                            colour configuration section is displayed. On
  2298.                            the left-hand  side of  the screen,  a  chart
  2299.                            shows a map  of all  possible attributes.  To
  2300.                            its right  is  a  list  of  all  the  various
  2301.                            attributes by  description, with  the  colour
  2302.                            corresponding  to   the  currently   selected
  2303.                            attribute highlighted on the chart.   Beneath
  2304.                            both of  these  is  a figure  with  a  sample
  2305.                            screen, so  you  can  more  readily  see  the
  2306.                            results of your selection.
  2307.  
  2308.                            To  change   the   colour   mapped   to   the
  2309.                            highlighted function,  press  ENTER. You  may
  2310.                            then use the  ARROW keys to  move around  the
  2311.                            chart, and examine the  sample at the  bottom
  2312.                            of the  chart and  watch  the effect  of  any
  2313.                            changes on the example screen. Pressing SPACE
  2314.                            causes  the   background  attribute   to   be
  2315.                            toggled; either non-blinking to blinking  and
  2316.                            vice versa,  or  intense  to  dull  and  vice
  2317.                            versa, according to  the setting of  "Intense
  2318.                            background" in the Video section.
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.             32                                                  InspectA
  2325.  
  2326.  
  2327.                                                            Configuration
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.                            When you are  happy with  your choice,  press
  2334.                            ENTER to keep it,  or ESC to abort selection
  2335.                            and restore the previously used colour.
  2336.  
  2337.                            You can use  the  ARROW keys to  move up  and
  2338.                            down the list,  to select and  change any  of
  2339.                            the attributes used  by INSPECT and  ICONFIG.
  2340.                            Once you are happy with your selection, press
  2341.                            ESC or the  right mouse button  to return  to
  2342.                            the previous screen. At  this point, you  may
  2343.                            either confirm  that  you wish  to  keep  the
  2344.                            current  colour  selection,  or  abandon  any
  2345.                            changes you have made.  If you elect to  keep
  2346.                            your changes, they are  not (yet) written  to
  2347.                            disk, but ICONFIG itself  will be set to  use
  2348.                            the new colour  selection. These are  written
  2349.                            to  disk   after  the   prompt  on   existing
  2350.                            InspectA.
  2351.  
  2352.                            After setting  up the  colour setup  to  your
  2353.                            requirements, press ESC to exit, and confirm
  2354.                            that you wish to use the changes made. If you
  2355.                            select Yes and  the palette  you changed  was
  2356.                            the  current   one  in   use,  ICONFIG   will
  2357.                            redisplay in the new palette.
  2358.  
  2359.                            Because it is  possible to configure  colours
  2360.                            that can  result in  a completely  unreadable
  2361.                            display, ICONFIG  provides  the  facility  to
  2362.                            quickly  reset  all  colours  back  to  their
  2363.                            original defaults. After selecting General  -
  2364.                            Colours and deciding which palate to  modify,
  2365.                            press  F9 to  reset. After  confirmation, the
  2366.                            attribute  settings  are  reset  and  ICONFIG
  2367.                            redisplayed using the original palette.
  2368.  
  2369.  
  2370.                Filelist
  2371.  
  2372.                            This   section   provides   the   option   of
  2373.                            customising the  format  of  directory  lists
  2374.                            presented by the File  Manager.  By  default,
  2375.                            InspectA uses three pre-defined formats,  but
  2376.                            you can delete these, add your own or  modify
  2377.                            them according to  your needs.  At least  one
  2378.                            list format must be defined; if not, InspectA
  2379.                            will automatically use the three  pre-defined
  2380.                            formats.
  2381.  
  2382.  
  2383.  
  2384.  
  2385.             InspectA                                                  33
  2386.  
  2387.  
  2388.             Configuration
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.                            Within INSPECT,  the  format of  the  current
  2395.                            list window may  be cycled  using the  ALT-F8
  2396.                            key. The format used  in each window is  also
  2397.                            saved and  restored with  the window  layout;
  2398.                            you can save the  current layout at any  time
  2399.                            by pressing ALT-F9.
  2400.  
  2401.                            Selecting  FileList  from  the  General  menu
  2402.                            displays a list of defined formats. To Add  a
  2403.                            new format, press INS. To Delete an existing
  2404.                            format, highlight the entry and press DEL. To
  2405.                            Modify a  format,  highlight it,  moving  the
  2406.                            cursor line with the ARROW keys or the mouse
  2407.                            to select the entry,  and press  F2, ENTER or
  2408.                            left mouse button.
  2409.  
  2410.                            When  adding  or  modifying  formats,   enter
  2411.                            information into the form as follows:
  2412.  
  2413.                       Field          Descriptions
  2414.  
  2415.  
  2416.  
  2417.                       Format Name    Select a  nominal name  to use  for
  2418.                                      this   format.   This   should   be
  2419.                                      descriptive of the  type of  format
  2420.                                      being entered.
  2421.  
  2422.                       Col Scale
  2423.  
  2424.                       Row Scale      These fields determine the size  of
  2425.                                      new windows  opened  in  the  Files
  2426.                                      Manager. Internally, window scaling
  2427.                                      is calculated on a  256 row by  256
  2428.                                      column plane, but  the actual  size
  2429.                                      used is  recalculated according  to
  2430.                                      the size of the screen.  Therefore,
  2431.                                      a scale factor of  128 rows by  128
  2432.                                      columns will produce a window  half
  2433.                                      the size  of  the screen  width  by
  2434.                                      half the size of the screen height.
  2435.                                      Vary these according to preference.
  2436.  
  2437.                       Fields         You can now select up to 10  fields
  2438.                                      to display horizontally across  the
  2439.                                      list. Once  you have  selected  all
  2440.                                      the fields you wish to place on the
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.             34                                                  InspectA
  2447.  
  2448.  
  2449.                                                            Configuration
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.                                      list,    fill  all  the   remaining
  2456.                                      fields with "None".
  2457.  
  2458.                       Available field types are:
  2459.  
  2460.                            Marker         This   is   the   highlighting
  2461.                                           'mark', used to indicate  that
  2462.                                           a file has been selected. When
  2463.                                           selected, the highlighter will
  2464.                                           display from this field to the
  2465.                                           right of the list.
  2466.  
  2467.                            File Name      The  name  of   the  file   or
  2468.                                           directory.
  2469.  
  2470.                            Size           Size of the file.
  2471.  
  2472.                            Wr Date        Date that  the file  was  last
  2473.                                           written to.
  2474.  
  2475.                            Wr Time HH:MM  Time that  the file  was  last
  2476.                                           written to.
  2477.  
  2478.                            Wr Time HH:MM:SS    Time that  the  file  was
  2479.                                           last written to.
  2480.  
  2481.                            Attributes     These    show    the    file's
  2482.                                           attributes. Where an attribute
  2483.                                           is not set, the  corresponding
  2484.                                           letter (see below) is replaced
  2485.                                           by  a  dot.  When  set,   each
  2486.                                           attribute shows  a  letter  to
  2487.                                           indicate its meaning:
  2488.  
  2489.                                    s      System.   Files   with    this
  2490.                                           attribute  set  are   normally
  2491.                                           'special' in some way and  are
  2492.                                           regarded as being essential to
  2493.                                           operation of  the system;  ie.
  2494.                                           IO.SYS  and  MSDOS.SYS,  which
  2495.                                           are the MSDOS operating system
  2496.                                           files loaded  when the  system
  2497.                                           is started.  System files  are
  2498.                                           automatically hidden from view
  2499.                                           and will not normally  display
  2500.                                           when a DIR command is  entered
  2501.                                           at    the    prompt.    Unless
  2502.                                           overridden using InspectA's -a
  2503.  
  2504.  
  2505.  
  2506.  
  2507.             InspectA                                                  35
  2508.  
  2509.  
  2510.             Configuration
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.                                           command line switch, you  will
  2517.                                           not  see   these  files   from
  2518.                                           InspectA either.
  2519.  
  2520.                                    h      Hidden. Files with the  hidden
  2521.                                           attribute  are  not   normally
  2522.                                           displayed when an DIR  command
  2523.                                           is executed.
  2524.  
  2525.                                    r      Read-Only.    The    read-only
  2526.                                           attribute attempts to  prevent
  2527.                                           (or  at  least  warn  against)
  2528.                                           modification or deletion of  a
  2529.                                           file. Attempts to move or copy
  2530.                                           a read-only file with InspectA
  2531.                                           will  product  warnings,   but
  2532.                                           provided that the file can  be
  2533.                                           accessed  by  the  user   (ie.
  2534.                                           access  is  not  prevented  by
  2535.                                           means    of    a     network's
  2536.                                           permission scheme),  this  can
  2537.                                           be      overridden       after
  2538.                                           confirmation. Read-only  files
  2539.                                           are usually visible.
  2540.  
  2541.                                    a      Archive.    This     attribute
  2542.                                           provides a  simple system  for
  2543.                                           determining  when  files  have
  2544.                                           been updated or added since  a
  2545.                                           previous backup.  The  archive
  2546.                                           attribute is automatically set
  2547.                                           by   the   operating    system
  2548.                                           whenever  a  file  is  copied,
  2549.                                           created or  written  to  -  it
  2550.                                           will normally only be reset by
  2551.                                           a backup program.
  2552.  
  2553.                                    S      Shareable. This  attribute  is
  2554.                                           not  supported   directly   by
  2555.                                           MSDOS, but is  used on  Novell
  2556.                                           Networks to indicate that  the
  2557.                                           file  can  be  accessed   from
  2558.                                           multiple workstations at once.
  2559.                                           The    file    is    therefore
  2560.                                           "shareable".    Most    modern
  2561.                                           software   written   for   DOS
  2562.                                           versions  greater   than   3.1
  2563.                                           which is  network  aware  does
  2564.  
  2565.  
  2566.  
  2567.  
  2568.             36                                                  InspectA
  2569.  
  2570.  
  2571.                                                            Configuration
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.                                           not require this attribute  to
  2578.                                           be  set  in  order  to   allow
  2579.                                           multiple    workstations    to
  2580.                                           access files  - the  attribute
  2581.                                           is intended for use only where
  2582.                                           it can  be determined  that  a
  2583.                                           file or group of files can  be
  2584.                                           safely  accessed  by  software
  2585.                                           which is not network aware.
  2586.  
  2587.                                           This    attribute    is    not
  2588.                                           supported (nor needed) by  the
  2589.                                           OS/2 version
  2590.  
  2591.                            Type           This is the file type. This is
  2592.                                           determined  by   InspectA   by
  2593.                                           reading the  contents  of  the
  2594.                                           file  itself,  except  in  the
  2595.                                           case of directories, where  it
  2596.                                           is already known by virtue  of
  2597.                                           the  directory  attribute.  In
  2598.                                           most cases, InspectA will need
  2599.                                           to examine the file before  it
  2600.                                           can display the correct type -
  2601.                                           which is exactly what the Scan
  2602.                                           Files function is intended  to
  2603.                                           do. If a file has not yet been
  2604.                                           accessed,  or   if  the   type
  2605.                                           cannot be determined, InspectA
  2606.                                           will display a question mark "
  2607.                                           ? " in this field.
  2608.  
  2609.                            Description    If description files are  used
  2610.                                           (see the next option,  Lists),
  2611.                                           and a description is found for
  2612.                                           any particular file,  InspectA
  2613.                                           displays that  description  in
  2614.                                           this  field.   You  can   also
  2615.                                           update   (or    create)    the
  2616.                                           description list by using  the
  2617.                                           INS key  when  the  cursor  is
  2618.                                           highlighting  the   file   and
  2619.                                           description   you   wish    to
  2620.                                           update. If  a  description  is
  2621.                                           too long to fit on the screen,
  2622.                                           it is truncated  at the  right
  2623.                                           edge of the list.
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.             InspectA                                                  37
  2630.  
  2631.  
  2632.             Configuration
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.                            The remaining fields are available only under
  2639.                                           OS/2:
  2640.  
  2641.                            Cr Date        Date   that   the   file   was
  2642.                                           created.
  2643.  
  2644.                            Cr Time HH:MM  Time   that   the   file   was
  2645.                                           created.
  2646.  
  2647.                            Cr Time HH:MM:SS    Time that  the  file  was
  2648.                                           created.
  2649.  
  2650.                            Acc Date       Date   that   the   file   was
  2651.                                           accessed.
  2652.  
  2653.                            Acc Time HH:MM Time   that   the   file   was
  2654.                                           accessed.
  2655.  
  2656.                            Acc Time HH:MM:SS   Time that  the  file  was
  2657.                                           accessed.
  2658.  
  2659.                            ExtAttr Size   This is  the  size of  the  EA
  2660.                                           (extended attributes) for  the
  2661.                                           file.  A   value  of   -1   is
  2662.                                           displayed where this cannot be
  2663.                                           determined   (usually   as   a
  2664.                                           result of the file being  open
  2665.                                           by another process).
  2666.  
  2667.  
  2668.                Lists
  2669.  
  2670.                            InspectA  can   be  configured   to   support
  2671.                            comments for any file or directory, and store
  2672.                            these in a separate file.
  2673.  
  2674.                            This option provides a way of determining how
  2675.                            file descriptions are stored on disk. Leaving
  2676.                            this list of "description files" empty causes
  2677.                            InspectA to not support file descriptions  at
  2678.                            all. Entering multiple description file names
  2679.                            provides   more   flexibility   in   allowing
  2680.                            InspectA to use any  one of a particular  set
  2681.                            of files. Each file is tried in turn until  a
  2682.                            match is found.
  2683.  
  2684.                            Use of description  files supports this  same
  2685.                            facility in 4DOS , which stores file comments
  2686.  
  2687.  
  2688.  
  2689.  
  2690.             38                                                  InspectA
  2691.  
  2692.  
  2693.                                                            Configuration
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.                            in a file by the name of "DESCRIPT.ION".  the
  2700.                            4DOS DIR command displays these descriptions.
  2701.                            Similarly, BBS  operators use  similar  files
  2702.                            ("FILES.BBS"  or  "@FILES")  to  store   this
  2703.                            information.
  2704.  
  2705.                            Note that this release  of InspectA does  not
  2706.                            support  comment  fields  in  OS/2   extended
  2707.                            attributes. This  is  planned  for  a  future
  2708.                            release.
  2709.  
  2710.                            The description  file  simply  contains  each
  2711.                            file name described, followed by one or  more
  2712.                            spaces or tabs,  and a  comment. The  comment
  2713.                            for any individual file  must be on a  single
  2714.                            line, and  can  be  up  to  1024  bytes  long
  2715.                            (InspectA will  internally truncate  anything
  2716.                            greater than this).
  2717.  
  2718.                            To Add a new description file name, press INS
  2719.                            and enter the  name into  the form  supplied.
  2720.                            Press ENTER or F10 to save. To Modify a name,
  2721.                            press  ENTER or   F2 after  highlighting  the
  2722.                            entry you  wish  to  edit  in  the  list.  To
  2723.                            Delete, use the DEL key.
  2724.  
  2725.                            Because the  order  of  files  in  this  list
  2726.                            determines the  priority in  which the  names
  2727.                            will be used  (for example,  when creating  a
  2728.                            description file in a directory which did not
  2729.                            previously contain one, InspectA will  always
  2730.                            use the first  entry in  this list),  ICONFIG
  2731.                            provides  the  ability  to  reorder   entries
  2732.                            easily. Simply hold  down the  SHIFT key and
  2733.                            move in the same direction in which you  wish
  2734.                            move the entry. As  the cursor moves, so  the
  2735.                            currently highlighted  entry will  move  with
  2736.                            it. This works  with all the  cursor-movement
  2737.                            keys.
  2738.  
  2739.  
  2740.  
  2741.             Archive
  2742.  
  2743.                            The Archive  section provides  the  interface
  2744.                            between    InspectA    and    the     archive
  2745.                            creation/management   programs    themselves.
  2746.                            While InspectA has  some intrinsic  knowledge
  2747.  
  2748.  
  2749.  
  2750.  
  2751.             InspectA                                                  39
  2752.  
  2753.  
  2754.             Configuration
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.                            about the various archive formats in order to
  2761.                            read their "directory", it does not implement
  2762.                            any  compression  or  decompression  routines
  2763.                            itself, but instead uses external programs to
  2764.                            carry out these tasks.  At least one  command
  2765.                            template must be  defined for each  operation
  2766.                            and archive type in order for that  operation
  2767.                            to be available.
  2768.  
  2769.                            The list presented when the Archive option is
  2770.                            selected from  the Main  Menu shows  all  the
  2771.                            defined archive operation; each member of the
  2772.                            list represents a  "command template",  which
  2773.                            consists  of  a  program  name  and   program
  2774.                            command  line  arguments,  including   macros
  2775.                            which are  used  to insert  the  archive  and
  2776.                            member file names when the program is run.
  2777.  
  2778.                            To Add an entry to this table, press  INS. To
  2779.                            Delete, press DEL. To Modify or view details,
  2780.                            press  ENTER or  F2 or  by clicking  the left
  2781.                            mouse button on a highlighted entry.
  2782.  
  2783.                            This list  also  provides a  Clone  function,
  2784.                            where the current entry can be copied and the
  2785.                            new entry edited. This is activated by  using
  2786.                            SHIFT-INSERT.
  2787.  
  2788.                            Following is  the  list of  fields  presented
  2789.                            during add or modify:
  2790.  
  2791.                       Field          Description
  2792.  
  2793.  
  2794.  
  2795.                       Arcv Type      Select the  archive type  from  the
  2796.                                      list presented.
  2797.  
  2798.                       Operation      One  of  the  following   operation
  2799.                                      types must be selected:
  2800.  
  2801.                                 Extract   Extract one or more files from
  2802.                                           an archive.
  2803.  
  2804.                                 Delete    Remove files from an archive
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.             40                                                  InspectA
  2813.  
  2814.  
  2815.                                                            Configuration
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.                                 Add       Add  files   to   an   archive
  2822.                                           (including  creating   a   new
  2823.                                           archive from a list of files)
  2824.  
  2825.                                 Test      Test archive  and member  file
  2826.                                           integrity
  2827.  
  2828.                                 Extract-recursive   This option use used
  2829.                                           for  archive  repacking,   and
  2830.                                           provides   teh   command    to
  2831.                                           extract   files    in    their
  2832.                                           original   directories   (this
  2833.                                           ability is  optional with  the
  2834.                                           standard Extract operation).
  2835.  
  2836.                                 Add-recursive  This  is   for   commands
  2837.                                           which  add   files  from   the
  2838.                                           current  directory   and   all
  2839.                                           subdirectories (if any).  This
  2840.                                           is  also  only  used  by   the
  2841.                                           archive re-pack option.
  2842.  
  2843.                                      If an  archiver  does  not  support
  2844.                                      paths (such as ARC v5.0), you  must
  2845.                                      nevertheless  define  at  least  an
  2846.                                      extract-recursive command in  order
  2847.                                      to repack  archives of  this  type.
  2848.                                      Failing to provide an add-recursive
  2849.                                      command  in  such  cases  is  wise,
  2850.                                      since it prevents possible loss  of
  2851.                                      files  when   converting  from   an
  2852.                                      archive containing  directories  to
  2853.                                      one which does not.
  2854.  
  2855.                       Extension      This is  the usual  file  extension
  2856.                                      assumed by the archive program  for
  2857.                                      its  archives.  This  is  used   to
  2858.                                      determine in an intelligent way the
  2859.                                      type of archive to create on  entry
  2860.                                      of a  new  archive name,  and  also
  2861.                                      nominates the extension to use when
  2862.                                      repacking from one archive type  to
  2863.                                      another.
  2864.  
  2865.                       Command        This  is   the  command   template.
  2866.                                      Nothing is  added to  this  command
  2867.                                      automatically,  so   if  you   need
  2868.                                      information to be  placed onto  the
  2869.  
  2870.  
  2871.  
  2872.  
  2873.             InspectA                                                  41
  2874.  
  2875.  
  2876.             Configuration
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.                                      command line, you must use  macros,
  2883.                                      which are substituted at runtime by
  2884.                                      the file names as required. See the
  2885.                                      following section  for  a  complete
  2886.                                      description of macros available.
  2887.  
  2888.                       Wildcard       As an optimisation, InspectA treats
  2889.                                      the operations involving all  files
  2890.                                      in a  directory (when  adding  Add)
  2891.                                      and all  files in  an archive  (for
  2892.                                      Extract and  Delete) as  a  special
  2893.                                      case; instead of listing individual
  2894.                                      files,   a   Wildcard   is    used,
  2895.                                      indicating to  the archive  command
  2896.                                      that   all   files   need   to   be
  2897.                                      processed. Typically,  this  avoids
  2898.                                      the  need   to  run   the   command
  2899.                                      multiple times to  process a  large
  2900.                                      list of files.
  2901.  
  2902.                                      Various archive  programs handle  a
  2903.                                      Wildcard  operation  in   different
  2904.                                      ways. Many of them assume all files
  2905.                                      if  this  field  is  empty;  others
  2906.                                      require  "*.*"   or   simply   "*".
  2907.                                      Consult   the    archive    program
  2908.                                      documentation for details.
  2909.  
  2910.                       Memory         [MSDOS] This  field  specifies  the
  2911.                                      amount of memory which must be free
  2912.                                      in order to  run the command.  This
  2913.                                      is used  by  INSPECT  to  determine
  2914.                                      whether or not to swap its  program
  2915.                                      image  to  XMS,  EMS  or  disk.  If
  2916.                                      sufficient memory  is free  to  run
  2917.                                      the program without swapping,  then
  2918.                                      swapping is  avoided  resulting  in
  2919.                                      faster execution.
  2920.  
  2921.                                      If this field is set to 0, swapping
  2922.                                      will  always  be  enabled  for  the
  2923.                                      command irrespective of the  amount
  2924.                                      of free memory unless swapping  has
  2925.                                      been   disabled    globally    (see
  2926.                                      Configuration,  General).   It   is
  2927.                                      advisable to  use this  setting  in
  2928.                                      most cases unless  you are sure  of
  2929.                                      the correct memory requirements. If
  2930.  
  2931.  
  2932.  
  2933.  
  2934.             42                                                  InspectA
  2935.  
  2936.  
  2937.                                                            Configuration
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.                                      set  to  -1,  swapping  is   always
  2944.                                      prevented.
  2945.  
  2946.  
  2947.                Macros
  2948.  
  2949.                            Archiving commands are  expressed as  command
  2950.                            templates.  This  means  that  before  it  is
  2951.                            executed, certain character sequences - known
  2952.                            as macros  - are  replaced with  the  archive
  2953.                            name, member names or file names.
  2954.  
  2955.                            All  macro   sequences  commence   with   the
  2956.                            character '$'.  If  you wish  to  insert  the
  2957.                            literal character '$' into a command line for
  2958.                            any  reason,  you  must   use  two  of   them
  2959.                            consecutively.
  2960.  
  2961.                            The list of macro strings are as follows:
  2962.  
  2963.                       Macro          Replaced with
  2964.  
  2965.  
  2966.  
  2967.                       $a             Archive name.
  2968.  
  2969.                       $p             Current directory.
  2970.  
  2971.                       $f             File name (add)  or member  (delete
  2972.                                      or modify). If  more than one  file
  2973.                                      or member  is marked,  the  command
  2974.                                      line  will  be  executed   multiple
  2975.                                      times with each of the marked  file
  2976.                                      names substituted in turn until the
  2977.                                      list  of  files  is  exhausted.  If
  2978.                                      there  are  no  members  or   files
  2979.                                      marked, the current file or  member
  2980.                                      is used, and  the command  executed
  2981.                                      only once.
  2982.  
  2983.                       $m             Multiple file names; if no files or
  2984.                                      members are marked, the current  is
  2985.                                      used,  otherwise,   the  names   of
  2986.                                      marked files or  members are  used.
  2987.                                      The  command   is  still   executed
  2988.                                      multiple times if the command  line
  2989.                                      would otherwise  exceed  the  MSDOS
  2990.                                      maximum of 126 characters.
  2991.  
  2992.  
  2993.  
  2994.  
  2995.             InspectA                                                  43
  2996.  
  2997.  
  2998.             Configuration
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.                                      Note that  the command  line  limit
  3005.                                      for OS/2 is  much larger.  InspectA
  3006.                                      will internally  limit  the  length
  3007.                                      given   to    programs   to    1024
  3008.                                      characters, however.
  3009.  
  3010.                       $r             A  redirect  list  (also  called  a
  3011.                                      response file), which contains  the
  3012.                                      names  of  files   or  members   to
  3013.                                      operate on.  Many archive  programs
  3014.                                      accept this  format -  the file  is
  3015.                                      simply a  list  of  file  names  to
  3016.                                      process;  the  file  name  actually
  3017.                                      substituted   for   '$r'   is   the
  3018.                                      temporary file name containing  the
  3019.                                      list.
  3020.  
  3021.                       $$             is replaced by $.
  3022.  
  3023.  
  3024.  
  3025.                            The macros  '$a',  '$f', '$m'  and  '$r'  may
  3026.                            contain fully  qualified path  names. In  the
  3027.                            case of archive  member files, the  directory
  3028.                            name may or may not  be present. It is  often
  3029.                            convenient to not  use the directory  portion
  3030.                            of these  names,  so the  following  list  of
  3031.                            modifiers may  be added  to these  macros  to
  3032.                            either omit or only  use parts. The  modifier
  3033.                            is a single character and is placed after the
  3034.                            '$' and prior the 'a', 'f', 'm' or 'r'  (note
  3035.                            that with the  macro '$r', the  path name  of
  3036.                            the files placed into  the redirect list  are
  3037.                            affected by the modifier, not the name of the
  3038.                            temporary file used).
  3039.  
  3040.                       Modifier       Description
  3041.  
  3042.  
  3043.  
  3044.                       +              (plus)   Remove    the    directory
  3045.                                      portion.
  3046.  
  3047.                       -              (minus) Remove the extension.
  3048.  
  3049.                       =              (equals) Remove both the  directory
  3050.                                      and extension.
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.             44                                                  InspectA
  3057.  
  3058.  
  3059.                                                            Configuration
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.                       _              (underline)  Remove  the  directory
  3066.                                      and file portion (leaving only  the
  3067.                                      file extension).
  3068.  
  3069.                       .              (period) Remove  any trailing  dots
  3070.                                      from filenames
  3071.  
  3072.                       #              (hash)  Use  forward  slash  as   a
  3073.                                      directory separator.
  3074.  
  3075.                            As  an  example,  given  that  the  macro  $a
  3076.                                      equals:
  3077.  
  3078.  
  3079.                                 C:\ARCHIVES\MYFILE.ZIP
  3080.  
  3081.                            the following macros evaluate to:
  3082.  
  3083.  
  3084.                                 $a   C:\ARCHIVES\MYFILE.ZIP
  3085.                                 $+a  MYFILE.ZIP
  3086.                                 $-a  C:\ARCHIVES\MYFILE
  3087.                                 $=a  MYFILE
  3088.                                 $_a  ZIP
  3089.                                 $#a  C:/ARCHIVES/MYFILE.ZIP
  3090.  
  3091.                            Note  that   modifiers   can   be   used   in
  3092.                            combination.
  3093.  
  3094.  
  3095.  
  3096.             Mailer
  3097.  
  3098.                            This  section  relates  to  configuration  of
  3099.                            items relating  to operating  InspectA  along
  3100.                            side a FidoNet mailer. If you do not  operate
  3101.                            such a mailer  you do not  need to use  these
  3102.                            options,  and  doing   so  will   be  of   no
  3103.                            advantage.
  3104.  
  3105.  
  3106.                Mailer Type
  3107.  
  3108.                            Almost all  FidoNet  mailers  fall  into  two
  3109.                            classes in terms of  how they store  outgoing
  3110.                            mail,  and  some   mailers  implement   minor
  3111.                            enhancements to the basic design to implement
  3112.                            explicit  addressing  to   other  Zones   and
  3113.  
  3114.  
  3115.  
  3116.  
  3117.             InspectA                                                  45
  3118.  
  3119.  
  3120.             Configuration
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.                            Domains. InspectA may be used with either  of
  3127.                            these   mailer   types   by   selecting   the
  3128.                            appropriate "Outbound" storage method.
  3129.  
  3130.                       Field          Description
  3131.  
  3132.  
  3133.  
  3134.                       Outbound       This describes the method which the
  3135.                                      mailer uses to store outbound  mail
  3136.                                      and  files.   Choices  are   either
  3137.                                      Static or Dynamic.
  3138.  
  3139.                                      Static mailers  use  the  "outbound
  3140.                                      directory"   method,   which   uses
  3141.                                      either  a  single  directory  or  a
  3142.                                      series  of  directories  to   store
  3143.                                      compressed mail archives,  packets,
  3144.                                      file attach and file request lists.
  3145.                                      The remote address of outbound mail
  3146.                                      is  determined  directly  from  the
  3147.                                      file and directory names used.
  3148.  
  3149.                                      Dynamic mailers use a netmail  file
  3150.                                      attach to determine  what file  and
  3151.                                      mail is  to  be  transmitted  to  a
  3152.                                      remote system.  Compressed  netmail
  3153.                                      is generally  stored  in  a  single
  3154.                                      directory, and the name of the mail
  3155.                                      bundle may or  may not reflect  the
  3156.                                      name of the  remote system; in  any
  3157.                                      case,   the   remote   address   is
  3158.                                      determined only by the  destination
  3159.                                      system in file attach message.
  3160.  
  3161.                       Zones          This  enables   zone   support   in
  3162.                                      determination      of      outbound
  3163.                                      directories, and is only used  when
  3164.                                      a static mailer is in use.
  3165.  
  3166.                       Points         This enables  point  support  (.PNT
  3167.                                      subdirectories) in determination of
  3168.                                      outbound directories,  and is  only
  3169.                                      used for static mailers.
  3170.  
  3171.                       Domains        This switch  should be  enabled  if
  3172.                                      your  mailer  configuration  stores
  3173.                                      outbound   compressed   mail    for
  3174.  
  3175.  
  3176.  
  3177.  
  3178.             46                                                  InspectA
  3179.  
  3180.  
  3181.                                                            Configuration
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.                                      addresses in  different domains  in
  3188.                                      separate directories. This  applies
  3189.                                      to both static and dynamic mailers.
  3190.  
  3191.                       Pointnet       This field accepts  the entry of  a
  3192.                                      pointnet   number.    Older    mail
  3193.                                      utilities may not  have been  built
  3194.                                      to  understand  or  implement  full
  3195.                                      point addressing, but instead  used
  3196.                                      a  pseudo  network  number  ("point
  3197.                                      network")  and   had   the   mailer
  3198.                                      software do the address translation
  3199.                                      as  required.  If   you  have   any
  3200.                                      software that  does this,  entering
  3201.                                      the  pointnet   number  here   will
  3202.                                      enable  InspectA   to  do   similar
  3203.                                      translation of pointnet addresses.
  3204.  
  3205.                            The  name  of   the  outbound  directory   is
  3206.                            determined  by  entering  it  in  the   Paths
  3207.                            section  and  selecting  "Outbound"  as   the
  3208.                            directory type.
  3209.  
  3210.  
  3211.                Address
  3212.  
  3213.                            Every FidoNet system identifies itself by  at
  3214.                            least one address,  and possibly others.  The
  3215.                            first address that a system uses is  regarded
  3216.                            as  special,   because  it   determines   the
  3217.                            behaviour   of   many   aspects   of   system
  3218.                            operation.
  3219.  
  3220.                            Addresses are  defined in  the Address  entry
  3221.                            screen; this  presents  a list  of  currently
  3222.                            defined addresses (if any) in the format:
  3223.  
  3224.  
  3225.                                 zone:net/node.point@domain
  3226.  
  3227.                            where ".point" is  optional. If your  network
  3228.                            does not use zones, this also may be  omitted
  3229.                            (but must not be if  you do use zones).  This
  3230.                            also applies to the "@domain" portion.
  3231.  
  3232.                            From the  address list,  you  can Add  a  new
  3233.                            address by pressing  INS, Delete by  pressing
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.             InspectA                                                  47
  3240.  
  3241.  
  3242.             Configuration
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.                            DEL, or Modify  by pressing  either  ENTER or
  3249.                            F2.
  3250.  
  3251.                            Because the order of  addresses in this  list
  3252.                            is significant, you are also able to  reorder
  3253.                            the list by holding down either SHIFT key and
  3254.                            using the  ARROW KEYS to change the  relative
  3255.                            position of the current address.
  3256.  
  3257.  
  3258.                Domain Equivalents
  3259.  
  3260.                            The lack of specification  of domain used  in
  3261.                            FidoNet software  has  unfortunately  led  to
  3262.                            their misuse. As domain aware software - such
  3263.                            as InspectA - comes into use, there is a high
  3264.                            risk  of  ambiguity  in  addresses  where  an
  3265.                            invalid  domain  is  used  in  messages.  The
  3266.                            unfortunate side-effect of  this is to  cause
  3267.                            mail not to be routed correctly, or at all.
  3268.  
  3269.                            To   compensate,    InspectA   employs    two
  3270.                            strategies. When an address is examined, only
  3271.                            the letters up to the first period ('.')  are
  3272.                            regarded   as   significant,   voiding    any
  3273.                            additional data as superfluous. This is  only
  3274.                            done as a temporary measure until sub-domains
  3275.                            are implemented  in  FidoNet  software.  Note
  3276.                            that InspectA will  never change an  existing
  3277.                            address in a message or packet as a result of
  3278.                            this -  it only  uses this  information as  a
  3279.                            means  of  'normalising'  addresses  for  the
  3280.                            purposes of comparison.
  3281.  
  3282.                            Secondly, InspectA  provides  a  facility  to
  3283.                            'remap' one domain  to another  to make  them
  3284.                            equivalent.  Whenever  the  first   nominated
  3285.                            character  sequence  is   encountered  as   a
  3286.                            domain, it  is  automatically assumed  to  be
  3287.                            equivalent to the  second. While this  scheme
  3288.                            is not perfect, it can be used to effectively
  3289.                            compensate  for  domain  misuse.  Note   that
  3290.                            because the sub-domain portion of domains are
  3291.                            removed prior scanning  for equivalents,  the
  3292.                            mapping of domains  with multiple parts  back
  3293.                            to their root name equivalent is unnecessary.
  3294.                            However, the facility to  do this is  present
  3295.                            because it is  expected that the  need to  do
  3296.  
  3297.  
  3298.  
  3299.  
  3300.             48                                                  InspectA
  3301.  
  3302.  
  3303.                                                            Configuration
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.                            sub-domain truncation will eventually  expire
  3310.                            and the removal of  this feature in  InspectA
  3311.                            and other software from Unique Computing will
  3312.                            occur in due course.
  3313.  
  3314.                            To Add a  new equivalent,  press  INS, Delete
  3315.                            with DEL and modify using ENTER or F2.
  3316.  
  3317.                            Technical  Note:  The  equating  of  domains
  3318.                            supports  recursion  of  up  to  16   levels,
  3319.                            although use in this  manner is probably  not
  3320.                            all  that  useful.  You  should  avoid  using
  3321.                            'circular'  definitions,  where  one   string
  3322.                            equates to  itself, directly  or  indirectly.
  3323.                            This not only does it  make no sense, but  it
  3324.                            can lead to some unexpected results.
  3325.  
  3326.  
  3327.                Products
  3328.  
  3329.                            InspectA's product table is simple a list  of
  3330.                            FTSC (FidoNet Technical Standards  Committee)
  3331.                            assigned product codes. These codes are  used
  3332.                            in packet headers  to determine the  software
  3333.                            which  was  responsible   for  creating   the
  3334.                            packet,  and  is   quite  useful   diagnostic
  3335.                            information. Using  this  table,  INSPECT  is
  3336.                            able to look up the  name of the software  by
  3337.                            its   product   code,   and   display    that
  3338.                            information in packet view mode.
  3339.  
  3340.                            You can manually add new products, delete  or
  3341.                            modify existing  ones,  but the  most  common
  3342.                            form of  entry is  to simply  use the  latest
  3343.                            FTSCPROD, a file issued and maintained by the
  3344.                            FTSC.  InspectA is  supplied with the  latest
  3345.                            version available as at the date of release.
  3346.  
  3347.                            To read in an  FTSCPROD list, press  F3. This
  3348.                            requests the name  of the file  to read;  you
  3349.                            can enter the name directly, change directory
  3350.                            after pressing F9, or by using F6 to list and
  3351.                            select files.
  3352.  
  3353.                            There may also be some cause to edit  records
  3354.                            in this list to  give some assistance to  the
  3355.                            way  in  which  InspectA  interprets   packet
  3356.                            headers. Older mail processors used a  packet
  3357.  
  3358.  
  3359.  
  3360.  
  3361.             InspectA                                                  49
  3362.  
  3363.  
  3364.             Configuration
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.                            header format which did not offer zone, point
  3371.                            or  domain   addressing   capability;   newer
  3372.                            variations have since  been introduced  which
  3373.                            provide  these  parts   of  the  source   and
  3374.                            destination address, and those packet formats
  3375.                            (type 2+  and  type  2.2)  are  automatically
  3376.                            recognised so that the interpretation of  the
  3377.                            address is correct. However, some products in
  3378.                            use have not yet implemented the newer packet
  3379.                            types, yet  have implemented  zone and  point
  3380.                            support in a  manner quite  similar to  those
  3381.                            newer formats. If a product is marked "3D" or
  3382.                            "4D"  capable,  INSPECT  will   automatically
  3383.                            assume  that  packets  made  by  products  so
  3384.                            marked  contain  valid   address  3D  or   4D
  3385.                            addressing if  neither  of the  newer  packet
  3386.                            formats are auto-detected.
  3387.  
  3388.                            To enable these flags, highlight the  product
  3389.                            code you wish  to update and  press  ENTER or
  3390.                            click on it once with the left mouse  button.
  3391.                            Press END to move to the last field, and use
  3392.                            the LEFT and  RIGHT ARROW  keys to  highlight
  3393.                            the entry you wish to select. Press  SPACE to
  3394.                            toggle on  or off,  as required,  then  press
  3395.                            ENTER or  F10 once to  save, or ESC to abort
  3396.                            changes.
  3397.  
  3398.                            Certain products known to support zone and/or
  3399.                            domain addressing  are automatically  updated
  3400.                            when the FTSCPROD file is read.
  3401.  
  3402.  
  3403.  
  3404.             Paths
  3405.  
  3406.                            This section allows you  to define a list  of
  3407.                            directories on your system. These are used as
  3408.                            a both means  of quickly  accessing them  via
  3409.                            the Select  Directory  function  (ALT-I) and
  3410.                            giving them  descriptions,  and  for  marking
  3411.                            particular directories for special use by the
  3412.                            FidoNet Mailer functions.
  3413.  
  3414.                            To Add  a new  directory to  the list,  press
  3415.                            INS. To Delete, press DEL. To view or modify,
  3416.                            press ENTER or F2.  When adding or modifying
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.             50                                                  InspectA
  3423.  
  3424.  
  3425.                                                            Configuration
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.                            a  path,   the  following   fields  must   be
  3432.                            completed:
  3433.  
  3434.                       Field          Description
  3435.  
  3436.  
  3437.  
  3438.                       Type           This is the type of directory being
  3439.                                      defined. Unless you  are using  the
  3440.                                      FidoNet  mailer  functions,  simply
  3441.                                      select Dir,  which  means  that  no
  3442.                                      special   significance   is   being
  3443.                                      attached to  the  directory.  Other
  3444.                                      options available are:
  3445.  
  3446.                            Netmail   This has  meaning  when  a  dynamic
  3447.                                      mailer  is  selected;  the  netmail
  3448.                                      directory  contains  all   outbound
  3449.                                      mail and file attaches.
  3450.  
  3451.                            Postmail  When a dynamic mailer is in use,  a
  3452.                                      directory with this attribute  will
  3453.                                      be the one  used to place  outgoing
  3454.                                      file  attach   and   file   request
  3455.                                      messages. This  would  normally  be
  3456.                                      the same as the Netmail  directory,
  3457.                                      but  need  not  be  (which  may  be
  3458.                                      useful, particular on  a LAN  based
  3459.                                      mail  system).   If   no   Postmail
  3460.                                      directory is  defined, the  Netmail
  3461.                                      directory is used,  so there is  no
  3462.                                      point in defining this if it is the
  3463.                                      same as the Netmail directory.
  3464.  
  3465.                            Inbound   This defines  a  directory  as  one
  3466.                                      which your  mailer  uses  to  store
  3467.                                      files sent to it from another  mail
  3468.                                      system. If  this attribute  is  set
  3469.                                      for   the    currently    displayed
  3470.                                      directory, INSPECT will attempt  to
  3471.                                      resolve  the  remote  address   for
  3472.                                      inbound    ARCmail    files,     so
  3473.                                      recognised by  their extension.  If
  3474.                                      an address  can  be  resolved  from
  3475.                                      such   a   file,   and   no   other
  3476.                                      description for  the  file  exists,
  3477.                                      the resolved  address is  displayed
  3478.                                      as the description.
  3479.  
  3480.  
  3481.  
  3482.  
  3483.             InspectA                                                  51
  3484.  
  3485.  
  3486.             Configuration
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.                            Outbound  An Outbound  directory  has  a  few
  3493.                                      special properties; they should  be
  3494.                                      dedicated to  containment of  files
  3495.                                      used by  the  mail system  and  not
  3496.                                      used for any other purpose. Similar
  3497.                                      to Inbound directories, the  remote
  3498.                                      address attaching  to a  particular
  3499.                                      file can usually  be resolved  from
  3500.                                      the file name  (always in the  case
  3501.                                      of  a  static   mailer,  and   only
  3502.                                      sometimes when a dynamic mailer  is
  3503.                                      used).
  3504.  
  3505.                                      When used with a static mailer, you
  3506.                                      should  only  define  your  primary
  3507.                                      outbound  path   in  this   manner;
  3508.                                      InspectA  will  determine  outbound
  3509.                                      other   zone   and   other   domain
  3510.                                      directories  automatically  by  the
  3511.                                      fact that they share the same  base
  3512.                                      directory and presence of the  zone
  3513.                                      extension.
  3514.  
  3515.                       Path           This is the  actual path name,  and
  3516.                                      should always be  a fully  resolved
  3517.                                      path, including disk drive letter.
  3518.  
  3519.                       Title          An optional description. If  given,
  3520.                                      the description  will be  displayed
  3521.                                      with the path name on the title bar
  3522.                                      in the File Manager.
  3523.  
  3524.  
  3525.  
  3526.             Keys
  3527.  
  3528.                            One of InspectA's  most powerful features  is
  3529.                            that  it  provides  the  ability  to   attach
  3530.                            external programs to any desired key,  giving
  3531.                            it the ability to act as an effective  front-
  3532.                            end   shell.   External   programs   can   be
  3533.                            integrated  into  InspectA  to  enhance   its
  3534.                            functionality  because  the  keyboard   macro
  3535.                            facility also allows you to give  information
  3536.                            to any external program on its command  line;
  3537.                            you can mark  files and  have them  processed
  3538.                            one at a time, multiple  files at a time,  or
  3539.                            placed into a response  file and even  prompt
  3540.  
  3541.  
  3542.  
  3543.  
  3544.             52                                                  InspectA
  3545.  
  3546.  
  3547.                                                            Configuration
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.                            the  user  for  information  when   required.
  3554.                            InspectA can then  become a  suitable way  to
  3555.                            use all of those powerful command line driven
  3556.                            utilities without having  to repeatedly  type
  3557.                            in the command itself.
  3558.  
  3559.                            In  addition  to  being  available  from  the
  3560.                            keyboard, these  same functions  can also  be
  3561.                            accessed  from  the  Special  pulldown   menu
  3562.                            available from the File Manager.
  3563.  
  3564.                            To Add  a  new  key  definition,  press  INS,
  3565.                            Delete using DEL, view or Modify using  ENTER
  3566.                            or F2.  SHIFT-INSERT may be used  to Clone an
  3567.                            existing entry, to use it as a template for a
  3568.                            new definition. CTRL-S sorts the list by key
  3569.                            name.
  3570.  
  3571.                            When  adding  or  modifying,  the   following
  3572.                            fields are presented for entry:
  3573.  
  3574.                       Field          Description
  3575.  
  3576.  
  3577.  
  3578.                       Key            The description in this field shows
  3579.                                      the key being re-defined. If a  new
  3580.                                      key is  being added,  simply  press
  3581.                                      the key  combination  you  wish  to
  3582.                                      define. Note  that if  you wish  to
  3583.                                      abort entry at this point you  must
  3584.                                      press the  ESC key twice -  once to
  3585.                                      satisfy this  prompt and  move  on,
  3586.                                      and secondly  to  abort.  To  avoid
  3587.                                      keys  being   inadvertently   being
  3588.                                      redefined  when  editing,  you  are
  3589.                                      required to  press  F2 to  edit the
  3590.                                      key.
  3591.  
  3592.                                      Some  keyboards  may  generate  key
  3593.                                      codes about which ICONFIG may  have
  3594.                                      no knowledge (it  is familiar  with
  3595.                                      only the  86-89 key  "PC" and  "AT"
  3596.                                      style keyboards,  and  the  101-key
  3597.                                      "extended" keyboard). In this case,
  3598.                                      instead of a description of the key
  3599.                                      being placed  in  this  field,  the
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.             InspectA                                                  53
  3606.  
  3607.  
  3608.             Configuration
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.                                      characters  "0x"   followed  by   a
  3615.                                      hexadecimal code are used.
  3616.  
  3617.                                      For an  explanation of  SHIFT,  ALT
  3618.                                      and  CTRL  key  descriptions,  see
  3619.                                      below.
  3620.  
  3621.                       Operation      The entry  selected in  this  field
  3622.                                      determines if  the  key  definition
  3623.                                      invokes an  external  program  (the
  3624.                                      default) or  an internal  function.
  3625.                                      If the  former,  then  the  Command
  3626.                                      field may be entered; if not,  then
  3627.                                      the next field will be skipped.
  3628.  
  3629.                                      In addition  to external  commands,
  3630.                                      all  internal  functions  available
  3631.                                      from  the  File   Manager  may   be
  3632.                                      reassigned, or  the  same  function
  3633.                                      may be set to be invoked from  more
  3634.                                      than one  key definition  according
  3635.                                      to preference.  However,  the  most
  3636.                                      common use of this capability  will
  3637.                                      be to integrate external commands.
  3638.  
  3639.                       Command        If the current key definition is an
  3640.                                      External Command,  then this  field
  3641.                                      accepts the  command name  to  run.
  3642.                                      This is a template macro, in  which
  3643.                                      character sequences  starting  with
  3644.                                      '$' will be replaced by file  names
  3645.                                      -  see  the  following  section  on
  3646.                                      Macros for details.
  3647.  
  3648.                                      This   field    accepts    multiple
  3649.                                      commands  separated  by  the  caret
  3650.                                      character  '^',  and  you  may  use
  3651.                                      environment      variables       by
  3652.                                      surrounding the variable name  with
  3653.                                      percent characters '%', as in batch
  3654.                                      files. If  you  need to  include  a
  3655.                                      literal '%' in  your command  line,
  3656.                                      use '%%'.
  3657.  
  3658.                                      For  example,   if   you   had   an
  3659.                                      environment variable  HOME  set  to
  3660.                                      D:\USERS\MYDIR, you  can enter  the
  3661.                                      command:
  3662.  
  3663.  
  3664.  
  3665.  
  3666.             54                                                  InspectA
  3667.  
  3668.  
  3669.                                                            Configuration
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.                                      dir %HOME%
  3676.  
  3677.                                      and the following  command will  be
  3678.                                      used:
  3679.  
  3680.  
  3681.                                      dir D:\USERS\MYDIR
  3682.  
  3683.                                      The   maximum    length   of    any
  3684.                                      individual command issued to  MSDOS
  3685.                                      after  environment  variables   are
  3686.                                      expanded and macros substituted  is
  3687.                                      126 characters; when  the $m  macro
  3688.                                      is  used,   the  command   may   be
  3689.                                      executed    multiple    times    if
  3690.                                      substituting all file names on  the
  3691.                                      one  command  line  will  not   fit
  3692.                                      within that  limitation.  The  OS/2
  3693.                                      version limits command line  length
  3694.                                      for   each    command    to    1024
  3695.                                      characters.
  3696.  
  3697.                                      The maximum length of all  commands
  3698.                                      before  both  environment  variable
  3699.                                      and  macro  substitution  is   1024
  3700.                                      (2048  in  OS/2  mode)  bytes,  and
  3701.                                      after substitution  is 2048  (4096)
  3702.                                      bytes; exceeding  either  of  these
  3703.                                      will result  in the  command  being
  3704.                                      silently truncated.
  3705.  
  3706.                       Description    The description field is  displayed
  3707.                                      in  the   Special   pulldown   menu
  3708.                                      accessed from the File Manager.
  3709.  
  3710.                       Req mem        [MSDOS] This specifies the  minimum
  3711.                                      amount of  memory  that  should  be
  3712.                                      free for the command to execute. If
  3713.                                      this  amount  of  memory  is   free
  3714.                                      without  requiring  program   image
  3715.                                      swapping, then swapping is skipped,
  3716.                                      usually   resulting    in    faster
  3717.                                      execution.
  3718.  
  3719.                                      The special value 0 forces swapping
  3720.                                      irrespective of free memory, and -1
  3721.                                      prevents swapping always.
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.             InspectA                                                  55
  3728.  
  3729.  
  3730.             Configuration
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.                       Rescan         If Rescan is enabled for a command,
  3737.                                      the  current   directory  will   be
  3738.                                      reread. Change this to Yes for  any
  3739.                                      command you define which affects or
  3740.                                      changes  files   other   than   the
  3741.                                      currently  highlighted   file,   or
  3742.                                      otherwise changes  the contents  of
  3743.                                      the current  directory. If  set  to
  3744.                                      No, InspectA  will only  rescan  if
  3745.                                      the file  or directory  highlighted
  3746.                                      in the current File Manager  window
  3747.                                      has been modified.
  3748.  
  3749.  
  3750.                Key Descriptions
  3751.  
  3752.                            To  identify  keys   and  key   combinations,
  3753.                            ICONFIG and INSPECT both  refer to keys in  a
  3754.                            specific way.
  3755.  
  3756.                            Normal   keys   use   standard   identifiers;
  3757.                            alphabetic  keys   use  their   corresponding
  3758.                            letter, symbols use the symbols as marked  on
  3759.                            the keyboard,  function keys  use  F1 through
  3760.                            F12, and  keypad keys  use  LEFT, RIGHT,  UP,
  3761.                            DOWN, HOME, END, PGUP, PGDN, INS, DEL, GREY-,
  3762.                            GREY+,  GREY*. Other  special  keys are  TAB,
  3763.                            ENTER, SPACE and BACKSPACE.
  3764.  
  3765.                            Any  of  these  keys   may  be  modified   by
  3766.                            indicating their shift-state;  that is,  when
  3767.                            one or more  of SHIFT,  ALT or CTRL are held
  3768.                            down  while   they   are   pressed.   ALT-KEY
  3769.                            combinations are preceded by the '@'  symbol;
  3770.                            ALT-C becomes @c. SHIFT-KEY (when either left
  3771.                            or right shift key is held down) combinations
  3772.                            are  indicated  by  a  preceding  '#'   sign.
  3773.                            Finally,   CTRL-KEYs  are   preceded   by   a
  3774.                            circumflex '^'.
  3775.  
  3776.  
  3777.                Macros
  3778.  
  3779.                            Macros are used as a way of substituting  the
  3780.                            current file name or  a marked file into  the
  3781.                            command line, or inserting other  information
  3782.                            as entered by  the user. This  allows you  to
  3783.                            use the marking facility in the File  Manager
  3784.  
  3785.  
  3786.  
  3787.  
  3788.             56                                                  InspectA
  3789.  
  3790.  
  3791.                                                            Configuration
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.                            to   integrate   functions   not    available
  3798.                            internally.
  3799.  
  3800.                            There is a great  deal of similarity  between
  3801.                            the command  macros and  macros available  in
  3802.                            archiving commands.
  3803.  
  3804.                       Macro          Replaced with
  3805.  
  3806.  
  3807.  
  3808.                       $a             Current file or directory
  3809.  
  3810.                       $p             The current directory name.
  3811.  
  3812.                       $f             Marked (or  current,  if  none  are
  3813.                                      marked) file name. If more than one
  3814.                                      file is  marked, the  command  line
  3815.                                      will  be  executed  multiple  times
  3816.                                      until  the   list   of   files   is
  3817.                                      exhausted. with each of the  marked
  3818.                                      file names substituted in turn.  If
  3819.                                      there  are  no  files  marked,  the
  3820.                                      currently highlighted file is used,
  3821.                                      and the command executed only once.
  3822.  
  3823.                       $m             Multiple file  names; if  no  files
  3824.                                      are marked, the  current file  name
  3825.                                      is used,  otherwise  the  names  of
  3826.                                      marked files are used. The  command
  3827.                                      may be executed  multiple times  if
  3828.                                      the command  line  would  otherwise
  3829.                                      exceed the  MSDOS  maximum  of  126
  3830.                                      characters, or  the OS/2  limit  of
  3831.                                      1024 characters.
  3832.  
  3833.                       $r             A  redirect  list  (also  called  a
  3834.                                      response file), which contains  the
  3835.                                      names  of  files   or  members   to
  3836.                                      operate on.
  3837.  
  3838.                       $?             Prompt for input. This macro allows
  3839.                                      one or  more parts  of the  command
  3840.                                      line to be given by the user. If  a
  3841.                                      '{' follows $?, the text  following
  3842.                                      and  all  characters   up  to   and
  3843.                                      including   the   next   '}'    are
  3844.                                      displayed as a prompt. For example,
  3845.  
  3846.  
  3847.  
  3848.  
  3849.             InspectA                                                  57
  3850.  
  3851.  
  3852.             Configuration
  3853.  
  3854.  
  3855.  
  3856.  
  3857.  
  3858.                                      $?{What is your name?} prompts  for
  3859.                                      input and  displays "What  is  your
  3860.                                      name?" above the  input field.  The
  3861.                                      results are placed  in the  command
  3862.                                      line and  substituted for  the  $?,
  3863.                                      with  the   optional   prompt   and
  3864.                                      brackets   deleted.    A    default
  3865.                                      response  may  also  be  given   by
  3866.                                      following  the  prompt  text  by  a
  3867.                                      vertical bar.
  3868.  
  3869.                                      An example:
  3870.  
  3871.  
  3872.                                 echo Hello, $?{Your name?|Me!}
  3873.  
  3874.                                      This defines the command;  InspectA
  3875.                                      first prompts  with  "Your  name?",
  3876.                                      offering  a  default  response   of
  3877.                                      "Me!". After  accepting input,  the
  3878.                                      command
  3879.  
  3880.  
  3881.                                 echo Hello <response>
  3882.  
  3883.                                      (where "<response>" is whatever was
  3884.                                      typed) is then run.
  3885.  
  3886.                                      It is quite valid to use any of the
  3887.                                      other    template     macros     or
  3888.                                      environment variables  in  response
  3889.                                      to the prompt.
  3890.  
  3891.                       $$             Replaced with a single '$'.
  3892.  
  3893.  
  3894.  
  3895.                            The macros '$a', '$f', '$m' and '$r'  contain
  3896.                            fully  qualified  path  names.  It  is  often
  3897.                            convenient to not  use the directory  portion
  3898.                            of these  names,  so the  following  list  of
  3899.                            modifiers may  be added  to these  macros  to
  3900.                            either omit or only  use parts. The  modifier
  3901.                            is a single character and is placed after the
  3902.                            '$' and prior the 'a', 'f', 'm' or 'r'  (note
  3903.                            that with the  macro '$r', the  path name  of
  3904.                            the files placed into  the redirect list  are
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.             58                                                  InspectA
  3911.  
  3912.  
  3913.                                                            Configuration
  3914.  
  3915.  
  3916.  
  3917.  
  3918.  
  3919.                            affected by the modifier, not the name of the
  3920.                            temporary file used).
  3921.  
  3922.                       Modifier       Description
  3923.  
  3924.  
  3925.  
  3926.                       +              (plus) Remove the directory portion
  3927.                                      .
  3928.  
  3929.                       -              (minus) Remove the extension
  3930.  
  3931.                       =              (equals) Remove both the  directory
  3932.                                      and extension.
  3933.  
  3934.                       _              (underline)  Remove  the  directory
  3935.                                      and file portion (leaving only  the
  3936.                                      file extension).
  3937.  
  3938.                       .              (period) Remove  any trailing  dots
  3939.                                      from the file name.
  3940.  
  3941.                       #              (hash) Use  forward  slash  as  the
  3942.                                      directory separator.
  3943.  
  3944.                            ICONFIG will allow you to define the same key
  3945.                            twice. However, only the first defined in the
  3946.                            list will  be  used. To  assist  in  locating
  3947.                            duplicates, the facility to sort the list has
  3948.                            been added, by pressing CTRL-S.
  3949.  
  3950.  
  3951.  
  3952.             File Associations
  3953.  
  3954.                            This  section   provides   the   ability   to
  3955.                            associate a nominated external command with a
  3956.                            file in the  File Manager.  By default,  file
  3957.                            selection simply  views a  file using  either
  3958.                            the standard viewer, or the internal  archive
  3959.                            lister or packet/message viewer, but this may
  3960.                            be varied  by defining  a file  specification
  3961.                            and an external command.
  3962.  
  3963.                            A file specification is a file name that  can
  3964.                            include wildcards. These are identical to the
  3965.                            wildcards the operating system accepts on the
  3966.                            command line,  including the  characters  '*'
  3967.  
  3968.  
  3969.  
  3970.  
  3971.             InspectA                                                  59
  3972.  
  3973.  
  3974.             Configuration
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.                            (replaces many characters) and '?'  (replaces
  3981.                            a single character. When  a file is  selected
  3982.                            in the File Manager, INSPECT scans this  list
  3983.                            for a match,  and if found  will execute  the
  3984.                            appropriate command.  If not  found, it  will
  3985.                            fall  through  to  the  appropriate   viewing
  3986.                            function.
  3987.  
  3988.                            To Add a new file specification to the  list,
  3989.                            press INS; to Delete, press  DEL; to Modify,
  3990.                            press ENTER or F2. On adding or modifying an
  3991.                            entry, the following fields are presented:
  3992.  
  3993.                       Field          Description
  3994.  
  3995.  
  3996.  
  3997.                       Filespec       This is the  file specification  to
  3998.                                      associate with  the  command.  This
  3999.                                      may be  as  simple as  matching  on
  4000.                                      extension only (eg. *.BAT), or more
  4001.                                      complex use of  wildcards, such  as
  4002.                                      "STR*.C" (which  matches all  files
  4003.                                      with names starting with "STR" with
  4004.                                      the extensions ".C").
  4005.  
  4006.                       Command        This field contains the  command(s)
  4007.                                      to run. You  can also  make use  of
  4008.                                      the template  macros  available  in
  4009.                                      key definitions as explained in the
  4010.                                      previous section, including the  $?
  4011.                                      macro  to  prompt   the  user   for
  4012.                                      information.
  4013.  
  4014.                       Description    Enter an optional description; this
  4015.                                      is  only  displayed  in  the   File
  4016.                                      Specification  list  as   presented
  4017.                                      here.
  4018.  
  4019.                       Req mem        [MSDOS]  This  field  contains  the
  4020.                                      minimum amount of memory that  must
  4021.                                      be free for the command to execute.
  4022.                                      If this amount of memory is already
  4023.                                      free  without   requiring   program
  4024.                                      image swapping,  then  swapping  is
  4025.                                      skipped,   usually   resulting   in
  4026.                                      faster execution.
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.             60                                                  InspectA
  4033.  
  4034.  
  4035.                                                            Configuration
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.                                      The special value 0 forces swapping
  4042.                                      irrespective of free memory, and -1
  4043.                                      prevents swapping.
  4044.  
  4045.                       Rescan         If Rescan is enabled for a command,
  4046.                                      the  current   directory  will   be
  4047.                                      reread. Change this to Yes for  any
  4048.                                      command you define which affects or
  4049.                                      changes files  or the  contents  of
  4050.                                      the current  directory. If  set  to
  4051.                                      No, InspectA  will only  rescan  if
  4052.                                      the file  or directory  highlighted
  4053.                                      in the current File Manager  window
  4054.                                      has been modified.
  4055.  
  4056.                                 NOTE:  This  option does  not yet  fully
  4057.                                 support long filenames under OS/2.  This
  4058.                                 issue will  be  addressed  in  a  future
  4059.                                 version of InspectA.
  4060.  
  4061.  
  4062.  
  4063.             Text
  4064.  
  4065.                            The Text  option  provides  the  facility  to
  4066.                            export or import  configuration data  between
  4067.                            text and InspectA's condensed binary  format.
  4068.                            This makes it easier to make bulk changes  to
  4069.                            an existing configuration using a plain  text
  4070.                            editor's search & replace functions, and  re-
  4071.                            reading   those   modifications   back   into
  4072.                            InspectA's internal format.
  4073.  
  4074.                            A text file exported  by ICONFIG consists  of
  4075.                            sections,  each   containing   Variable=Value
  4076.                            pairs. The general format of one section is:
  4077.  
  4078.  
  4079.                                 [section-heading]
  4080.                                 variable1=value1
  4081.                                 variable2=value2
  4082.                                 .
  4083.                                 .
  4084.  
  4085.                            When Importing a file, ICONFIG  automatically
  4086.                            initialises all data  covered by any  section
  4087.                            before  reading  in  any  new  values.  If  a
  4088.                            section is  not  included in  the  text  file
  4089.  
  4090.  
  4091.  
  4092.  
  4093.             InspectA                                                  61
  4094.  
  4095.  
  4096.             Configuration
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.                            being imported,  then  data in  that  section
  4103.                            remains untouched.  This means  that you  can
  4104.                            extract a  full configuration,  but you  only
  4105.                            need to import the complete section to  which
  4106.                            you make changes.
  4107.  
  4108.                            Specific details  about  the  variable  names
  4109.                            used can  be found  in  an appendix  to  this
  4110.                            manual.  The  main  text  configuration  file
  4111.                            sections are:
  4112.  
  4113.                       Section        Description
  4114.  
  4115.  
  4116.  
  4117.                       [general]      This   section   contains   general
  4118.                                      configuration   items,   such    as
  4119.                                      EMS/XMS/Disk  swapping  setup   for
  4120.                                      DOS, temporary  path  for  archived
  4121.                                      file  viewing,   and  the   default
  4122.                                      editor/viewer programs.
  4123.  
  4124.                       [video]        Contains  all   video   and   mouse
  4125.                                      related options.
  4126.  
  4127.                       [archive]      Contains   the   archive    command
  4128.                                      definitions and templates.
  4129.  
  4130.                       [mailer]       All mailer configuration items.
  4131.  
  4132.                       [paths]        Contains details  for system  paths
  4133.                                      and their descriptions.
  4134.  
  4135.                       [externals]    Defines  all  keyboard   overrides,
  4136.                                      external      keyboard      command
  4137.                                      definitions and file specifications
  4138.                                      used to run external programs.
  4139.  
  4140.  
  4141.                Import
  4142.  
  4143.                            The Import option requests  a file name.  You
  4144.                            can use  the standard  File Selection  Prompt
  4145.                            (see Appendix)  to  navigate  your  disk  and
  4146.                            locate the file you wish to import.
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.             62                                                  InspectA
  4155.  
  4156.  
  4157.                                                            Configuration
  4158.  
  4159.  
  4160.  
  4161.  
  4162.  
  4163.                Export
  4164.  
  4165.                            The Export option asks  for a path/file  name
  4166.                            to export to.  If the file  you give  already
  4167.                            exists, confirmation to overwrite it will  be
  4168.                            requested.
  4169.  
  4170.  
  4171.  
  4172.             Quit
  4173.  
  4174.                            This option requests that ICONFIG  terminates
  4175.                            and returns  you  to the  previously  running
  4176.                            process  (command  prompt  or  INSPECT).   If
  4177.                            changes  to  the  configuration  were   made,
  4178.                            ICONFIG first asks whether you wish to retain
  4179.                            them by saving to disk. The save file name is
  4180.                            shown on  the  top  line of  the  screen  and
  4181.                            cannot be changed.
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.             InspectA                                                  63
  4216.  
  4217.  
  4218.             InspectA Functions
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.             InspectA Functions
  4230.  
  4231.  
  4232.                            This section  provides  an in-depth  look  at
  4233.                            each of the major functions.
  4234.  
  4235.  
  4236.  
  4237.             File Manager
  4238.  
  4239.                            When  first  invoked  without  specifying  an
  4240.                            archive to  examine,  InspectA  is  in  "file
  4241.                            management" mode.  It displays  at least  one
  4242.                            window showing  the contents  of the  current
  4243.                            directory,  with   subdirectories  shown   in
  4244.                            uppercase,  and  files  in  lower  case.   To
  4245.                            display more entries, use  the PGUP and  PGDN
  4246.                            keys to move up and  down keys. You may  also
  4247.                            move around  the  list  with  the  mouse  (if
  4248.                            active) and using the  SCROLLBAR on the right
  4249.                            of the list. Click  the left mouse button  on
  4250.                            the top or bottom dark area on the  SCROLLBAR
  4251.                            to move  the  file  selector up  or  down  by
  4252.                            entry. To move in larger increments, click on
  4253.                            the  SCROLLBAR above  or  below  the  current
  4254.                            position marker. To  move directly  to a  new
  4255.                            position in  the list,  click with  the  left
  4256.                            mouse button on  the current position  marker
  4257.                            and  drag  it  to  a  new  position  on   the
  4258.                            SCROLLBAR.
  4259.  
  4260.                            There are  some additional  controls in  each
  4261.                            window   which   provide   the   ability   to
  4262.                            manipulate, move and resize.
  4263.  
  4264.                               To move, click on  the title bar  with the
  4265.                               left mouse button  and while  holding down
  4266.                               the button,  drag  the  window  to  a  new
  4267.                               position. The  keyboard equivalent  is the
  4268.                               GREY-* key, using the ARROW KEYS  to move.
  4269.                               Release the  mouse  button  (press  ENTER)
  4270.                               when moved to the desired position.
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.             64                                                  InspectA
  4277.  
  4278.  
  4279.                                                       InspectA Functions
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.                               To resize, click on the  bottom right hand
  4286.                               corner of the  window and drag  the corner
  4287.                               to adjust the size.  If you are  using the
  4288.                               keyboard, press GREY-* and hold  down the
  4289.                               SHIFT key to adjust the  size. Release the
  4290.                               mouse button or press ENTER to confirm.
  4291.  
  4292.                               To zoom or  un-zoom the window,  click the
  4293.                               left mouse button on the  up-arrow icon on
  4294.                               the upper right corner of the window. This
  4295.                               may also be done by  using CTRL-ENTER from
  4296.                               the keyboard.
  4297.  
  4298.                               Windows may be  iconised when not  in use.
  4299.                               This means that the  window is temporarily
  4300.                               collapsed, taking  up  less  room  on  the
  4301.                               desktop and appearing only  as a directory
  4302.                               name in background. To iconise, click with
  4303.                               the mouse on the down-arrow  symbol to the
  4304.                               left of  the  upper  right corner  of  the
  4305.                               window or press SHIFT-NUMPAD-5. To restore
  4306.                               an iconised window,  click the  left mouse
  4307.                               button on the symbol on the desktop to the
  4308.                               left of the  directory name. At  least one
  4309.                               window must be  open at  all times,  so if
  4310.                               only one window is displayed, it cannot be
  4311.                               iconised or closed.
  4312.  
  4313.                               To close a window,  click on the  top left
  4314.                               corner on  the window.  SHIFT-DEL performs
  4315.                               this same function from the keyboard.
  4316.  
  4317.                               To open a  new window, press  SHIFT-INS or
  4318.                               use the mouse to pull down the Window sub-
  4319.                               menu and select Open.
  4320.  
  4321.  
  4322.                Files display
  4323.  
  4324.                            The contents of any file lists is  determined
  4325.                            by a  configurable  list  format  defined  in
  4326.                            ICONFIG. By  default, InspectA  automatically
  4327.                            installs three formats:
  4328.  
  4329.                       Default        contains   a   useful   amount   of
  4330.                                      information for  most common  uses,
  4331.                                      and is similar to  that used by  an
  4332.                                      DOS  DIR  command   in  the   MSDOS
  4333.  
  4334.  
  4335.  
  4336.  
  4337.             InspectA                                                  65
  4338.  
  4339.  
  4340.             InspectA Functions
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.                                      version, or  OS/2 DIR  in the  OS/2
  4347.                                      version.
  4348.  
  4349.                       Brief          contains just the bare essentials -
  4350.                                      the    file    name,    type    and
  4351.                                      description.
  4352.  
  4353.                       Full           displays most information available
  4354.                                      about a file.
  4355.  
  4356.                            You  can   modify  these   formats,.   delete
  4357.                            unnecessary ones  and  add more.  The  format
  4358.                            used for the current window can be changed by
  4359.                            using ALT-F8, or by selecting the List Format
  4360.                            option from the Utils pulldown menu.
  4361.  
  4362.                            The meaning of file information displayed  is
  4363.                            usually obvious.  The  only field  which  may
  4364.                            require further explanation is the Attributes
  4365.                            field. This is a series of single characters,
  4366.                            each position represents  a single  attribute
  4367.                            for a  file  -  a dot  is  displayed  if  the
  4368.                            attribute  is  not  set,  but  a  letter   is
  4369.                            displayed  if  it  is.  The  following   list
  4370.                            explains  the   precise   meaning   of   each
  4371.                            attribute.
  4372.  
  4373.                       System    s    System file  attribute. This  is  a
  4374.                                      special attribute used to  identify
  4375.                                      special operating system files. You
  4376.                                      should avoid deleting or  modifying
  4377.                                      any file  with this  attribute  set
  4378.                                      because it  will almost  always  be
  4379.                                      required.
  4380.  
  4381.                       Hidden    h    This  attribute  indicates  that  a
  4382.                                      file is hidden from view in the DIR
  4383.                                      command. It will also be  invisible
  4384.                                      to many  programs  which  list  the
  4385.                                      contents of the directory (the same
  4386.                                      is  also  true  of  System  files).
  4387.                                      These are  rarely as  important  as
  4388.                                      files  marked   with   the   System
  4389.                                      attribute, but  are usually  hidden
  4390.                                      to prevent accidental deletion.
  4391.  
  4392.                       Read-only r    Read-only files  are visible  using
  4393.                                      DIR, but cannot be modified.  Files
  4394.  
  4395.  
  4396.  
  4397.  
  4398.             66                                                  InspectA
  4399.  
  4400.  
  4401.                                                       InspectA Functions
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.                                      are marked with  this attribute  to
  4408.                                      prevent   casual   or    accidental
  4409.                                      modification.
  4410.  
  4411.                       Archive   a    Whenever a  file is  written to  or
  4412.                                      created,    this    attribute    is
  4413.                                      automatically set.  It  is  usually
  4414.                                      only  reset  by  programs  which  a
  4415.                                      responsible for  backing up  files.
  4416.                                      Using this built-in facility, it is
  4417.                                      possible to  do incremental  backup
  4418.                                      of  only  changed  files,  avoiding
  4419.                                      having to back up a large amount of
  4420.                                      data each time.
  4421.  
  4422.                       Shareable S    This attribute  will only  ever  be
  4423.                                      seen on  files  which  exist  on  a
  4424.                                      Novell   Network   network   volume
  4425.                                      (MSDOS  only).  It  is  a   special
  4426.                                      attribute   used   for    backwards
  4427.                                      compatibility   with   older   non-
  4428.                                      network aware applications which do
  4429.                                      not  use  file  sharing  modes   to
  4430.                                      access files, but are  nevertheless
  4431.                                      able   to   share   files   without
  4432.                                      conflict.
  4433.  
  4434.  
  4435.  
  4436.                            File descriptions are  read from  one of  the
  4437.                            configured 'description list'  files. If  any
  4438.                            are specified (see ICONFIG, General,  Lists),
  4439.                            INSPECT will look for each name in turn after
  4440.                            reading   all   files,    then   match    any
  4441.                            descriptions  contained  in  the  first  file
  4442.                            successfully  opened  against  files  in  the
  4443.                            current directory.
  4444.  
  4445.                            In the  case  of paths  configured  with  the
  4446.                            Outbound or Inbound attributes (see  ICONFIG,
  4447.                            Paths), when in either  type of directory  is
  4448.                            current, InspectA  will  attempt  to  resolve
  4449.                            FidoNet addressing  in any  recognised  mail-
  4450.                            related file types.  The resolved address  is
  4451.                            displayed as a file description.
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.             InspectA                                                  67
  4460.  
  4461.  
  4462.             InspectA Functions
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.                Functions
  4469.  
  4470.                            Following  is   a   list  of   File   Manager
  4471.                            functions. The key assignments given are  the
  4472.                            default ones, and all functions, except where
  4473.                            marked, are also available from the  pulldown
  4474.                            menu.
  4475.  
  4476.  
  4477.                            F1                                       Help
  4478.  
  4479.                               Accesses the help system.
  4480.  
  4481.  
  4482.                            F2                                Global Mark
  4483.  
  4484.                               Toggles the  global  file  marker; if  all
  4485.                               files are  currently marked  (marked files
  4486.                               are highlighted and a square block appears
  4487.                               to the left  of the  file name),  they are
  4488.                               all unmarked, else  all files  are marked.
  4489.                               This  is  useful  when  performing  global
  4490.                               operations on  all  files  in the  current
  4491.                               directory.
  4492.  
  4493.  
  4494.                            F3                                       View
  4495.  
  4496.                               Views the current file in list text/binary
  4497.                               mode.
  4498.  
  4499.  
  4500.                            F4                                       Edit
  4501.  
  4502.                               Invokes  the  editor  with  the  currently
  4503.                               selected file as the file to edit.
  4504.  
  4505.  
  4506.                            F5                                       Copy
  4507.  
  4508.                               Copy  the  current  file,  or  all  marked
  4509.                               files. (see also F6, MOVE).
  4510.  
  4511.  
  4512.                            F6                                       Move
  4513.  
  4514.                               Moves or renames the current  file, or all
  4515.                               marked files. Depending on the destination
  4516.  
  4517.  
  4518.  
  4519.  
  4520.             68                                                  InspectA
  4521.  
  4522.  
  4523.                                                       InspectA Functions
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.                               path or file  specified, this  will either
  4530.                               move the files  with the  same names  to a
  4531.                               different place  on  the  same or  another
  4532.                               disk, or rename the files.  Note that wild
  4533.                               card  renames  are  also   supported  (ie.
  4534.                               marked files can  be renamed to  *.cxx, if
  4535.                               that is specified). Individual directories
  4536.                               may also  be  renamed  using this  option,
  4537.                               although  this  may   not  work   on  some
  4538.                               networks (in  which  case,  InspectA  will
  4539.                               simply report an error).
  4540.  
  4541.  
  4542.                            F7                                      Mkdir
  4543.  
  4544.                               Creates a new directory.
  4545.  
  4546.  
  4547.                            F8                                       Sort
  4548.  
  4549.                               Provides the ability to change the default
  4550.                               sorting  order   of   files.   Note   that
  4551.                               subdirectories are  ALWAYS at  the top  of
  4552.                               the  list,  irrespective  of  the  current
  4553.                               sorting method.
  4554.  
  4555.  
  4556.                            F9                                       Tree
  4557.  
  4558.                               Logs the  entire  drive's directory  tree,
  4559.                               and  presents  a  graphical  view  of  its
  4560.                               directory structure,  and  allows  you  to
  4561.                               "walk"   through   directories   and   get
  4562.                               directly where you wish to go. If you have
  4563.                               given the -m command  line switch, logging
  4564.                               and selecting  drives  will  automatically
  4565.                               read and  update  the  DISKMAP.IND in  the
  4566.                               root directory of each drive visited. This
  4567.                               speeds up operating significantly.
  4568.  
  4569.  
  4570.                            F10                                      Exec
  4571.  
  4572.                               Execute. The function of  this key depends
  4573.                               on the currently  highlighted file.  If it
  4574.                               is an executable file (has a .EXE, .COM or
  4575.                               .BAT  extension)   it   will  prompt   for
  4576.                               additional  command  line   arguments  and
  4577.  
  4578.  
  4579.  
  4580.  
  4581.             InspectA                                                  69
  4582.  
  4583.  
  4584.             InspectA Functions
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.                               execute  that   program   (this   can   be
  4591.                               overridden,  if   necessary).   Otherwise,
  4592.                               InspectA simply prompts  for a  program to
  4593.                               run and a  command line  to use,  with the
  4594.                               currently  highlighted   file   name   the
  4595.                               default.
  4596.  
  4597.                               The  "exec"  prompt  has  a  command  line
  4598.                               history  which   maintains  the   last  64
  4599.                               command entered.  press  UP for  previous,
  4600.                               DOWN for next, PGUP for first  and END for
  4601.                               the last command entered.
  4602.  
  4603.  
  4604.                            ALT-F9                           Save Windows
  4605.  
  4606.                               Saves the  current desktop  arrangement to
  4607.                               disk (in INSPECT.SAV).
  4608.  
  4609.  
  4610.                            ALT-F8                            Next Format
  4611.  
  4612.                               Switches to  the  next  file  list  format
  4613.                               type.
  4614.  
  4615.  
  4616.                            ALT-F7                             Video Mode
  4617.  
  4618.                               This option  switches video  modes if  the
  4619.                               display  adaptor   supports  it.   If  the
  4620.                               configuration file defines a "custom" mode
  4621.                               (or, in  OS/2,  custom  rows and  colums),
  4622.                               then this may also be switched to, whether
  4623.                               it is active or not.
  4624.  
  4625.  
  4626.                            ALT-F6                         Set Video Mode
  4627.  
  4628.                               This has  the same  effect as  ALT-F7, but
  4629.                               also enables  the  "set  mode" switch,  so
  4630.                               that the  previously  active  mode is  not
  4631.                               restored  when  exiting  or  when  running
  4632.                               external programs.
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.             70                                                  InspectA
  4643.  
  4644.  
  4645.                                                       InspectA Functions
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.                            ALT-F5                 Toggle File Statistics
  4652.  
  4653.                               Toggles the file  statistics window  on or
  4654.                               off. Whether this  window is  displayed or
  4655.                               not initially  depends  on  an  option  in
  4656.                               ICONFIG.
  4657.  
  4658.  
  4659.                            ALT-Q                                    Quit
  4660.  
  4661.                               ALT-Q is an alias of ESC,  which will exit
  4662.                               InspectA. The  difference between  the two
  4663.                               is that  Alt-Q leaves  the current  screen
  4664.                               displayed  and  (under  MSDOS   only)  the
  4665.                               current directory  as  shown  in the  file
  4666.                               manager, which is  convenient if  you wish
  4667.                               to  carry  out  some  operation  from  the
  4668.                               command line  using information  displayed
  4669.                               by the file manager.
  4670.  
  4671.  
  4672.                            ESC                                      Exit
  4673.  
  4674.                               Exits InspectA,  returns  to the  original
  4675.                               drive and  directory  from which  InspectA
  4676.                               was  invoked  (if  it  still  exists)  and
  4677.                               restores the screen).
  4678.  
  4679.  
  4680.                            SPACE                                    Mark
  4681.  
  4682.                               Toggles the  file marker  for the  current
  4683.                               file.
  4684.  
  4685.  
  4686.                            CTRL-PGUP                               Updir
  4687.  
  4688.                               Change to parent directory.
  4689.  
  4690.  
  4691.                            CTRL-PGDN                               DnDir
  4692.  
  4693.                               Change to  the currently  highlighted sub-
  4694.                               directory. This key is  ignored unless the
  4695.                               currently highlighted file is a directory.
  4696.  
  4697.  
  4698.  
  4699.  
  4700.  
  4701.  
  4702.  
  4703.             InspectA                                                  71
  4704.  
  4705.  
  4706.             InspectA Functions
  4707.  
  4708.  
  4709.  
  4710.  
  4711.  
  4712.                            CTRL-R                                 Rescan
  4713.  
  4714.                               Rereads the  current directory;  useful in
  4715.                               networking and  multi-tasking environments
  4716.                               to reread the disk when it has changed.
  4717.  
  4718.  
  4719.                            CTRL-S                                   Scan
  4720.  
  4721.                               Examines  all   files   in   the   current
  4722.                               directory to determine the  file type. The
  4723.                               type description replaces the " ? " in the
  4724.                               file display, or remains that  if the file
  4725.                               type cannot be determined.
  4726.  
  4727.  
  4728.                            CTRL-E                       Previous Command
  4729.  
  4730.                               Brings up the "Exec" (F10) prompt with the
  4731.                               previously executed command.
  4732.  
  4733.  
  4734.                            CTRL-F                                 Locate
  4735.  
  4736.                               Scans a  directory and  all subdirectories
  4737.                               for   files   matching   a    given   file
  4738.                               specification. The specification given may
  4739.                               include any  valid  file  spec,  including
  4740.                               wildcard  characters.  On  completing  the
  4741.                               scan -  which can  be  interrupted at  any
  4742.                               time by  using the  ESC key  -  a list  of
  4743.                               matching   files   will    be   presented.
  4744.                               Selecting any matching file moves into its
  4745.                               directory and highlights it.
  4746.  
  4747.  
  4748.                            CTRL-D                                  Drive
  4749.  
  4750.                               Select  a  different  drive   to  examine.
  4751.                               Displays a  list of  available drives  and
  4752.                               the  current  directory  on   each  drive;
  4753.                               select the new  drive with arrow  keys and
  4754.                               ENTER  or  simply   type  the   letter  as
  4755.                               required.
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.             72                                                  InspectA
  4765.  
  4766.  
  4767.                                                       InspectA Functions
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.                            ALT-A                      Add/Create Archive
  4774.  
  4775.                               Allows selected  files to  be added  to an
  4776.                               existing archive (see below  for available
  4777.                               types),   or   a   new   archive   created
  4778.                               containing those files.
  4779.  
  4780.                               If adding to an existing  archive, be sure
  4781.                               to give the extension.  InspectA will then
  4782.                               be  able  to  read  it  and  automatically
  4783.                               determine which  archiver  to  use to  add
  4784.                               files to it  and will  not need  to prompt
  4785.                               you to select the archiver type.
  4786.  
  4787.  
  4788.                            ALT-C                      Configure InspectA
  4789.  
  4790.                               This option loads ICONFIG  for interactive
  4791.                               configuration. On exiting ICONFIG, INSPECT
  4792.                               will reload  the  new  configuration  from
  4793.                               INSPECT.INI if it has been modified..
  4794.  
  4795.  
  4796.                            ALT-T                           Test Archives
  4797.  
  4798.                               Allows selected  files  to  be tested  for
  4799.                               archive    integrity.    If    none    are
  4800.                               highlighted, the  current file  is tested.
  4801.                               Files being tested must be compressed file
  4802.                               archives, and are  simply skipped  if not.
  4803.                               If  a   corrupted   archive   is   located
  4804.                               (indicated  by   a  non-zero   error  code
  4805.                               returned by the archive program), the file
  4806.                               is marked  as "corrupt",  and an  asterisk
  4807.                               will be displayed next to its file type in
  4808.                               the files list.
  4809.  
  4810.  
  4811.                            ALT-S                                    Sort
  4812.  
  4813.                               Alias for F8; select file sort order.
  4814.  
  4815.  
  4816.                            ALT-I                         Directory Index
  4817.  
  4818.                               If a directory index has  been defined, it
  4819.                               is  displayed  to  allow  fast  change  of
  4820.                               directory by selection from the list.
  4821.  
  4822.  
  4823.  
  4824.  
  4825.             InspectA                                                  73
  4826.  
  4827.  
  4828.             InspectA Functions
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.                            ALT-L                                    List
  4835.  
  4836.                               Alias for F3, View.
  4837.  
  4838.  
  4839.                            ALT-E                                    Edit
  4840.  
  4841.                               Alias for F4, Edit.
  4842.  
  4843.  
  4844.                            ALT-V                              Virus Scan
  4845.  
  4846.                               The action of this key  depends on whether
  4847.                               any files are marked. If  none are marked,
  4848.                               the Virus Scan program is  invoked to scan
  4849.                               all files  in  the  current directory  and
  4850.                               below.
  4851.  
  4852.                               If specific files have  been marked, these
  4853.                               are examined  and  if InspectA  determines
  4854.                               that they are a valid  archive, all member
  4855.                               files  are  extracted  into   a  temporary
  4856.                               directory (see  View Dir  in ICONFIG)  and
  4857.                               scanned for viri.
  4858.  
  4859.  
  4860.                            ALT-R                          Repack Archive
  4861.  
  4862.                               Repack archives. This command  may be used
  4863.                               to convert  archives  to  a new  type,  or
  4864.                               update member files to a newer compression
  4865.                               type. During  the  repacking process,  you
  4866.                               may also invoke the virus  scan program to
  4867.                               check member files for viri.
  4868.  
  4869.                               This function is  executed on  the current
  4870.                               file is  none are  marked,  or all  marked
  4871.                               files.
  4872.  
  4873.  
  4874.                            ALT-Z                                   Shell
  4875.  
  4876.                               Shells to  the operating  system's command
  4877.                               interpreter.  Use  'EXIT'  to   return  to
  4878.                               InspectA.
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.             74                                                  InspectA
  4887.  
  4888.  
  4889.                                                       InspectA Functions
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.                            DEL                                    Delete
  4896.  
  4897.                               Erase current or marked files.
  4898.  
  4899.  
  4900.                            ENTER                                  Action
  4901.  
  4902.                               Pressing ENTER selects  the current  file,
  4903.                               with the  action dependant  on the  file's
  4904.                               type.  Note  that  the  type  of  file  is
  4905.                               determined from its contents, and not from
  4906.                               its name.
  4907.  
  4908.                               DIR    Directory.
  4909.                                         Selecting   a   directory   will
  4910.                                         change  to  that  directory  and
  4911.                                         display files in that directory.
  4912.  
  4913.                               MSG    "FTSC-1 *.MSG" message format.
  4914.                                         Invokes "message  view" mode  to
  4915.                                         examine the message.
  4916.  
  4917.                               PKT    FTSC format packet.
  4918.                                         Invokes  "packet   view"   mode,
  4919.                                         calling up  a  list of  messages
  4920.                                         that it contains.
  4921.  
  4922.                               EXE    Executable
  4923.                                         Note that  some  .EXE files  are
  4924.                                         actually archives  with a  self-
  4925.                                         extracting    envelope;     when
  4926.                                         InspectA   detects   these,   it
  4927.                                         assumes the archive  type rather
  4928.                                         than .EXE.
  4929.                               TXT    Text files.
  4930.                               ?LO    Outbound   'static   mailer'   file
  4931.                                      attach list
  4932.                               BDL    Outbound mail  file,  archiver  not
  4933.                                      yet determined
  4934.                               BSY    Mailer/packer address 'busy' flag
  4935.                               REQ    Inbound or  outbound  file  request
  4936.                                      list
  4937.                               PRO    Mailer call in progress list
  4938.                                         Invokes   the    standard   list
  4939.                                         program to view the file.
  4940.  
  4941.                               BWZ    Incomplete  file  transfer   marker
  4942.                                      (FidoNet mailer).
  4943.  
  4944.  
  4945.  
  4946.  
  4947.             InspectA                                                  75
  4948.  
  4949.  
  4950.             InspectA Functions
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.                                         The view  mode  is dependant  on
  4957.                                         the type  of  file detected.  If
  4958.                                         this cannot be  determined, then
  4959.                                         the  standard  list  program  is
  4960.                                         used.
  4961.  
  4962.                               AR5    SEA ARC v5.X
  4963.                               AR6    SEA ARC v6.X
  4964.                               AR7    SEA ARC v7.X
  4965.                               PKA    PKWare's PKPAK/PKARC series (v3.5+)
  4966.                               PAK    NoGate Consulting's PAK (v2.51)
  4967.                               ZIP    PKWare's ZIP (v1.10 or below)
  4968.                               LZH    Yoshi's LHARC (v1.13d or below)
  4969.                               LHA    Yoshi's LHA (v2.x)
  4970.                               ZOO    Dhesi's ZOO (v2.01 or below)
  4971.                               ZOH    Dhesi's ZOO  with high  compression
  4972.                                      (v2.10)
  4973.                               ARJ    Jung's ARJ (v2.22)
  4974.                               HPK    Gutmann's HPACK
  4975.                               ZI2    PKWare's ZIP (2.0 or above)
  4976.                               DWC    Cooper's DWC compressor (5.01)
  4977.                                         Invokes  "archive   view"  mode,
  4978.                                         listing  the  contents   of  the
  4979.                                         archive for further action.
  4980.  
  4981.                               Note  that  the  above   are  the  default
  4982.                               actions taken as a result of selecting the
  4983.                               corresponding  file  types.  This  can  be
  4984.                               overridden    by    defining     a    file
  4985.                               specification in  ICONFIG which  specifies
  4986.                               that another  external  program should  be
  4987.                               run instead.
  4988.  
  4989.  
  4990.                            CTRL-ENTER                        Zoom Window
  4991.  
  4992.                               This toggles the list  size between normal
  4993.                               windowed mode and zoomed (full screen).
  4994.  
  4995.  
  4996.                            SHIFT-ENTER                       View screen
  4997.  
  4998.                               This function provides the ability to view
  4999.                               the DOS or OS/2 screen. InspectA preserves
  5000.                               and uses  the initial  screen on  startup,
  5001.                               and  uses  this   to  display   output  of
  5002.                               external commands.  This  is  useful  when
  5003.                               InspectA is used  as a front-end  to other
  5004.  
  5005.  
  5006.  
  5007.  
  5008.             76                                                  InspectA
  5009.  
  5010.  
  5011.                                                       InspectA Functions
  5012.  
  5013.  
  5014.  
  5015.  
  5016.  
  5017.                               applications, so  that program  output can
  5018.                               be reviewed at any time.
  5019.  
  5020.                               Unless set  mode  (see  ICONFIG,  General,
  5021.                               Video)  is  enabled,  InspectA  will  also
  5022.                               switch back to the original  video mode at
  5023.                               startup when running external  programs or
  5024.                               viewing the  DOS or  OS/2  screen. If  set
  5025.                               mode is  enabled,  and  a  video  mode  is
  5026.                               selected  which  results  in   the  screen
  5027.                               dimensions changing,  the original  screen
  5028.                               cannot  be   preserved.   In  that   case,
  5029.                               however, InspectA will not  need to switch
  5030.                               video  mode  before  running  programs  or
  5031.                               viewing this screen.
  5032.  
  5033.  
  5034.                            TAB                        Select next window
  5035.  
  5036.                               If  multiple  windows  are   open  on  the
  5037.                               screen, this key moves to the next window.
  5038.                               If you  have a  mouse, merely  placing the
  5039.                               mouse cursor  on the  window  you wish  to
  5040.                               select and  clicking  once  with the  left
  5041.                               mouse button will  select that  window and
  5042.                               make  it  current.  Iconised  windows  are
  5043.                               skipped.
  5044.  
  5045.  
  5046.                            SHIFT-TAB                         Window list
  5047.  
  5048.                               SHIFT-TAB  provides   a   full   list   of
  5049.                               available File Manager  windows, including
  5050.                               iconised ones,  which  are  marked with  a
  5051.                               symbol on the left of the list entry.
  5052.  
  5053.                               From the Window List, you can Add a window
  5054.                               by pressing INS, Delete a  window (except
  5055.                               the last) by  using DEL, or selecting  any
  5056.                               particular  one  by  highlighting  it  and
  5057.                               pressing ENTER.
  5058.  
  5059.  
  5060.                            SHIFT-NUM5                     Iconise Window
  5061.  
  5062.                               For any window  except the  last, pressing
  5063.                               this key combination iconises  the current
  5064.                               window and moves to the next.  This is the
  5065.  
  5066.  
  5067.  
  5068.  
  5069.             InspectA                                                  77
  5070.  
  5071.  
  5072.             InspectA Functions
  5073.  
  5074.  
  5075.  
  5076.  
  5077.  
  5078.                               same as clicking  on the  Minimise control
  5079.                               on the window using the mouse.
  5080.  
  5081.  
  5082.                            SHIFT-INS                   Open a new window
  5083.  
  5084.                               To add  a  new  window,  press  shift-ins.
  5085.                               InspectA them prompts  for a  directory to
  5086.                               start from  using  the  standard file  and
  5087.                               directory selection  prompt. On  accepting
  5088.                               the  directory  name,  a   new  window  is
  5089.                               created  with   the  standard   dimensions
  5090.                               defined for the default list format.
  5091.  
  5092.  
  5093.                            SHIFT-DEL                Close current window
  5094.  
  5095.                               SHIFT-DEL  closes   the   current   window
  5096.                               (unless it is the only open window).
  5097.  
  5098.  
  5099.                            GREY-*                  Resize or move window
  5100.  
  5101.                               This key is the  grey asterisk key  on the
  5102.                               numeric  keypad.  Some  earlier  XT  style
  5103.                               keyboards have  this  key marked  "PrtSc",
  5104.                               "Prt Sc" or "Print Screen". After pressing
  5105.                               this, a double  frame is drawn  around the
  5106.                               current window; you can use the ARROW KEYS
  5107.                               to move the frame and  SHIFT-ARROW KEYS to
  5108.                               resize. Press ENTER to keep the changes or
  5109.                               ESC to restore the original window state.
  5110.  
  5111.  
  5112.                            CTRL-BSPACE              View disk statistics
  5113.  
  5114.                               Beneath the File Manager windows, InspectA
  5115.                               maintains another  window  containing  the
  5116.                               current   disk,    directory   and    file
  5117.                               statistics. If this is obscured completely
  5118.                               or partially  by other  windows it  can be
  5119.                               temporarily shifted to the top by pressing
  5120.                               CTRL-BACKSPACE.
  5121.  
  5122.                               From the  file  manager,  mark  &  un-mark
  5123.                               functions are  provided  by  holding  down
  5124.                               either SHIFT key and using UP, DOWN, PGUP,
  5125.                               PGDN, HOME and END cursor movement keys.
  5126.  
  5127.  
  5128.  
  5129.  
  5130.             78                                                  InspectA
  5131.  
  5132.  
  5133.                                                       InspectA Functions
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.                               Some of  the  functions  above  require  a
  5140.                               "destination" path or file;  this involves
  5141.                               the File  Selection  Prompt, discussed  in
  5142.                               length in a later chapter.
  5143.  
  5144.  
  5145.                            / (fwd-slash)                  Pulldown menus
  5146.  
  5147.                               The  pulldown  menu  may  be  accessed  by
  5148.                               pressing the  forward slash  key. You  may
  5149.                               then navigate  the menus  in a  "point and
  5150.                               shoot" manner  using  the  ARROW KEYS and
  5151.                               select the  function you  wish to  execute
  5152.                               using ENTER. Press   ESC at  any  time  to
  5153.                               return to the File Manager.
  5154.  
  5155.  
  5156.                            \ (back-slash)               Change directory
  5157.  
  5158.                               To quickly and directly change the current
  5159.                               window's directory  to another,  press the
  5160.                               back-slash key. This invokes  the standard
  5161.                               file and directory selection  prompt where
  5162.                               the directory  name to  change  to may  be
  5163.                               typed in directly.
  5164.  
  5165.  
  5166.                            ? (questionmark)                  Toggle Menu
  5167.  
  5168.                               This  toggles  the  pulldown  menu  titles
  5169.                               on/off.
  5170.  
  5171.  
  5172.  
  5173.             Archive Manager
  5174.  
  5175.                            InspectA provides the ability to view  multi-
  5176.                            file archives of  the types described  above.
  5177.                            To further manipulate those archives (add to,
  5178.                            delete, extract and view), you will need  the
  5179.                            appropriate piece  of software  as  indicated
  5180.                            below. Note  that you  only need  one of  the
  5181.                            programs mentioned to  support any type,  and
  5182.                            that some  programs  support  more  than  one
  5183.                            format.
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.             InspectA                                                  79
  5192.  
  5193.  
  5194.             InspectA Functions
  5195.  
  5196.  
  5197.  
  5198.  
  5199.  
  5200.                       FormatOS       Description (Author)
  5201.  
  5202.  
  5203.  
  5204.                       AR5   OS2/DOS  ARC.EXE, 5.12 or higher (SEA)
  5205.  
  5206.                             DOS      PKARC.COM, PKPAK.EXE 3.x (PKWare)
  5207.  
  5208.                       AR6   OS2/DOS  ARC.EXE,  version  6.02  or  higher
  5209.                                      (SEA)
  5210.  
  5211.                       AR7   OS2/DOS  ARC.EXE,  version  7.12  or  higher
  5212.                                      (SEA)
  5213.  
  5214.                             OS2/DOS  ARCPLUS.EXE, version 7.12 (SEA)
  5215.  
  5216.                             OS2/DOS  XARC.EXE - extract only (SEA)
  5217.  
  5218.                       PKA   DOS      PKARC.COM/EXE 3.x,  PKPAK.EXE  3.61
  5219.                                      (PKWare)
  5220.  
  5221.                             DOS      PAK.EXE v2.51 or higher (NoGate)
  5222.  
  5223.                             OS2/DOS  ARCPLUS.EXE - extract only (SEA)
  5224.  
  5225.                       PAK   DOS      PAK.EXE v2.51 or higher (NoGate)
  5226.  
  5227.                       ZIP   DOS      PKZIP.EXE,PKUNZIP.EXE v1.1 (PKWare)
  5228.  
  5229.                             OS2      PKZIP2.EXE,PKUNZIP2.EXE        v1.1
  5230.                                      (PKWare)
  5231.  
  5232.                             OS2/DOS  ZIP.EXE 1.0,  UNZIP.EXE 4.2  (Info-
  5233.                                      Zip)
  5234.  
  5235.                       ZI2   DOS      PKZIP.EXE,PKUNZIP.EXE        v2.04g
  5236.                                      (PKWare)
  5237.  
  5238.                             OS2      ZIP.EXE 1.9,  UNZIP.EXE 5.0  (Info-
  5239.                                      Zip)
  5240.  
  5241.                       LZH   DOS      LHARC.EXE v1.13 or higher (Yoshi)
  5242.  
  5243.                             DOS      LHA.EXE v2.0 or higher (Yoshi)
  5244.  
  5245.                             OS2      LH.EXE v1.x or higher (A:WARE)
  5246.  
  5247.                       LHA   DOS      LHA.EXE v2.X (Yoshi)
  5248.  
  5249.  
  5250.  
  5251.  
  5252.             80                                                  InspectA
  5253.  
  5254.  
  5255.                                                       InspectA Functions
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.                             OS2      LH.EXE v2.x or higher (A:WARE)
  5262.  
  5263.                       ZOO   OS2/DOS  ZOO.EXE v2.01 or higher (Dhesi)
  5264.  
  5265.                       ZOH   OS2/DOS  ZOO.EXE v2.10 (Dhesi)
  5266.  
  5267.                       ARJ   DOS      ARJ.EXE v2.x (Jung)
  5268.  
  5269.                             OS2/DOS  UNARJ.EXE v2.x (Jung)
  5270.  
  5271.                       HPK   OS2/DOS  HPACK.EXE 0.78 or higher (Gutman)
  5272.  
  5273.                                      NOTE: InspectA  no longer  supports
  5274.                                      HPACK v0.75
  5275.  
  5276.                       DWC   DOS      DWC.EXE vA5.01
  5277.  
  5278.  
  5279.  
  5280.                            Without these programs,  InspectA will  still
  5281.                            be able to list  the internal directories  of
  5282.                            these archive formats, but cannot provide any
  5283.                            further  management   functions  because   it
  5284.                            relies upon the programs above to perform the
  5285.                            actual  Add,   Delete,   Extract   and   Test
  5286.                            operations.
  5287.  
  5288.                            Similar to the files list, the archive viewer
  5289.                            provides the ability to examine the  internal
  5290.                            directory of the compressed library. The list
  5291.                            may be  scrolled using  the  ARROW KEYS, and
  5292.                            archive  members  marked   and  unmarked   by
  5293.                            holding down SHIFT and using  UP, DOWN, PGUP,
  5294.                            PGDN, HOME and END keys.
  5295.  
  5296.                            The  following  functions  are  available  in
  5297.                            Archive View mode:
  5298.  
  5299.  
  5300.                            DEL                                    Delete
  5301.  
  5302.                               Delete current or marked files.
  5303.  
  5304.  
  5305.                            ALT-E                                 Extract
  5306.  
  5307.                               Extract current file  or all  marked files
  5308.                               to a nominated directory.
  5309.  
  5310.  
  5311.  
  5312.  
  5313.             InspectA                                                  81
  5314.  
  5315.  
  5316.             InspectA Functions
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.                            ENTER                                  Select
  5323.  
  5324.                               Extract   current   file,   then   execute
  5325.                               whatever action would  be if the  file was
  5326.                               selected from the  File Manager  list (ie.
  5327.                               view  archive,  view  packet,  message  or
  5328.                               file).
  5329.  
  5330.  
  5331.                            ALT-Z                                   Shell
  5332.  
  5333.                               Shell to  the  command  interpreter,  type
  5334.                               'EXIT' to return to InspectA.
  5335.  
  5336.  
  5337.                            ESC                      Exit Archive Manager
  5338.  
  5339.                               Quits the Archive  Manager and  returns to
  5340.                               the File Manager.
  5341.  
  5342.  
  5343.  
  5344.             FidoNet Related Functions
  5345.  
  5346.                            Skip  this  section  unless  you  operate   a
  5347.                            FidoNet mail system, and wish to make use  of
  5348.                            the mail-file handling features of InspectA.
  5349.  
  5350.                            In the  Paths  section of  ICONFIG,  you  can
  5351.                            nominate  that   specific   directories   are
  5352.                            treated  as  though  they  are  "Inbound"  or
  5353.                            "Outbound"  file  holding  areas  used  by  a
  5354.                            FidoNet  mailer.   These   directories   have
  5355.                            special properties in  that they may  contain
  5356.                            files which are named according to their type
  5357.                            and  a  remote  system  address,  usually  in
  5358.                            hexadecimal. To assist in management of  mail
  5359.                            and  to  assist  in  identifying  where  mail
  5360.                            packets are destined for or originated  from,
  5361.                            InspectA provides  the ability  to  calculate
  5362.                            the remote system address as indicated by the
  5363.                            file name. This appears  as a comment to  the
  5364.                            right of the file name  in the list of  files
  5365.                            presented by the File Manager; in all  cases,
  5366.                            an explicit  entry  in the  description  file
  5367.                            will override any calculated address and will
  5368.                            be displayed in preference.
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.             82                                                  InspectA
  5375.  
  5376.  
  5377.                                                       InspectA Functions
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.                            The resolution of remote addresses works most
  5384.                            reliably   with   Opus/BinkleyTerm   outbound
  5385.                            holding areas, since  InspectA uses the  same
  5386.                            algorithm to determine the address. Make sure
  5387.                            that the FidoNet addresses are configured  in
  5388.                            InspectA in  the  same order  as  the  mailer
  5389.                            users! Also, be sure to suppress those  parts
  5390.                            of the addressing which your mailer cannot or
  5391.                            is configured  not to  use:  ie. if  you  run
  5392.                            Opus, be sure  to suppress  zone, domain  and
  5393.                            point    resolution    in    your    "Mailer"
  5394.                            configuration,  and  configure  according  to
  5395.                            your  BinkleyTerm   domain  setup   and   the
  5396.                            "NoZones" setting in BINKLEY.CFG.
  5397.  
  5398.                            Note that  when  you use  a  static  outbound
  5399.                            mailer  such  as  Opus  or  BinkleyTerm,  you
  5400.                            should specify  only the  "primary"  outbound
  5401.                            area which applies to  your first aka's  zone
  5402.                            and domain. All of  the other outbound  areas
  5403.                            will   be   recognised   automatically    for
  5404.                            directories which are  subdirectories of  the
  5405.                            same 'root' directory as the primary one, and
  5406.                            the   directory   name's   extension   is   a
  5407.                            hexadecimal number.
  5408.  
  5409.                            Use of this facility with dynamic mailers and
  5410.                            various mail packing and processing  software
  5411.                            will have varying results since many of  them
  5412.                            have different ways  of calculating the  file
  5413.                            name  from  the  remote  address.  You   will
  5414.                            probably  find   that  the   "ARCmail   0.60"
  5415.                            standard naming convention  will be used  for
  5416.                            other systems  in your  default address  zone
  5417.                            only.  In  almost  all  other  cases,  it  is
  5418.                            impossible to work back from the file name to
  5419.                            the destination address  by any  calculation.
  5420.                            Whenever a calculated  address appears to  be
  5421.                            suspect, InspectA precedes the address with a
  5422.                            question mark.
  5423.  
  5424.                            You can circumvent this problem by using  the
  5425.                            wildcard description feature:  once you  find
  5426.                            out which  system a  bundle of  a  particular
  5427.                            name is destined for, place that name with  a
  5428.                            ".*" extension  into  the  description  file,
  5429.                            followed by  the destination  address.  Since
  5430.                            the description file overrides the calculated
  5431.  
  5432.  
  5433.  
  5434.  
  5435.             InspectA                                                  83
  5436.  
  5437.  
  5438.             InspectA Functions
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.                            address, the "correct"  address is  displayed
  5445.                            instead of that which InspectA calculates.
  5446.  
  5447.                            For example:
  5448.  
  5449.  
  5450.                                 00000FBC.* 3:632/348.44@fidonet
  5451.  
  5452.                            Even on  BinkleyTerm/Opus systems,  this  can
  5453.                            also be  handy to  identify bundles  in  your
  5454.                            inbound directory,  where bundle  names  sent
  5455.                            from remote systems are less predictable  and
  5456.                            likely to  not conform  to the  ARCmail  0.60
  5457.                            naming.
  5458.  
  5459.                            Since 4DOS or NDOS may remove descriptions of
  5460.                            this type which do not match with a  specific
  5461.                            file, you may find it more convenient to  not
  5462.                            use a "DESCRIPT.ION"  file for your  outbound
  5463.                            files,  but   instead  define   a   secondary
  5464.                            description list name and use this instead.
  5465.  
  5466.                            When  logged  into   one  of  these   special
  5467.                            directories,  InspectA  will  enable  use  of
  5468.                            additional file types,  which represent  what
  5469.                            the files mean to the mailer software.  These
  5470.                            are:
  5471.  
  5472.                               ?LO    Outbound   'static   mailer'   file
  5473.                                      attach list
  5474.  
  5475.                               BDL    Outbound mail  file,  archiver  not
  5476.                                      yet determined
  5477.  
  5478.                               BSY    Mailer 'address busy' flag
  5479.  
  5480.                               REQ    Inbound or  outbound  file  request
  5481.                                      list
  5482.  
  5483.                               PRO    Call in progress list
  5484.  
  5485.                               BWZ    Bad 'Wazoo' (file transfer) marker
  5486.  
  5487.                            "BDL" (outbound  compressed mail  files)  are
  5488.                            necessarily archived files, and once a bundle
  5489.                            is  accessed  or   its  type  determined   by
  5490.                            InspectA, this type will  be replaced by  the
  5491.                            archiving  method.  However,  when  initially
  5492.  
  5493.  
  5494.  
  5495.  
  5496.             84                                                  InspectA
  5497.  
  5498.  
  5499.                                                       InspectA Functions
  5500.  
  5501.  
  5502.  
  5503.  
  5504.  
  5505.                            logging an  inbound  or  outbound  directory,
  5506.                            placing these files into a broad class  helps
  5507.                            when sorting all files  by type by file  name
  5508.                            (and therefore address).
  5509.  
  5510.  
  5511.  
  5512.             FTSC Type 2 Packet Manager
  5513.  
  5514.                            On  selecting  a  FidoNet  type  2.x  packet,
  5515.                            InspectA will use its "packet view" mode. The
  5516.                            initial screen displays the packet  contents,
  5517.                            one message  per  line,  with  packet  header
  5518.                            details on the bottom line, including:
  5519.  
  5520.                       Field          Description
  5521.  
  5522.  
  5523.  
  5524.                       Type           The packet type, which will be  one
  5525.                                      of:
  5526.  
  5527.                            Stoneage  "Old" style  type 2  packets.  This
  5528.                                      type  of  packet   is  assumed   to
  5529.                                      contain no  valid  zone  and  point
  5530.                                      information.
  5531.  
  5532.                            4D Pkt    Several products in FidoNet include
  5533.                                      4D (zone and point) information  in
  5534.                                      packet  headers.   Other  than   by
  5535.                                      looking at the product code,  there
  5536.                                      is no  certain way  of  determining
  5537.                                      which are 4D packets or not.
  5538.  
  5539.                                      InspectA  uses  the  product  codes
  5540.                                      list  defined  and  maintained   in
  5541.                                      ICONFIG to determine which  product
  5542.                                      types  have   extended   addressing
  5543.                                      capability, but which  may not  use
  5544.                                      either type-2+ or type2.2  extended
  5545.                                      addressing.
  5546.  
  5547.                            Type 2+   This packet  type is  described  in
  5548.                                      the FTSC document FSC-0039. Packets
  5549.                                      of this type  always contain  valid
  5550.                                      zone    and    point     addressing
  5551.                                      information  and  also  contain   a
  5552.                                      "signature"      which      readily
  5553.  
  5554.  
  5555.  
  5556.  
  5557.             InspectA                                                  85
  5558.  
  5559.  
  5560.             InspectA Functions
  5561.  
  5562.  
  5563.  
  5564.  
  5565.  
  5566.                                      identifies them  from other  packet
  5567.                                      types.
  5568.  
  5569.                            Type 2.2  This packet  type is  used by  some
  5570.                                      mailers and mail handling software,
  5571.                                      and -  like type  2+ -  is  readily
  5572.                                      identifiable  by   its   signature.
  5573.                                      Since these package can be  readily
  5574.                                      identified,  the  zone,  point  and
  5575.                                      domain information is assumed to be
  5576.                                      correct.
  5577.  
  5578.                       O=             Displays the  origin address.  This
  5579.                                      will be net/node  only in the  case
  5580.                                      of a "stoneage" packet, and will be
  5581.                                      4D (zone:net/node.point) for 4D and
  5582.                                      2+       types,       and        4D
  5583.                                      (zone:net/node.point@domain)    for
  5584.                                      type 2.2  packets.  Note  that  for
  5585.                                      type  2.2   packets,  domains   are
  5586.                                      truncated to 8 characters.
  5587.  
  5588.                       D=             Displays  the  destination  address
  5589.                                      for  the  packet.  The  same  rules
  5590.                                      regarding address resolution apply.
  5591.  
  5592.                       Product        The FTSC product code in the packet
  5593.                                      header, together  with the  product
  5594.                                      description    (if    known)     is
  5595.                                      displayed.
  5596.  
  5597.                            You should  refer  to the  FidoNet  Standards
  5598.                            Committee   documents   FTS-0001   "A   basic
  5599.                            FidoNet(r) technical  standard", FTS-0039  "A
  5600.                            type-2 packet extension  protocol", and  FTS-
  5601.                            0045  "A  new  packet  header  format",   for
  5602.                            additional information contained in and  used
  5603.                            by "type 2" mail packets.
  5604.  
  5605.                            Each line  in the  list represents  a  packet
  5606.                            message, showing:
  5607.  
  5608.                       Field          Description
  5609.  
  5610.  
  5611.  
  5612.                       Inf            An entry in the first three  places
  5613.                                      indicates that data  in the  packed
  5614.  
  5615.  
  5616.  
  5617.  
  5618.             86                                                  InspectA
  5619.  
  5620.  
  5621.                                                       InspectA Functions
  5622.  
  5623.  
  5624.  
  5625.  
  5626.  
  5627.                                      message  header  is  in  some   way
  5628.                                      corrupt or malformed. This  usually
  5629.                                      indicates that one or more messages
  5630.                                      may  be   corrupt,  or   that   the
  5631.                                      software  used   to  generate   the
  5632.                                      original message  was in  some  way
  5633.                                      deficient.   Entries   here    will
  5634.                                      indicate one of:
  5635.  
  5636.                            D         A malformed date.  The most  common
  5637.                                      of these is  a missing  space in  a
  5638.                                      "Fido" format date, which should be
  5639.                                      of the form:
  5640.  
  5641.                                                "DD Mon YY  HH:MM:SS".
  5642.  
  5643.                                      Although these malformed dates  are
  5644.                                      reasonably       common,       they
  5645.                                      nevertheless   remain   a   problem
  5646.                                      because only  dates of  exactly  20
  5647.                                      characters   in   length   can   be
  5648.                                      considered valid for type 2  packet
  5649.                                      format.  Most  software  does  work
  5650.                                      around this however.
  5651.  
  5652.                            L         One or  more fields  in the  header
  5653.                                      are too  long.  This  usually  does
  5654.                                      mean that a packet is partially  or
  5655.                                      completely  corrupt.  The   maximum
  5656.                                      lengths of  header  fields  are  35
  5657.                                      characters  for  'to'  and   'from'
  5658.                                      names,  20   characters   for   the
  5659.                                      message date, and 71 characters for
  5660.                                      the message subject.
  5661.  
  5662.                            I         Indicates invalid (non-7bit  ascii)
  5663.                                      data in one or more header  fields.
  5664.                                      Depending on where  you live,  this
  5665.                                      may or may not indicate that  there
  5666.                                      is a problem. Some parts of Europe,
  5667.                                      in the absence of any standards for
  5668.                                      use of character  sets, have  opted
  5669.                                      to use  IBM-PC specific  characters
  5670.                                      as part of  their alphabet, and  so
  5671.                                      this would  be considered  'normal'
  5672.                                      in   that   case.   However,   this
  5673.                                      indicator can usually show that the
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.             InspectA                                                  87
  5680.  
  5681.  
  5682.             InspectA Functions
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.                                      field's data may  be corrupted  and
  5689.                                      should be examined further.
  5690.  
  5691.                            G         Indicate  that   the   message   is
  5692.                                      "grunged" in some  way. This  comes
  5693.                                      about if  any embedded  NUL  (ASCII
  5694.                                      0)'s are discovered at any position
  5695.                                      in  between   the  message   header
  5696.                                      information   and   the   following
  5697.                                      message or end of packet. A NUL  is
  5698.                                      used  to  indicate  the  end  of  a
  5699.                                      message, so if a NUL is  discovered
  5700.                                      at a position which is not the  end
  5701.                                      of the  message as  expected,  then
  5702.                                      the message  is considered  garbled
  5703.                                      and invalid.
  5704.  
  5705.                       Date           Date of the  message, or  *Invalid*
  5706.                                      if  it  cannot  be  read  at   all.
  5707.                                      InspectA  reads  and  interprets  a
  5708.                                      number of technically  non-standard
  5709.                                      dates in addition to those  formats
  5710.                                      specifically allowed  by  FTS-0001.
  5711.                                      It will, however  flag an error  on
  5712.                                      the  date,  even   if  it  can   be
  5713.                                      interpreted if the  date format  is
  5714.                                      non-compliant.
  5715.  
  5716.                       From           Author of the message.
  5717.  
  5718.                       To             Name  to  which   the  message   is
  5719.                                      addressed.
  5720.  
  5721.                       Subject        Message subject (or if "area"  mode
  5722.                                      is enabled, it  shows the  echomail
  5723.                                      tag for the  message, or  "NETMAIL"
  5724.                                      if it doesn't have one).
  5725.  
  5726.                            As  each  message  is  highlighted  with  the
  5727.                            cursor bar, additional information  regarding
  5728.                            each message is shown above the packet header
  5729.                            information  at  the  foot  of  the  display,
  5730.                            consisting of:
  5731.  
  5732.  
  5733.  
  5734.  
  5735.  
  5736.  
  5737.  
  5738.  
  5739.  
  5740.             88                                                  InspectA
  5741.  
  5742.  
  5743.                                                       InspectA Functions
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.                       Field          Description
  5750.  
  5751.  
  5752.  
  5753.                       [#/#]          Message number of a total number of
  5754.                                      messages.
  5755.  
  5756.                       Origin         Shows the  origin  address  of  the
  5757.                                      currently highlighted message. Note
  5758.                                      that packed message headers do  not
  5759.                                      contain  zone,   point  or   domain
  5760.                                      information, so this will show only
  5761.                                      net/node.
  5762.  
  5763.                       Dest           Destination    address    of    the
  5764.                                      currently highlighted message.
  5765.  
  5766.                       Offset         Shows the offset (distance in bytes
  5767.                                      from the  start  of  file)  of  the
  5768.                                      current  message   in   hexadecimal
  5769.                                      notation. This  is  useful  when  a
  5770.                                      mail processor  records offsets  at
  5771.                                      which  it   considers   a   message
  5772.                                      grunged or  corrupted. The  problem
  5773.                                      can   be   quickly   located    and
  5774.                                      eliminated
  5775.  
  5776.                       Area           If  the  message  is  an   echomail
  5777.                                      message  (ie.   the  message   text
  5778.                                      starts  with   AREA:<tag>  or   the
  5779.                                      message     body     contains     a
  5780.                                      ^aAREA:<tag>  control  line),   the
  5781.                                      area tag is shown. Anything else is
  5782.                                      assumed to be netmail.
  5783.  
  5784.                            Functions available from  the packed  message
  5785.                            list are:
  5786.  
  5787.  
  5788.                            ENTER                            View message
  5789.  
  5790.                               View highlighted  message,  enter  message
  5791.                               view mode.
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.             InspectA                                                  89
  5802.  
  5803.  
  5804.             InspectA Functions
  5805.  
  5806.  
  5807.  
  5808.  
  5809.  
  5810.                            ALT-H                           Packet header
  5811.  
  5812.                               Displays packet  header  information.  The
  5813.                               first displayed window shows  the complete
  5814.                               message header,  interpreted according  to
  5815.                               its type,  together  with  other  relevant
  5816.                               information. Pressing  Alt-H again  cycles
  5817.                               through two other screens, which include a
  5818.                               hex and ascii  dump of the  message header
  5819.                               and packet diagnostic information.
  5820.  
  5821.  
  5822.                            SPACE                                    Mark
  5823.  
  5824.                               Mark a message (usually for deletion).
  5825.  
  5826.  
  5827.                            F2                                Global Mark
  5828.  
  5829.                               Mark/un-mark all messages.
  5830.  
  5831.  
  5832.                            CTRL-A                                   Area
  5833.  
  5834.                               Toggles the display of AREA: tags for each
  5835.                               message instead of subject.
  5836.  
  5837.  
  5838.                            DEL                                    Delete
  5839.  
  5840.                               Deletes a message (or all marked messages)
  5841.                               from a packet. BE CAREFUL IF  YOU USE THIS
  5842.                               OPTION. When  deleting  the first  message
  5843.                               from a packet, InspectA will warn you that
  5844.                               you are  about to  delete mail.  Note that
  5845.                               the message  is  not immediately  deleted,
  5846.                               and this  is delayed  until you  allow the
  5847.                               packet to be rebuilt.
  5848.  
  5849.  
  5850.                            ALT-S                                    Sort
  5851.  
  5852.                               Selects the sorting criteria  for messages
  5853.                               within the  packet. When  used with  Alt-C
  5854.                               (set changed  flag), this  can be  used to
  5855.                               physically  reorder   messages  within   a
  5856.                               packet.
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.             90                                                  InspectA
  5863.  
  5864.  
  5865.                                                       InspectA Functions
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.                            ALT-C                        Toggle "changed"
  5872.  
  5873.                               Toggles the  "packet  changed" flag.  When
  5874.                               set, InspectA will ask whether you wish to
  5875.                               rebuild the packet when ESC is pressed.
  5876.  
  5877.  
  5878.                            ALT-M                       Export to message
  5879.  
  5880.                               Exports one  or  all  marked  messages  to
  5881.                               *.MSG format to a directory nominated.
  5882.  
  5883.  
  5884.                            CTRL-S                           Split packet
  5885.  
  5886.                               This  function  provides  the  ability  to
  5887.                               split the current packet into  one or more
  5888.                               packets  -  it  is  especially  handy  for
  5889.                               splitting  very  large  packets  for  more
  5890.                               convenient handling.
  5891.  
  5892.                               Note that  use of  this function  does not
  5893.                               require that the entire packet can be read
  5894.                               into memory  and will  work regardless  of
  5895.                               whether the packet scan has been completed
  5896.                               or not. You can use ESC to abort the scan
  5897.                               and then CTRL-S to split the packet.
  5898.  
  5899.  
  5900.                            ALT-Z                                   Shell
  5901.  
  5902.                               Shell to DOS.
  5903.  
  5904.                            Messages  may  also  be  marked/un-marked  by
  5905.                            holding down the SHIFT key and using the  UP,
  5906.                            DOWN, PGUP,  PGDN, HOME and END keys to mark
  5907.                            in the direction moved.
  5908.  
  5909.  
  5910.  
  5911.             Message View
  5912.  
  5913.                            When viewing  messages  within  packets,  the
  5914.                            following keys may be used:
  5915.  
  5916.  
  5917.  
  5918.  
  5919.  
  5920.  
  5921.  
  5922.  
  5923.             InspectA                                                  91
  5924.  
  5925.  
  5926.             InspectA Functions
  5927.  
  5928.  
  5929.  
  5930.  
  5931.  
  5932.                       Key            Description
  5933.  
  5934.  
  5935.  
  5936.                       LEFT           Previous message
  5937.  
  5938.                       RIGHT          Next message
  5939.  
  5940.                       HOME           First message in packet
  5941.  
  5942.                       END            Last message in packet
  5943.  
  5944.                       UP             Scroll message up
  5945.  
  5946.                       DOWN           Scroll message down
  5947.  
  5948.                       PGDN           Scroll message down 1 screen
  5949.  
  5950.                       PGUP           Scroll message up 1 screen
  5951.  
  5952.                       CTRL-S         Toggle seen-by viewing
  5953.  
  5954.                       CTRL-C         Toggle hard CR viewing
  5955.  
  5956.                       CTRL-K         Toggle control line viewing
  5957.  
  5958.                       CTRL-M         Export individual messages to  .MSG
  5959.                                      format
  5960.  
  5961.                       SPACE          Toggle mark
  5962.  
  5963.                            When viewing .MSG files  from the files  list
  5964.                            directly, the above  keys also apply,  except
  5965.                            that only  one message  may  be viewed  at  a
  5966.                            time, and  exporting to  .MSG format  is  not
  5967.                            available.
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.  
  5974.  
  5975.  
  5976.  
  5977.  
  5978.  
  5979.  
  5980.  
  5981.  
  5982.  
  5983.  
  5984.             92                                                  InspectA
  5985.  
  5986.  
  5987.                                                          Common Features
  5988.  
  5989.  
  5990.  
  5991.  
  5992.  
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.             Common Features
  5999.  
  6000.  
  6001.                            Various other parts of the user interface are
  6002.                            common throughout the program and do not vary
  6003.                            irrespective of their context.
  6004.  
  6005.  
  6006.  
  6007.             Path Selection
  6008.  
  6009.                            The first of these  is the entry window  used
  6010.                            to enter  directory file  or path  names.  In
  6011.                            addition to simple field  entry in which  the
  6012.                            directory or path to use may be entered  from
  6013.                            the keyboard,  the  window  also  offers  the
  6014.                            following additional functions:
  6015.  
  6016.  
  6017.                            F6                                 Files List
  6018.  
  6019.                               Enters  files  list  selection  mode  (see
  6020.                               below, Files List Selection).
  6021.  
  6022.  
  6023.                            F9                             Directory Tree
  6024.  
  6025.                               Press F9 to invoke the directory view mode
  6026.                               (see below, Directory Tree).
  6027.  
  6028.  
  6029.                            F8                                Paths Index
  6030.  
  6031.                               Allows a directory to be selected from the
  6032.                               "Path Index",  which  is  defined  in  the
  6033.                               Paths list in ICONFIG.
  6034.  
  6035.  
  6036.                            ENTER                   Select File/Directory
  6037.  
  6038.                               Pressing enter  (F10 is  also  an  alias)
  6039.                               confirms entry.  If  the  field is  empty,
  6040.                               Files List mode  will be  invoked, showing
  6041.  
  6042.  
  6043.  
  6044.  
  6045.             InspectA                                                  93
  6046.  
  6047.  
  6048.             Common Features
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.                               all files in the current directory. If the
  6055.                               file or  directory is  not acceptable  for
  6056.                               some reason,  an  error  message  will  be
  6057.                               displayed and you will be  returned to the
  6058.                               path selection prompt.
  6059.  
  6060.  
  6061.                            ESC                                     Abort
  6062.  
  6063.                               Aborts/cancels entry  and  returns to  the
  6064.                               original context.
  6065.  
  6066.  
  6067.  
  6068.             Files List Selection
  6069.  
  6070.                            File selection offers  the ability to  browse
  6071.                            the directory structure to select the file or
  6072.                            directory you wish to action. By supplying  a
  6073.                            wildcard specification at the Path  Selection
  6074.                            prompt, you can  also limit what  you see  to
  6075.                            only those files which match the wildcard, or
  6076.                            directories.
  6077.  
  6078.                            For example, if you enter:
  6079.  
  6080.  
  6081.                                 D:\FILES\*.BAT
  6082.  
  6083.                            then the only  files that  will be  displayed
  6084.                            are those with  the extension  "BAT" and  all
  6085.                            directories,  starting   in   the   directory
  6086.                            D:\FILES.
  6087.  
  6088.                            Pressing ENTER on any directory entry changes
  6089.                            to that directory.  ENTER while on  any non-
  6090.                            directory entry selects the highlighted  file
  6091.                            as the  target.  If  you  wish  to  select  a
  6092.                            directory name, press F10 instead.
  6093.  
  6094.                            Use CTRL-D to change drives (see below, Drive
  6095.                            Selection).
  6096.  
  6097.                            F9 invokes the graphical directory tree  (see
  6098.                            below, Directory Tree)
  6099.  
  6100.                            ESC aborts file selection and returns to  the
  6101.                            Path Selection prompt.
  6102.  
  6103.  
  6104.  
  6105.  
  6106.             94                                                  InspectA
  6107.  
  6108.  
  6109.                                                          Common Features
  6110.  
  6111.  
  6112.  
  6113.  
  6114.  
  6115.                            You can also  type in letters  to locate  the
  6116.                            file name with the closest match.  TAB clears
  6117.                            all letters previously entered.
  6118.  
  6119.  
  6120.  
  6121.             Directory Tree
  6122.  
  6123.                            This may be used to easily find a  particular
  6124.                            directory by moving  around a "tree"  diagram
  6125.                            instead of  having to  move through  multiple
  6126.                            directories to select the one you want.
  6127.  
  6128.                            The  Directory  Tree  is  either  derived  by
  6129.                            scanning all directories on  a drive when  it
  6130.                            is invoked, or it may be optionally read from
  6131.                            disk if the option  to use a Directory  Index
  6132.                            is enabled in ICONFIG (General, Options).  If
  6133.                            the current  directory  on  a  drive  is  not
  6134.                            present in  the  directory  index  read  from
  6135.                            disk, InspectA will ask if you wish to rescan
  6136.                            the drive to update the index file.
  6137.  
  6138.                            When the  tree  is displayed,  the  following
  6139.                            keys may be used:
  6140.  
  6141.                       Key            Description
  6142.  
  6143.  
  6144.  
  6145.                       UP/DOWN        Navigate the  tree,  up  and  down,
  6146.                                      from one branch to the next.
  6147.  
  6148.                       RIGHT          Parent to child or next sibling  if
  6149.                                      not child exists.
  6150.  
  6151.                       LEFT           Child to parent.
  6152.  
  6153.                       HOME           Top of list (root directory)
  6154.  
  6155.                       END            Bottom of the list.
  6156.  
  6157.                       PGUP/PGDN      Up or down by screen.
  6158.  
  6159.                       ENTER          Select  a   directory,  return   to
  6160.                                      caller.
  6161.  
  6162.  
  6163.  
  6164.  
  6165.  
  6166.  
  6167.             InspectA                                                  95
  6168.  
  6169.  
  6170.             Common Features
  6171.  
  6172.  
  6173.  
  6174.  
  6175.  
  6176.                       CTRL-R         Rescan current  drive; this  forces
  6177.                                      InspectA  to  physically  scan  the
  6178.                                      drive and re-generate  its view  of
  6179.                                      the drive. Since  disk index  files
  6180.                                      can  get   out  of   date  due   to
  6181.                                      directories   being   created    or
  6182.                                      deleted outside  of  InspectA,  you
  6183.                                      should   do    this    periodically
  6184.                                      whenever you find an  inconsistency
  6185.                                      between what  is presented  on  the
  6186.                                      directory tree and the disk itself.
  6187.  
  6188.                                      Note that INSPECT's -m command line
  6189.                                      switch provides a  way of  updating
  6190.                                      these  automatically  on  all  non-
  6191.                                      removable drives.
  6192.  
  6193.                       CTRL-D/F9      Select drive. This provides a means
  6194.                                      of switching the viewed drive  from
  6195.                                      the  directory  tree  display.  See
  6196.                                      Drive  Selection  below  for   more
  6197.                                      information.
  6198.  
  6199.                       <text>         To  locate   a  directory   without
  6200.                                      having to  scroll up  and down  the
  6201.                                      tree, you can simply type its  name
  6202.                                      and have InspectA home in on it  to
  6203.                                      locate a close or exact match.
  6204.  
  6205.                       TAB/SHIFT-TAB  Search for next directory  matching
  6206.                                      the search  text. For  example,  if
  6207.                                      you  have  two  directories   named
  6208.                                      "SECRET",  then   typing   in   the
  6209.                                      letters S-E-C-R-E-T will locate the
  6210.                                      first   one   below   the   current
  6211.                                      starting position  with that  name.
  6212.                                      Move to the  next directory of  the
  6213.                                      same name by using this key.
  6214.  
  6215.                       INS            Make a new directory below the  one
  6216.                                      currently highlighted.
  6217.  
  6218.                       DEL            Delete the  highlighted  directory.
  6219.                                      The directory  being  deleted  must
  6220.                                      contain no files or  subdirectories
  6221.                                      whatsoever for the  deletion to  be
  6222.                                      successful. Also, you should ensure
  6223.                                      that the directory being deleted is
  6224.  
  6225.  
  6226.  
  6227.  
  6228.             96                                                  InspectA
  6229.  
  6230.  
  6231.                                                          Common Features
  6232.  
  6233.  
  6234.  
  6235.  
  6236.  
  6237.                                      not your current directory (you can
  6238.                                      change if  necessary by  using  the
  6239.                                      SPACE key).
  6240.  
  6241.                       F2             Renames the highlighted  directory.
  6242.                                      You may  be  prevented  from  doing
  6243.                                      this on some networks which require
  6244.                                      special  network-specific  ways  to
  6245.                                      change directory names.
  6246.  
  6247.                            The following  keys are  also active  if  the
  6248.                            directory tree  is  invoked  from  the  files
  6249.                            list:
  6250.  
  6251.                       SPACE          Change to the highlighted directory
  6252.                                      and   refresh   the   files    list
  6253.                                      displayed  beneath  the   directory
  6254.                                      tree window.
  6255.  
  6256.                       F10            Enables  "follow-me"  mode,   which
  6257.                                      forces  InspectA  to  refresh   the
  6258.                                      files list  displayed as  you  move
  6259.                                      from one  directory  to  the  next.
  6260.                                      This is similar  to pressing  SPACE
  6261.                                      each  time  a   new  directory   is
  6262.                                      selected. This may slow things down
  6263.                                      considerably on some systems.
  6264.  
  6265.                            If the  directory tree  is invoked  from  the
  6266.                            files pick list,  the following  keys may  be
  6267.                            used:
  6268.  
  6269.                       F10            Switch to the files picklist.
  6270.  
  6271.  
  6272.  
  6273.             Drive Selection
  6274.  
  6275.                            The  Drive   Selection  list   is  a   pop-up
  6276.                            available  directly  from  the  File  Manager
  6277.                            (CTRL-D), from  the Directory  Tree, or  from
  6278.                            the Path Selection prompt from the  directory
  6279.                            or file selector windows.
  6280.  
  6281.                            This presents a list of available drives; the
  6282.                            current directory is shown next to each drive
  6283.                            letter, as well as  available disk space.  If
  6284.                            the drive  is  a non-removable  type  (ie.  a
  6285.  
  6286.  
  6287.  
  6288.  
  6289.             InspectA                                                  97
  6290.  
  6291.  
  6292.             Common Features
  6293.  
  6294.  
  6295.  
  6296.  
  6297.  
  6298.                            floppy disk),  InspectA does  not attempt  to
  6299.                            read  the  disk  to  determine  the   current
  6300.                            directory  and   free  space,   but   instead
  6301.                            displays the word "<floppy>". If the drive is
  6302.                            on  a  network  or  CD-ROM,  an  asterisk  is
  6303.                            displayed  between  the   drive  letter   and
  6304.                            directory name.
  6305.  
  6306.                            To select  a drive  letter, move  the  cursor
  6307.                            using the  ARROW KEYS or mouse, or  press the
  6308.                            key corresponding to the drive letter.  Press
  6309.                            ENTER to select. ESC cancels drive selection.
  6310.  
  6311.  
  6312.  
  6313.  
  6314.  
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.  
  6324.  
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343.  
  6344.  
  6345.  
  6346.  
  6347.  
  6348.  
  6349.  
  6350.             98                                                  InspectA
  6351.  
  6352.  
  6353.                                                        Networks & CD-ROM
  6354.  
  6355.  
  6356.  
  6357.  
  6358.  
  6359.  
  6360.  
  6361.  
  6362.  
  6363.  
  6364.             Networks & CD-ROM
  6365.  
  6366.  
  6367.                            InspectA is fully  network compatible; it  is
  6368.                            both aware of and explicitly supports use  on
  6369.                            a network,  including all  NETBIOS and  SHARE
  6370.                            based  networks  and  Novell  Netware.   This
  6371.                            section lists some of the considerations  you
  6372.                            may wish to take into account when setting up
  6373.                            InspectA for use by multiple users.
  6374.  
  6375.                            NOTE:  Use  of  InspectA  on  a  network  by
  6376.                            multiple  users  simultaneously  requires   a
  6377.                            multiple-user site licence.
  6378.  
  6379.  
  6380.                User Configuration
  6381.  
  6382.                            Users on a network should share a single copy
  6383.                            of INSPECT.EXE and ICONFIG.EXE, but may elect
  6384.                            to share  a  common  configuration  file,  or
  6385.                            maintain  a   separate  one   with   personal
  6386.                            preferences. In  the  first  case  (a  shared
  6387.                            configuration), place  INSPECT.INI  into  the
  6388.                            same directory  as the  executable file.  For
  6389.                            personal setup, you  must also  set the  HOME
  6390.                            environment variable on each workstation  (or
  6391.                            for each user) to point to a unique  location
  6392.                            on  the   network  drive   or  to   a   local
  6393.                            workstation drive  and  have  each  user  run
  6394.                            ICONFIG. This will  force the public  version
  6395.                            of INSPECT.INI to be read as a template,  but
  6396.                            the output will be  placed into the  personal
  6397.                            directory  and  read   from  there   whenever
  6398.                            INSPECT  or  ICONFIG  is  run.  Any   changes
  6399.                            subsequently made to  the configuration  will
  6400.                            be stored in the user's personal INSPECT.INI.
  6401.  
  6402.                            You need  not  have  separate  configurations
  6403.                            simply to account  for hardware  differences;
  6404.                            ie. colour  vs. monochrome  monitor, 25  line
  6405.                            vs. 43/50 line. InspectA automatically  takes
  6406.                            hardware capability into account on  startup.
  6407.  
  6408.  
  6409.  
  6410.  
  6411.             InspectA                                                  99
  6412.  
  6413.  
  6414.             Networks & CD-ROM
  6415.  
  6416.  
  6417.  
  6418.  
  6419.  
  6420.                            If you need to override this (for example, if
  6421.                            you run a  colour capable video  card with  a
  6422.                            monochrome monitor  in a  colour video  mode)
  6423.                            then you can  change InspectA's behaviour  by
  6424.                            using command line switches.
  6425.  
  6426.  
  6427.                Disk Index Files
  6428.  
  6429.                            Because network volumes and CD-ROM drives may
  6430.                            not be writable,  you may need  to take  this
  6431.                            into account  for  items which  are  normally
  6432.                            written  to  and  maintained  on  the   drive
  6433.                            itself; namely the disk directory index  file
  6434.                            used by the Directory Tree selector.
  6435.  
  6436.                            ICONFIG provides  a  way to  get  around  the
  6437.                            problem by  providing  an  option  to  use  a
  6438.                            particular path for storage of the  directory
  6439.                            index. These are found in General, Options:
  6440.  
  6441.                       Index Path     If a drive  and directory is  given
  6442.                                      here, all directory index files are
  6443.                                      placed in the nominated  directory,
  6444.                                      with the first letter of the  index
  6445.                                      file name  is substituted  for  the
  6446.                                      drive letter.
  6447.  
  6448.                                      Note that  if  no drive  letter  is
  6449.                                      given,  disk  index  files  on  all
  6450.                                      drives are stored in a subdirectory
  6451.                                      of the given drive.
  6452.  
  6453.                       Net Path Only  If this switch is enabled, InspectA
  6454.                                      will only  use the  Index Path  for
  6455.                                      network and  CD-ROM  drives.  Local
  6456.                                      logical drive indices are stored in
  6457.                                      the index  file name  nominated  in
  6458.                                      the root directory of the drive.
  6459.  
  6460.                            You may  need  to  take  the  following  into
  6461.                            consideration:
  6462.  
  6463.                               If all workstations  share the  same drive
  6464.                               mappings, you  would  benefit  by  placing
  6465.                               directory index files on a network volume,
  6466.                               readable and writeable by all users on the
  6467.                               network. Whenever any user  makes, deletes
  6468.  
  6469.  
  6470.  
  6471.  
  6472.             100                                                 InspectA
  6473.  
  6474.  
  6475.                                                        Networks & CD-ROM
  6476.  
  6477.  
  6478.  
  6479.  
  6480.  
  6481.                               or renames a  directory, the  shared index
  6482.                               file for  the  drive  is updated  for  all
  6483.                               users.
  6484.  
  6485.                               If workstations  use  different  mappings,
  6486.                               then maintaining shared index files on the
  6487.                               network would  cause  some  collisions  in
  6488.                               what each workstation considers  is on any
  6489.                               particular drive. In this  case, you could
  6490.                               set the Index  Path to  a local  drive, so
  6491.                               that each workstation maintains  their own
  6492.                               image according  to  their  logical  drive
  6493.                               mappings on  the  network,  or  have  each
  6494.                               workstation/user which  uses a  particular
  6495.                               set of mappings also use  a different name
  6496.                               for the directory index file.
  6497.  
  6498.                            A better scheme,  where InspectA maintains  a
  6499.                            single  directory  index  for  each   network
  6500.                            volume  (not   related   to   logical   drive
  6501.                            assignment), is being considered.
  6502.  
  6503.  
  6504.                Description Files
  6505.  
  6506.                            InspectA does not yet support placement of  a
  6507.                            description  file  on  any  other  drive   or
  6508.                            directory other than the one being read. This
  6509.                            facility applies more to CD-ROM media than to
  6510.                            networks, but in any case, most CD-ROM drives
  6511.                            are supplied with a  description file in  the
  6512.                            directory and are  in a format  which may  be
  6513.                            used   directly   by   InspectA.   The   only
  6514.                            disadvantage is  that  because this  file  is
  6515.                            read-only, it cannot  be updated or  changed.
  6516.                            This will be addressed in a future version of
  6517.                            InspectA.
  6518.  
  6519.  
  6520.  
  6521.  
  6522.  
  6523.  
  6524.  
  6525.  
  6526.  
  6527.  
  6528.  
  6529.  
  6530.  
  6531.  
  6532.  
  6533.             InspectA                                                 101
  6534.  
  6535.  
  6536.             External Commands
  6537.  
  6538.  
  6539.  
  6540.  
  6541.  
  6542.  
  6543.  
  6544.  
  6545.  
  6546.  
  6547.             External Commands
  6548.  
  6549.  
  6550.                            InspectA executes  external commands,  either
  6551.                            directly from  user  input or  from  commands
  6552.                            configured for  the manipulation  of  archive
  6553.                            libraries, action  on selecting  a file  from
  6554.                            the files list or external commands mapped to
  6555.                            the keyboard  or  selected from  the  Special
  6556.                            pulldown menu.
  6557.  
  6558.                            Some  special  rules  are  used  in  external
  6559.                            programs and are an extension to the  command
  6560.                            line. InspectA  does  not  use  the  system's
  6561.                            currently installed command interpreter,  but
  6562.                            instead will search the PATH directly for the
  6563.                            programs to  run  in  much the  same  way  as
  6564.                            COMMAND.COM (MSDOS) and CMD.EXE (OS/2) do. It
  6565.                            checks  the  current   directory,  then   all
  6566.                            directories in the path for a named  program,
  6567.                            or  uses  an  explicit   path  when  one   is
  6568.                            specified. After completing  execution of  an
  6569.                            external program.,  InspectA  may  optionally
  6570.                            report the "errorlevel",  or exit code,  with
  6571.                            which the program  terminates. Many  programs
  6572.                            will  report  a   non-zero  exit  status   to
  6573.                            indicate abnormal termination, or an error of
  6574.                            some type. Programs intended for use in batch
  6575.                            files will often set the errorlevel to convey
  6576.                            information to the controlling batch file.
  6577.  
  6578.                            It may be desirable to run a program via  the
  6579.                            command  interpreter.  To   force  this   and
  6580.                            override InspectA's internal search facility,
  6581.                            precede the command with an exclamation  mark
  6582.                            '!'. An exit code of zero is always  reported
  6583.                            by COMMAND.COM  (this  may  not  be  true  of
  6584.                            alternative command shells, such as 4DOS, MKS
  6585.                            or CMD.EXE). In all  cases, the shell run  is
  6586.                            determined from  the  value  of  the  COMSPEC
  6587.                            environment variable.  Running  a  DOS  batch
  6588.                            file (.BAT) or  4DOS batch  file (.BTM)  from
  6589.  
  6590.  
  6591.  
  6592.  
  6593.  
  6594.             102                                                 InspectA
  6595.  
  6596.  
  6597.                                                        External Commands
  6598.  
  6599.  
  6600.  
  6601.  
  6602.  
  6603.                            InspectA  will  always  involve  running  the
  6604.                            command interpreter first.
  6605.  
  6606.                            Similarly, InspectA also  knows about  MS-DOS
  6607.                            and OS/2 internal commands, for DOS  versions
  6608.                            up to  DOS  5.0,  and OS/2  2.1.  When  given
  6609.                            without a  preceding  path  or  drive,  these
  6610.                            commands  will  always  be  invoked  via  the
  6611.                            command interpreter.
  6612.  
  6613.  
  6614.                Environment
  6615.  
  6616.                            [MSDOS] When an external  program is run,  it
  6617.                            inherits a  copy  of  InspectA's  environment
  6618.                            variables (those displayed when using the SET
  6619.                            command by itself). Irrespective of what size
  6620.                            environment is set in CONFIG.SYS in a  SHELL=
  6621.                            statement for the first  copy of the  command
  6622.                            interpreter, DOS will only allocate only  the
  6623.                            size  required   to   contain   the   current
  6624.                            environment in sub-shells. Since batch  files
  6625.                            often use environment  variables it is  often
  6626.                            convenient to allocate  a larger  environment
  6627.                            for the sub-shell as  well to avoid the  "Out
  6628.                            of environment space" error. To support this,
  6629.                            InspectA allows  you  to  specify  additional
  6630.                            switches to pass  to the command  interpreter
  6631.                            if specified  prior  the  program  name.  For
  6632.                            example:
  6633.  
  6634.  
  6635.                                 !/E:1280 callit xyz
  6636.  
  6637.                            invokes the command  line interpreter in  the
  6638.                            following     manner      (assuming      that
  6639.                            COMSPEC=C:\COMMAND.COM):
  6640.  
  6641.  
  6642.                                 C:\COMMAND.COM /E:1280 /Ccallit xyz
  6643.  
  6644.                            This has the effect of running "callit"  with
  6645.                            an environment expanded to 1280 bytes.
  6646.  
  6647.                            NOTE: In versions of  DOS 3.1 and prior,  the
  6648.                            /E switch  specifies  the number  of  16-byte
  6649.                            paragraphs, not  the  number  of  bytes.  You
  6650.                            should consult your  DOS manual to  determine
  6651.  
  6652.  
  6653.  
  6654.  
  6655.             InspectA                                                 103
  6656.  
  6657.  
  6658.             External Commands
  6659.  
  6660.  
  6661.  
  6662.  
  6663.  
  6664.                            the exact behaviour of  the version that  you
  6665.                            run.
  6666.  
  6667.  
  6668.                Environment Variables
  6669.  
  6670.                            InspectA  allows  use  environment  variables
  6671.                            directly in any command line. You can specify
  6672.                            an environment variable in the same way as in
  6673.                            a batch file, ie. preceded and followed by  a
  6674.                            percent '%' symbol. This allows you to  'soft
  6675.                            code' some commands and have the command line
  6676.                            change  automatically   according   to   your
  6677.                            current environmental settings. This  applies
  6678.                            both to  the  program  name  itself  and  its
  6679.                            arguments.
  6680.  
  6681.                            Batch file  command  line variables  (ie.  %1
  6682.                            through  %9)  are  not  used  nor  supported.
  6683.                            However, because of the special treatment  of
  6684.                            the '%'  in environment  variables, you  will
  6685.                            need to use two  %'s in the  place of one  if
  6686.                            you desire  to include  a  literal '%'  on  a
  6687.                            command line.
  6688.  
  6689.                            As an  example, let's  say that  you wish  to
  6690.                            execute the following command (this works  on
  6691.                            the command line):
  6692.  
  6693.  
  6694.                                 for %f in (*.txt) do list %f
  6695.  
  6696.                            The effect would be to execute "LIST  <name>"
  6697.                            on all files  in the  current directory  with
  6698.                            the extension of .TXT.
  6699.  
  6700.                            From within InspectA, this may be entered as:
  6701.  
  6702.  
  6703.                                 for %%f in (*.txt) do %PAGER% %%f
  6704.  
  6705.                            assuming that the environment variable  PAGER
  6706.                            (which InspectA also  uses internally as  the
  6707.                            program to invoke to view files unless one is
  6708.                            configured) is set to "list". Note the double
  6709.                            %'s. This is identical  to what DOS and  OS/2
  6710.                            expect in  batch (command)  files when  using
  6711.                            the "FOR" command.
  6712.  
  6713.  
  6714.  
  6715.  
  6716.             104                                                 InspectA
  6717.  
  6718.  
  6719.                                                        External Commands
  6720.  
  6721.  
  6722.  
  6723.  
  6724.  
  6725.                Redirection
  6726.  
  6727.                            InspectA   fully   supports   input    output
  6728.                            redirection via the use of '<', '>' and  '>>'
  6729.                            symbols.
  6730.  
  6731.  
  6732.                Stacked Commands
  6733.  
  6734.                            InspectA supports  multiple commands  on  the
  6735.                            same  line.  This  means  that  you  can  run
  6736.                            consecutive commands  from  the  entry  of  a
  6737.                            single line. Simply separate each command  to
  6738.                            run with a circumflex character '^'.
  6739.  
  6740.                            Since this character is treated specially  in
  6741.                            this manner and  you may rarely  need to  use
  6742.                            this  in  a  command  line,  the  ability  is
  6743.                            provided to quote this by preceding it with a
  6744.                            backslash ("\^") to insert a literal '^'.
  6745.  
  6746.                            If you have errorlevel reporting enabled (the
  6747.                            -ea or  -ee command  line switch),  only  the
  6748.                            errorlevel of the last command executed  will
  6749.                            be reported. If for  some reason InspectA  is
  6750.                            unable to execute a given command,  execution
  6751.                            of the  stacked  commands will  stop  at  the
  6752.                            point  execution   failed   and   the   error
  6753.                            reported.
  6754.  
  6755.  
  6756.                Current Directory
  6757.  
  6758.                            [MSDOS only] The current directory is  always
  6759.                            maintained across calls to external  programs
  6760.                            by InspectA. The  initial starting  directory
  6761.                            is always restored. However, this is not  the
  6762.                            case between multiple  commands separated  by
  6763.                            '`' - the starting directory is restored only
  6764.                            after  all  commands  in  a  set  have   been
  6765.                            executed. It is therefore quite valid to  use
  6766.                            a "CHDIR" or "CD" command and expect that the
  6767.                            next command after a '`' will be executed  in
  6768.                            the directory changed to (if it succeeds).
  6769.  
  6770.                            Because the current  directory under OS/2  is
  6771.                            processed based,  this  does not  work  in  a
  6772.                            similar manner  under OS/2.  If you  need  to
  6773.  
  6774.  
  6775.  
  6776.  
  6777.             InspectA                                                 105
  6778.  
  6779.  
  6780.             External Commands
  6781.  
  6782.  
  6783.  
  6784.  
  6785.  
  6786.                            change directory  before  running  a  command
  6787.                            under OS/2, you will have to create a command
  6788.                            file containing the CD  command and then  run
  6789.                            the command.
  6790.  
  6791.  
  6792.  
  6793.  
  6794.  
  6795.  
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.  
  6806.  
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.  
  6814.  
  6815.  
  6816.  
  6817.  
  6818.  
  6819.  
  6820.  
  6821.  
  6822.  
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.  
  6829.  
  6830.  
  6831.  
  6832.  
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.             106                                                 InspectA
  6839.  
  6840.  
  6841.                                                                  Prompts
  6842.  
  6843.  
  6844.  
  6845.  
  6846.  
  6847.  
  6848.  
  6849.  
  6850.  
  6851.  
  6852.             Prompts
  6853.  
  6854.  
  6855.                            Almost all single line prompts used for  file
  6856.                            specifications, paths or commands to  execute
  6857.                            have the facility known as "command  history"
  6858.                            where the previous  (up to)  64 commands  are
  6859.                            stored and may be  easily recalled using  the
  6860.                            cursor keys.
  6861.  
  6862.                            Special keys used to scroll through  previous
  6863.                            entries in the command line history are:
  6864.  
  6865.                       Key            Description
  6866.  
  6867.  
  6868.  
  6869.                       UP             Scroll back to previous command.
  6870.  
  6871.                       DOWN           Scroll forward to next command.
  6872.  
  6873.                       PGUP           Go to first command in history.
  6874.  
  6875.                       PGDN           Go to last command in history.
  6876.  
  6877.                       F2             View command stack in popup list.
  6878.  
  6879.                            Line  entry  prompts   assume  the   previous
  6880.                            entered text as the  default. Simply type  to
  6881.                            destroy this  (clear  the  field)  and  enter
  6882.                            something completely  new.  If  you  wish  to
  6883.                            modify the existing text, then use any of the
  6884.                            horizontal cursor movement keys (LEFT, RIGHT,
  6885.                            HOME or  END) to  indicate that  you wish  to
  6886.                            edit the entry rather than replace it.
  6887.  
  6888.                            Other special key  functions in line  editing
  6889.                            throughout InspectA are:
  6890.  
  6891.  
  6892.  
  6893.  
  6894.  
  6895.  
  6896.  
  6897.  
  6898.  
  6899.             InspectA                                                 107
  6900.  
  6901.  
  6902.             Prompts
  6903.  
  6904.  
  6905.  
  6906.  
  6907.  
  6908.                       Key            Description
  6909.  
  6910.  
  6911.  
  6912.                       HOME           Go to start of field
  6913.  
  6914.                       END            Go to end of field
  6915.  
  6916.                       LEFT           Left one character
  6917.  
  6918.                       RIGHT          Right one character
  6919.  
  6920.                       CTRL-LEFT      Left one word
  6921.  
  6922.                       CTRL-RIGHT     Right one word
  6923.  
  6924.                       CTRL-Y         Erase entire field
  6925.  
  6926.                            Some  fields  (for  example,  the   "Execute"
  6927.                            function, usually assigned to F10 in the main
  6928.                            files list)  are  actually longer  than  they
  6929.                            appear. Long entries will scroll horizontally
  6930.                            within the field displayed  on the screen  so
  6931.                            that only a portion  of the entry is  visible
  6932.                            at once.
  6933.  
  6934.  
  6935.  
  6936.  
  6937.  
  6938.  
  6939.  
  6940.  
  6941.  
  6942.  
  6943.  
  6944.  
  6945.  
  6946.  
  6947.  
  6948.  
  6949.  
  6950.  
  6951.  
  6952.  
  6953.  
  6954.  
  6955.  
  6956.  
  6957.  
  6958.  
  6959.  
  6960.             108                                                 InspectA
  6961.  
  6962.  
  6963.                                                            Import/Export
  6964.  
  6965.  
  6966.  
  6967.  
  6968.  
  6969.  
  6970.  
  6971.  
  6972.  
  6973.  
  6974.             Import/Export
  6975.  
  6976.  
  6977.                            ICONFIG   provides   a   text   import/export
  6978.                            facility for configuration information.  This
  6979.                            section provides descriptions  for the  verbs
  6980.                            used in the exported configuration file.
  6981.  
  6982.                            The configuration  file  itself  is  in  text
  6983.                            (human  readable)  format,  with  information
  6984.                            grouped into sections. Each section is marked
  6985.                            by a  section heading  - typically  a  single
  6986.                            word surrounded  by  square  bracket  symbols
  6987.                            "[]" and optionally followed by a blank line.
  6988.  
  6989.                            Each  configuration  line  within  a  section
  6990.                            consist of a Verb=Variable pair. Verbs assume
  6991.                            meaning within  the  context of  the  current
  6992.                            section - verbs from  one section may or  may
  6993.                            not be valid  when used  in another  section,
  6994.                            but if  they  are, they  almost  always  mean
  6995.                            something  different.  Variables  may  be  of
  6996.                            various types, and which type is dependant on
  6997.                            the verb; typically it is numeric, a 'string'
  6998.                            (series  of  characters),   or  a   'complex'
  6999.                            variable  with  multiple  fields  or  entries
  7000.                            separated by commas or spaces.
  7001.  
  7002.                            Some verbs may be specified only once  within
  7003.                            the section; two or more statements using the
  7004.                            same verb may either be invalid or result  in
  7005.                            the second value overriding the first.  Other
  7006.                            verbs may  appear  multiple  times,  and  may
  7007.                            allow multiple  values  to  be  given.  Where
  7008.                            allowed, multiple  values accumulate  into  a
  7009.                            set.
  7010.  
  7011.                            If a value includes embedded space or commas,
  7012.                            the value  itself must  be quoted  in  double
  7013.                            quotation marks.
  7014.  
  7015.  
  7016.  
  7017.  
  7018.  
  7019.  
  7020.  
  7021.             InspectA                                                 109
  7022.  
  7023.  
  7024.             Import/Export
  7025.  
  7026.  
  7027.  
  7028.  
  7029.  
  7030.                [general]
  7031.  
  7032.                            General items,  not  falling into  any  other
  7033.                            category.
  7034.  
  7035.  
  7036.                            rescan=<numeric>
  7037.  
  7038.                               Specifies the number of  minutes which the
  7039.                               keyboard should  be idle  after which  the
  7040.                               current  directory  will  be  ""rescanned"
  7041.                               (reread  and  displayed).  A   zero  value
  7042.                               disables this  feature. Useful  for multi-
  7043.                               tasking systems and networks.
  7044.  
  7045.  
  7046.                            editor=<string>
  7047.  
  7048.                               Names  the   editor  program.   If  blank,
  7049.                               InspectA  uses   the  EDITOR   environment
  7050.                               variable, or if that is  not set, attempts
  7051.                               to invoke "Q" (SemWare's QEDIT) as editor.
  7052.  
  7053.  
  7054.                            editmem=<value>
  7055.  
  7056.                               [MSDOS] Amount of  memory required  by the
  7057.                               editing  program.  As  with  all  "memory"
  7058.                               fields, a value of  0 causes unconditional
  7059.                               program image swapping, and  -1 causes the
  7060.                               program to  be run  without swapping.  Any
  7061.                               other value  makes program  image swapping
  7062.                               conditional on there not  being sufficient
  7063.                               memory to run the program.
  7064.  
  7065.  
  7066.                            viewer=<string>
  7067.  
  7068.                               Names the file  viewer program.  If blank,
  7069.                               InspectA  uses   the   PAGER   environment
  7070.                               variable, or if that is  not set, attempts
  7071.                               to invoke "LIST"  (Vernon D.  Buerg's LIST
  7072.                               program) as viewer.
  7073.  
  7074.  
  7075.  
  7076.  
  7077.  
  7078.  
  7079.  
  7080.  
  7081.  
  7082.             110                                                 InspectA
  7083.  
  7084.  
  7085.                                                            Import/Export
  7086.  
  7087.  
  7088.  
  7089.  
  7090.  
  7091.                            viewmem=<value>
  7092.  
  7093.                               [MSDOS] Amount of  memory required  by the
  7094.                               viewing program.  See "editmem="  for more
  7095.                               information
  7096.  
  7097.  
  7098.                            virusscan=<string>
  7099.  
  7100.                               Specifies the name of the file  to use for
  7101.                               virus scanning.  The  default  command  is
  7102.                               scan /NOMEM /SUB, which is compatible with
  7103.                               McAfee & Assocs SCAN program.
  7104.  
  7105.  
  7106.                            scanmem=<value>
  7107.  
  7108.                               [MSDOS] Determines  the  amount of  memory
  7109.                               required by the virus scan program.
  7110.  
  7111.  
  7112.                            viewdir=<path>
  7113.  
  7114.                               Directory used  to  store archive  members
  7115.                               while viewing.
  7116.  
  7117.  
  7118.                            swapdir=<path>
  7119.  
  7120.                               [MSDOS]  Directory   used  to   store  the
  7121.                               program image  file when  swap to  disk is
  7122.                               activated.
  7123.  
  7124.  
  7125.                            swaptype=<type>
  7126.  
  7127.                               [MSDOS] Valid  values of  <type> are  XMS,
  7128.                               EMS, Disk and None.
  7129.  
  7130.  
  7131.                            kbddelay=<numeric>
  7132.  
  7133.                               Keyboard repeat delay.  -1 is  Auto (don't
  7134.                               adjust), 0=250 milliseconds  (1/4 second),
  7135.                               1=500ms, 2=750ms, 3=1000ms.
  7136.  
  7137.  
  7138.  
  7139.  
  7140.  
  7141.  
  7142.  
  7143.             InspectA                                                 111
  7144.  
  7145.  
  7146.             Import/Export
  7147.  
  7148.  
  7149.  
  7150.  
  7151.  
  7152.                            kbdspeed=<numeric>
  7153.  
  7154.                               Keyboard repeat  rate. -1  is Auto  (don't
  7155.                               adjust), Values range from 0=30 characters
  7156.                               per   second   (fastest)   to   31=2   cps
  7157.                               (slowest).
  7158.  
  7159.  
  7160.                            dirmaps=<boolean>
  7161.  
  7162.                               Enables creation of directory index files;
  7163.                               if  "No"   (or  "False"   or  "Disabled"),
  7164.                               directory index  files  are  only used  if
  7165.                               present,  but   drives  without   must  be
  7166.                               scanned  completely  each  time  they  are
  7167.                               logged.
  7168.  
  7169.  
  7170.                            diskmapfile=<filename>
  7171.  
  7172.                               Specifies a file name to use for directory
  7173.                               indices. The default is "diskmap.ind".
  7174.  
  7175.  
  7176.                            diskmappath=<path>
  7177.  
  7178.                               Specifies the  directory  where  directory
  7179.                               index files  are  stored.  If  blank,  the
  7180.                               default is  in the  root directory  of the
  7181.                               indexed  drive.  If  no  drive  letter  is
  7182.                               specified, then  the directory  is created
  7183.                               on the drive being  indexed; otherwise the
  7184.                               directory given  is  used  to store  index
  7185.                               files for all drives.
  7186.  
  7187.  
  7188.                            netpathonly=<boolean>
  7189.  
  7190.                               If "Yes"  (or "True",  or "Enabled"),  the
  7191.                               value for "diskmappath=" is  used only for
  7192.                               logging   network   and   CD-ROM   drives,
  7193.                               otherwise the  root directory  is used  to
  7194.                               store index files for local drives.
  7195.  
  7196.  
  7197.  
  7198.  
  7199.  
  7200.  
  7201.  
  7202.  
  7203.  
  7204.             112                                                 InspectA
  7205.  
  7206.  
  7207.                                                            Import/Export
  7208.  
  7209.  
  7210.  
  7211.  
  7212.  
  7213.                            prefermethod=<numeric>
  7214.  
  7215.                               This field determines the default archiver
  7216.                               to use when interactively  adding files to
  7217.                               an archive.   The  value  -1 indicates  no
  7218.                               preference.
  7219.  
  7220.  
  7221.                            listformat=<complex>
  7222.  
  7223.  
  7224.                            <desc>,<rowscale>,<colscal>,<"fieldlist">
  7225.  
  7226.                               This entry defines a files list format.
  7227.  
  7228.                               <desc> A brief description of the format.
  7229.  
  7230.                               <rowscale>,
  7231.  
  7232.                               <colscale>  A number  between  1  and  255
  7233.                                      indicating the number  of rows  and
  7234.                                      columns that a  new window of  this
  7235.                                      type should use by default. A value
  7236.                                      of 255  indicates the  full  screen
  7237.                                      length of width.
  7238.  
  7239.                               <fieldlist> This is a series of 10 numbers
  7240.                                      indicating a field  type. Refer  to
  7241.                                      the section on Configuration for  a
  7242.                                      discussion of these fields. A value
  7243.                                      of 0  indicates that  the entry  is
  7244.                                      unused.
  7245.  
  7246.  
  7247.                            descfile=<filename>
  7248.  
  7249.                               Describes the name(s) used  for storage of
  7250.                               file name descriptions.
  7251.  
  7252.  
  7253.                            prefermethod=<number>
  7254.  
  7255.                               Nominates the default  archive type  as an
  7256.                               index.
  7257.  
  7258.  
  7259.  
  7260.  
  7261.  
  7262.  
  7263.  
  7264.  
  7265.             InspectA                                                 113
  7266.  
  7267.  
  7268.             Import/Export
  7269.  
  7270.  
  7271.  
  7272.  
  7273.  
  7274.                            listpad=<number>
  7275.  
  7276.                               Number  of   columns   to  pad   filenames
  7277.                               inserted into file description lists.
  7278.  
  7279.  
  7280.                            listcase=<number>
  7281.  
  7282.                               Determines the case of  filenames inserted
  7283.                               into file  description lists.  0 indicates
  7284.                               default, 1 is lowercase, 2 i s uppercase.
  7285.  
  7286.  
  7287.                            displaypad=<number>
  7288.  
  7289.                               Number of columsn allocated for file names
  7290.                               in the files list display.
  7291.  
  7292.  
  7293.                            displaycase=<number>
  7294.  
  7295.                               Case of  filenames displayed  in the  File
  7296.                               Manager; 0 is  default, 1 is  lowercase, 2
  7297.                               is uppercase.
  7298.  
  7299.  
  7300.                            dircase=<number>
  7301.  
  7302.                               Case of directory  names displayed  in the
  7303.                               File Manager.
  7304.  
  7305.  
  7306.                            hidemenu=<boolean>
  7307.  
  7308.                               Determines the initial state  of the pull-
  7309.                               down menu title bar.
  7310.  
  7311.  
  7312.                            titlejustify=<number>
  7313.  
  7314.                               Indicates the  style  of justification  of
  7315.                               the file  window title;  0 is  centered, 1
  7316.                               indicates  left  justification,   2  right
  7317.                               justification.
  7318.  
  7319.  
  7320.  
  7321.  
  7322.  
  7323.  
  7324.  
  7325.  
  7326.             114                                                 InspectA
  7327.  
  7328.  
  7329.                                                            Import/Export
  7330.  
  7331.  
  7332.  
  7333.  
  7334.  
  7335.                            titlefillchar=<numeric>
  7336.  
  7337.                               This is the ascii value of  the title fill
  7338.                               character (must be between 0 and 255).
  7339.  
  7340.  
  7341.                            disablehotalt=<boolean>
  7342.  
  7343.                               Indicates the status of the  'hot' ALT key
  7344.                               action.
  7345.  
  7346.  
  7347.                            statswindow=<boolean>
  7348.  
  7349.                               Indicates the  default (startup)  state of
  7350.                               the directory statistics window.
  7351.  
  7352.  
  7353.                [video]
  7354.  
  7355.                            Video related items.
  7356.  
  7357.  
  7358.                            intense=<numeric>
  7359.  
  7360.                               0=Auto    (don't    change),    1=Blinking
  7361.                               background   colours,    2=Intense    non-
  7362.                               blinking.
  7363.  
  7364.  
  7365.                            hires=<numeric>
  7366.  
  7367.                               InspectA's  default  video   mode;  0=Auto
  7368.                               (don't  change),  1=Force  25  line  mode,
  7369.                               2=Force  43  (EGA)  or   50  (VGA)  lines,
  7370.                               3=Custom   (use    mode    specified    by
  7371.                               "videomode=").
  7372.  
  7373.  
  7374.                            videomode=<numeric>
  7375.  
  7376.                               [MSDOS] If  "hires=" value  is 3,  this is
  7377.                               the video  mode  number  to  set.  Usually
  7378.                               useful only on SuperVGA  systems - consult
  7379.                               your   VGA   adaptor   documentation   for
  7380.                               information.
  7381.  
  7382.  
  7383.  
  7384.  
  7385.  
  7386.  
  7387.             InspectA                                                 115
  7388.  
  7389.  
  7390.             Import/Export
  7391.  
  7392.  
  7393.  
  7394.  
  7395.  
  7396.                            customrows=<numeric>
  7397.  
  7398.                               [OS/2] Nominates the number of rows to set
  7399.                               when "custom mode" is selected.
  7400.  
  7401.  
  7402.                            customcols=<numeric>
  7403.  
  7404.                               [OS/2] Nominates the number  of columns to
  7405.                               set when "custom mode" is selected.
  7406.  
  7407.  
  7408.                            setmode=<boolean>
  7409.  
  7410.                               If "Yes", the video mode set  by the value
  7411.                               of the  "hires=" verb  (if not  "Auto") is
  7412.                               assumed permanently  and  is not  restored
  7413.                               before  running   external   programs   or
  7414.                               invoking   a   shell   to    the   command
  7415.                               interpreter.
  7416.  
  7417.  
  7418.                            dirwin=<size>
  7419.  
  7420.                               Determines  the   default   size  of   the
  7421.                               Directory Tree window accessible  from the
  7422.                               File Manager  (via  F9). This  is  one  of
  7423.                               Small, Medium or Large.
  7424.  
  7425.  
  7426.                            blanktime=<numeric>
  7427.  
  7428.                               Screen blank time - this is  the number of
  7429.                               minutes that  the  keyboard  must be  idle
  7430.                               before the screen blanker is activated.
  7431.  
  7432.  
  7433.                            frametype=<numeric>
  7434.  
  7435.                               This determines the type of frame used for
  7436.                               the active window in the Files Manager. -1
  7437.                               means no  frame,  and  values 1-6  specify
  7438.                               different frame types.
  7439.  
  7440.  
  7441.  
  7442.  
  7443.  
  7444.  
  7445.  
  7446.  
  7447.  
  7448.             116                                                 InspectA
  7449.  
  7450.  
  7451.                                                            Import/Export
  7452.  
  7453.  
  7454.  
  7455.  
  7456.  
  7457.                            inactiveframetype=<numeric>
  7458.  
  7459.                               This determines the type of frame used for
  7460.                               all inactive window in the Files Manager.
  7461.  
  7462.  
  7463.                            mouse=<boolean>
  7464.  
  7465.                               Determines whether the mouse is to be made
  7466.                               active  or  not.  If   "Yes",  then  mouse
  7467.                               functions are  activated  if  there  is  a
  7468.                               mouse driver available.
  7469.  
  7470.  
  7471.                            SVGAmouse=<boolean>
  7472.  
  7473.                               Determines whether the mouse is to be made
  7474.                               active or  not in  any extended  SVGA text
  7475.                               mode.
  7476.  
  7477.  
  7478.                            mousecursor=<type>
  7479.  
  7480.                               Specifies the type of mouse cursor to use;
  7481.                               valid types are "Standard",  "Diamond" and
  7482.                               "Triangle".
  7483.  
  7484.  
  7485.                            mousespeed=<numeric>
  7486.  
  7487.                               Changes the  mouse  speed and  sensitivity
  7488.                               according to  preference;  0=use  default,
  7489.                               1=slow, 2=medium, 3=fast, 4=very fast.
  7490.  
  7491.  
  7492.                            attr-colour=<numeric list>
  7493.                            attr-mono=<numeric list>
  7494.  
  7495.                               These set the screen attributes for colour
  7496.                               and monochrome  video monitors.  Up to  64
  7497.                               individual  settings   for   the   various
  7498.                               attribute types, in the same order as they
  7499.                               appear   in   ICONFIG's   attribute   list
  7500.                               (General,  Colours).   Because  the   list
  7501.                               contains  embedded  spaces,  it   must  be
  7502.                               surrounded by double quotes.
  7503.  
  7504.  
  7505.  
  7506.  
  7507.  
  7508.  
  7509.             InspectA                                                 117
  7510.  
  7511.  
  7512.             Import/Export
  7513.  
  7514.  
  7515.  
  7516.  
  7517.  
  7518.                [archive]
  7519.  
  7520.                            Defines  archiving  commands;  the  means  by
  7521.                            which  the   Archive  Manager   is  able   to
  7522.                            manipulate compressed archives. There is only
  7523.                            one valid verb in this section, but it may be
  7524.                            specified  multiple  times.  For  simplicity,
  7525.                            each individual  archive  command  should  be
  7526.                            defined on a separate line.
  7527.  
  7528.  
  7529.                            cmd=<complex>
  7530.  
  7531.                               where  the  <complex>  field   is  in  the
  7532.                               format:
  7533.  
  7534.  
  7535.                            <type>,<op>,<abbrev>,<wildcard>,<reqmem>,<cmd
  7536.                            template>
  7537.  
  7538.                               The meaning of these sub-fields are:
  7539.  
  7540.                               <type> Type archiver type. Valid types are
  7541.                                      AR5, AR6, AR7, ARJ, HPK, LHA,  LZH,
  7542.                                      PAK, PKA, SQZ, ZIP, ZOH and ZOO.
  7543.  
  7544.                               <op>   Must be one of Add, Delete, Extract
  7545.                                      or Test. This  determines what  the
  7546.                                      command being defined does.
  7547.  
  7548.                               <abbrev>    This   is   the   usual   file
  7549.                                      extension used by  archives of  the
  7550.                                      type being described. This is  only
  7551.                                      used  to   "guess"   the   intended
  7552.                                      archive type  when creating  a  new
  7553.                                      archive.
  7554.  
  7555.                               <wildcard>  Specifies what  to  use  as  a
  7556.                                      wildcard when  the entire  contents
  7557.                                      of a directory are being added,  or
  7558.                                      the  all  member  files  are  being
  7559.                                      tested or  extracted.  This  is  an
  7560.                                      optimisation to  prevent having  to
  7561.                                      call the archiver multiple times.
  7562.  
  7563.                               <reqmem>    This determines the amount  of
  7564.                                      free memory which must be available
  7565.                                      to the  archiving  command.  It  is
  7566.  
  7567.  
  7568.  
  7569.  
  7570.             118                                                 InspectA
  7571.  
  7572.  
  7573.                                                            Import/Export
  7574.  
  7575.  
  7576.  
  7577.  
  7578.  
  7579.                                      used to  determine whether  or  not
  7580.                                      the program image should be swapped
  7581.                                      out to XMS/EMS/Disk. This is unused
  7582.                                      by the OS/2 version.
  7583.  
  7584.                               <cmdtemplate>    Specifies  the   template
  7585.                                      for  the  command  which  is  being
  7586.                                      defined;   this   always   contains
  7587.                                      special '$' tokens which  represent
  7588.                                      macros to  be replaced  by  archive
  7589.                                      and file names when used.
  7590.  
  7591.  
  7592.                [mailer]
  7593.  
  7594.                            This section defines mailer characteristics.
  7595.  
  7596.  
  7597.                            mailertype=<type>
  7598.  
  7599.                               Type  is  one   of  "None",   "Static"  or
  7600.                               "Dynamic".
  7601.  
  7602.  
  7603.                            outbound=<attributes>
  7604.  
  7605.                               Attributes   determine    the   type    of
  7606.                               addressing  supported  by  files   in  the
  7607.                               mailer's  outbound   queue.  Any   of  the
  7608.                               following may  be specified;  multiple are
  7609.                               allowed: "Domains", "Zones", "Points".
  7610.  
  7611.  
  7612.                            pointnet=<number>
  7613.  
  7614.                               Specifies the  'fake' network  number used
  7615.                               if you  need  to  support 3D  style  point
  7616.                               addressing.
  7617.  
  7618.  
  7619.                            address=<ftnaddr>
  7620.  
  7621.                               <ftnaddr> is a FidoNet style address, in
  7622.  
  7623.                                 zone:net/node[.point][@domain]
  7624.  
  7625.                               format. You can specify  multiple address,
  7626.                               either  on  the  same  line  separated  by
  7627.  
  7628.  
  7629.  
  7630.  
  7631.             InspectA                                                 119
  7632.  
  7633.  
  7634.             Import/Export
  7635.  
  7636.  
  7637.  
  7638.  
  7639.  
  7640.                               spaces, or  on  separate  lines  following
  7641.                               multiple   occurrences    of   the    verb
  7642.                               "address=".
  7643.  
  7644.  
  7645.                            equate=<string>,<string>
  7646.  
  7647.                               Equates one domain string  to another. The
  7648.                               first  string  is  the  one  to  equate  -
  7649.                               whenever it  is  found  to  be used  as  a
  7650.                               domain  designation,  InspectA  internally
  7651.                               replaces it with the second string.
  7652.  
  7653.  
  7654.                            product=<complex>
  7655.  
  7656.                               Describes a product code.  Each definition
  7657.                               consists of the following fields:
  7658.  
  7659.                               <code>,<name>,<os>,<type>,<author>,<addres
  7660.                               s>,<flags>
  7661.  
  7662.                               <code> This is the product  identification
  7663.                                      code  which  is  placed  in  FTSC-1
  7664.                                      packet headers.
  7665.  
  7666.                               <name> The product name.
  7667.  
  7668.                               <os>   The operating system(s) under which
  7669.                                      the product runs.
  7670.  
  7671.                               <type> The  type   of   product;   usually
  7672.                                      "packer", "mailer" or both.
  7673.  
  7674.                               <author>    The  name  of  the   product's
  7675.                                      author.
  7676.  
  7677.                               <address>   The FidoNet  address at  which
  7678.                                      the   product's   author   may   be
  7679.                                      contacted (via FidoNet).
  7680.  
  7681.                               <flags>Special  flags  used  to  determine
  7682.                                      whether or  not extended  zone  and
  7683.                                      point information in packet headers
  7684.                                      made by this particular product can
  7685.                                      be  'trusted'  should  the   packet
  7686.                                      header type not be of a  recognised
  7687.                                      'enhanced' type.
  7688.  
  7689.  
  7690.  
  7691.  
  7692.             120                                                 InspectA
  7693.  
  7694.  
  7695.                                                            Import/Export
  7696.  
  7697.  
  7698.  
  7699.  
  7700.  
  7701.                [paths]
  7702.  
  7703.                            This section defines  a list of  directories.
  7704.                            These may be used by the mailer functions for
  7705.                            special operations, but  may also be  defined
  7706.                            to place them on the list of paths which  may
  7707.                            be selected from the Paths Index feature.
  7708.  
  7709.  
  7710.                            dir=<complex>
  7711.  
  7712.                               Fields  in  the  variable  is  defined  as
  7713.                               follows:
  7714.  
  7715.  
  7716.                            <type>,<path>,<description>
  7717.  
  7718.                               <type> This is one of <blank> (no  entry),
  7719.                                      "Netmail",  "Postmail",  "Inbound",
  7720.                                      "Outbound" or  "Nodelist". A  blank
  7721.                                      field means no special  attributes.
  7722.                                      See the  documentation  on  ICONFIG
  7723.                                      for  a   more  detailed   list   of
  7724.                                      meanings  attached  to  the   other
  7725.                                      types.
  7726.  
  7727.                               <path> Is the name of the directory  being
  7728.                                      defined.
  7729.  
  7730.                               <description>    An  optional  description
  7731.                                      used for the directory.
  7732.  
  7733.  
  7734.                [externals]
  7735.  
  7736.                               This section defines the interface between
  7737.                               InspectA and external programs.
  7738.  
  7739.  
  7740.                            key=<complex>
  7741.  
  7742.                               where <complex is>
  7743.  
  7744.  
  7745.                            <key>,<op>,<flags>,<reqmem>,<cmd>,<descriptio
  7746.                            n>
  7747.  
  7748.  
  7749.  
  7750.  
  7751.  
  7752.  
  7753.             InspectA                                                 121
  7754.  
  7755.  
  7756.             Import/Export
  7757.  
  7758.  
  7759.  
  7760.  
  7761.  
  7762.                               <key>  This is a pneumonic which describes
  7763.                                      the key being  mapped. It may  also
  7764.                                      specify the scan + ASCII codes  for
  7765.                                      the key in hexadecimal and preceded
  7766.                                      by "0x". Shifted keys are  preceded
  7767.                                      by '#', control keys by '^' and alt
  7768.                                      keys by '@'.
  7769.  
  7770.                               <op>   Defines what the key does; this  is
  7771.                                      an internal  code  that  designates
  7772.                                      function. A  '0' or  blank in  this
  7773.                                      field defines an external command.
  7774.  
  7775.                               <flags>If set to 1 in an external  command
  7776.                                      definition,  the  logged  directory
  7777.                                      will be rescanned.
  7778.  
  7779.                               <reqmem>    The amount of memory that  the
  7780.                                      external command  requires.  If  0,
  7781.                                      program image swapping will be used
  7782.                                      unconditionally,   if   -1   never,
  7783.                                      otherwise  image  swapping  is  not
  7784.                                      used   unless   needed   to    free
  7785.                                      sufficient  memory   to   run   the
  7786.                                      program. This entry  is ignored  in
  7787.                                      the OS/2 version.
  7788.  
  7789.                               <cmd>  This is  the command  template  for
  7790.                                      external commands.  '$' macros  can
  7791.                                      be used in much the same way as  in
  7792.                                      archiving commands except that  the
  7793.                                      macros  themselves  have  different
  7794.                                      meanings; $f refers to each  marked
  7795.                                      file individually,  $m  all  marked
  7796.                                      files,   $a   as   the    currently
  7797.                                      highlighted file.
  7798.  
  7799.                               <description>    Describes    what     the
  7800.                               command does.
  7801.  
  7802.  
  7803.                            file=<complex>
  7804.  
  7805.                               Defines a  program  to  run  when  a  file
  7806.                               matching  the   specification   given   is
  7807.                               selected.
  7808.  
  7809.                               <complex> consists of:
  7810.  
  7811.  
  7812.  
  7813.  
  7814.             122                                                 InspectA
  7815.  
  7816.  
  7817.                                                            Import/Export
  7818.  
  7819.  
  7820.  
  7821.  
  7822.  
  7823.                            <spec>,<flags>,<reqmem>,<cmd>,<description>
  7824.  
  7825.                               where
  7826.  
  7827.                               <filespec>  This is the file specification
  7828.                                      used to match  to a selected  file.
  7829.                                      It may contain wildcard characters,
  7830.                                      '?' and '*'.
  7831.  
  7832.                               For the remaining fields, see above, under
  7833.                               key=.
  7834.  
  7835.  
  7836.  
  7837.  
  7838.  
  7839.  
  7840.  
  7841.  
  7842.  
  7843.  
  7844.  
  7845.  
  7846.  
  7847.  
  7848.  
  7849.  
  7850.  
  7851.  
  7852.  
  7853.  
  7854.  
  7855.  
  7856.  
  7857.  
  7858.  
  7859.  
  7860.  
  7861.  
  7862.  
  7863.  
  7864.  
  7865.  
  7866.  
  7867.  
  7868.  
  7869.  
  7870.  
  7871.  
  7872.  
  7873.  
  7874.  
  7875.             InspectA                                                 123
  7876.  
  7877.  
  7878.             Miscellaneous
  7879.  
  7880.  
  7881.  
  7882.  
  7883.  
  7884.  
  7885.  
  7886.  
  7887.  
  7888.  
  7889.             Miscellaneous
  7890.  
  7891.  
  7892.  
  7893.                Screenblanker
  7894.  
  7895.                            InspectA includes a built-in screen  blanker,
  7896.                            which is intended to prevent monitor  burn-in
  7897.                            caused  by  constantly  displaying  the  same
  7898.                            screen; the lighter areas  tend to erode  the
  7899.                            surface in the  video tube in  some types  of
  7900.                            monitors. Over  a  long  period,  the  effect
  7901.                            becomes  quite  noticeable,  and  can   cause
  7902.                            severe problems  with  the  displayed  image.
  7903.                            While  this  is  most  pronounced  on   older
  7904.                            monochrome monitors,  it  has been  known  to
  7905.                            occur   in even  some of  the newer  SuperVGA
  7906.                            compatible display units.
  7907.  
  7908.                            You can also switch the screen blanker on  by
  7909.                            depressing both SHIFT keys at the same  time.
  7910.                            You may need to  wait a short while  (usually
  7911.                            between  2-5  seconds)  after  sitting  at  a
  7912.                            prompt for this to work due to the  "timeout"
  7913.                            strategy used  internally  which is  used  to
  7914.                            avoid   doing   too   much   "work"   between
  7915.                            keystrokes  or  time  slicing  too  viciously
  7916.                            under a multi-tasking system.
  7917.  
  7918.  
  7919.  
  7920.  
  7921.  
  7922.  
  7923.  
  7924.  
  7925.  
  7926.  
  7927.  
  7928.  
  7929.  
  7930.  
  7931.  
  7932.  
  7933.  
  7934.  
  7935.  
  7936.             124                                                 InspectA
  7937.  
  7938.  
  7939.                                                  Copyrights & Trademarks
  7940.  
  7941.  
  7942.  
  7943.  
  7944.  
  7945.  
  7946.  
  7947.  
  7948.  
  7949.  
  7950.             Copyrights & Trademarks
  7951.  
  7952.  
  7953.                            InspectA and its associated documentation and
  7954.                            same configuration files are Copyright  1992-
  7955.                            1993 by David L. Nugent and Unique  Computing
  7956.                            Pty Limited. No warrantee  is made as to  the
  7957.                            fitness of  this  product  for  any  intended
  7958.                            purpose, nor will any responsibility be taken
  7959.                            for any  damage, consequential  or  otherwise
  7960.                            arising out of use or abuse of this  product.
  7961.                            It is provided  purely on an  "as is"  basis,
  7962.                            with no promises or agreements regarding  any
  7963.                            future versions or releases should they  ever
  7964.                            be published.
  7965.  
  7966.                            This  work   is   protected   by   Australian
  7967.                            copyright law and by the Burne  International
  7968.                            Treaty on Copyrights. The commercial  version
  7969.                            of this  program  may not  be  re-distributed
  7970.                            under any  conditions and  in any  form.  The
  7971.                            "shareware"  release  may  be  re-distributed
  7972.                            under  the  terms   and  conditions  of   the
  7973.                            accompanying "LICENCE.TXT".
  7974.  
  7975.                            Various copyrighted  works  of  software  and
  7976.                            registered trademarks are referred to in  the
  7977.                            documentation, and where applicable these are
  7978.                            held and owned by their respective  copyright
  7979.                            holders,  including  the  following  list  of
  7980.                            products:
  7981.  
  7982.                               ARC is  a registered  trademark of  System
  7983.                               Enhancement Associates Inc.
  7984.  
  7985.                               ARC+PLUS is  copyright System  Enhancement
  7986.                               Associates, Inc.
  7987.  
  7988.                               ARCA &  ARCE are  copyright by  Wayne Chin
  7989.                               and Vernon D. Buerg.
  7990.  
  7991.                               PKARC,  PKPAK,  PKXARC,   PKUNPAK,  PKZIP,
  7992.                               PKUNZIP are copyright PKWARE, Inc.
  7993.  
  7994.  
  7995.  
  7996.  
  7997.             InspectA                                                 125
  7998.  
  7999.  
  8000.             Copyrights & Trademarks
  8001.  
  8002.  
  8003.  
  8004.  
  8005.  
  8006.                               PKZIP & PKUNZIP are  trademarks of PKWARE,
  8007.                               Inc.
  8008.  
  8009.                               PAK is copyright by NoGate Consulting.
  8010.  
  8011.                               ZOO was written by Rahul Dhesi.
  8012.  
  8013.                               ARJ is copyright by Robert Jung.
  8014.  
  8015.                               HPACK is copyright by Peter Gutmann.
  8016.  
  8017.                               DWC is copyright by Dean W. Cooper.
  8018.  
  8019.                               LH  is  copyright  by   A:WARE  and  Peter
  8020.                               Fitzsimmons.
  8021.  
  8022.                               LIST is copyright Vernon D. Buerg.
  8023.  
  8024.                               QEdit is copyright SemWare.
  8025.  
  8026.                               MSDOS is copyright Microsoft Corporation.
  8027.  
  8028.                               FidoNet is a trademark of Tom Jennings.
  8029.  
  8030.                               BinkleyTerm  is   copyright   Bit   Bucket
  8031.                               Software, Co.
  8032.  
  8033.                               Opus is copyright Wynn Wagner III.
  8034.  
  8035.                               SEAdog  is  copyright  System  Enhancement
  8036.                               Associates.
  8037.  
  8038.                               FrontDoor  is  copyright  by   Joaquim  H.
  8039.                               Homrighausen  and   Advanced   Engineering
  8040.                               Sarl.
  8041.  
  8042.                               InterMail is  copyright  by Peter  Stewart
  8043.                               and InterZone Software
  8044.  
  8045.                               OS/2  is  a  trademark   of  International
  8046.                               Business Machines.
  8047.  
  8048.  
  8049.  
  8050.  
  8051.  
  8052.  
  8053.  
  8054.  
  8055.  
  8056.  
  8057.  
  8058.             126                                                 InspectA