JICB v1.07, a Java ICB client Copyright 1996,1997 by Mark Damon Hughes _______________________________________________________________________________ WHAT'S NEW v1.07 * Integrated the scrollback into the terminal. When your screen goes grey, you're looking at the scrollback - the history of all text that's gone by before. Hit PGUP and PGDN to move around in it, and ESC to get rid of it. You don't really want to use JICB all the time in scrollback mode, because it doesn't show a cursor and it doesn't move along with the text. It also displays a bit slower than usual. v1.06 * Added simplistic clipboard support - drag the mouse over text, and a rectangular region will be highlighted and placed in a text area. Then just hit your usual "copy to clipboard" key (control-insert on OS/2 and Windows, Propeller-C on Macs, etc.) Hit escape or close the "clipboard" window to get rid of it. * Put help files in pop-up windows, so they don't scroll off the screen. v1.04 * Made more stable on and compatible with more platforms. * Added '!' and '>' commands, to execute local programs from inside JICB. * Added 'unmacro' command and changed 'macro ' to be consistent with 'option'. * Command-line option to change the size of the scrollback buffer. _______________________________________________________________________________ WHERE TO GET IT will always have the latest version of JICB. _______________________________________________________________________________ INSTALLATION Carefully read and follow these steps, one at a time. No, really, this MATTERS. 0) GETTING JAVA (if you don't have it already) Install a Java runtime or JDK (Java Development Kit) from 1) EXTRACTING THE ARCHIVE Unzip this archive with 'unzip' or 'winzip' (pkunzip does not handle long filenames) in a directory in your CLASSPATH (a Java-required environment variable you set in step 0), or if you've already unzipped it somewhere else, either move it into your CLASSPATH or add its parent dir to the CLASSPATH. For example, if you have: CLASSPATH=.;C:\Home\Java;C:\JAVAOS2\lib\classes.zip You could then unzip jicb.zip in C:\Home\Java, so you have C:\Home\Java\mdh\, C:\Home\Java\mdh\jicb\, and C:\Home\Java\mdh\lib\ beneath it, and you would not need to change your CLASSPATH. Or you could unzip jicb.zip in C:\Home\JICB, so you have C:\Home\JICB\mdh\, C:\Home\JICB\mdh\jicb\, and C:\Home\JICB\mdh\lib\, and add C:\Home\JICB to your CLASSPATH. You do not want C:\Home\Java\mdh\jicb in your CLASSPATH, just C:\Home\Java. 2) SETTING YOUR USERID Make sure your user.name property is set in Java. This is your userid on the machine you're connected to the Net with (generally the same as your email address). For example, if you are foo@bar.com, your userid is "foo". JICB will not work without your userid - showing up as "@bar.com" would be socially unacceptable. This is done for you automatically on Unix platforms. In OS/2 and other PC systems, you can set the USER environment variable to your userid by putting SET USER=foo in your config.sys. If you are on some other system, you can set this in the hotjava/properties file (see the documentation that came with your Java runtime), by adding: user.name=foo As a last resort, you can put it on the java command line or in the batch file: java -Duser.name=foo mdh.jicb.JICB -jicbhome %JICB_HOME% %ARGS% This is not recommended. 3) JICB SUPPORT FILES Set the JICB_HOME environment variable to the mdh\jicb\ directory from this archive. If you did step 1 in C:\Home\Java, you should have: SET JICB_HOME=C:\Home\Java\mdh\jicb JICB_HOME is used to find the help files and icons for JICB. If you don't care to clutter up your config.sys, change the appropriate batch file for your system (jicbos2.cmd, jicbwin.bat, or jicbunix) and replace "%JICB_HOME%" or "$JICB_HOME" with the directory, so it would be java mdh.jicb.JICB -jicbhome C:\Home\Java\mdh\jicb %ARGS% in the last example. 4) JICBRC - YOUR OWN CUSTOMIZABLE SETUP Copy the %JICB_HOME%\jicbrc.sample file to your home directory or wherever the user.home property points, and rename it to "jicbrc", like: [C:\] copy %JICB_HOME%\jicbrc.sample %HOME%\jicbrc Be sure to go through it and change whatever you like - it's simply a list of commands to execute, just as if you typed them yourself. The last command in it should be "connect" (see "/help local" for more information) if you want JICB to automatically try to connect to the server when it starts. Almost done... 5) THE JICB "EXECUTABLE" Copy the appropriate batch file or script for your system (jicbos2.cmd, jicbwin.bat, or jicbunix) to somewhere in your PATH as jicb.cmd, jicb.bat, or jicb, like: [C:\] copy %JICB_HOME%\jicbos2.cmd \bin\jicb.cmd Or just call Java directly, like: java mdh.jicb.JICB -jicbhome C:\Home\Java\mdh\jicb %ARGS% If you're not behind a firewall (if you don't know what one is, you don't need to worry about it), you're done! Go on to USE below. 6) BREAKING THROUGH A FIREWALL If you are behind a firewall, set the PROXY_HOST environment variable to : Example: SET PROXY_HOST=proxyhost:8080 _______________________________________________________________________________ USE Type "jicb". When JICB comes up, type /help or hit F1 if you need help, and then read the ^^^^ ^^^^ ^^^^^ ^^^ ^^^^ ^^^^^ ^^ ^^^ ^^ ^^ ^^^ ^^^^ ^^^^^ ^^^ ^^^^ ^^^^ ^^^ rest of the help subjects. The online help is there FOR YOU. If you do not ^^^^ ^^ ^^^ ^^^^ ^^^^^^^^^ ^^^ ^^^^^^ ^^^^ ^^ ^^^^^ ^^^ ^^^^ ^^ ^^^ ^^ ^^^ read it, the author will not help you in any way, except to point you back at ^^^^ ^^^ ^^^ ^^^^^^ ^^^^ ^^^ ^^^^ ^^^ ^^ ^^^ ^^^^ ^^^^^^ ^^ ^^^^^ ^^^ ^^^^ ^^ the online help. ^^^ ^^^^^^ ^^^^^ -(I really mean this. READ AND OBEY!) _______________________________________________________________________________ KNOWN BUGS/LIMITATIONS * Slow scrolling. This can be a real problem if you're using a large screen. Try setting '/option scrolljump 3' (or even higher), and see if that helps. If not, let me know - the more demand for a faster screen, the more work I'll put into it. * If you leave JICB running for a very long time, the scrollback will eventually consume all memory and bring about the heat death of the universe. * When JICB loses a connection to the server, it has no clue. You have to hang up (alt-h or '/hangup') and re-connect. This is a Java socket limitation, and I am trying to find a solution. _______________________________________________________________________________ LEGAL This program is provided for private, non-profit use only. Registration is required if used in any commercial environment. Reverse-engineering or decompiling this code is strictly forbidden - a source license is available, however. This program is provided without warranty, and the author assumes no liability for any damages. No endorsement of any commercial product is intended or implied by this document. _______________________________________________________________________________