home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / spaudit.zip / README < prev    next >
Text File  |  1990-08-14  |  7KB  |  183 lines
  1.                         Read Me First
  2.                              for
  3.                            SPAudit
  4.  
  5.     Table of Contents
  6.  
  7.          Introduction
  8.          How to use the SPAudit diskette
  9.          Files on the SPAudit diskette
  10.          Network Considerations
  11.          Really NEEED help?
  12.  
  13.     Introduction:
  14.  
  15.     SPAudit is an MS/PC-DOS application that collects software census
  16.     information.  The program must be executed from the A: dirve.  By
  17.     default, it observes and records software information from your C: and
  18.     D: drives.  As you run SPAudit, you can specify other drives to be
  19.     included or excluded from observation.
  20.  
  21.     Each SPAudit diskette should hold information for about 50 or more
  22.     computers.  If you are auditing more than that, you should make
  23.     copies using the DOS COPY command.  If you wish to consolidate
  24.     information from several SPAudit diskettes, this can be accomplished
  25.     using standard DOS commands.  Check your DOS reference manual for
  26.     specific instructions.
  27.  
  28.     How to use the SPAudit diskette:
  29.  
  30.          Instructions:
  31.  
  32.               1)  Insert a SPAudit diskette in drive A
  33.               2)  Type A:SPAudit [enter]
  34.               3)  Highlight Collect Information [enter]
  35.               4)  Highlight Quit [enter]
  36.               5)  Remove SPAudit diskette
  37.  
  38.          (Optional Actions)
  39.  
  40.               1)  Review content of README file on SPAudit diskette
  41.                   A)  To display on screen, type TYPE A:README | MORE
  42.                   B)  To display on printer, type COPY A:README PRN
  43.  
  44.               2)  Review content of PIF.TXT file on SPAudit diskette
  45.                   A)  To display on screen, type TYPE A:PIF.TXT
  46.                   B)  To display on printer, type COPY A:PIF.TXT PRN
  47.                   CAUTION: This file has over 1,000 lines!
  48.  
  49.               3)  Alter default drives to be observed
  50.  
  51.                   Type A:SPAudit [action][drive letter]
  52.  
  53.                      [action] indicates action to take: "+" means
  54.                      include, and "-" means exclude from observation.
  55.  
  56.                      [drive letter] indicates the drive to be acted upon.
  57.  
  58.                    Example:
  59.  
  60.                      A:SPAudit -C -D +F
  61.  
  62.                      This command will cause SPAudit to ignore the
  63.                      contents of the default drives C: and D: and
  64.                      look only at the contents of the F: drive.
  65.  
  66.               4)  Modify the User Product List
  67.                   A)  Highlight Maintain User Product List [enter]
  68.                   B)  Type file names for user specified program/product
  69.                   C)  [Esc] when complete
  70.  
  71.               5)  Print Report
  72.                   Highlight Print Report [enter]
  73.  
  74.     Files on the SPAudit diskette:
  75.  
  76.          SPAudit.EXE
  77.  
  78.               This file is the executable SPAudit program.
  79.  
  80.          PIF.TXT
  81.  
  82.               This file is a comma delimited ASCII text file that
  83.               contains information provided to the SPA by member
  84.               firms.  Each record consists of three fields.  First
  85.               an 11 character product identifier.  Second is the
  86.               popular name of the product.  Third is the name of
  87.               the publisher.
  88.  
  89.               This file is purposely marked as READ ONLY.  It should
  90.               be left that way.  Alteration of this file can cause
  91.               unpredictable results.
  92.  
  93.          USER.TXT
  94.  
  95.               This file is the optional User Product List.  It contains
  96.               information collected by the Maintain User Product List
  97.               function of the SPAudit program.  The Maintain User
  98.               Product List function may only be used prior to the
  99.               use of the Collect Information function of the program.
  100.               If this file is marked READ ONLY, the Maintain User
  101.               Product List function is disabled.
  102.  
  103.               The User Product List cannot be modified after a PIF.FIL
  104.               has been created (that indicates that a machine has been
  105.               processed).
  106.  
  107.          PIF.FIL
  108.  
  109.               This file is a comma delimited ASCII text file that
  110.               contains information collected with every execution of
  111.               the Collect Information function of the SPAudit
  112.               program.  The file is organized to be easy to import
  113.               into a spreadsheet or data base for consolidation and
  114.               analysis.
  115.  
  116.               The file can be perceived as a spreadsheet.  Each line
  117.               (row, or text record) represents one product that was
  118.               located on one machine.
  119.  
  120.               The first field (column) contains the Machine ID that
  121.               was entered as the first step in the Collect Information
  122.               function of the program.  The second field (column)
  123.               contains the FileSpec of the Product.  The third field
  124.               (column) contains the count of the number of matching
  125.               FileSpec entries located on the indicated Machine ID.
  126.               The fourth field (column) contains the Product Name,
  127.               and the fifth field (column) contains the Publisher
  128.               Name.  There will be no entries for Products that
  129.               were not located.
  130.  
  131.               Example:
  132.  
  133.               "DAVE","IBMDOS.COM",1,"IBM DOS","IBM Corporation"
  134.               "DAVE","123.EXE",2,"Lotus 1-2-3","Lotus Development"
  135.               "PETE","IBMDOS.COM",1,"IBM DOS","IBM Corporation"
  136.  
  137.               Dave's machine has 1 copy of DOS, and 2 copies of
  138.               1-2-3 from Lotus Development.  Pete's machine
  139.               has 1 copy of DOS.
  140.  
  141.  
  142.     Network Considerations:
  143.  
  144.          To take a software census of the content of a file server,
  145.          either:
  146.  
  147.               1.  If the file server is of the type that will allow
  148.                   DOS programs to be run against the C: (and D:)
  149.                   drives, simply treat the server as any other
  150.                   PC to be inventoried.  Or,
  151.  
  152.               2.  If the file server is of the type that will not
  153.                   allow DOS programs to be run, then you must run
  154.                   SPAudit from a remote node, as if it were being
  155.                   run locally (on the server itself).  Choose the
  156.                   drive letter that represents the root of the
  157.                   server's C: drive, and direct SPAudit to search
  158.                   that drive and not the C: or D: drive.  Example:
  159.  
  160.                        SPAudit -C -D +R
  161.  
  162.                   if the R: drive represents the root of the C:
  163.                   drive on the server.
  164.  
  165.                   See "Optional Actions 3)" above.
  166.  
  167.  
  168.     Really NEED help?
  169.  
  170.          If you have read the preceding, if you have faithfully followed
  171.          the instructions and are still unsuccessful in making use of
  172.          the program, or if you have procedural questions about conducting
  173.          an internal software audit in your organization, contact:
  174.  
  175.               Software Audit Support
  176.               Software Publishers Association
  177.               1101 Connecticut Avenue Northwest
  178.               Suite 901
  179.               Washington, DC  20036
  180.  
  181.               Tel: (202) 452-1600
  182.               Fax: (202) 223-8756
  183.