Java POS

Home

Docs

Changes

To-do

End Users

FAQs

Getting Started

Developers

JCL RI

Sample Code

JavaDOC

References

jpos.config/loader (JCL) - Getting Started


This page will help and guide you on using the JCL.  Please see the Sample Code for information on how to write JCL compatible JavaPOS services and on how to configure them.

NOTE: this page assumes that you are using the Simple JCL reference implementation.  If you are not, then most of this will apply to all implementations but one should refer to the third party provider for details on anything specific to their implementation. 

This page is Under Construction (needs updating for 2.1.0 release)


Directory and Files in the JCL Release

The JCL is released as a Zip file.  When extracted it will create a directory by the name of the JCL release.

By default the source files are jarred into JAR files in the "lib" directory with names terminating in "src.jar".  If you want to build or see the source files then extract the JAR files in the appropriate directory "src", "sample" and "test" directory using the command:

>jar xvf <sourceFile>.jar 

NOTE: the only difference is that in Win32 path separation is "\" but "/" in UNIX and setting environment variables will differ on UNIX depending on what shell you are using.

Once the JCL is installed and the sources extracted (assume in <jcl-dir>) you will have the following files and directories (not all the files are listed e.g. html files, ...):

<jcl-dir> Root directory of JCL installation.  Contains readme.html pointer and changes.txt files
<jcl-dir>\lib Contain all JAR files
<jcl-dir>\docs Contain the white paper doc and other doc directories
<jcl-dir>\docs\html Contain this set of HTML files
<jcl-dir>\docs\html\jdoc Contain generated JavaDOC files for this JCL release
<jcl-dir>\sample Contain the sample JCL service and test application
<jcl-dir>\src Contain all the JCL source files including simple reference implementation source and JCL enabled JavaPOS controls
<jcl-dir>\test Contains the JCL JUnit sources tests files
<jcl-dir>src\jpos\res\jpos.properties An example of the properties file to use with the JCL
<jcl-dir>src\jpos\res\jcl.dtd DTD for the simple XML registry populator
<jcl-dir>\src\jpos\res\jcl.xsd XML Schema for the XML registry
   
<jcl-dir>\lib\jcl.jar Core JCL classes
<jcl-dir>\lib\jcl_src.jar Core JCL sources
<jcl-dir>\lib\jcl_editor.jar JCL editor classes
<jcl-dir>\lib\jcl_editor_src.jar JCL editor sources
<jcl-dir>\lib\jpos1<x>.jar JCL-enabled JavaPOS controls where x == 5, 6 and 7 for the JavaPOS controls 1.5, 1.6 and 1.7
<jcl-dir>\lib\jcl_sample.jar Sample JCL-enabled JavaPOS virtual service + sample Swing application
<jcl-dir>\lib\jcl_sample_src.jar Sample sources

 


Setup and Quick Test

In order to setup the JCL you need to get JCL-enabled services or test using the sample virtual LineDisplay service.  In either case the process to setting up the JCL is the same.  What will follow is the setup of the JCL for the sample service, but you should be able to extrapolate for other service packages.

Setting your CLASSPATH

Your CLASSPATH environment variable must have the following JAR files listed:

NOTE: If you are using JDK1.1.8 you must have to install swing in your computer and add it in your CLASSPATH.

  <jcl-dir>\lib\jclall.jar or ( <jcl-dir>\lib\jcl.jar, <jcl-dir>\lib\jcl_simple.jar and <jcl-dir>\lib\jpos.jar)

You can set your CLASSPATH with the following command (on Win32):

set CLASSPATH=<jcl-dir>\lib\jclall.jar;%CLASSPATH%

OR

set CLASSPATH=<jcl-dir>\lib\jcl.jar;<jcl-dir>\lib\jcl_simple.jar; and <jcl-dir>\lib\jpos.jar;%CLASSPATH%

Either options are equivalent in functionality but not in typing!

To do a quick verification that the JCL is installed and setup you can run the simple version applications by issuing the following command at the command prompt:

>java jpos.config.Version

OR

>java jpos.loader.Version

The output should be something like the following:

JavaPOS jpos.config/loader (JCL) version 1.2.0 EA3

Now you are ready to use it!

You can also test the sample service (thereby binding a control to a JCL-enabled service) by following the Sample Code example setup and running instructions.


 


Last modified by EMM on 05/05/2002 10:37 PM

Java