# Inventory Control Program
# README File
# By Mike Calabrese
# Version 1.0
# http://www.mikecalabrese.com/index.shtml
# 03-29-2005

# This program is available for free on an AS-IS basis.  I am not
# responsible for consequential damages, loss of income or whatever
# else that may happen as a result of the use of this program.

This application is designed to allow users to check in and check out 
software inventory and show the status of each item via a web interface 
spreadsheet. The items are pulled from flat files.  The app also includes 
an admin area that allows one to add, edit or delete inventory items.

The application comes with a config file (called config_file) that shows 
what variables have to be configured to make this app work.  This is the only 
file that needs to be edited.

The following variables need to be configured within the config_file:

$items_path- This is the exact UNIX path to where the items directory is 
located.  This is the file that contains the flat files that have the comma 
separated fields for each item in the inventory.  This variable is 
used in various places throughout the app.

$inventory_path- This is the exact UNIX path to where the web based 
inventory spreadsheet is located.

$inventory_url- This is the url path to where the web based inventory 
spreadsheet is located.

$max_item_filename- This is the name of the file that contains the maximum 
number of files that are in the inventory.  This number is incremented each 
time that a new inventory item is added via the admin gui.  It is important 
to note that if inventory files are batch loaded to this app, this file will 
have to be manually updated to accurately reflect the maximum number of files 
in the items directory.  If this is not done, the files won't show up in the 
online spreadsheet.

$items_filename- This is the name that is prepended to a distinct number 
such that each inventory item is distinct.

$counter0, $counter1-  These are starting point variables for counters used 
throught the app.

$admin_login, $admin_pwd-  These are presently set to 'inventory' and 
'invent0ry' and can be changed in this file.

If you are getting the zipped and compressed version of this app, the
directory structures are already in place. If you are getting these files
via email, the following directory structure must be observed:

/inventory
  README
  config_file
  index.pl
/admin
  add1.pl
  add2.pl
  admin_login.pl
  admin_loginok.pl
  delete1.pl
  delete2.pl
  delete3.pl
  edit1.pl
  edit2.pl
  edit3.pl
  main.pl
/users
  users1.pl
  users2.pl
/items
  max_item