Administrator's Guide to pssRecruit

A Product of Progressive Software Solutions

May 30, 2001


Contents

Return to Top

Overview of pssRecruit

pssRecruit(R) V2.5 EASY! A smarter way to manage your recruiting.
Copyright 2000, 2001 Progressive Software Solutions, LLC
All Rights Reserved

Single-Recruiter License: Licensed for a single user.
Two-to-Five-Recruiter License: Licensed for a up to five users.
Enterprise Version: Licensed for an unlimited number of users.

Software Product Description: pssRecruit is a Web-based job board, a smarter way to manage your recruiting. Job boards are one of the most popular and successful uses of the Internet today. But the public high volume job boards (hotjobs.com, etc.) alone do not meet the requirements of many organizations that seek a private, niche or specialized job board function.

pssRecruit is the Web-based job board solution for any organization that recruits employees. Our Web-based system gives your recruiters the flexibility of working from everywhere, every time ... day or night. And it gives your applicants the ability to find and apply for your positions. pssRecruit provides your organization a private Web-based job board easily, quickly and cost effectively.

Return to Top

Definitions of terms used in this help file

Return to Top

System Requirements for pssRecruit

pssRecruit must be used from a web server. The application must be placed in a folder with execute permissions on the web server. It's recommended that pssRecruit and its associated files be placed in a subdirectory of the web server's /cgi-bin or /scripts folder.

pssRecruit requires approximately 1.5 MB of disk space on the web server. Each job posting will require 1 to 2 additional kilobytes of space.

Return to Top

