The Analytical Engine

AES: Command-Line Emulator

----------------------------------------

This page describes, in Unix manual page style, the command-line Analytical Engine emulator. This program is implemented in Java; in order to use it you must have a Java virtual machine implementation installed on your computer; most Java Development Kits include this component.

NAME

aes - command-line Analytical Engine emulator

SYNOPSIS

java aes [ -c -l -n -p -slibtemp -t -u] cardfile

DESCRIPTION

aes is an Analytical Engine emulator which runs as a stand-alone Java application on the user's computer under the control of a Java virtual machine interpreter. It runs the program specified by the chain of programming cards in the given cardfile.

OPTIONS

-c
Instructs the Attendant to remove all comment cards from the card chain before mounting the cards on the card reader. In addition, the Attendant will not add comments describing expansion of advancing and backing cards and decimal place expansion cards. This option, in conjunction with the -p option, allows preparation of a more authentic card chain with no comments and all expansions by the Attendant already done.
-l
Lists the card chain as mounted by the Attendant. All Attendant expansions of advancing and backing and decimal place expansion cards will be shown in this listing. If the -c option is specified, comment cards will be removed before this listing is printed.
-n
No execution: the card chain is neither mounted on the card reader nor run through the Engine. This option is used in conjunction with the -l or -p options when only a listing or punched copy of the program is desired.
-p
Punch a copy of the card chain as mounted by the Attendant. All Attendant expansions of advancing and backing and decimal place expansion cards will be shown in this listing. If the -c option is specified, comment cards will be removed before the cards are punched. Punched output differs from the listing produced by the -l option in that the cards are output without annotation of line number and file name.
-slibtemp
The source of cards included by the Attendant in response to A include from library cards for name requests will be the URL (if the libtemp string begins with “http:” or “file:”) or directory name given by libtemp. The library template must contain the character sequence @@, which is replaced by the library name requested.
-t
Print an execution trace of this program. Specifying -t is equivalent to inserting a “T1” card at the beginning of the infile. A “T0” card will turn off tracing initiated with the -t option.
-u
Print a summary of the command-line options.

FILES

The programming cards submitted to the Engine are read from cardfile, which can be either a file on the local system or, if cardfile begins with “http:” or “file:”, a URL specifying cards anywhere on the World-Wide Web. Access to files and documents on the Web may be restricted due to security provisions at your site; contact your system administrator in case of difficulty.

BUGS

Compiled Java programs presently consist of individual .class files, one for each class defined in the program. For a relatively large and complicated program such as aes, loading all these files can take a while.

SEE ALSO

java(1)

DOWNLOAD

  Download aes ready-to run program: aeclass.zip

  Download aes Java source code: aesource.zip

Source code is intended for experienced Java programmers only. You're free to use the source code in any way, but you're entirely on your own; no assistance or support of any kind is provided.

AUTHOR

John Walker

This software is in the public domain. Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, without any conditions or restrictions. This software is provided “as is” without express or implied warranty.

----------------------------------------