------------------------------------
Requirements
------------------------------------

Perl: 5.004_02 or later must be installed on your server. 
   The script will probably run on older versions of Perl.

You must have access to a cgi-bin on your website's server.

You should have prior knowledge of CGI script installation
   to install the script yourself.
 

------------------------------------
z_search.cgi Script Installation instructions:
------------------------------------

1. Download the script zip file.

2. Unzip to any directory on your hard drive.

3. Edit z_search.cgi's first line to reflect the path to
   Perl on your server. If you have a working cgi script in
   your cgi-bin then you can get this information from the top
   line.

   examples are:
      #!/usr/bin/perl
      #!/usr/bin/local/perl
      #!/usr/bin/perl5

4. Follow the instructions at the top of the cgi script and
   edit variables, paths and related information.

5. Upload the cgi script to your website's cgi-bin directory,
   using FTP. 

   IMPORTANT: You MUST upload using ASCII mode NOT BINARY.

6. Set the cgi script file permission to CHMOD 755


------------------------------------ 
search.htm HTML Page installation.
------------------------------------

1.) Change the Form Action line, located in the html code, to
    point to the CGI script newly installed in your cgi-bin.
    Example:
    <form action="http://www.yourwebsite.com/cgi-bin/z_search.cgi" method="POST">

2.) Install the lines of HTML code located between the <CENTER>
    tags in search.htm, to your Zeus Header, Footer, or PRO 
    Template file. This will put the search entry box, All or
    ANY selector and the Submit button on your Link Directory
    page(s). This HTML code may also be installed anywhere on your 
    website.


------------------------------------
What to do next.
------------------------------------

1.) Enter the z_search registration code, you received after purchasing, into your running Zeus application, by clicking "Help/Enter Registration Code". Zeus will acknowledge the correct code.

2.) Create and upload your Link Directory. Zeus will automatically create and upload an index text file that the z_search.cgi script will use.

3.) Try the search script by typing a search word into the search text entry box, located on the html page you installed the html code on and then clicking the Search button.


------------------------------------
TROUBLESHOOTING
------------------------------------

If you have problems running the script (for example you
   get an "Internal Server Error" or ANY "Server Error"),
   try each of the following in turn:

      Rename the script extension from .cgi to .pl

      Re-upload the cgi script making sure it is uploaded in
      ASCII and NOT binary. 

      Be careful with the type of text editor you use. 
      If you do not edit in text mode, you can get invisible
      characters that will crash your program.
      Notepad is perfect to use.

      Set the cgi script permission to 755. If you're on
      unix and need to change permissions, but don't have
      access to the system prompt, a program called CuteFTP
      will help you change permissions.



------------------------------------
Call to outside Perl programmers:
------------------------------------

If you are an experienced Perl programmer we would love to 
chat with you. It's easy to use the data provided by Zeus 
for use in CGI scripts. In addition to a ready made market 
of thousands of Zeus users, it makes sense to consider 
writing, modifying or editing scripts to interact with Zeus.


Thanks from all of us at cyber-robotics.com