NetRexx

# NetRexx 4.05 GA [10 May 2023] ## Project - an ant build.xml (in examples) to build an Android .apk for the NetRexx translator (Jason Martin) - Reworked NetRexx Language Reference documentation - Reworked NetRexx Pipelines Guide and Reference documentation ## Language - a new option -deps to list dependencies - a new option -noimplicituses to avoid automatic addition of Classic Rexx compatible classes to 'uses' -see below - the package org.netrexx.address is now deprecated, because its work is better done by the ADDRESS statement - #! shebangs are now supported for systems that support them, such as Linux and macOS - and ignored by the translator (Marc Remes) - the launch script nrc now can be run with no CLASSPATH present (Marc Remes) - The Classic Rexx (and ooRexx, Regina) functions user() and directory() are added to aid scripting.(René Jansen) - #48 nrws.properties can now be .nrws.properties (though support for the filename without a dot is still there) - a Classic Rexx compatible random() function is added. ## Pipelines - org.netrexx.njpipes.pipes.runner now reads pipeline source from stdin when invoked without arguments (Marc Remes) - a new ALL stage (Jeff Hennick) - a new DELAY stage (Jeff Hennick) ## Fixes - #38: the ADDRESS environment for SYSTEM is now resolved at runtime, previously a class compiled on another platform could look for a shell that was not there (Marc Remes) - the sqlselect stage has an exception message protected against nullpointers from a failing JDBC driver - #33: fix interpreter handling constant properties - #35: Rexx date() now standard in all modes (scripting mode and standard mode) -noimplicituses option for breakage - adapted qtime.nrx example for #35 (René Jansen) - #40: detect unreachable code (Marc Remes) - #41 The Workspace for NetRexx (nrws) now tries to avoid leaving _WS_*.nrx files after ending (René Jansen) - #42 A settings.history=off property in nrws.properties can be used to avoid writing a nrws.history file (René Jansen) - when interpreting, wait for all threads to complete after main() returned. - better diagnostics on failed clgMain (compile-load-go) dynamic compiles, e.g. for pipes and their stage exits - an error in RexxTime which could lead to a recursive call has been solved - #43: Erroneous leading zero on Date() and Date('n') corrected, now following the language reference and standard - allow lowercase 'date()' functions - updated ADDRESSable bin/pipe shell script - lifted restriction on macOS where due to an Apple caused 'feature' the home directory was not scanned for packages on startup of the translator. The restriction is now limited to the $HOME/Library hidden system directory on macOS, NetRexx will not find classes in that location. - #47 a related issue (but for another part of the user home directory) is solved for windows

NetRexx 4.03 GA [03 May 2022] - ADDRESS WITH implemented (Marc Remes) - a fix for NETREXX-24 (was 148): ITERATE without label is not inside LOOP construct message (Marc Remes) - a small fix for the MOD option (Jason Martin) - correct slightly erroneous DataIO2.nrx example from NrxRedBk (René Jansen) (Thank you Terry Fuller) - a fix for JavaFX usage with the JPMS (and any other imported module) (Marc Remes) (Thank you Terry Fuller) - a new sample how to address https by Ruurd J. Idenburg - A Classic Rexx inspired Stream I/O implementation (René V. Jansen) - A new example of how to use a Swing Gui by Ruurd J. Idenburg - Start of a new organisation of the examples directory by function - a 'scripting mode' application adds 'uses RexxDate, RexxStream' to the generated class definition - RxJrt now compiles under Java 8 and RxJrtApi.nrx under Java >=9 (Marc Remes) - The java2nrx tool has been upgraded to v1.05 - The distribution package now also contains java2nrx (previously onlyin source package) - in scripting mode, 'parse pull' can be used as an equivalent of 'parse ask'