Supported Operating Systems

  • Don't see your OS - email us at support@progressivesoft.com
  • Return to Top

    Click Here to open the Installation Instructions in a seperate window for printing.

    Installing pssRecruit

    Currently pssRecruit has been compiled, tested and validated on Intel X86 or compatible platforms with the Supported Operating Systems listed previously. The Solaris version requires a Sun SPARC or compatible platform. The Digital Unix and OSF/1 binary requires an Alpha platform. IRIX requires a Silicon Graphics platform. Cobalt Linux (MIPS) requires a MIPS platform. Compiled versions for other Linux or Unix versions are available upon request.

    You can have the experts install pssRecruit for you, using our Installation and Customization Service.

    pssRecruit is easy to install. You can have your copy of pssRecruit installed and running in a few minutes by following the step-by-step instructions, below.

    Based on your webserver configuration you may need to specify the full path to the GIF files. If you do not specify a path to the GIF files, the default location to place your GIF file in IIS and PWS is C:\Inetpub\wwwroot. The default location on Apache v1.3.9 is /home/httpd/html or /usr/local/www/data.

    Be sure to delete the administrator account that came set up in the download package.

    See our pssRecruit support pages for additional examples and tips to customize your copy of pssRecruit.

    If you desire to rename pssRecruit you may do so. You must also rename pssRecruit.ini, pssRecruit.adm and pssRecruit.tpl to correspond to the new name. For example, if you rename it MyRecruiter.exe or MyRecruiter.cgi you must rename the .ini file MyRecruiter.ini. If you do this and it it still looks for pssRecruit.ini then your OS is using a different source executable environment variable other than "SOURCEEXE" or "sourceExe." If this is the case simply continue to use pssRecruit.ini, run "printenv" (most systems have this program) and email us the output along with the type of OS you are running. From this we can add the new source executable variable and get a new executable to you that will allow you to rename pssRecruit to whatever you desire. If your system does not have a "printenv" email us and we will send you one.

    Click Here to open the Installation Instructions in a seperate window for printing.

    Return to Top

    Click Here to open the Administering Instructions in a seperate window for printing.

    Administering pssRecruit

    Every effort has been made to make the pssRecruit interface as intuitive as possible for recruiters and clients. Most routine administrative functions are accomplished by using the application's administrative interface. The administrative interface is accessed by pointing your browser to the pssRecruit application with ?-admin appended onto the end of the URL. On a Windows system this can be done by setting up a desktop shortcut by entering http://YourDomainName/cgi-bin/pssRecruit/pssRecruit.exe?-admin in the Command Line box of the Create Shortcut Wizard.

    Upon accessing the administrative interface the initial display in your web browser is the login screen. Continue access by entering your login name and password and click on the 'Login' button. Passwords and user names are case sensitive (i.e. Password is different than password and recruiter1 is not the same user as Recruiter1). After gaining access to the system, the Choose an Action screen will appear. On this screen you can choose to perform any of the following actions.

    Click Here to open the Administering Instructions in a seperate window for printing.

    Return to Top

    Click Here to open the File Adjustment Instructions in a seperate window for printing.

    Administrator adjustments to certain application files.

    Generally, no adjustments will be required after initial setup of the pssRecruit application. In a few situations, however, you may need to change some entries in the pssRecruit.ini file or in the AreaDefinitions.tpl file. These two files are covered here in detail.


    The pssRecruit.ini file is the application's configuration initialization file. Using this file you can customize many of the features of pssRecruit. Within the ini file, any line beginning with a pound sign "#" is treated as a comment line and will be ignored. The parameter key names (words to the left of the equal sign) must be specified exactly as they appear and must not be changed. The application reads these parameters and sets them equal to what follows the equal sign.


    The DisciplineDefinitions.tpl file sets the job categories and sub-categories that will be used to organize job postings. This enables the client to more easily find positions listed by pssRecruit. Each category (Discipline Area) starts with a line with only the category name. The next line(s) contain the sub-categories (specialty areas) within this category followed by <br>(the HTML Line Break tag). Each category ends with <EOD> (End of Definition).

    All All Postings <EOD> Engineering Electrical<BR> Mechanical<BR> Software<BR> <EOD> Technical Writing Proposal Preparation<BR> User Manual Preparation<BR> <EOD> Finance Chief Financial Officer<BR> Accounting<BR> Accounts Receivable<BR> <EOD> Recruiting All Recruiting <EOD>


    The pssRecruit.tpl file establishes certain parameters for the input and selection boxes on the client and admin interfaces. Generally, changes are not required in this file. The only line that may need adjustment is the Discipline line. You may add job area names at the end separated by commas. An associated entry must be made in the AreaDefinitions.tpl file. The first line should not be changed at all.

    #FIELD NAME|FIELD TYPE|RECRUITER|SUMMARY|DETAIL Job ID|textfield|1|1|1 Date Posted|textfield|1|0|1 Disciplines|popup_menu|1|1|1|Engineering,Technical Writing,Finance,Recruiting Job Title|textfield|1|1|1 Location|textfield|1|1|1 Job Description|textarea|1|0|1 Expertise|textfield|1|0|1 Salary Range|textfield|1|0|1 Years of Experience|textfield|1|0|1 Degree|textfield|1|0|1 Contact|textfield|1|0|1

    Click Here to open the File Adjustment Instructions in a seperate window for printing.

    Return to Top

    Click Here to open the Customize Instructions in a seperate window for printing.

    Customizing pssRecruit web pages

    The appearance of pssRecruit web pages can be customized by changing the HTML in various *.tpl files. These *.tpl files can have any valid name as configured in the pssRecruit.ini file. For purposes of explanation the file names from the sample configuration above will be used here.

    There are eight *.tpl file settings that help create the web page content viewed by the client or administrator in the web browser. Generally these files contain HTML that will appear above or below the page content generated by the pssRecruit application.

    Click Here to open the Customize Instructions in a seperate window for printing.

    Return to Top

    Connecting pssRecruit to other Web pages.

    Clients can be directed to pssRecruit using the following link on any web page.

    <a href="http://YourDomainName/cgi-bin/pssRecruit /pssRecruit.exe">Put Link Text Here</a> Administrators and Recruiters can be directed to the admin pages with this link: <a href="http://YourDomainName/cgi-bin/pssRecruit /pssRecruit.exe?-admin">Go to Admin pages</a>

    Or on Unix/Linux variants...

    Clients can be directed to pssRecruit using the following link on any web page. <a href="http://YourDomainName/cgi-bin/pssRecruit /pssRecruit.cgi">Put Link Text Here</a> Administrators and Recruiters can be directed to the admin pages with this link: <a href="http://YourDomainName/cgi-bin/pssRecruit /pssRecruit.cgi?-admin">Go to Admin pages</a>
    Return to Top

    Browsing with pssRecruit

    is designed to be intuitive for the client. Anyone who is familiar with surfing the world wide web should be able to find the job postings available at your company. To complete the client's job search, pssRecruit directs the browser to the URL of your registration page. Connecting clients to the registration page is accomplished with the pssRecruit.ini file by setting the proper URL on the RegistrationURL line. Clients are then directed to this URL submit a resume or fill out a form.
    Return to Top

    Release History

    Version 2.53  05-30-2001
    		Enhanced support for newer Netscape browsers
    		Improved default interface
    		Improved on-line documents
    
    Version 2.52   05-01-2001
                 Simplified installation with easier to read documentation
                 Bug fix in Unix / Linux .tar ball extract
    
    Version 2.51 04-08-2001
    	     Added integrated search capability
    	     Added customizable sorting capability
    	     Support for more file-system filename standards
    	     Enhanced support for older browsers
    	     
    Version 2.50 03-01-2001 Original
    

    Return to Top

    Contacting the Author

    We'd like to hear your questions and comments! You can reach us at:

    Internet Email: support@progressivesoft.com
    WWW: http://www.progressivesoft.com/

    Return to Top

    License Agreement

    You should carefully read the following terms and conditions before using this software. Unless you have a different license agreement signed by Progressive Software Solutions, LLC, your use of this software indicates your acceptance of this license agreement and warranty.


    Registered Version

    Each registered copy of pssRecruit is subject to the following conditions:

    No registered user, nor anyone else, may alter or modify the pssRecruit exe/cgi file. Nor can you give anyone else permission to modify the pssRecruit exe/cgi file.

    All rights not expressly granted in this license agreement are reserved entirely to Progressive Software Solutions, LLC.


    Governing Law

    This agreement shall be governed by the laws of the State of Virginia, USA.


    Disclaimer of Warranty

    THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. Because of the various hardware and software environments into which pssRecruit may be put, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it. The user must assume the entire risk of using the program. ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.


    Shareware Version

    This is not free software. You are hereby licensed to use the shareware evaluation version of pssRecruit for evaluation purposes without charge for a period of 30 days. If you use this software after the 30 day evaluation period a registration fee is required. Unregistered use of pssRecruit after the 30 day evaluation period is in violation of copyright laws.


    Distribution of pssRecruit

    You are hereby licensed to make as many copies of the shareware evaluation version of this software and documentation as you wish; give exact copies of the original shareware version to anyone; and distribute the shareware version of the software and documentation in its unmodified form via electronic means. There is no charge for any of the above.

    You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission from Progressive Software Solutions, LLC., with one exception: Disk Vendors approved by the Association of Shareware Professionals are permitted to redistribute pssRecruit subject to the conditions in this license, without specific written permission.

    Return to Top

    A Product of Progressive Software Solutions, LLC