home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Dr. Business
/
DR_BUSINESS.BIN
/
CG05.DOC
< prev
next >
Wrap
Text File
|
1993-11-04
|
17KB
|
475 lines
Part II: The Program Details
Chapter 5 - Main Menu and Misc Features
The Main Menu is divided into several sections, with the first section
listed underneath the current portfolio, the second section listed under
Global Operations, and the last section listed under Other Operations. The
first section includes the following options:
o Activity - buy shares, sell shares, or record distributions.
o Security - go to the Local Security Table, to view, add, change, or
delete local securities.
o Log Maintenance - view, add, change, or delete open shares records,
closed shares records, or distribution records.
The Global Operations section offers the following:
o Portfolio - go to the Portfolio Table, to view, add, change, delete, or
open portfolios.
o Global Security - go to the Global Security Table, to view, add, change,
or delete global securities.
o Broker/Investment Company - go to the Broker/Investment Company Table,
to view, add, change, or delete broker/investment companies.
o Security Types - go to the Security Type Table, to view, add, change, or
delete security types.
o Reports - generate reports.
o User Settings - go to the User Settings Form to change the current
settings.
o View Documentation - view the Capital Gainz documentation files, or
select any other file to view.
o Check Data Consistency - check your data files for suspicious data, such
as stray price entries.
o Exit - return to DOS. The Esc key will not exit from the Main Menu.
At the top of the menu, the current version number is displayed. At
the bottom, the remaining conventional memory is displayed. You are issued
a warning if you get low on memory.
Function keys displayed under Other Operations are:
o Help - popup a list of help topics to choose from.
o F2:System Date Range - set a date range for tables and reports.
Capital Gainz Users Manual 5-1
o F3:Backup User Data - copy data files to diskette.
o F4:Set Password - set a password to restrict access to Capital Gainz.
o F5:Enter Portfolio ID - enter the ID of a portfolio to open.
o F8:Utility Program - switch to the Utility Program.
o F9:Graphics Program - switch to the Graphics Program.
o F10:Download Program - switch to the Download Program.
5.1 Global Function Keys
Some function keys are available from many menus, tables and forms,
and will not be discussed in other sections of this manual:
o Help - bring up the part of the users manual most relevant to your
current activity. This is discussed below.
o Ctrl-D Shell To DOS - suspend the program and invoke the DOS shell. This
is discussed below.
o Ctrl-C:Calculator - popup a calculator. You can paste the result into
the current form field. This is discussed below.
5.2 Date Range
===>>> You can limit records displayed in tables or printed on reports by
specifying a range of dates in the Dates Form. On the Main Menu and Report
Menu, you'll see a function key labeled Select Date Range. When you select
a date range, this range stays in effect until you explicitly change it.
Limiting records to a range of dates will generally speed up table
displays and reports.
The Date Form accepts a Begin Date and an End Date. If the End Date is
before the Begin Date, the two are swapped. You must enter valid dates.
The F2:All Dates key lets you remove any current date restriction.
5.3 Passwords
Capital Gainz implements system password to secure your data. A
password of all spaces, the initial value after installation, is the same
as having no password. Any other setting causes the Capital Gainz programs
to prompt the user for the password on startup.
Instead of echoing the characters, each keystroke causes a '.' to be
displayed. After three incorrect entries, the program aborts.
A password can be 1-8 characters long, with entry terminated by the
Enter key. Any of the printable ASCII characters can be used in your
password, and it is not case-sensitive. The password is blank-padded, so
trailing spaces are not significant. Select something you will remember,
Capital Gainz Users Manual 5-2
but is not easily guessed. A good way to avoid easily guessed passwords is
to include at least one non-alphabetic character, such as ! or a number.
To change the password, use the Main Menu's Set Password function:
o If the current password is not all spaces, you must enter it first. This
prevents someone from changing your password if you leave your computer
unoccupied while Capital Gainz is running.
o You are prompted for the new password. Keystrokes are not echoed.
o You are asked to verify the new password by retyping it, since the
password's characters are not echoed. After successful verification, the
new password is in effect.
===>>> The Password File is encrypted, so looking at a hex or ASCII dump
of the file will not reveal your password. The Capital Gainz programs
require that this file exist in the directory you're in when you start the
program. If you delete the Password File, the Capital Gainz programs will
not run. The only way to regain access if you forget your password is to
reinstall the original Password File. Alternatively, you can copy an old
file with a known password into the program directory.
5.4 Backup
Your data can be wiped out or corrupted by a disk failure, inadvertent
file deletion, or a number of other actions. In DOS, application errors
can cause cross-links in the file allocation table (FAT). This means that
two different programs write to the same chunk of disk space, as if each
'owned' it. The result is usually jumbled data inaccessible by either
application. A backup copy of your data can save a lot of work in such
situations. The Backup key on the Main Menu executes:
o The Internal Backup/Restore function described below if the Backup
Command value in the User Settings Form is blank.
or
o The Backup Command value in the User Settings Form, if it is not blank.
5.4.1 Backup Strategy
The Capital Gainz data files are identified by the file
specifications:
*.DAT
*.K01
While data on your hard disk can be inadvertently wiped out, data on
diskettes is even more vulnerable. Here's a good, simple backup strategy:
o Label 3 blank, formatted disks as Capital Gainz Backup #1, #2, and #3.
o Set aside three sheets of paper, labeled Log #1, #2, and #3. These will
be the backup logs corresponding to the diskettes.
Capital Gainz Users Manual 5-3
o Every day that you make significant additions or changes, backup your
Capital Gainz data using the Backup function. The first time you backup,
use Disk #1 and record the date on Log #1. The second time you backup,
use Disk #2 and record the date on Log #2. The third time you backup,
use Disk #3 and record the date on Disk #3. Then, you'll rotate the
disks. The fourth time you backup, use Disk #1 and record the date on
Log #1. The fifth time you backup, use Disk #2 and record the date on
Log #2. And so on...
o If one of the backup disks starts having problems (such as Sector Not
Found errors), get rid of it and insert a new blank, formatted disk into
the rotation.
o You should also make special backups at 'safe' times. For instance,
after reconciling all your broker and mutual fund statements with
Capital Gainz at tax time, make a backup and store it with your tax
information. This can come in handy in case, say, a computer virus
slowly attacks your data files, and you don't notice until after all 3
regular backup disks have been affected.
This strategy requires very little effort, and only takes a couple minutes
a day. Be prepared: the question is not 'if' you will lose data, but
'when'.
5.4.2 Internal Backup/Restore
Capital Gainz' internal backup/restore procedure lets you:
o Backup data files TO diskette.
o Restore data files FROM diskette.
The fields in the Backup/Restore form are:
o (Required) The Operation, which is either BACKUP or RESTORE.
o (Required) The Drive and Directory to Backup or Restore data files From.
o (Required) The Drive and Directory to Backup or Restore data files To.
o (Required) Whether to Include Portfolio History. Portfolio histories are
'snapshots' of portfolios on given dates. The current portfolio data is
always Backed up or Restored, so you can elect to not backup or restore
historical data files.
o (Required) Whether to Execute the requested Backup or Restore. This
forces you to review the information you entered, preventing inadvertent
actions.
Capital Gainz displays intelligent defaults when you bring the form up.
For BACKUP, the From Drive and Directory are set to the current drive
and directory, which contains the current Capital Gainz data files. The
To Drive and Directory are set to the floppy disk drive specified in the
Capital Gainz Users Manual 5-4
previous Backup/Restore and \, the root directory. You will probably
Backup to the root directory on drive A or B.
For RESTORE, the From Drive and Directory are set to the floppy disk
drive specified in the previous Backup/Restore and \. You may need to
change this, depending on where the Capital Gainz backup files are. The
To Drive and Directory are set to the current drive and directory, which
contains the current Capital Gainz data files. The data files will be
replaced with the ones being Restored.
When the BACKUP or RESTORE operation is invoked, Capital Gainz first
checks if the drive to Backup or Restore to has enough free disk space to
hold the data files, and returns an error if there isn't. Next, data files
on the disk being Backed up or Restored to are deleted. Then, if you are
Backing up, the current Capital Gainz data files are copied from the
Capital Gainz directory to the Backup disk. If you are Restoring old
Capital Gainz data files, they are copied from the Backup disk to the
Capital Gainz directory.
===>>> It takes a lot of data to exceed available disk space on a Backup,
especially a high density 1.2MB or 1.44MB diskette. However, if this
happens, you can limit the amount of data by choosing not to Include
Portfolio History. Or, you can specify a different Backup Command in the
User Settings Form. For instance, you can invoke a compression utility
such as PKZIP, either directly or via a batch file.
5.4.3 External Backup/Restore
If you'd rather use a file compression utility such as PKZIP to
backup/restore data, you can:
o Manually run it from the DOS command line.
or
o Write a small batch file that asks if you want to backup or restore,
then executes the appropriate command. Specify the batch file's name in
the Backup Command field in the User Settings Form.
or
o Specify the backup command in the Backup Command field in the User
Settings Form. If you need to restore files, you can do it from the DOS
command line.
The file specification used should include *.DAT and *.K01 files (note
that this is zero, not O), and you'll need to use subdirectory recursion
if you want to include the portfolio history files. Using PKZIP:
PKZIP -upr A:CGDATA.ZIP *.DAT *.K01
The '-upr' option specifies to update the ZIP file, retain pathnames, and
recurse through subdirectories.
Capital Gainz Users Manual 5-5
5.5 Switching Programs
You can switch among the Capital Gainz programs from each program's
Main Menu. The keys are labeled: F7:Capital Gainz, F8:Utility Program,
F9:Graphics Program and F10:Download Program. However, to be able to
switch:
o You must have started Capital Gainz with CG.BAT.
o The Capital Gainz programs must all be installed in the same directory.
5.6 Calculator
Most forms and tables allow you to pull up a calculator supporting
five functions: add, subtract, multiply, divide, and square root. A single
memory is also supported. The fields should be self-explanatory, and you
can 'hit' a key either by moving the highlight bar and hitting Enter or by
hitting the associated key. You can use the number keys above the letters
on the keyboard, or use the numeric keypad. For operations, you can use
the regular keys or the grey keys on the numeric keypad. The Backspace key
erases the last digit entered. Other functions have associated mnemonic
keys indicated in < >, or offset by capitalization:
o 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 : record the entered number.
o . : insert a decimal point.
o +, -, *, / : add , subtract, multiply, divide operation.
o √ : Square root.
o = : the equal sign or space bar performs the last operation entered.
o +- : Negate the current value.
o C, CE : Clear, clear last Entry.
o M+, M- : Increment memory, Decrement memory.
o MC, MR : clear (Flush) memory, Recall memory.
If you pop up the calculator while you are currently on a field with a
numeric value, that value is displayed on the calculator. To exit:
o eXit : eXit from the calculator, which is the same as hitting Esc.
o Paste : Paste the currently displayed value into the field you were on
when you invoked the calculator.
Capital Gainz Users Manual 5-6
5.7 Shell to DOS
The Goto DOS option, on the Main Menus of the Capital Gainz programs,
lets you suspend the program and shell to DOS. A temporary program image
is saved, and your DOS command line prompt is altered. Typing EXIT from
DOS returns you to the suspended program. GoTo DOS is NOT the same as
ending the program with the Exit option.
5.8 View Documentation
The View Documentation option on the Main Menu lets you view the
online Capital Gainz documentation, if you chose to install it. Viewing
documentation is the same as viewing a report on the screen. See Chapter
14 for information about viewing reports.
You can view the following documents on line:
o USERS MANUAL: the Capital Gainz Users Manual.
o README: contains recent information not in the Users Manual.
o LICENSE: license agreement, describing usage restrictions.
o HISTORY: changes, fixes, and additions to this release.
o SELECT FILE: select another file to view.
5.8.1 Select File
If you choose SELECT FILE, you are shown a list of files in the
current directory. At the top of screen are the following fields:
o The current Directory to use.
o The File Mask to use, such as *.*.
These fields are initialized to the current directory and *.*. Function
keys at the bottom of the screen are:
o Enter:Select - view the highlighted file.
o F2:Dir/Mask - change the Directory and File Mask.
o Esc:Exit - exit from the table.
Files are not checked to see if they consist of readable text.
5.9 Online Help
===>>> Whenever Capital Gainz is waiting for input, you can hit F1 to
bring up online help. The help facility uses the online users manual,
displaying the section most appropriate to where you currently are in the
program. You can use Ctrl-X to bring up an index of help topics and
chapters from the users manual.
Capital Gainz Users Manual 5-7
After choosing a topic, the relevant part of the users manual is
displayed. As indicated, some topics correspond to specific chapters. You
can also bring up this index from the View Documentation option.
The online documentation is a subset of the complete users manual.
Capital Gainz Users Manual 5-8