Portfolios
Chapter 11 - Portfolios
[[Screen not in online version of documentation.]]
The Portfolio Table, brought up from the Main Menu, shows a single line of information for each portfolio, with portfolios listed in order by ID. There is a checkmark displayed to the left of the currently open portfolio. When you start Capital Gainz for the first time, a portfolio with an ID of 001, named <<Default Portfolio>>, is created. The values displayed for each portfolio are:
- Portfolio ID, a number between 1 and 999.
- Portfolio Name, which will be displayed on forms and reports that are portfolio specific.
If you used the Show Values function key, you are also shown:
- Current Value of portfolio holdings.
- Current Gain/Loss of portfolio holdings.
- Total Value of holdings in all portfolios.
- Total Gain/Loss of holdings in all portfolios.
At the bottom of the Portfolio Table is a scrollable row of functions:
- Ctrl-F1:Function List - popup a list of functions to choose from.
- Enter:Make Current - makes the highlighted portfolio the current portfolio. A checkmark is displayed to the left of the currently open portfolio.
- Ins:Add - add a portfolio.
- F2:Change - change the highlighted portfolio.
- Del:Delete - delete the highlighted portfolio.
- Esc:Exit - exit from the table, returning to the Main Menu.
- Ctrl-PgUp:Top - go to the first record.
- Ctrl-PgDn:Bottom - go to the last record.
- F3:Tax Report - generate the Schedule B and D-1 reports for the highlighted portfolio.
- F4:Portfolio Summary Report - generate the Portfolio Summary Report.
- F5:Portfolio Detail Report - generate the Portfolio Detail Report for the highlighted portfolio.
- F6:Portfolio Allocation Report - generate the Portfolio Allocation Report for the highlighted portfolio.
- F8:Show Portfolio Values - toggles showing/not showing portfolio values.
- F10:More - scroll the list of functions.
Each of these functions is described below.
11.1 Make Current
===>>> By hitting the Enter key, you make the highlighted portfolio the current portfolio. This opens the portfolio for buy, sell, and distribution activity. All portfolio specific forms and reports show the current portfolio, if you defined more than one portfolio.
The current portfolio is distinguished in the Portfolio Table by a checkmark to the left of its ID. The current portfolio is 'remembered' between sessions, so whenever you start up Capital Gainz, the last portfolio that you had opened automatically becomes the current portfolio.
11.2 Add a Portfolio
[[Screen not in online version of documentation.]]
The Portfolio Form is brought up to add a portfolio when you hit the Ins key while viewing the Portfolio Table. The fields in the Portfolio Form are:
- (Required) The ID for the portfolio. This is a value from 1 to 999, and is used as part of the filename for the Local Security, Open Shares, Closed Shares, and Distributions Files. Capital Gainz displays the first unused ID.
- (Optional) The portfolio Name. This name is shown on all portfolio specific forms and reports.
- (Optional) A Description of up to 3 lines for the portfolio. This description is only used on the Portfolio Summary Report. If you leave a line blank and hit Enter, the other lines are skipped.
Function keys at the bottom of the screen are:
- Form Accept - accept all entries, the same as hitting Enter on each field. This key is only displayed when changing records.
- Form Reject - exit immediately, the same as hitting Esc to back out of the form. This key is only displayed when adding or changing records.
After completing the form, the portfolio record is added and the corresponding Local Security, Open Shares, Closed Shares, and Distribution Files are created. You return to the Portfolio Table, and the just added portfolio is highlighted and becomes the current portfolio.
11.2.1 Example - Add a Portfolio
Say you add a portfolio for your son, Junior:
ID : 002
Name: Junior's Portfolio
Desc: Goal: To save money for college.
- The portfolio record is added.
- The local security, open shares, closed shares, and distribution files for the portfolio are created: LSEC002, OPEN002, CLOSE002, and DISTR002.
11.3 Change a Portfolio
The Portfolio Form is brought up to change the highlighted portfolio when you hit the F2 key while viewing the Portfolio Table. The Portfolio Form, described in the Add a Portfolio section, is initialized to the current values of the portfolio to be changed.
After completing the form, the portfolio record is updated. If you changed the portfolio's ID, the Local Security, Open Shares, Closed Shares, and Distribution Files are renamed accordingly. Confirmation is required regardless of the Confirm Update global setting, since many records could be affected. You return to the Portfolio Table, and the just changed portfolio is highlighted.
11.3.1 Example - Change a Portfolio
Using the previous example, say you change the Portfolio ID to 003.
- The portfolio record is changed.
- The local security, open shares, closed shares, and distribution files for the portfolio are renamed to: LSEC003, OPEN003, CLOSE003, and DISTR003.
11.4 Delete a Portfolio
The Portfolio Form is brought up to delete the highlighted portfolio when you hit the Del key while viewing the Portfolio Table. The Portfolio Form, described in the Add a Portfolio section, is initialized to the current values of the portfolio to be deleted.
The portfolio record is deleted, as are the portfolio's Local Security, Open Shares, Closed Shares, and Distribution Files. Confirmation is required regardless of the Confirm Delete global setting, since many records could be affected. When you're finished with the Portfolio Form, you return to the Portfolio Table, and the portfolio after the one just deleted is highlighted.
11.4.1 Example - Delete a Portfolio
Using the previous example, say you delete Portfolio ID 003.
- The portfolio record is deleted.
- The local security, open shares, closed shares, and distribution files for the portfolio are removed: LSEC003, OPEN003, CLOSE003, and DISTR003.
11.5 Tax Report
The Schedule B and Schedule D-1 Reports for the highlighted portfolio are available via the Tax Report function key on the Portfolio Table. See Chapter 15 for descriptions of these reports.
11.6 Portfolio Summary Report
The Portfolio Summary Report, similar in format to the Portfolio Table, is available via a function key on the Portfolio Table. See Chapter 15 for a description of this report.
11.7 Portfolio Detail Report
The Portfolio Detail Report for the highlighted portfolio, similar in format to the Local Security Table, is available via a function key on the Portfolio Table. See Chapter 15 for a description of this report.
11.8 Portfolio Allocation Report
The Portfolio Allocation Report for the highlighted portfolio is available via a function key on the Portfolio Table. See Chapter 15 for a description of this report.
11.9 Show Portfolio Values
Capital Gainz can calculate and display the value of your portfolios. However, if you have large portfolios, or many portfolios, this process may be slow. Use the Show Portfolio Values function key to toggle turning the value calculations on and off. The default is not to show the values.
