Command Overview

The ar command is used to age transaction amounts into ranges. The command supports four sources of data for testing:

1. Data file in tab separated value format
2. WorkSheet
3. Selected range within a worksheet
4. Database (e.g. MS-Access, MySQL, etc)

Syntax

The command is entered on the command line as the command name ("ar") followed by one or more command parameters. Each command parameter consists of an argument name, immediately followed by an equal sign ("=") and then immediately followed by a value. The value may be enclosed with quotation marks, and must be enclosed by quotation marks if the value consists of any embedded spaces.

An example of a command parameter to specify that the file name to be processed is test.txt is entered as "file=test.txt" (without the quotations). Each argument on the command line must consist of only valid parameter names. If a required parameter name is missing, then the command line will be colored yellow, an error message will be displayed on the Excel status bar and an audible tone will be sounded.

The following is a listing of all parameter values for the benford command:

An example

The command to age invoices on the file named \test\invoice\tran.txt using the amount column named "Paid Amount" and the invoice date column named "Invoice Date", storing the results on the worksheet named "Ageing Results" is as follows:

ar file=\test\invoice\tran.txt date datecol="Invoice date " amtcol = "Invoice Amount" recap="Ageing Results " AgeingDate="6/30/2007"

Output from the processing will include the amounts of the incoices, classified into ageing buckets.

An example of the command bar is shown below:

An example ageing report is shown below:

Main Form