>>  <<  Ndx  Usr  Pri  JfC  LJ  Phr  Dic  Rel  Voc  !:  wd  Help  User

Install

Overview
Folder Summary

Windows
Linux
Mac
PocketPC

jwd Problems
Multiple Users
Customized User Folder
USB Memory Stick

Overview

The J install folder is j602 (j64-602 for 64 bit systems). A standard install puts the J folder in your HOME folder.

Admin privilege is not required for a standard install or for web updates.

User and temp files are in HOME folder j602-user (or j64-602-user).

Doing the install in a protected folder path such as "Program Files..." or /usr/... requires admin privilege and will require admin privilege for web updates. Installing in other than HOME can be a nuisance and has no compelling benefit with the possible exception of an install for Multiple Users.

JE (J Engine) is a shared library that executes J sentences and is the system core. JE is j.dll in Windows and PocketPC, libj.so in Linux, and libj.dylib in Mac.

JFE (J Front End) is a user interface to JE.

Jwd is a GUI JFE. It is j.exe in Windows and PocketPC and Java j.jar in Linux and Mac.

Jwd is recommended for new users as it has help, demos, and tutorials.

Jconsole is a console JFE. It is jconsole.exe in Windows and jconsole in Linux and Mac.

Unix hardlinks to JFE are not supported and symlinks must have an absolute path.

Folder Summary

J
  jinstall: j602          or j64-602
  juser:    j602-user     or j64-user-602

home
  Vista: \Users\name
  XP:    \Documents and Settings\name
  Linux: /home/name
  Mac:   /Users/name

system
  J32 on Win 32: C:\Program Files
  J64 on Win 64: C:\Program Files
  J32 on Win 64: C:\Program Files (x86)
  Unix:          /usr/...

standard install
  home/jinstall
  home/juser

system install
  system/jinstall
  home/juser

custom install
  [...]/jinstall
  home/juser

custom install with profilex.ijs
  [...]/jinstall
  [???]

Windows and Windows64

The installer creates J folder j602 and Program Group j602 (j64-602 for Windows64).

Blue J icon runs Jwd.

Yellow J icon interrupts a running J program.

Gray J icon runs Jconsole (Ctrl+D exits).

Run jreg.bat in the J folder to register the J COM servers.

Windows XP: HOME is "\Documents and Settings\username".

Linux and Linux64

If you downloaded to ~/temp , do a standard J32 install with: 
...> sh ~/temp/j602a_linux32.sh -install
For J64 use 64 instead of 32. Run without -install for options.

This unpacks the J folder in your home folder. A linux32 file creates j602 and linux64 creates j64-602.

In the following examples, if your install is linux64, use j64-602 instead of j602.

Run Jwd:

...> ~/j602/bin/jwd

See jwd Problems if jwd fails.

Run Jconsole:

...> ~/j602/bin/jconsole

For easy Jwd start, create desktop launch icon (method depends on desktop).

For easy Jconsole start, create a symbolic link in a folder in PATH. For example, 
...$ ln -s ~/j602/bin/jconsole jc
...$ sudo mv jc /usr/bin/jc

Mac (intel and powerpc)

Standard install is to use Finder to copy j602 folder from the mounted disk image to your home folder. Be sure you copy j602 folder, not the red J icon it contains!

Copy does a complete replace of an existing J folder and you need extra steps if there are files you want to protect or carry forward.

Red J icon runs Jwd.

Yellow J icon interrupts a running J program.

Run Jconsole in a Terminal window (Finder Applications Utilities Terminal):

...$ ~/j602/bin/jconsole

For easy Jconsole start, create a symbolic link in a folder in PATH. For example, 
...$ ln -s ~/j602/bin/jconsole jc
...$ sudo mv jc /usr/bin/jc
An option is to copy j602 folder to Applications. This requires admin privilege for the install and for subsequent web updates. An Applications install can be used by other users.

A 3rd option, for casual use, is to just run J from the mounted disk image.

PocketPC

J requires PocketPC Windows CE 4.20 (PocketPC 2003) or later.

Strongly recommend putting j602 folder in your PocketPC at \ (same level as Windows folder).

