Files

Creating a new file

You can create a new file by choosing File->New from the menu.

After clicking the appropriate menu button, you will be asked if you want the program to setup default accounts. It is a good idea to answer Yes to that question. You can edit the default accounts chart to suit your needs later.

If you chose to create the standard accounts, the main window should show newly created accounts in the Accounts tab.

Figure 3-2. New file with standard accounts

Opening and saving

You can open previously saved file with File->Open (F3) or with toolbar button Open. It will load the selected file and handle appropriate scheduled transactions (see the section called Scheduled transactions)

Note: If you want to automatically load a file at Emma startup, please read about program Invocation (the section called Invocation and configuration).

To save a file choose File->Save (Control-S) or if you want to change filename File->Save as....

Figure 3-3. File selection dialog

File format

Emma data files are flat, ASCII files. Your ledger accounts and transactions can be converted to the emma format using the usual Unix text processing tools.

Each emma file consist of three sections. One for storing data for accounts, one for transactions and one for scheduled transactions. Each section beggins with a single integer on a line of its own. That's the number of data items in the section. Each data item in the section occupies one line.

Accounts section

This section describes accounts for later use in the transactions and scheduled transactions sections. Each line in this section consist of five fields separated by whitespace.

ID Number

Identifies the account through the file. Has to be uniqe number in the range 1..N (where N is the number of accounts).

Parent ID

Parent account identification number. If zero then the account is a top-level account.

Reversed flag

Possible values 0 and 1

Unlimited flag

Possible values 0 and 1

Name

Defines the name of the account. It has to be unique for the purpose of identifying account during normal program operation. The length is limited to 32 characters. If the name happens to be longer it will be truncated.

Transactions section

This section describes recorded transactions. Each line in this section consist of five fields separated by whitespace.

From account ID

Identifies the account from which the money was transfered.

To account ID

Identifies the account into which the money was transfered.

Amount

How much money was transfered. Divide this by 100 to get appropriate value.

Date

Date of the transaction. It is written in format month/day/year.

Desc

Description of the transaction. The length is limited to 64 characters. If it happens to be longer it will be truncated.

Scheduled transactions section

This section describes recorded scheduled transactions. Each line in this section consist of seven fields separated by whitespace.

From account ID

Identifies the account from which the money will be transfered.

To account ID

Identifies the account into which the money will be transfered.

Frequency

Specifies how often the transaction should be entered. See schedule.h for more details. (If it hasn't changed than 0 stands for daily, 1 - mothly, 2 - weekly, 3 - yearly).

Prompt

Possible values 0 and 1

Amount

How much money will be transfered. Divide this by 100 to get appropriate value.

Next Date

Date of the next occurence of the transaction. It is written in format month/day/year.

Desc

Description of the transaction. The length is limited to 64 characters. If the name happens to be longer it will be truncated.