Make your own free website on Tripod.com
NetRexxJe Version 0.09 (Feburary 2003)
By Satguru P Srivastava (srivastava.satguru@mcleodusa.net)
http://ssatguru.tripod.com/NetRexx
Introduction

The "NetRexxJe" plugin provides a quick and easy way to compile and run your NetRexx or Java program from within the jEdit environment.

Requirements

The minimum requirements are

Installation

jEdit can install the plugin for you or you can install it manually.

To let jEdit install the plugin

To install it manually
Getting Started

To start the plugin

Hopefully this is all you would need to do to get going.

But if a message box pops up asking you to set some paths or you are having problem later on while using NetrexxJe then read on.

Every time NetRexxJe is started it checks to see if certain paths are set and that they are valid.
If a path is not set it will try to set it itself.
If a path is set then it will check to see if the it is valid i.e. if it exits.
If it is unable to set a path or if it finds that a path is invalid it will pop up a message box warning you of that and will ask you to set it manually.

To set/check/change the paths set by NetRexxJe -


Using the Navigator

Structure Browser.

This displays the structure of your program and helps you move around your code.

This has been implemented using the SideKick Plugin.
The NetRexxJe Plugin scans your source code for NetRexx tokens (classes, properties and methods), creates a tree model and passes that over to the SideKick plugin. The SideKick Plugin displays the tree in a separate docked\undocked Structure Browser window.

When you click a node on the tree the Structure Browser moves the cursor\caret over to the line containing the class, property or method referred to by that node.
When you click a node while pressing the Shift key the Structure browser selects the whole class, property or method referred to by that node
When you click a node while pressing the Ctrl key the Structure browser displays the the whole class, property or method referred to by that node and hides the rest of the code. Clicking another node redisplays the rest of the code
As you move around your code the corresponding node on the tree is automatically selected.

Clicking the refresh button will force the Structure Browser to parse and refresh the tree.
You can also set options to automatically parse at certain time intervals or when certain events occur.
To do so go to Global Options and set the properties of the SideKick Plugin

The Structure browser can also be docked using global options, docking.

NB:The NetRexxJe plugin uses simple regular expression for parsing your code. It is not a true Parser. It will not validate your code. If your code does not compile properly you might get unexpected results.

Compiling your Program

NetRexx / Java Compiler.

The compile button is a toggle button and will remain pressed during the compile process. To abort the compile process anytime press the Compile button again.

If the compile process was error free then a class file would be created in the same directory as that of the source file.

Any warning or error messages reported by the compiler will be passed on to the EditBus.
If you have installed the ErrorList Plugin then these messages will be displayed in the ErrorList plugin panel. Clicking a message on the ErrorList panel will highlight the erring phrase in your source code.

If the file type of the program is 'java' then the plugin would invoke the java compiler otherwise it would invoke the NetRexx compiler.

If you are compiling a java program you can add/change compile options by typing them in the 'Args/Stdin' text box. For example to compile the java program with the 'verbose' option just type -verbose in the 'Args/Stdin' text box and press the Compile button.

NB: While compiling netrexx program the plugin uses the NetRexx compiler's "compact" option to make it display the messages in particular format. If this option is overridden, using the option keyword in your source program, then the plugin will not be able to capture the messages.

Creating the Java Program

Netrexx to Java

Like the compile button the Java button is also a toggle button and will remain pressed during the whole process. To abort the Java process anytime press the Java button again.

Pressing the Java button also invokes the NetRexx compiler. But this time the compiler merely parses the source file and creates the equivalent java file. It does not create the class file.

At the end of the process if there were no errors a java file is created in the same directory as your source file and is also displayed in another edit pane.

By default the file is given the name of your program and an extension of "JAVA.KEEP". This can be overridden to give an extension of "JAVA". To do this go the Global Option dialog box and select the NetRexxJe option "Change file type from JAVA.KEEP to JAVA after the java Processing". Changing file ext to "JAVA" can be helpful because then you can use other Java Plugins like JBrowse etc to analyze your code.

If the "JAVA.KEEP" to "JAVA" option was chosen in the Global Options dialog box then remember to also override the noreplace compiler options. Normally the compiler complains if it finds a JAVA file already there.

Error messages are handled in the same manner as the Compile process described above.

Changing Compiler Options

NetRexx compiler options

Pressing the Options button will replace the NetRexx console panel by the compiler option panel. Pressing the Options button again will restore the console panel.

The compiler option panel contains a list of the DEFAULT options used by the compiler. To override an option just go and select it. The selections made are saved across jEdit sessions.

Changing Classpath

You can change the classpath used by the NetRexx & Java compiler by typing in a new classpath in the ClassPath field. You can also set the path interactively by clicking the ClassPath button.

The ClassPaths set by you are stored in the jEdit's History file. They are available when you start jedit again.The number of ClassPaths stored is determined by the 'History entries' setting in the General Global Option.

To select a previous classpath click the drop down box and pick one from the drop down list.

The plugin adds the following paths to what you selected

NB:In windows if you started jEdit using the jar option (eg java -jar jedit.jar) then your system classpath would be just jedit.jar

Running Your Program

Run NetRexx / Java program.

This is a toggle button and will remain pressed during the run. To abort the run anytime press the Run button again.

To pass any arguments to your program type in those arguments in the Args/Stdin field or pick one more the drop down box before running the pgm. To store your arguments in the history press ENTER after entering the arguments.

Your program will run with the classpath set as described above and with the arguments typed in the Args/Stdin field

If your program reads from the STDIN during it's run ie. if it uses ask or readln etc then you can pass data to it by typing the data into the Args/Stdin field or picking one from the drop down box and pressing the ENTER key on the keyboard. The data is stored in the history.

Using Keyboard Shortcuts

All of the tasks that you can perform by clicking buttons on the plugin toolbar can also be performed by pressing certain keyboard keys. Before you can do this you need to assign certain keyboard combinations to a task.
To do this

For more help on setting and using keyboard shortcuts see the jEdit Help.

Notes
To Do

These are the additional features that are being considered:

Change log

Version 0.09 (Feburary 2003)

Version 0.08 (October 2002)

Version 0.07 (June 2002)

Version 0.06 (May 2002)

Version 0.05 (October 2001)

Version 0.04 (March 2001)

Version 0.03 (March 2001)

Version 0.02 (Nov. 2000)

Version 0.01 (Oct. 2000)

Feedback

Please send any bug reports or feedback to me at the following address
srivastava.satguru@mcleodusa.net

Thanks
Satguru Srivastava