home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-387-Vol-3of3.iso
/
c
/
cadtrack.zip
/
CADTRACK.DOC
< prev
next >
Wrap
Text File
|
1992-03-01
|
39KB
|
929 lines
╔════════════════════════════════════════╗
║ CadTrack ║
║ Version 1.00 ║
║ Copyright (C) 1992, Neal Abrams ║
╚════════════════════════════════════════╝
TABLE OF CONTENTS
-----------------
1.0 What is CadTrack ........................................ 7
2.0 System Requirements ..................................... 7
3.0 Installation ............................................ 8
4.0 Configuring CadTrack .................................... 9
5.0 Running CadTrack ........................................ 10
5.1 Program Limitations ................................ 10
5.2 Log-in Procedure ................................... 10
5.3 Job Selection ...................................... 10
5.4 Adding/Editing a Job ............................... 12
5.5 File Selection ..................................... 12
6.0 Accessing the Edit CadTrack.uid Menu .................... 14
6.1 Editing/Adding a user .............................. 15
7.0 Cadd Tracking ........................................... 16
8.0 Technical ............................................... 17
9.0 Acknowledgements ........................................ 17
10.0 Revision History ....................................... 17
11.0 Appendix A: Site Licenses ............................... 18
CadTrack 1.00 Page 3
DISCLAIMER
----------
Neal Abrams hereby disclaims all warranties relating to this software,
whether express or implied, including without limitation any implied
warranties of merchantability or fitness for a particular purpose.
Neal Abrams will not be liable for any special, incidental,
consequential, indirect or similar damages due to loss of data or any
other reason, even if Neal Abrams or an agent of Neal Abrams has been
advised of the possibility of such damages. In no event shall Neal
Abrams' liability for any damages ever exceed the price paid for the
license to use software, regardless of the form of the claim. The
person using the software bears all risk as to the quality and
performance of the software.
LICENSE
-------
CadTrack is a Shareware product. As such, it is made available to the
general personal computing public for evaluation. Users are licensed
to operate this program on their computers for the purpose of test and
evaluation on a trial basis for a limited trial period. It is not
possible to reasonably define the limits of a fair and equitable time
period for evaluation; therefore it is left to the user's judgment and
sense of fair play as to the time required to make a decision as to
its usefulness. (As a guideline, 30 days should generally be
sufficient time to evaluate the utility of a program of this type.)
If the user decides the program is not of sufficient merit to warrant
purchase through registration with the author, he/she should remove
the program from his/her personal computer. Otherwise, if the program
is deemed useful and is in regular use on the user's computer system,
registration with the author is required.
Registered users are those users who elect to pay for CadTrack and
register that payment with the author. By virtue of registration and
payment for the program, registered users are granted a license to
continue to utilize the program on their personal computer for as long
as they choose. This license authorizes the user to use the program
on any personal computer system he or she may own or use so long as
the program is operated on only one computer system at a time.
GUARANTEE
---------
CadTrack is offered with an unconditional 30-day money-back guarantee.
If you become dissatisfied with the program for any reason within that
period, just let me know and your registration fee will be refunded.
If you purchased a registration package which included a diskette
and/or a manual, please return these when requesting a refund. This
guarantee is unconditional. I would ask, however, if you are having a
problem to let me know before giving up on CadTrack since your problem
may be something I can solve.
CadTrack 1.00 Page 4
Finally, if you order a registration package which includes a
diskette or manual and either of these items are defective -- either
through my error or through postal service "processing",let me know
and I will send replacements promptly.
REGISTRATION
------------
The registration fee is $25, payable to:
Neal Abrams
161 Bentley Street
Staten Island, NY 10307
The payment of this registration fee to the author entitles the
user to full use of the product for an unlimited period of time in
addition to product support. The distribution of diskette copies of
CadTrack and future upgrades is not included as part of the basic
registration fee.
CadTrack is a fully functional Shareware product. Shareware is a
computer program distribution and marketing method that permits
potential buyers to thoroughly try the program prior to purchase. It
is NOT free and it is not in the Public Domain. If, after evaluating
the program, you find it useful enough to use on a regular basis, you
are expected to pay for it by registering with the author.
Please note that the registration fee is specifically limited to
CadTrack (CADTRACK.COM and CADTRK10.EXE) program and its associated
documentation.
SITE LICENSING
--------------
Attractively-priced site licensing is available for commercial users.
Pricing for "typical" site licensing is given in an appendix to this
manual. If you have needs which are not met by the standard license
terms, please call or write for a quote which addresses any unique
support or product update requirements. Customization is also
available on a contract basis.
UPGRADE AND UPDATE POLICIES
---------------------------
First, some definitions: I define upgrade as the RIGHT to use a later
revision of a piece of software. I define update as the physical
media on which the upgrade resides. I'll further define an update as
not including hard-copy documentation unless specifically defined. My
current upgrade/update policies are as follows:
There are no upgrade charges associated with CadTrack and I do not
have any plans at present to institute such charges with future
revisions. I do reserve the right to do so, however, if in my
CadTrack 1.00 Page 5
opinion the nature and magnitude of CadTrack changes to such a degree
as to constitute a substantially new product. I do plan to charge for
updates. The content and pricing for specific update packages is
described at the end of this document and in the REGISTER.DOC file.
Pricing is subject to change without notice, however, to accommodate
postage, printing, and other price increases.
DISTRIBUTING CADTRACK
---------------------
CadTrack may be freely distributed subject only to the following
distribution for-charge restrictions:
CadTrack is the sole property of Neal Abrams. The program may be
freely copied and transferred to individual parties for evaluation
purposes. It may be posted on Bulletin Board systems (BBS) for
electronic access as long as NO FEE is charged for its distribution
except for private BBS operations that charge a regular user
subscription fee.
Please feel free to distribute copies of this program to friends,
co-workers, bulletin boards, and users' groups. I do ask, however,
that you please distribute all of the original files and not modified
copies.
TECHNICAL SUPPORT
-----------------
Registered Users: Full technical support is available to registered
users of CadTrack. I will provide support through the mails, or, if
the problem absolutely cannot wait, the telephone (no collect calls
please). I will do my best to resolve any software bugs in a timely
manner and I am always open to incorporating new features or changes
which are appropriate to the nature of the product.
Unregistered Users: I will attempt to respond to software trouble
reports made by non-registered users if the problems concern the
general functionality of the program. Such users should not, however,
expect product support beyond initial aid to determine if the program
is suitable for their needs.
If you have a problem: I ask that, before calling or writing, you
take the following steps:
1) Check the manual.
2) See if you can duplicate the problem.
3) If you're still stuck, please make a note of your hardware and
software environment and the sequence of actions which lead to
the error. If I can't reproduce an error, it will be very
difficult to correct, so your help is vital in isolating the
problem.
CadTrack 1.00 Page 6
If you follow these steps, it will help me to solve your problem in a
more efficient and timely manner.
I may be contacted via:
Executive Network BBS (914) 667-4567
U.S. Mail 161 Bentley Street
Staten Island, NY 10307
Telephone (718) 984-5295 (after 8pm Eastern time)
I usually check the Executive Network daily.
AMI is a registered trademark of American Megatrends Incorporated
AutoCAD is registered trademarks of Autodesk, Inc.
DEC is a registered trademark of Digital Equipment Corporation
IBM PC/XT/AT are registered trademarks of International Business
Machines Corporation
Intel is registered trademarks of Intel Corporation
Microsoft, MS-DOS and QuickBASIC are registered trademarks of
Microsoft Corporation
NEC is a registered trademark of NEC Corporation
CadTrack 1.00 Page 7
1.0 What is CadTrack
CadTrack is an AutoCAD front end which keeps track of jobs, users and
the time they spend working on these jobs within the AutoCAD drawing
environment. Jobs and users are kept within simple data files which
may be edited or updated as needed within CadTrack. Users must log in
to each cadd session by entering their name and personal password.
(Users names and passwords are kept encrypted within the user data
file). They may only be accessed by entering a special password when
logging in to CadTrack (See "Accessing the Edit CadTrack.uid Menu).
Each session is tracked and the information automatically written to a
log file. A new log file is created on the first session of each
month (See "Cadd Tracking"). This log file could then be used for
billing clients by job number.
2.0 System Requirements
This program *should* run on any IBM compatible PC with a math
coprocessor; however to date, CadTrack has only been tested on the
following computers running MS-DOS Version 5.0, and AutoCAD version 10
(including 386 version). While I realize that CadTrack has not *yet*
been tested with AutoCAD version 11, I don't foresee any problems.
Also, Cadtrack has NOT *yet* been tested in a network environment.
AMI 80286/12Mhz PC w/ Intel 80287-10
NEC 80386/20Mhz PC w/ Intel 80387
DEC 80486/33Mhz PC
Memory Cadtrack requires approximately 100KB of DOS memory. Note
that one of the important features of CadTrack is that it
doesn't take away any precious DOS memory from AutoCAD.
CadTrack does NOT create a DOS command shell to run AutoCAD.
AutoCAD CadTrack makes no attempt to insure that AutoCAD has been
installed properly. Make certain that AutoCAD knows where
to find what it needs. This is accomplished by setting the
appropriate AutoCAD environment variables (Refer to AutoCAD
Reference Manual).
CadTrack 1.00 Page 8
3.0 Installation
File Name Directory to copy files Description
--------- ----------------------- -----------
CADTRACK.COM C:\CADTRACK Loads the main program
CADTRK10.EXE " Main Program
CADTRACK.CFG " Configuration file (see
Cadtrack Configuration
section)
LOGOUT.BAT Any sub-directory which This batch file allows users
is included within your to log-out of an AutoCAD
DOS path statement. drawing without actually
quitting. It then loads your
your favorite screen saver
(assuming you have enough
memory for it). This batch
file must be edited with your
favorite text editor.
Instructions are included
within the batch file.
Also, the CADTRACK.UID file should be installed in the directory of
your choice. However you must tell CadTrack where it is located.
This is accomplished by setting the userid=drive:\pathspec setting
within CADTRACK.CFG (See "Configuring CadTrack").
CadTrack 1.00 Page 9
4.0 Configuring CadTrack
The CADTRACK.CFG file distributed with CadTrack should be edited by
your favorite text editor to suit the configuration you desire.
CadTrack will look for the following settings within the file:
SETTING PURPOSE
------- -------
acadexe=drive:\pathspec Tells Cadtrack location of ACAD.EXE
userid=drive:\pathspec Tells CadTrack location of
CADTRACK.UID
job=drive:\pathspec Desired location of CADTRACK.JOB
log=drive:\pathspec Desired location of log file
The CADTRACK.CFG file and the above settings are REQUIRED and CadTrack
will not even load if they aren't correct. If any of the settings are
not correct, Cadtrack will abort and tell you the reason (order and
case are *not* important).
CadTrack 1.00 Page 10
5.0 Running CadTrack
To start Cadtrack the file CADTRACK.COM *must* be executed first.
This can be accomplished by either including the CadTrack sub-
directory in the DOS path statement within AUTOEXEC.BAT and then
typing "CADTRACK", or it may be called directly from a batch file.
5.1 Program Limitations
- Maximum of 400 User/Password entries.
- Maximum of 400 Job entries.
- Maximum of between 500 and 1000 files in a directory
- Operating system revision of at least DOS 3.3
5.2 Log-in Procedure:
The first thing CadTrack asks the user to do is log in. First
Cadtrack prompts the user for his/her name. If the name is found
within the CADTRACK.UID file, CadTrack then prompts the user for their
personal password. CadTrack only allows a total of three attempts to
log in, at which time the program will terminate. If the log-in is
successful Cadtrack will proceed to the Job Selection menu.
5.3 Job Selection
At the Job Selection menu CadTrack reads in all the jobs found in the
file CADTRACK.JOB and displays them on the screen. If this file
doesn't exist or has no jobs in it, CadTrack will prompt you to add a
job. If CadTrack finds any jobs within the file, it will display them
and you will have the following options:
Key What it does. Details
--- ------------ -------
UP ARROW |
DN ARROW |
PG UP |------ Use these keys to highlight a job record for
PG DN | editing, deleting or file selection.
HOME |
END |
F1 Help Pressing this key will display primary
options.
ESC Abort Pressing this key will terminate current
operation and will cause Cadtrack to
terminate returning the user to the DOS
command prompt.
CadTrack 1.00 Page 11
Key What it does Details
--- ------------ -------
A Add Job Pressing this key will cause Cadtrack to
prompt user for job information. Pressing
<ESC> at any prompt will terminate this
operation. When all the prompts are
correctly responded to, Cadtrack will add the
job to the CADTRACK.JOB file and will display
on these prompts see "Adding/Editing a Job").
E Edit Job Pressing this key will cause CadTrack to
prompt user to re-enter job information for
the job record selected by the highlight bar.
Pressing <ESC> at any prompt will terminate
this operation. When all the prompts have
been correctly responded to, Cadtrack will
update the job within the CADTRACK.JOB file
and will re-display it on the screen with the
new information (For additional information
on these prompts, see "Adding/Editing a new
Job").
D Delete Job Pressing this key will cause CadTrack to
prompt user whether they are sure they want
to delete the job record selected by the
highlight bar. Pressing <Y> will cause
CadTrack to delete the job record from within
CADTRACK.JOB and update the Select Job menu.
Pressing <N> will abort the operation (Note
that pressing <ESC> will NOT abort this
prompt).
ENTER Select Job Pressing this key will cause CadTrack to
select the highlighted job record. CadTrack
will then check to see if the sub-directory
configured for this job record actually
exists. If it doesn't CadTrack will ask the
user whether they want to create it. At this
prompt, pressing <Y> will cause CadTrack to
attempt create the directory. If CadTrack
cannot create the sub-directory it will tell
you so. This could occur if the CADTRACK.JOB
file you are using was created on a different
machine which was configured with substituted
drives which don't exist on the current
machine. Pressing <N> will abort the
operation (Note that pressing <ESC> will NOT
abort this prompt). If CadTrack was able
to find the sub-directory CadTrack will then
proceed to the File Selection menu for the
selected job record.
CadTrack 1.00 Page 12
5.4 Adding/Editing a job
Pressing <A> or <E> while within the Job Selection menu will cause
CadTrack to prompt the user for the following information:
Prompt Description
------ -----------
Enter job name: Enter job name or abbreviated name of job.
Enter job number: Enter the job number for the job.
Enter sub number: Enter sub number for the job
Enter Job description: Enter a short description of job.
Enter job path: This prompt accepts any valid DOS sub-
directory in the form of drive:\pathspec. If
CadTrack cannot locate the entered sub-
directory it will attempt to create it as
entered. If it is not a valid DOS sub-
directory name CadTrack will prompt you for
again for a valid one.
5.5 File Selection
At the File Selection menu CadTrack reads in all the files (including
directories) found within the directory for the selected job record.
CadTrack then displays them on the screen after which you will have
the following options:
Key What it does. Details
--- ------------ -------
UP ARROW |
DN ARROW |
PG UP |------ Use these keys to highlight a file for
PG DN | selection or a directory to change to.
HOME |
END |
F1 Help Pressing this key will display primary
options.
ESC Abort Pressing this key will cause Cadtrack to
return to the Job Selection menu.
SPACEBAR Load AutoCAD Pressing this key will immediately cause
CadTrack to terminate and bring the user to
the AutoCAD main menu screen. Before
CadTrack terminates it will log the starting
time for the job selected at the Job
Selection menu.
CadTrack 1.00 Page 13
Key What it does Details
--- ------------ -------
ENTER Select DWG Pressing this key while a file that has a
.DWG extension is highlighted will cause
CadTrack to terminate and bring the user to
the AutoCAD drawing screen, with the selected
drawing loaded. Before CadTrack terminates,
it will log the starting time for the job
selected at the Job Selection menu (For
information regarding time logging see
"Cadd Tracking").
ENTER Select SCR Pressing this key while a file that has a
.SCR extension is highlighted, will cause
CadTrack to terminate and immediately execute
the selected AutoCAD script file. Before
CadTrack terminates, it will log the starting
time for the job selected at the Job
Selection menu (For information regarding
time logging see "Cadd Tracking").
ENTER Select DIR Pressing this key while a directory <DIR> is
highlighted, will cause CadTrack change to
the selected directory. CadTrack will then
read in the files (including directories)
within the selected directory and display
them on the screen for selection.
CadTrack 1.00 Page 14
6.0 Accessing the Edit CadTrack.uid Menu.
In order for users to log-in to cadd sessions, they must first be
added to the user data base file CADTRACK.UID. This is accomplished
by logging into CadTrack as follows:
At the "Enter first name:" prompt of the CadTrack Log-in procedure
enter the name "config". At the "Enter password:" prompt enter
"security" (note that case is not important). CadTrack will then
proceed to the Edit CadTrack.uid menu. CadTrack will read in all the
users found in the CADTRACK.UID file and display them on the
screen. Passwords will be shown encrypted. You will then have the
following options:
Key What it does. Details
--- ------------ -------
UP ARROW |
DN ARROW |
PG UP |------ Use these keys to highlight a user record for
PG DN | editing or deleting.
HOME |
END |
F1 Help Pressing this key will display primary
options.
ESC Abort Pressing this key will terminate current
operation and will eventually cause Cadtrack
to terminate returning the user to the DOS
command prompt.
A Add User Pressing this key will cause Cadtrack to
prompt user for user information. Pressing
<ESC> at any prompt will terminate this
operation. When all the prompts are
correctly responded to, Cadtrack will add the
user to the CADTRACK.UID file and will
display it on the screen (For additional
information on these prompts see
"Adding/Editing a User").
E Edit User Pressing this key will cause CadTrack to
prompt user to re-enter new password
information for the user record selected by
the highlight bar. Pressing <ESC> at any
prompt will terminate this operation. When
all the prompts have been correctly responded
to, Cadtrack will update the user within the
CADTRACK.UID file and will re-display it on
the screen with the new information (For
additional information on these prompts, see
the "Adding/Editing a new User").
CadTrack 1.00 Page 15
Key What it does. Details
--- ------------ -------
D Delete User Pressing this key will cause CadTrack to
prompt user whether they are sure they want
to delete the user record selected by the
highlight bar. Pressing <Y> will cause
CadTrack to delete the user record from
within CADTRACK.UID and update the Edit
CadTrack.uid menu. Pressing <N> will abort
the operation (Note that pressing <ESC> will
NOT abort this prompt).
6.1 Adding/Editing a user
Pressing <A> while within the Edit CadTrack.uid menu will cause
CadTrack to prompt the user for the following information:
Prompt Description
------ -----------
Enter user name: Enter first name of new user.
Enter password: Enter password of new user.
Pressing <E> while within the Edit CadTrack.uid menu will cause
CadTrack to prompt the user for the following information:
Prompt Description
------ -----------
Enter old password: Enter previous password of user.
Enter new password: Enter new password of user.
CadTrack 1.00 Page 16
7.0 Cadd Tracking
Before CadTrack terminates and brings the user into AutoCAD, it will
look for the monthly log file. CadTrack automatically creates a new
log file on the first session of each month. CadTrack creates this
log file within the directory specified by the job=drive:\pathspec
setting within the CADTRACK.CFG file (See configuring CadTrack). The
name of the log file depends upon the date. For example on the first
session of February 1992, CadTrack would create a log file named
FEB92.LOG. If CadTrack cannot locate the appropriate log file, it will
create it. CadTrack writes the following information to the log file
for each cadd session.
Log file field header Description of information under field
--------------------- --------------------------------------
Job Name Job name or abbreviated name of job which the
user selected at the Job selection menu.
Job number The job number for the job which the user
selected at the Job Selection menu.
Sub number The sub number for the job which the user
selected at the Job Selection menu.
Discipline Name of the directory for the job which the
(Disc.) user selected at the Job Selection menu.
Note that only the name of the directory (8
char. max) is listed and not the entire path
(ie "c:\dwg\archwork" would produce
"archwork").
User Name of user that logged into cadd session.
PCID Machine descriptor read from the DOS
environment. This can be set by placing
using the "SET" command within AUTOEXEC.BAT.
(ie SET PCID=PC000001). The PCID environment
should not exceed 8 characters. CadTrack
will only read the first 8 characters from
the DOS environment and place them under this
field.
Date Date of cadd session in the format
MM/DD/YY.
Start Starting time of cadd session in the format
HH:MM:SS (Military Time).
Time Elapsed time of cadd session in the format
HH:MM:SS.
CadTrack 1.00 Page 17
8.0 Technical
CadTrack was written using Microsoft QuickBASIC 4.5 in conjunction
with the PBClone library (Version 1.7) written and copyrighted by
Thomas G. Hanlin III.
9.0 Acknowledgements
For CadTrack 1.00, special thanks go to Thomas G. Hanlin III who's
PBCLone library made this project possible. Using the routines from
his library allowed me to accomplish things which are beyond my
programming capabilities at this time.
I would also like to thank my wife and son for putting up with me
while I payed a bit less attention to them while writing the code and
documentation for CadTrack.
Finally, I would like to thank my Lord and Savior Jesus Christ. If it
were not for Him, I would not even be alive today.
10.0 Revision history
Version Release Date Description of revision(s)
------- ------------ --------------------------
1.00 03-01-92 First release
CadTrack 1.00 Page 18
11.0 Appendix A: Site Licenses
Site Licenses are available for CadTrack. The rates below are for a
"basic" site license. This includes registration for the specified
number of copies and support through a single specified individual. I
will, however, be happy to address specific requirements such as
update subscriptions and support through multiple persons.
$40 1 registration with media, copy of manual and update
$18 2-5 registrations
$16 6-9
$14 10-19
$12 20-29
$10 30-99
$8 100 and up
Unlimited $2,500
The above schedule means that the first copy is $40, the 2nd through
5th copies are $18, and so forth. (The exception is the unlimited
license which represents the total license cost.) So, for example, 6
copies would cost $128 ($40 + 4x$18 + 1x$16). The table below lists
the site license cost for a variety of user counts. My terms read
support through a single person, though I'm flexible within reason.
Registration for CadTrack
To register, please return this form with your registration check or
money order (Purchase orders are also accepted) to:
Neal Abrams
161 Bentley Street
Staten Island, NY 10307
Phone: (718) 984-5295
Name ____________________________________
Address ________________________________________________________
________________________________________________________
________________________________________________________
Phone (_____)_____-______
Where did you get CadTrack 1.00 from?
BBS / Service Name ______________________ Number (_____)_____-______
_____ CadTrack 1.00 Registration w/ diskette @ $ 30.00 ea $ _____
(Includes a license for one user, diskette w/ CadTrack and all
associated files, and product support.)
_____ CadTrack 1.00 Registration @ $ 25.00 ea $ _____
(Includes a license for one user and product support; No diskette or
hard-copy documentation.)
_____ CadTrack 1.00 Registration w/ diskette/docs/upd @ $ 40.00 ea $ _____
(Includes Registration and product support plus: A diskette with
CadTrack and all associated files, printed documentation, one free
update diskette)
_____ CadTrack Update w/ diskette only @ $ 5.00 ea $ _____
(Includes diskette with latest CadTrack and all associated files.
REGISTERED USERS ONLY)
_____ CadTrack Update w/ diskette and docs @ $ 15.00 $ _____
(As above plus printed documentation. REGISTERED USERS ONLY)
(*) Non-North American shipping @ $ 5.00 $ _____
TOTAL Enclosed (in US Dollars please) $ _____
If a diskette is being ordered: 3.5" ____ 5.25" ____
(*) Non-North American orders should please include $5.00 extra to
cover additional shipping and handling charges ONLY if a diskette
and/or manual is being ordered. Please send all payments payable in
U.S. Dollars.
Canadian customers may use Canadian postal money orders in dollar
denominations.
Feel free to attach any other comments or instructions (e.g. program
features you'd like to see, or don't send a copy of the program until
the next major rev, etc.)
Note that the update options are:
1) Only available to users who have registered a previous
revision of CadTrack and
2) Only required of registered users if they wish a copy of the
latest revision on disk and/or a printed manual. In other words,
this is a Materials/S&H charge for sending out the latest
revision. Registered users of CadTrack who have obtained the
latest rev from other sources (e.g. a BBS) are under no
obligation to pay an upgrade fee for the use of that rev.
(Of course, this revision will be mailed out automatically to
those users for whom it represents their free update.)
