DISCLAIMER It's all in the license, but just to be sure: The application is provided "as is", and may contain errors. Use it at your own risk. Neither Ex Ponto nor the copyright holders takes any responsability, what soever, for action taken as a consequence of using this application. This application is only tested with the version of JDK I currently use on my workstation, currently 1.5.0 for Linux. Generated code shpould work on all 1.4 jre, but it will not be tested. I occasionally test jStock on the w2k and the only problem is that Windows doesn't seem to understand /home/... :-) INSTALLATION Unpack the *.tgz file in a directory you have write access to. ~/jstock might be an good idea on *nix. For Windows users Winzip is able to handle tgz files (and jar files, may have to rename them to *.zip). The source code is inside the jstock.jar file. From version 0.3 log4j-1.2.8.jar is needed for logging. log4j-1.2.8.jar is included and must be placed on the java class path. The easiest way of doing that is to copy log4j-1.2.8.jar to the "/path/to/java/jre/lib/ext" directory. This directory is on the class path by default. The properties of log4j may be adjusted in the log.properties file. As default it has a rolling logfile with max size 100kB, and one backup file. It is also possible to have the log in a separate window. The properties file is currently inside the jstock.jar package so it is a little awkward to edit. See http://logging.apache.org/log4j/docs/documentation.html for details about log4j Jakarta - log4j, Copyright (C) The Apache Software Foundation. and is distributed under the The Apache Software License, Version 1.1. Updated version can be downloaded from: http://logging.apache.org/log4j/docs/download.html Start jStock with the following comand: java -jar /path/to/jstock.jar jStock Where path to is the directory you have put the jar file. Be sure that you have write access to that directory as the properties file will be written in this directory. Oh, and I assume that you have a java runtime enviroment installed and that the path is set to include the java binaries. Otherwise use path to "java" as well. Java can be downloaded from java.sun.com. Before you use this application, push the "Options" button after you have started the application and modify the properties you would like to change. Note that the file isn't really saved before you quit the application in a "normal" way. There is also some properties that is automatically changed, e.g. window size. You probably would like to change the path to data files and the extension. Note that the filename need to be like this: /path/to/datafiles/maybe_some_txt.extension where is the text string you enter in the application to load a particular stock. An example: "/pub/brand/analyse/paperhistory.php?paper=ahm.OSE" where path is "/pub/brand/analyse/paperhistory.php?paper=" is "ahm" extension is "OSE" The db properties are only applicable if you intend to use a sql database with jStock. Only tested with postgresql. Without db support the notes button is rather meaningless, and using it would generate a few exceptions. In order for the database application to work, you need a jdbc driver for your database. Install according to instruction with the jdbc driver. I have only tested with files from a Norwegian online broker, www.netfonds.no. If your files are on a different format, take a look at the "File input" tab in the options panel and enabel column positions. Modify to suit your needs. If it still won't work, send me a sample file and I'll have a look at it. ken.OSE is included as a sample file. (ken - Kenor is a Norwegian gold mining company). The program uses the following fields (in order): date - YYYYMMDD open high low close volume All fields starting with letters are ignored. In a not to distant future I would also use the "exchange" field in order to support stocks from different exchanges better. To download the files from the broker I use wget with a list of the files I need. Don't know if a similar application exists for Windows, but it is a very handy application and I would be surprised if it didn't. But then again Windows has surprised me more then once. USE See jstock_doc.html for some documentation. Currently active keyboard commands in the chandlestick area ("selected day" and lines) The candlestick area has to be selected by a mouseclick in order for the commands to work. "Selected day" n, right arrow next p, left arrow previous "Lines" (Draw mode checked) l select next line L (shift L) select end of current line (both, first, last, none) p select previous line right arrow move selected point(s) right (if a line is selected) left arrow move selected point(s) left (if a line is selected) up arrow move selected point(s) up (if a line is selected) down arrow move selected point(s) down (if a line is selected) d, Del delete selected line CTRL s save lines to database (only with db support) Note that movement in the x directions (left, right) is dependent on the size of the candlestick. KNOWN ISSUES The only issue of some importance I know about is that there seems to be some problems with week numbers in 2000 and earlier. CONTACT If you have any questions, suggestions or find any bugs, please contact me at jstock@exponto.com.