home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Der Mediaplex Sampler - Die 6 von Plex
/
6_v_plex.zip
/
6_v_plex
/
DISK4
/
BUSIN_09
/
CGZDC31A.ZIP
/
CG02.DOC
< prev
next >
Wrap
Text File
|
1992-10-19
|
49KB
|
1,161 lines
Part I: Getting to Know You
Chapter 2 - System Overview
This chapter discusses Capial Gainz' functions and files.
2.1 System Functions
[[Screen not in online version of documentation.]]
These functions are available from Capital Gainz' Main Menu.
[[Screen not in online version of documentation.]]
These functions are available from the Activity Menu.
[[Screen not in online version of documentation.]]
These functions are available after choosing Security on the Main
Menu.
[[Screen not in online version of documentation.]]
These functions are available after choosing Log Maintenance on the
Main Menu.
[[Screen not in online version of documentation.]]
These functions are available after choosing Portfolio on the Main
Menu.
[[Screen not in online version of documentation.]]
These functions are available after choosing Global Security on the
Main Menu.
[[Screen not in online version of documentation.]]
These functions are available after choosing Broker/Investment
Company.
[[Screen not in online version of documentation.]]
These functions are available after choosing Security Type on the Main
Menu.
[[Screen not in online version of documentation.]]
These functions are available after choosing Reports on the Main Menu.
[[Screen not in online version of documentation.]]
These functions are available after choosing User Settings on the Main
Menu.
[[Screen not in online version of documentation.]]
The functions are available after choosing View Documentation.
[[Screen not in online version of documentation.]]
These functions are available from the Utility Program.
Capital Gainz Users Manual 2-1
[[Screen not in online version of documentation.]]
These functions are available from the Graphics Program.
2.1.1 File Relationships
[[Screen not in online version of documentation.]]
This illustrates the relationships between Capital Gainz data files.
2.2 Progress Displays
Capital Gainz displays messages at the bottom of the screen when
it's busy with time-consuming activities such as updating multiple
records. Sometimes these messages flash rather quickly. Any errors
displayed will pause for user input.
2.3 Executables and Related Files
The following executable files are installed in the Program
Directory:
o CAPGNZ.EXE: The main executable file for Capital Gainz. It's very
large, and contains numerous overlays to fit into limited DOS
conventional memory. This is the last command executed by CG.BAT.
o CAPGNZ.INF: Created at installation (or the first time you run
CAPGNZ.EXE), this file contains information for CAPGNZ.EXE. The
format of this file is:
Program Directory - base directory for executable files
Documentation Directory - used to view user documentation
Revision Number - determines if you need to upgrade
Temporary Directory - for temporary files (also in CG.BAT)
<Unused>
<Unused>
Registration Number
Your Name
o CAPGNZBU.BAT: A simple backup batch file that copies your data
files to diskette. There is a single parameter, the destination
drive to copy to. For example, to copy your data files TO drive A:
C:> CD \CAPGNZ
C:> CAPGNZBU A
You can change it as needed. For instance, if your data files are
too large to fit on one diskette, you may want to compress them
with PKZIP. CAPGNZBU.BAT is the default command executed by the
Backup option on the Capital Gainz Main Menu.
o CAPGNZRS.BAT: A simple restore batch file. It does the opposite of
CAPGNZBU.BAT, as it copies data files from diskette. There is a
2-2 Capital Gainz Users Manual
single parameter, the source drive to copy from. For example, to
copy your data files FROM drive A:
C:> CD \CAPGNZ
C:> CAPGNZRS A
If you change CAPGNZBU.BAT, you should make analogous changes to
CAPGNZRS.BAT. For instance, if you use PKZIP to compress your files
in CAPGNZBU.BAT, then use PKUNZIP to decompress them in
CAPGNZRS.BAT. CAPGNZRS.BAT is not executed by Capital Gainz.
o CG.BAT: The startup batch file for Capital Gainz created at
installation (or the first time you execute CAPGNZ.EXE.) It changes
to the Capital Gainz program directory specified at installation,
deletes any temporary files, sets up the temporary directory, and
then executes CAPGNZ.EXE.
If you want to switch between Capital Gainz, the Utility Program,
and the Graphics Program. you must start Capital Gainz with CG.BAT.
You may want to change CG.BAT, such as adding a line to backup your
data files before executing CAPGNZ.EXE.
o CGGRAPH.EXE: The Capital Gainz Graphics Program, which lets you
generate a variety of graphs with your data. It's large, and
contains numerous overlays to fit into limited DOS conventional
memory.
See Chapter 19 for a full description of CGGRAPH.EXE.
o CGGRAPH.PCX: The initial logo screen displayed by the Graphics
Program.
o CGUTIL.EXE: The Capital Gainz Utility Program, which lets you
upgrade files from previous versions, copy/move securities,
copy/move portfolios, and import/export files. It also uses
overlays to reduce memory requirements.
See Chapter 18 for a full description of CGUTIL.EXE.
===>>>
o CLARION.RTL: A runtime library containing common code used by
CAPGNZ.EXE, CGUTIL.EXE, and CGGRAPH.EXE.
o DP.EXE: The DoublePrint utility, which gives you some handy
printing features such printing 2 pages per sheet on a laser
printer. If you use DP.EXE regularly, you may want to move it to a
directory on your DOS PATH for convenient access.
For a full list of DP.EXE's features:
C:> DP ?
Capital Gainz Users Manual 2-3
o RTLINKST.COM: Loads CLARION.RTL automatically when you run
CAPGNZ.EXE, CGGRAPH.EXE, or CGUTIL.EXE.
o *.STX, *.CHR: Miscellaneous font files used by the Graphics
Program.
The following files are installed in the Demo Directory:
o CGDEMO.EXE: The Capital Gainz demo/tutorial screen show. You should
run this before you begin entering your own data in Capital Gainz.
o CGGDEMO.EXE: The Capital Gainz Graphics demo/tutorial screen show.
o CGSCRnn.LBR: Screen libraries, only used by the demo/tutorial.
o CGDEMO.DOC: Instructions on how to run the demo.
The following files are not installed:
o CGINST.BAT: This batch file is created and used during
installation.
o INSTALL.EXE: The Capital Gainz installation program.
o INSTALL.HLP: Online help for INSTALL.EXE.
o INSTALL.INF: This file contains the installation disk
configuration.
o INSTALL.LOG: This file is created in the Program Directory during
the installation process. It includes messages indicating which
files were installed and which existing files were renamed.
o INSTALL.UPG: This file is created and used during data upgrade.
2.3.1 Switches
CAPGNZ.EXE, CGUTIL.EXE, and CGGRAPH.EXE allow several options to
be modified by command line settings and switches. You can alter the
CG.BAT start up batch file to execute these programs with one or more
switches. If the switch has a value, such as B=NO, don't preface it
with the / character. If the switch does not have a value, preface it
with /, such as /E.
2.3.1.1 Screen Blanking
These executables have a built in screen blanker. After 10 minutes
of inactivity, the monitor is blanked. Hit any key to bring back the
previous display. The V switch changes the video timeout value. Thus,
to blank the screen only after 30 minutes of inactivity:
2-4 Capital Gainz Users Manual
CAPGNZ V=30
To disable screen blanking:
CAPGNZ V=0
===>>> If you use other screen savers, you should turn off screen
blanking.
2.3.1.2 Sound
To disable beeping, commonly used to signal errors, use the B
switch:
CAPGNZ B=NO
2.3.1.3 Enhanced Keyboard
Use the E switch to specify that the system keyboard is an
enhanced keyboard:
CAPGNZ /E
This switch is automatically used in CG.BAT, allowing you to use F11
and F12 when remapping keys.
2.3.1.4 Ignore Warnings
If you don't want to be bothered by warning messages, such as when
shares multiplied by price does not equal the purchase amount, use the
W switch:
CAPGNZ W=NO
2.4 Data Files
===>>> Most of the data files have separate index (.K01) and data
(.DAT) parts. All of these files are located in the Program Directory.
The error, password, and security type files are copied during
installation, and all other files are created the first time you run
Capital Gainz. The Utility and Graphics Programs require that these
files already exist.
2.4.1 Local (Activity) Files
For the local files, the 'nnn' corresponds to the portfolio ID.
Thus, the files for Portfolio 1 are LSEC001, OPEN001, CLOSE001, and
DISTR001.
Capital Gainz Users Manual 2-5
2.4.1.1 Local Security File - LSECnnn.DAT, LSECnnn.K01
A local security has open share information associated with it,
and is linked to a global security. The global security defines the
actual security-specific details, while the local security is an
instance of the global security held in a portfolio. The reason for
distinguishing between global and local securities is to reduce
redundant data. The price history of a security is associated with the
global security, and not with each instance of the local security.
===>>> Global and local securities both have symbols associated with
them, but the symbols can be the same. The global security symbol must
be unique over all global securities, but the local security symbol
must only be unique within a given portfolio. If you have two
portfolios that both contain IBM stock, you can set the global symbol
and both local symbols to IBM. On the other hand, you may have one
portfolio that holds IBM stock both within and outside an IRA plan. In
this case, you can define the global symbol as IBM, and link two local
security symbols, say IBMT (IBM taxable) and IBMTF (IBM tax-free) to
it.
Local security information is shown in the Local Security Table,
and inserted or changed with the Local Security Form. When you edit a
local security with the Local Security Form, the associated global
security's information is also displayed. The Local Security File
includes:
o Local Symbol: a 1-5 character id, unique within a portfolio. This
can be the same or different from the global symbol.
o Global Symbol: a 1-5 character id, unique over all portfolios. This
can be the stock symbol used in the newspaper listings, or any
other representative string. The local security is linked to this
global security; the global security contains the security name and
price history.
o Broker/Investment Company: the name of the broker or investment
company associated with the local security. This can be the same or
different from the broker/investment company in the associated
global security.
o Account Number: the brokerage account number, mutual fund account
number, or company dividend reinvestment plan number. This can be
the same or different from the account number in the associated
global security.
o Tax Exempt Flag: this flag tells whether or not this local security
is held in a tax-exempt retirement program. Local securities with
this flag set are skipped when you generate the tax forms.
o Sell Method: the most recent selling method used with this security
is saved and used as the default the next time you sell shares.
2-6 Capital Gainz Users Manual
o Open Shares Information: the number of open shares, the open
amount, and the open commission are maintained for two reasons.
First, it allows this information to be displayed quickly on the
Local Security Table without totalling the values of all open
shares records. Second, it is necessary for a security that employs
an averaging selling method, since maintaining average share price
information in each open shares record would cause many write
operations every time you buy or sell shares.
o Precision: the price and share precision for this local security.
You can specify between 2 and 4 decimal places.
2.4.1.2 Open Shares File - OPENnnn.DAT, OPENnnn.K01
Every time you record a purchase, an open shares record is
created. Open shares records are associated with a local security,
which is in turn associated with a global security. You can record
multiple purchases with the same date. When you record a purchase, the
date and price information are automatically used to update the Price
History File. Open share summary information is maintained within the
Local Security File, for the reasons mentioned above.
You add share purchases by using the Activity option of the Main
Menu to get to the Buy Shares Form. Open shares records can be added,
changed, or deleted by going through the Log Maintenance option of the
Main Menu to get to the Buy Shares Form. Even when using an averaging
method, the original purchase price is used when you change or delete
open shares records. Buying shares creates an open shares record with:
o Local Symbol: the purchased local security's symbol.
o Date: the date the shares were purchased.
o Shares: the number of shares purchased.
o Price: the purchase price of the shares. Even when using an
averaging method, the price in the open shares record is the actual
purchase price.
o Amount: the purchase amount, not including any commission or load.
o Commission: the commission or load charged on this purchase.
o Notes: any comment you wish to record with this purchase.
2.4.1.3 Closed Shares File - CLOSEnnn.DAT, CLOSEnnn.K01
Every time you record a sale, one or more closed shares records
are created. Each open shares record affected by the sale results in a
closed shares record. If you sold all the shares in an open shares
Capital Gainz Users Manual 2-7
record, then the open shares record is deleted. If you only sold some
of the shares, then the open shares record is modified to reflect the
number of shares remaining after the sale. With this approach, you can
'unsell' shares: when deleting a closed shares record, you can elect
to unsell it, meaning that the original open shares record is
recreated.
Closed shares records are associated with a local security, which
is in turn associated with a global security. When you record a sale,
the date and price information are automatically used to update the
Price History File. Open share summary information maintained within
the Local Security File is updated based on the selling information.
You sell shares by using the Activity option of the Main Menu to
get to the Sell Shares Form. Closed shares records can be added,
changed, or deleted by going through the Log Maintenance option of the
Main Menu to get to the Sell Shares Form. Even when using an averaging
method, the original purchase price is used when you 'unsell' a closed
shares record. Selling shares creates one or more closed shares record
with:
o Local Symbol: the sold local security's symbol.
o Date: the date the shares were sold.
o Status Flag: this is set to Short Term, Long Term, Return of
Principal, or Short Sale.
o Shares: the number of shares sold.
o Price: the selling price of the shares.
o Amount: the amount received for selling the shares, before
subtracting any commission or load.
o Commission: the commission or load charged on this sale.
o Notes: any comment you wish to record with this sale.
o Open Share Information: the purchase date, purchase price, purchase
amount, purchase commission, and basis of the associated open
shares. By maintaining this information, Capital Gainz can
'unsell', or recreate, open shares records when you delete closed
shares records. The purchase amount and basis will be the same
unless you used an averaging sell method.
2.4.1.4 Distributions File - DISTRnnn.DAT, DISTRnnn.K01
Every time you record a distribution, a distribution record is
created. Distribution records are associated with a local security,
which is in turn associated with a global security. You can record
2-8 Capital Gainz Users Manual
multiple distributions with the same date. When you record a
distribution, the date and per share information are automatically
used to update the Price History File. Distributions include
dividends, interest, short term capital gains, long term capital
gains, and miscellaneous fees.
You add distributions by using the Activity option of the Main
Menu to get to the Distribution Form. Distribution records can be
added, changed, or deleted by going through the Log Maintenance option
of the Main Menu to get to the Distribution Form. Recording a
distribution creates a distribution record with:
o Local Symbol: the local security's symbol.
o Date: the date of the distribution.
o Type: the type of distribution - dividends/interest, long term
capital gain, short term capital gain, or fee.
o Amount: the amount of the distribution.
o Amount Per Share: the per share amount of the distribution. This
value is important in calculating accurate yield and total return
figures.
o Notes: any comment you wish to record with this distribution.
2.4.2 Global Files
2.4.2.1 Portfolio File - PORT.DAT, PORT.K01
A portfolio separates holdings, and has zero or more local
securities. The Portfolio File contains information about each defined
portfolio. When using Capital Gainz, forms and reports that are
portfolio specific always show the associated portfolio's name, if you
defined more than one portfolio. Local security maintenance and buy,
sell, and distribution activity always apply to the current portfolio,
which is the last portfolio opened.
Portfolio information is shown in the Portfolio Table, available
from the Main Menu, and inserted or changed with the Portfolio Form.
Also, you set the current portfolio from the Portfolio Table. The
Portfolio File includes:
o ID: a value between 1 and 999 that uniquely identifies the
portfolio. This number is used as the last 3 characters of the file
names of the associated Local Security, Open Shares, Closed Shares,
and Distribution Files.
o Name: a descriptive name. This name is displayed on activity forms,
Capital Gainz Users Manual 2-9
tables, and reports that reference this portfolio.
o Description: up to three lines of descriptive text.
2.4.2.2 Global Security File - GSEC.DAT, GSEC.K01
A global security defines a particular stock, bond, or mutual
fund. Local securities are linked to global securities, and have
actual associated activity. The price history of a security is
associated with the global security. Thus, whenever you update prices,
you are directly updating the prices of the global security, and
indirectly updating the prices of the local security.
===>>> Global and local securities both have symbols associated with
them, but the symbols can be the same. The global security symbol must
be unique over all global securities, but the local security symbol
must only be unique within a given portfolio. If you have two
portfolios that both contain IBM stock, you can set the global symbol
and both local symbols to IBM. On the other hand, you may have one
portfolio that holds IBM stock both within and outside an IRA plan. In
this case, you can define the global symbol as IBM, and link two local
security symbols, say IBMT (IBM taxable) and IBMTF (IBM tax-free) to
it.
Global security information is shown in the Global Security Table,
available from the Main Menu, and inserted or changed with the Global
Security Form. The Global Security File includes:
o Global Symbol: a 1-5 character id, unique over all portfolios. This
is the stock symbol used in the newspaper listings, or any other
representative string.
o Name: a full, descriptive name for the security.
o Broker/Investment Company: the name of the broker or investment
company associated with the global security.
o Account Number: the brokerage account number, mutual fund account
number, or company dividend reinvestment plan number.
o Type: the security type. This defines the security's class when
determining portfolio allocation ratios, and also determines the
security's tax treatment.
o Interest Flag: if true, then holders of this security receive
interest instead of dividends.
o Dividends Per Year: the number of dividend payouts per year. For
instance, if the company pays dividends annually, enter 1. If the
company pays dividends monthly, enter 12.
2-10 Capital Gainz Users Manual
2.4.2.3 Security Type File - SECTYP.DAT, SECTYP.K01
Security type information lets you define common attributes for
some set of global securities. These attributes mainly target the
treatment of distributions and sales in the generated tax forms.
Security types are grouped into classes for the portfolio allocation
report. The Security Type File copied at installation will handle most
users' needs. Global securities are assigned security types through
the Type field on the Global Security Form.
Security type information is shown in the Security Type Table,
available from the Main Menu, and inserted or changed with the
Security Type Form. The Security Type File includes:
o Type Code: any 1-4 character code, usually having some pneumonic
link to the security type. This code must be unique over all
security types.
o Class: the security type's class.
o Description: descriptive text.
o Dividends/Interest: tells whether a security of this type pays
dividends or interest.
o Taxable: tells whether dividend or interest distributions by a
security of this type are taxable on Schedule B.
o Long Term Capital Gains: tells where long term capital gains
distributions by a security of this type are reported on the tax
forms.
o Short Term Capital Gains: tells where short term capital gains
distributions by a security of this type are reported on the tax
forms.
o Group Sales: tells whether to group sales of a security or list
them individually on Schedule D.
o Return of Principal: tells where return of principal distributions
by a security of this type are reported on the tax forms.
2.4.2.4 Price History File - PRC_HST.DAT, PRC_HST.K01
Price History information includes prices, distributions, and
stock splits. You can display it in a table from the Local or Global
Security Table, and insert or change it with the Price Form. While
price history information is really associated with a global security,
it can be accessed via the local security through its global security
link. Buying shares, selling shares, recording distributions, and
executing splits create price history records. Each price history
Capital Gainz Users Manual 2-11
type/date is unique, so buying shares, selling shares, or recording
distributions may replace existing price history records.
Activity logs contain price/dates and distribution/dates, so there
is no danger of losing activity information by changing the Price
History File. The Price History File is just a tool to use for
security analysis, and the Capital Gainz Utility Program can
reconstruct it from the activity logs. The Price History File
includes:
o Global Symbol: the global security's symbol.
o Date: the date associated with the price history entry.
o Type: the type of price history entry: price, dividend/interest,
long term capital gain, short term capital gain, or stock split.
o Price: the value associated with the price history entry - a price,
per share value, or split ratio.
2.4.2.5 Broker/Investment Company File - BROKER.DAT, BROKER.K01
===>>> Broker/investment company information lets you keep names,
addresses, and phone numbers of brokers and mutual fund companies used
to buy and sell shares in your portfolios. Broker/investment companies
and account numbers occur in both local and global security records.
You probably want to associate a mutual fund company with the mutual
fund in the global security record, but specify the account number in
each local security record. On the other hand, you probably want to
associate some default or 'dummy' broker with a stock in the global
security, and define the actual broker holding the shares in the local
security. This approach was taken to give you maximum flexibility.
Broker/Investment Company information is shown in the
Broker/Investment Company Table, available from the Main Menu, and
inserted or changed with the Broker/Investment Company Form. The
Broker/Investment Company File includes:
o Name: the name of the broker/investment company.
o Address: the address of the broker/investment company.
o City: the city where the broker/investment company is located.
o State: the state code of the broker/investment company.
o Zip: the zip code of the broker/investment company.
o Phone: the phone number of the broker/investment company.
2-12 Capital Gainz Users Manual
2.4.2.6 User Settings File - SETTINGS.DAT
User settings allow you to maintain dynamic global information and
to customize Capital Gainz. The User Settings File contains two
records. The fields in the first record are set with the User Settings
Form:
o ID: this is set to SETTINGS.
o Revision: the current Capital Gainz revision number.
o Holding Period: the number of days that shares must be held to be
classified as long term. This value is used to determine whether
the gain/loss from a sale is classified as long term or short term,
and for classifying long term/short term values in displays and
reports.
o Confirm Add/Update/Delete: if YES, you are prompted for
confirmation before a new record is written or deleted. Actions
that add, change, or delete multiple records will always prompt for
confirmation.
o Reinvest Distributions: if YES, you are prompted for reinvestment
information after recording a distribution.
o Append Reports: if YES, specifying a DOS file when printing a
report will append the report to the file. Otherwise, the report
will overwrite the original file without warning.
o Backup Command: the DOS command string executed when you select the
Backup key from the Main Menu.
o Lines Per Page: the number of report lines to print on a single
page. This depends on your printer. Setting this to 0 is a paper
saver, as reports are printed with no page breaks and only the
initial page header.
o Line Draw Chars: if YES, then the extended ASCII line drawing
characters are used in reports. If your printer does not support
these characters, enter NO to use the substitute characters '-' and
'='.
o Colors: the colors for each grouped set of screens.
o View File Command: the command invoked to view a file or report on
the screen. If left blank, then the internal file viewer is used.
o Commission in Basis: if YES, then the buy and sell commissions are
factored into the basis for gain/loss percentages. This results in
slightly lower absolute gain/loss percentages then if they were not
included in the basis. By default, Capital Gainz does not include
commissions in the basis, since the amount paid was never actually
Capital Gainz Users Manual 2-13
used to buy shares.
o Portfolio ID: the current portfolio's ID. This value is set
whenever you open a portfolio. When you start up Capital Gainz,
this portfolio is opened initially.
o Accept Key/Reject Key: the internal key code for the Form
Accept/Form Reject short cut keys.
o Price File: the comma-delimited ASCII price file used to update the
price history file every time you start up Capital Gainz.
o Short Sales: if YES, then whenever you record a share purchase, the
Closed Shares File is searched for outstanding short sales. This
value is automatically set to YES if you execute a short sale.
o Redistribute Proceeds: if YES, then whenever you record a sale, you
are asked if you want to redistribute the proceeds by purchasing
shares of another security.
o Strip CRs: if YES, then terminating carriage returns are stripped
before a report is printed.
o Brief Formats: if YES, then the brief format is used for reports
that have both brief and long formats.
o Show Subtotals: if YES, then subtotals are calculated and shown for
reports that support subtotals.
The fields in the second record apply only to the Graphics Program,
and are set from the Graphics Program:
o Adapter: the type of monitor you are using.
o Label Colors: the color of graph labels.
o Axis Color: the color of graphics grids.
o Fill Type: the fill pattern for graphics.
o Append Report: whether to append or overwrite when printing to a
file. This is separate from the value used by Capital Gainz.
o Printer Type: the type of printer for graphics output.
o Printer Model: the manufacturer and model for dot matrix printers.
o Price Chart Parameters: the colors of the price, best-fit, average,
and standard deviation lines; whether or not to use icons at price
points.
o Total Return Chart Parameters: price fill color and distribution
2-14 Capital Gainz Users Manual
fill color.
o Portfolio Allocation Chart Parameters: the maximum number of pie
chart 'slices' for the portfolio allocation charts.
o Security Performance Chart Parameters: value bar color, cost bar
color, and whether or not to include cash equivalent security
types.
o Performance Chart Parameters: begin, end, buy, sell, distribution,
and gain/loss pie slice colors.
o Printer Parameters: reset before print, formfeed after print,
aspect ratio, page orientation, black/white reversal, horizontal
and vertical offsets, density, and printer codes.
2.4.2.7 Password File - PASSWD.DAT, PASSWD.K01
The Password File contains your system password. The data is
encrypted to prevent someone from dumping its contents to discover
your password. This file is copied during installation, and initially
contains a blank password. You can change it from the Main Menu. To
keep your data private, you must set a password then secure the
installation disks.
o Password: a 1-8 character password, case-sensitive with embedded
blanks allowed. A blank password is treated as no password.
2.4.2.8 Error Message File - ERROR.DAT
The error message and help index file. This is an ASCII file, and
the format is described within the file itself. Using a text editor,
you can change the error messages and help indexes if you want, but
don't change the error numbers.
2.4.2.9 Printer File - MPCONFIG.DAT
The printer file contains the default graphics configurations for
a number of different dot matrix printers. If you print graphics to a
dot matrix printer, you'll need to select a printer in the Graphics
Program. You can change the default configuration if necessary.
2.4.3 Field Limits
The following limits apply to any one record. The sum of multiple
records may exceed these values. If you see all asterisks or all nines
displayed in a form or a report, then the totals are too big to fit in
the report field.
Capital Gainz Users Manual 2-15
Open Shares: 0 - +999,999.9999 (per record)
Open, Closed Amount: 0 - +999,999.99 (per record)
Open, Closed Price: 0 - +9,999.9999
Open, Closed Commission: 0 - +9,999.99 (per record)
Distribution Per Share: 0 - +9,999.9999 (per record)
Local Security Total Open Shares: 0 - +99,999,999.9999
Local Security Total Open Amount: 0 - +99,999,999.99
Local Security Total Open Commission: -999,999.99 - +999,999.99
Percentages: -999.99% - +999.99%
2.5 Temporary Files
If you want to change the Temporary Directory, you must edit
CAPGNZ.INF and CG.BAT. On startup, CG.BAT deletes files with the .TMP
extension in this directory. Capital Gainz creates the following
temporary files in the Temporary Directory:
o $*.TMP: this file (the '*' is a DOS wildcard) is created when you
shell to DOS, and contains the Capital Gainz program image to
restore when you enter EXIT on the DOS command line.
o CAPGNZSH.BAT: this is a temporary file used when you shell to DOS.
o CGPRT.TMP: this is a temporary file used for appending reports.
o CGSCR.TMP: this is a temporary file used for viewing reports.
o CLARION.DMP: dump file with information about abnormal
terminations.
2.6 Documentation Files
The following files are installed in the Documentation Directory:
o CGnn.DOC: The 'nth' chapter of the online users manual. There are
no illustrations in the online version. If you want to use online
help or view the manual online, you need to install it.
o HISTORY.DOC: This file contains a list of fixes, modifications, and
changes to Capital Gainz, broken down by version number.
o LICENSE.DOC: This is the Capital Gainz license statement. It
specifies what you are legally entitled to do with Capital Gainz.
It also specifies what rights and benefits you receive with
registration.
The following file is installed in the Program Directory:
o README.DOC: This file contains quick help on getting started and
new information not in the users manual.
2-16 Capital Gainz Users Manual
2.7 Reports
All reports are available from the Report Menu, except the Open
Information for Shares Sold Report, which is only available after
selling shares. As indicated, reports may also be available from
certain tables. Reports use the following user settings: Append
Report, Lines Per Page, Line Draw Chars, Strip CRs, Brief Formats,
Show Subtotals. You can change these values prior to printing.
The only reports that include open information for shares that
have been subsequently sold are the Activity Summary Report and the
Mixed Detail Report. For reports such as the Open Shares Detail
Report, shares that have been sold are not included, regardless of the
specified date range.
All reports are sent to the screen first. From there, you can
choose to direct them to the printer or a file.
These reports are for all portfolios:
o Portfolio Summary Report: shows the current open value and
gain/loss for each portfolio. This report is also available from
the Portfolio Table.
o Broker/Investment Company Report: shows information for all
brokers/investment companies. This report is also available from
the Broker/Investment Company Table. You can choose to total
commissions and fees over a specified period (Show Subtotals=YES).
o Global Security Report: shows all global securities, including
current price and yield. This report is also available from the
Global Security Table. You can choose to show local securities
linked to the global security (Brief Formats=NO).
o User Settings Report: shows the current user settings. This report
is also available from the User Settings Form.
o Security Type Report: shows the current security type definitions.
This report is also available from the Security Type table.
o Total Return Report: shows the total return for all global
securities over a specified period. This report is also available
from the Global Security Table.
These reports can be generated for the current portfolio or for all
portfolios:
o Portfolio Detail Report: shows current open values for each local
security in the portfolio. You can generate subtotals based on the
broker/investment company (Show Subtotals=YES), and choose either a
brief or long format (Brief Formats). This report is also available
from the Portfolio Table and Local Security Table.
Capital Gainz Users Manual 2-17
o Portfolio Allocation Report: shows allocation percentages by
security class, security type, and security. This report is also
available from the Local Security Table and Portfolio Table.
o Schedule B Report, Schedule D-1 Report, Fee Report: shows Schedule
B and Schedule D-1. Presents dividend, distribution, and selling
information in a format easily transferrable to your tax form.
Prior to printing the report, you can specify the year, whether to
round to dollars, whether to group sales, and whether to create a
TurboTax import file. This report is also available from the
Portfolio Table. Two additional reports are also generated. The Fee
Report summarizes fees paid for the year, and the Wash Sales Report
lists potential wash sales.
These reports are for the current portfolio only, and you can restrict
output to one or more securities and by a range of dates:
o Activity Summary Report: shows the cumulative and short term open,
closed, and distribution values along with gain/loss for the
specified period. Also shows the security's total return over the
period, and combines purchases, sales, and distributions to present
your performance over the period. You can choose to print the brief
or long format (Brief Formats). This report is also available from
the Local Security Table.
o Activity Detail Report: shows individual transactions from the
activity logs, and a total for the specified period. All logs, a
single log, or a chronological list of all activity can be printed.
You can choose the brief or long format (Brief Formats). The Open
Shares Detail Report is also available from the Open Shares Log.
The Closed Shares Detail Report is also available from the Closed
Shares Log. The Distribution Detail Report is also available from
the Distribution Log. The Mixed Detail Report is also available
from the Local Security Table.
o Price History Report: shows price history, distributions, and stock
splits for a global security. High and low prices are flagged. This
report is also available from the Price History Table, via the
Local Security Table or the Global Security Table.
Finally, this report is only available after you sell shares:
o Open Information for Shares Sold Report: after completing the Sell
Shares Form, you can view or print out information resulting from
the sale without actually committing the sale. You can include the
broker/investment companies name and address, along with selling
instructions (Brief Formats=NO).
All reports end with a formfeed. Make sure you line up your paper
before printing, as Capital Gainz does not output an initial formfeed.
2-18 Capital Gainz Users Manual
2.8 Multiple Form Activity
Some activities in Capital Gainz require two different activity
forms:
o Reinvest Distributions - after recording a distribution in the
Record Distribution Form, the Buy Shares Form is presented to
record the reinvestment.
o Redistribute Proceeds - after recording a sale in the Sell Shares
Form, the Buy Shares Form is presented to record the redistribution
of the sale proceeds.
o Cover Fee - after recording a fee in the Record Distribution Form,
the Sell Shares Form is presented to record the sale to cover the
fee.
After entry, the two activities are not linked in anyway. For
instance, open shares records created by reinvesting distributions are
not linked to the distribution record. Thus, to change the
distribution per share, you only have to change the distribution
record, and to change the number of shares purchased you only have to
change the open shares record. But, to change the date you must change
both the open shares record and the distribution record.
If you don't want the additional activity, answer NO when asked if
you want to reinvest, redistribute, or cover. Or, you can simply Esc
out of the second form. In both cases, the initial activity is
recorded, but the additional activity is skipped. If you want to
record the additional activity at a later time, record it normally.
For instance, if you record a dividend but forget to record the
reinvestment, you can add the reinvestment as a separate purchase at
any time.
2.9 "Why Doesn't Capital Gainz..."
===>>> Users frequently ask why Capital Gainz doesn't do certain
things automatically, like changing recorded purchases when the price
history is changed. Well, the applicability of these requests vary. If
you think Capital Gainz should do something, but this action is not
always required, then it's simply not done. In the price example,
propagating a change in the price history to the Open Shares File is
not always desired. What if a stock was purchased at the beginning of
the day, then you updated the price at the end of the day? If so, then
applying the change to the purchase would render the purchase
incorrect. Even worse, what if the amount were re-adjusted based on
this price?
The bottom line is that Capital Gainz is not an expert system. It
can't anticipate what you want it to do, and it can't learn what to
do. Stated in black-and-white, this is all rather obvious. But,
assuming too much from a program can cause a lot of problems down the
Capital Gainz Users Manual 2-19
road. Any program touting this sort of expert knowledge should be
treated with skepticism.
Thus, Capital Gainz only does what's absolutely necessary when you
add, change, or delete data. If you expect Capital Gainz to do
something, check the manual. If it's not mentioned, then chances are
you are assuming too much. Many of these types of problems can be
avoided by carefully reading Chapter 5, Questions and Answers.
2-20 Capital Gainz Users Manual