1. unzip j602x_pocketpc.zip in temp folder on your desktop computer
2. copy j602 folder to your Pocket PC (Confirm File Copy - Yes to All)
3. copy j602\J602 (J shortcut .lnk file) to \Windows\StartMenu\Programs

Click Start, Programs, J602 to start J.

Reboot (soft reset)
You may have to occasionally reboot your PocketPC. This is typically done by pressing the stylus in a hole in the back (check your manual!).

Help install
You can have the same J help on your Pocket PC as on your desktop. Copy the J help folder from your desktop to your PocketPC main memory j602 folder or to your storage card j602 folder. J Help menu commands look in \j602\help folder and if not there, in the storage card.

Running a 2nd copy of J
If J is running, clicking the J icon brings it to the forground. To start a second J, run shortcut Jx602 (Start|Programs|File Explorer|j602|Jx602).

Shortcuts
PocketPC shortcuts (.lnk) files are text files with format:
nn#"path to exe file" parameters
J602.lnk file is: 17#"\j602\bin\j.exe"
Jx602.lnk file is: 24#"\j602\bin\j.exe" -jnew
shortcut to run app.ijs without an ijx is: 31#"\j602\bin\j.exe" -jijx app.ijs

jwd Problems

J32 jwd runs command java and fails if java isn't in your path or isn't the correct version.

J64 jwd runs java64 and fails if java64 isn't in your path or isn't the correct version.

Find the path to the correct 32 bit or 64 bit java binary (you may have to install it).

For example, if /home/name/jre1.5.0_06/bin/java is your Java 64 bit binary, then edit J64 jwd to have that fullpath rather than just the command java64.

Alternatively, create a java64 symlink in your path that links to that binary. 
...$ ln -s "/home/name/jre1.5.0_06/bin/java" java64
...$ sudo mv java62 /usr/bin/java64
The following commands may be of help: 
...> which java
...> java -version
...> which java64
...> java64 -version
This shows which Java binary is being run (if any) and the version. J32 requires Java 1.4.2 or later and the version must not be 64 bit. J64 requires 1.5.0 or later and the version must be 64 bit.

There may be problems with some less common Java builds. The Sun and Blackdown builds seem to be your best bet.

Multiple Users

Multiple users can share a single J install. Different users automatically get their own user and temp folders in their HOME folder.You can share a standard install with the J folder in the HOME directory of the user who is primarily responsible for J and updates and maintenance.

Alternatively you can do the install (or move an existing install) to a folder you feel is more appropriate. If you move a Windows install you have to manually edit the jsoftware-j602 icon properties to reference the new location.

You will want to provide users a convenient way to run J and this varies across platforms.

Windows
To allow all users to see the jsoftware-j602 Program Group, copy it from your HOME Programs folder to the public Programs folder: 
1. right click Start button and click Open
2. right click jsoftware-j602 and click copy
3. right click Start button and click Open All Users
4. right click Programs folder and click paste
Linux
Create desktop launch icons and symlinks as appropriate.

Mac
If you put j602 in Applications, the J icons are already there in the j602 folder. If J is somewhere else you can create alias links for the J icons in Applications as follows: 
1. in J folder press ctrl, click red J icon, click Make Alias
2. drag j602 alias to Applications
3. rename alias to just be j602
4. repeat steps for yellow J icon if desired
Create a symlink to jconsole as appropriate.

Customized User Folder

The normal folder for user and temp files is HOME j602-user (or j64-602-user). Override this by creating profilex.ijs in your J bin folder.

bin\profilex_template.ijs is a template of what you want in profilex.ijs for the override. Study profilex_template.ijs before making your profilex.ijs file. Backup and be careful as errors may prevent J from starting properly.

USB Memory Stick

You can copy a J folder to a USB memory stick for a complete and portable J system. If you want the J user folders to be on the memory stick you need to create a proflilex.ijs file in the memory stick J bin folder. See Customized User Folder for more information. You will want to edit profilex.ijs to have user in the install folder.

If you don't put profilex.ijs in the J folder on the memory stick, the J system will use HOME for the user folder.
>>  <<  Ndx  Usr  Pri  JfC  LJ  Phr  Dic  Rel  Voc  !:  wd  Help  User