We recommend the latest stable version unless you have compelling reasons to use older versions. Jsoftware archives only a few previous systems.
J32 Windows: j601c_win.exe J64 Windows: j601c_win64.exe J32 Linux: j601c_linux.tar.gz J64 Linux: j601c_linux64.tar.gz J32 Mac PowerPC: j601c_darwin_powerpc.tar.gz J32 Mac Intel: j601c_darwin_intel.tar.gz J32 PocketPC: j601c_pocketpc.zip
JE (J Engine) is a shared library that executes J sentences and is the system core. JE is j.dll in Windows, libj601.so in Linux, and libj601.dylib in Mac.
Jconsole is a JE console front end. It is jconsole.exe in Windows and jconsole in Unix.
Jwd is a JE GUI front end. It is j.exe in Windows and PocketPC. Jwd is provided by Java j.jar in Windows 64 and Unix.
Jwd is recommended for new users as it has help, demos, tutorials, manuals, and release notes.
Install files have names of form: jrrrx_platform.suffix
rrr is release number and x is buglevel letter
platform is win, win64, pocketpc, linux, linux64, or darwin (Mac OS X)
suffix is exe for win and win64, zip for pocketpc, and tar.gz for Unix
Download from www.jsoftware.com to [download] directory and follow platform instructions:
Windows
Windows 64
PocketPC
Linux
Linux 64
Mac OS X
More complicated installations are possible.
Run j601x_win.exe and follow instructions. Run Jwd with blue J icon in the J Program Group. Run Jconsole with jconsole.exe (Ctrl+D exits). The yellow J icon signals an interrupt to a running J program.
Run j601x_win64.exe and follow instructions. Run Jwd with red J icon in the J Program Group. Run Jconsole with jconsole.exe (Ctrl+D exits). The yellow J icon signals an interrupt to a running J program.
Red J icon assumes 64 bit javaw.exe is in your path. If this is not the case
the icon has to be edited to have the full path to javaw.exe. Test the
assumption in a Command Prompt (DOS) window:
> java.exe -version
icon is ready for use if result says 64 bit
Find the 64 bit javaw.exe. If you don't have it, you need to install it
before you can run Jwd. It is likely down the path "c:\program files\java".
> [path to javaw.exe]/java.exe -version
result must say 64 bit
Edit red J icon with a right click|Properties and change javaw.exe to have
the full path.
Target: "[path to javaw.exe 64]\javaw.exe" -Xss12000000 -jar j.jar
Start in: c:\j601
Note: java.exe is used with -version, but javaw.exe is the target.
J601 requires PocketPC Windows CE 4.20 (PocketPC 2003) or later.
Unzip j601x_pocketpc.zip in a temp directory on a desktop system (not your PocketPC).
We strongly recommend installing the j601 directory in your PocketPC main memory at the same level as "My Documents", "Program Files", and Windows. The j601 directory is under 5mb. If installed as recommended the default icons (shortcuts) will work and the install is simplified and you don't need to build your own shortcuts.
Click PocketPC Start, Programs, J601. PocketPC does not have a Jconsole.
Just as you sometimes have to reboot your desktop to get things working again, you may occasionally have to reboot your PocketPC. A reboot is called a soft reset and is typically done by pressing the stylus in a hole in the back (check your device manual before trying this!).
You can have the same J help on your PocketPC as you have on your desktop. The help is about 8MB and is not included in the PocketPC zip.
The easiest install is to copy the J601 help directory from your desktop (system\extras) to your PocketPC J601 system\extras directory.
If your PocketPC J system is in main memory you may want to put your help directory on a storage card. In this case copy the help directory from your desktop to the j601\system\extras directory on your storage card.
The J Help menu commands automatically look for help files in the J directory system\extras\help and if not found there, in the storage card directory j601\system\extras\help.
If J is running, clicking the J icon just brings the running version to the forground. To start a second copy you need to run J with a -jnew parameter. The shortcut Jx601 has the -jnew parameter.
If you rarely start a 2nd copy of J you can do: Start|Programs|File Explorer|j601|Jx601. If you require a 2nd copy of J more frequently, copy the Jx601 shortcut to the Windows\Start Menu\Programs directory.
PocketPC shortcuts (.lnk) files are text files with format:
nn#"path to exe file" parameters
J601.lnk file is: 13#"\j601\j.exe"
Jx601.lnk file is: 20#"\j601\j.exe" -jnew
shortcut to run app.ijs without an ijx is: 27#"\j601\j.exe" -jijx app.ijs
The tar, done in your home directory, unpacks the file to create a j601
directory in your home directory. See Sudo for sudo info
and options. See Unix Run for info on running J.
Installing elsewhere requires more steps.
> cd
> tar -xzf [download]/j601x_linux.tar.gz
> cd j601
> sudo mv libj601.so /usr/lib/.
> [password]
The tar, done in your home directory, unpacks the file to create a j601_64
directory in your home directory. See Sudo for sudo info
and options. See Unix Run for info on running J.
Installing elsewhere requires more steps.
> cd
> tar -xzf download]/j601x_linux64.tar.gz
> cd j601_64
> sudo mv j601_64/libj601.so /usr/lib64/.
> [password]
Mac download may automatically unpack to your desktop. If the unpack is done for you, skip the tar step and move j601 directory from your desktop to your home directory. The sudo is always required.
The tar, done in your home directory, unpacks the file to create a j601 directory
in your home directory. See Sudo for sudo info and options.
See Unix Run for info on running J. Installing
elsewhere requires more steps.
> cd
> tar -xzf [download]/j601x_darwin.tar.gz
> cd j601
> sudo mv j601/libj601.dylib /usr/lib/.
> [password]
Mac Finder, J (red icon) starts Jwd. Drag to the Dock for easy starts.
Run Jwd:
> ~/j601/jw (~/j601_64/jw for linux64)
If jw fails see Java section.
Run Jconsole (Ctrl+D exits):
> ~/j601/jconsole (~/j601_64/jconsole for linux64)
If jconsole fails the likely problem is with the sudo step.
Run Jbreak to signal an interrupt to a running J program.
> ~/j601/jbreak (~/j601_64/jbreak for linux64)
Shared library file libj601.so (.dylib) is the J Engine. Front ends (Jconsole and Jwd) load this file and the loader must be able to find it.
One solution is to move the file to /usr/lib (/usr/lib64). The mv requires superuser privilege so is done under the sudo command which asks for the password.
You can put the file anywhere the loader will find it. Alternatively, add J dir to LD_LIBARY_PATH.
If jconsole works and jw fails, the likely problem is finding the correct
java binary.
> which java
java jw uses by default
> java -version
default java version
Linux and Mac OS X require version 1.4.2 or later and the version must not be 64 bit. Linux 64 requires 1.5.0 or later and the version must be 64 bit.
Find path to the correct java binary and edit jw shell script to have the full path to the binary. For example, for Linux 64 if you have installed java 64 bit 1.5.0_06 in your home home directory, edit jw to have: "~/jre1.5.0_06/bin/java" -Xss...
We recommend that you install as described above and not move j601 or j601_64 to another location until you are familiar with it.
When J starts it needs to find profile.ijs for loading the standard library. If env var JPATHj601 (JPATHj601_64 for linux64) is not defined, then J looks in ~/j601 (or ~/j601_64). If you move j601 you need to set/export JPATHj601 (JPATHj601_64) to be the path to profile.ijs.
The Mac set/export must be done in /etc/profile for the red J icon to work.
More complicated installations, for example installation in a shared, read-only directory, for use by multiple users are possible, and require both system admin and J programming knowledge. The profile.ijs has to be modified so that standard J user directories such as user and temp are properly set. For example, the following changes to profile.ijs would give each user their own temp and user directories in their ~/J directory:
USER_j_=: (2!:5'HOME'),'/J'
TEMP_j_=: USER_j_
J50x systems require a J User License (JUL), which is freely available. Please use the following:
Name: Jay Soft JUL: 7888-027-4275
Download and run the installation executable. The files unzip into the final directory. You can overwrite an earlier installation, or install into a new directory.
Download and unpack to create the J directory. For a simple installation, unpack in your home directory. For example, in Linux, download to a temp directory, then:
cd ~
tar -xzf temp/j504b_linux32.tar.gz
The Mac download may automatically unpack to your desktop and you must then move it to your home directory.
Start J with command line:
~/j504/jw
and start J console with:
~/j504/jconsole
Mac Finder J (red icon) starts J and jconsole starts J console. Drag J to the Dock for easy starts.
If you don't install in your home directory, you must set/export environment variable JPATHj504 to point to the J directory. Mac J (red icon) requires the set/export in /etc/profile. See install.txt in the J directory for additional information.
J501 PocketPC runs on Strongarm and Mips processors and requires Windows CE 3.0 or later.
Download the appropriate file and unzip in a temp directory on a Windows system that connects to your PocketPC. File readme.htm has install instructions.