Main Page Cookbook/Overview ImageMeister the jcprops file Licensing Please Vote! Binary Installation & Configuration [ Win · Mac · Nix · OSX ] Changes Public API Source Code Main Page Java [ Common · Win · Mac · Nix ] Native Code [ Common · Win · Mac · Nix ] Manifest Native Code Overviews [ Common · Win · Mac · Nix · Strings ] Macros [ General · Native Macros ] Walkthroughs [ Java only · Java and native ] Building [ Win · Mac · Nix · OSX ] Distribution Issues

# Windows Installation and Configuration Notes

## Platforms

> This version of JConfig is for use on Win95, Win98, and WinNT with the SunJDK ( 1.1 or higher ) and the MSIE VM. It has also been run with JBuilder (jdk1.1.6 version).

## Installation

> In the batch files described below, it is assumed that you unzipped the archive containing this file to the root of your C: drive, creating a c:\samizdat folder. If you unzipped this to another location, you will need to edit the batch files to reflect the different location, as described below. Other than that, no special installation is required.

## Running ImageMeister

> The ImageMeister application is run using 'imrunMS.bat' and 'imrunSN.bat', both of which are in the 'imeister' folder. To run ImageMeister, you may need to edit the first few lines of these files, as described in the next section.

> For more information on ImageMeister, see imagemeister.html.

## Running the Sample Applications

> JConfig comes with two sample applications, the source code for both apps is inside the `source/com/tolstoy/testjc` folder.

> The first application ( Tester.java ) opens up notepad.exe and launches your Web browser with a URL.

> The second application is the predecessor to ImageMeister, and is a simple disk browser. The source code for this is in the files 'DiskBrowser.java' and 'BrowserPanel.java'.

> The compiled versions of these apps are in the JConfig.zip file, so you don't need to compile them separately.

> Four batch files are provided to run the sample applications:

> - TesterMS.bat ( the first application, for use with the MSIE VM )
> - TesterSN.bat ( the first application, for use with the Sun JDK )
> - BrowseMS.bat ( the disk browser, for use with the MSIE VM )
> - BrowseSN.bat ( the disk browser, for use with the Sun JDK )

> NOTE: You may need to edit the first few lines of these batch files if you did not install the distribution to the root of your C:\ drive.

> NOTE: If you get the message 'Out of Environment Space' when running the batch files, right click on the batch file, and choose 'Properties'. On the 'Memory' tab, in the 'Conventional Memory' area, set the 'Initial Environment' popup menu to its highest setting.

> In addition to Tester and DiskBrowser, three other samples are provided.

> Run these in a similar fashion to running Tester. See the comments in these files for more information.

> - `com.tolstoy.testjc.FileAttributesTest`: Lets you view and set the attributes for files and folders.
> - `com.tolstoy.testjc.TestResFork`: shows how to copy a Mac file's data and resource forks to a new file. Copying the file's attributes is left as an exercise.
> - `com.tolstoy.testjc.MakeLink`: shows how to create a Windows shortcut, but could be adapted for the Mac.

## Paths and Classpaths

> On Windows, you must put JConfig.zip in your classpath, either in autoexec.bat, or in the batch file used to run your app. So, if JConfig.zip is in the 'c:\myapp' directory, you could use the following line in your batch file:

>         set classpath=.;c:\myapp\JConfig.zip;%classpath%

> Also, the native code libraries (jcnfigSN.dll, etc.) must be in the path. Note that the 'path' is a completely different environment variable from the classpath. The path is initially set in your autoexec.bat file, and tells Windows where to look for executables.

> If the JConfig DLLs are in the 'c:\myapp' directory, you could use the following line in your batch file:

>         set path=.;c:\myapp\;%path%

> Note: you indicate the directory where the DLLs are stored, not the DLLs themselves.

> Note: you can set the classpath and the path either in autoexec.bat, or in the batch file used to run your app, depending on your distribution method and other factors.

> Another example of how to set the path and classpath is provided in the 'TesterSN.bat' batch file:

>         set SAMDRIVE=c:
>         set SAMHOME=c:\samizdat
>         set JDKHOME=e:\jdk1.1.4

>         %SAMDRIVE%
>         cd %SAMHOME%\jconfig

>         set classpath=.;%SAMHOME%\common\jconfig.zip;%JDKHOME%\lib\classes.zip
>         set path=%path%;%SAMHOME%\common\

>         set LD_LIBRARY_PATH=%LD_LIBRARY_PATH%;%SAMHOME%\common\

>         %JDKHOME%\bin\java com.jconfig.Tester

> The line setting 'LD_LIBRARY_PATH' is probably not needed, but it doesn't hurt either.

## Debugging

> JConfig writes debug messages to the DBWin32.exe application. This application is included in the file DBWin32.zip, which is in the windebug folder. Please run this application when using JConfig; if you have any problems with JConfig, please copy the contents of the DBWin32 window, and send them with your bug report.

Main Page · JConfig · ImageMeister · System Properties Repository · Native Macros · Free Samples · WordMeister · Java Freeware · Links · Contact Us

Copyright (c) 1997-2002 Samizdat Productions. All Rights Reserved.
JConfig and ImageMeister are trademarks of Samizdat Productions. Other trademarks are the property of their respective owners.
samizdat@tolstoy.com