NetRexx 4.02 GA [Januari 24, 2022] - for building NetRexx 4.0.2, Java 8 is now the lowest supported version - tested and buildable from Java 8 up to and including Java 19ea - including a fix for building on Java >=18 - NetRexx option (no)annotate to turn off pass through annotations - NetRexxC.jar and NetRexxF.jar now contain the ANT task for NetRexx - The ANT task is modified for the new -annotations option - The ANT task is modified for the new -address option - ANT in the source code repository upgraded to 1.10 for building NetRexx - a new chapter in the Programming Guide documenting two ANT scenarios - new special word asknoecho to request console input without echo, e.g. for passwords - NetRexx option MOD for generation of tailored source representations (Jason Martin) - documentation additions and corrections (numerous) - the base font for all documents is now an open source version of Palatino (TeX Gyre Pagella , due to font copyright issues Pipeline additions, improvements: - fix for arguments on command stage - DIGEST stage (SHA1, SHA256, SHA512, MD2, MD5 and more). - a small CMS-compatibility improvement for stage LITERAL (Jeff Hennick) - a new pipr script that is guaranteed to work in a Docker container (Marc Remes)

NetRexx 3.11 GA [December 23rd, 2020] - 3.10 is skipped as a release number, to avoid confusion with 3.01 - Diskr and diskw stages:enhanced detection of Windows-type path strings - diskr and diskw stages fixed for relative filepaths - COLLATE stage; with tests and documentation - cons stage: add PRefix & PRompt keywords - added USER to sqlselect.properties for some dbms - change stage: add TO, FROM, TOFROM optional keywords - command stage: add isWindows and cmd processing; better error message; documentation - Stages decode64 & encode64 - Stages q, qu, que, quer as aliases for query - Change stage: add FROM, TO, FROMTO, FOR, RESPECTCASE keywords - ChangeRegex stage add FROM and TO options - changeparse stage & abbreviations - display stage - htmlrow stage - htmlrows stage (all work on CMS/NetRexx Pipelines is by Jeff Hennick)

NetRexx 3.08 GA [September 5th, 2019] - restore OS/2 and Java 6 compatibility - fixes a serious translator problem introduced in 3.07 - some classes ended up in the wrong files - suppress generics-related warnings by adding a @SuppressWarnings annotation - added a NetRexxC.clgMain method for compile, load and go - the pipes.runner class now (compiles and directly) runs a pipeline - default stage separator is now | like on zVM - added the VM abbreviations of >,<,>> for file I/O device drivers - pipes compiler now reliably finds classes it needs - cleaned up pipes examples to make sure they all compile - fixed C2X function on specs pipe stage - added listzip stage - added zip stage - added unzip stage - added -- (comment) stage (Jeff Hennick) - improved take stage (Jeff Hennick) - added pipe query stage for version info - pipes compiler command is now called pipc - added Pipes for NetRexx docs to distribution - display failed summaries last - Jason Martin - squelched the remark that we found a java compiler and other tourist information - add an experimental rexxcps.nrx from the work of Mike Cowlishaw (for wider evaluation) - added Joy programming language interpreter in examples/languages - added two javafx examples in examples/javafx - resurrected Martin Lafaix' NetRexx Workspace and added to NetRexx distribution (needs java 8) - with added: - pipes execution in tenths of seconds - (without needing to quote the specification like in an OS shell) - command history and editing on par with zsh - multiline editing, history and amends - command alias and shell script is called nrws - added and updated documentation: - moved the chapter on programmatic use of the translator from the Quick Start Guide to the Programmers's Guide - added a chapter on method resolution to the Programmer's Guide - added a chapter on the NetRexx Workspace (nrws) to the Quick Start Guide - updated, rewrote and expanded the Pipelines Quick Start Guide (renamed) - Docker image added to standard distribution

NetRexx 3.08 GA [August 23th, 2019] - restore OS/2 and Java 6 compatibility - suppress generics-related warnings by adding a @SuppressWarnings - annotation - added a NetRexxC.clgMain method for compile, load and go - the pipes.runner class now (compiles and directly) runs a pipeline - default stage separator is now | like on zVM - added the VM abbreviations of >,<,>> for file I/O device drivers - pipes compiler now reliably finds classes it needs - cleaned up pipes examples to make sure they all compile - fixed C2X function on specs pipe stage - added listzip stage - added zip stage - added unzip stage - pipes compiler command is now called pipc - added Pipes for NetRexx docs to distribution - display failed summaries last - Jason Martin - squelched the remark that we found a java compiler and others - added Joy programming language interpreter in examples/languages - added Martin Lafaix' NetRexx Workspace in NetRexx distribution

NetRexx 3.06 GA [December 10th, 2017] - Method level annotations will pass through to Java source.

NetRexx 3.04 [June 1st, 2015] - a jsr 199 compliant way of calling the java compiler - Java source is saved on disk by the 3.04 translator if options -keep or -keepasjava are specified just as in release 3.03 of NetRexx. However NetRexx 3.04 does not write java to disk otherwise since it is no longer required in order to produce class files. - an automatic search for a compiler : this release of the translator also finds compilers that are not on the classpath if one cannot be found via the classpath; for example in the directory the translator is loaded from or in any directory associated with the current JVM. This may reduce installation issues due to "Java compiler not found". - integration of Pipes for NetRexx (available in the NetRexxF.jar file) - a new level of (4.4.2) of the eclipse java compiler (available in the NetRexxF.jar file) - a less verbose startup message when the translator is started without options - NetRexxC option list now requires "-help" - new: NETREXX-120, option -javac indicates a preference for the javac compiler - new: NETREXX-120, option -ecj indicates a preference for the ecj compiler - new: the tools section now has support for the vim and nano editors - NetRexx now requires JVM 1.6 to build and run the translator - new: NETREXX-69, do binary support - a fix for NETREXX-117, NPE in jsr223 support - a fix for NETREXX-116, a new 'returnobject' option to return a returncode from a jsr223 script - a fix for NETREXX-114: fixes z/OS compatibility (broken in 3.03) - new: NETREXX-109, a parallel processing api - new: NETREXX-100, a list processing api - a fix for NETREXX-92, enabling negative values in interfaces - a fix for NETREXX-115, enabling trivial subclassing of some collection classes in java 8 and up - new: NETREXX-119, toByteArray() method on type Rexx - a fix for NETREXX-118, error in jsr223 engine - a fix for NETREXX-127, unneeded import of pipes and stages packages - an enhancement to add wildcard (*) support to the NetRexxC -classpath operand matches Java behavior and also adds support for double wildcards (**) which will cause loading of jar files from nested directories (a feature lacking in Java). In addition, the enhanced compiler search will find compilers specified in the -classpath operand and via classpath wildcards. - The Java system property "nrx.compiler" can be used to provide options for the Java compiler called by NetRexx. This property is set on starting the NetRexx translator as in this example: java -Dnrx.compiler="-target 1.6" org.netrexx.process.NetRexxC myprogram If the first option specified is "javac" or "ecj", NetRexx will use that option to prefer selection of a compiler although the "-javac" and "-ecj" translator options will override it. Other options are passed to the Java compiler unchanged. If you are using the Windows script "nrc.bat" to compile programs, you can place the system property in the Windows environment to make it automatic as in this example: set netrexx_java=-Dnrx.compiler="ecj -source 1.6 -target 1.6" The nrx.compiler property can also be set directly in Ant builds or via the Ant project property "ant.netrexxc.javacompiler". - a fix for NETREXX-134 -time output references correct compiler name - a fix for a transient NullPointer exception when looking for compilers - a fix for NETREXX-131 : add RuntimeConstants to enable building of the translator using ecj again The Pipes for NetRexx documentation is not ready yet, but previews will be available from the NetRexx website.