Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jwoehr/ublu
Ublu Midrange and Mainframe Life Cycle Extension Language
https://github.com/jwoehr/ublu
as400 cim ibm ibmi ibmioss interpreted-languages java-platform language midrange zvm
Last synced: about 2 months ago
JSON representation
Ublu Midrange and Mainframe Life Cycle Extension Language
- Host: GitHub
- URL: https://github.com/jwoehr/ublu
- Owner: jwoehr
- License: bsd-2-clause
- Created: 2016-02-16T02:45:46.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2024-10-23T16:07:02.000Z (2 months ago)
- Last Synced: 2024-10-23T21:52:35.506Z (2 months ago)
- Topics: as400, cim, ibm, ibmi, ibmioss, interpreted-languages, java-platform, language, midrange, zvm
- Language: Java
- Size: 27.5 MB
- Stars: 13
- Watchers: 8
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.TXT
- License: LICENSE
Awesome Lists containing this project
README
# ublu
Ublu Midrange and Mainframe Life Cycle Extension Language
Copyright (c) 2015, Absolute Performance, Inc. http://www.absolute-performance.com
Copyright (c) 2016, 2018, 2022, Jack J. Woehr http://www.softwoehr.com
All rights reserved.
See file LICENSE for license information.
* General information
* Quickstart instructions
* Goublu console support for Ublu
* Discussion of Ublu
Ublu is an interpretive language for remote systems programming of midrange or
mainframe hosts from a Java platform such as Linux, Mac, OpenBSD or Windows. It
also can run natively on IBM i ®, IBM z/OS USS ® or any other reasonable Java
platform including Android [UserLAnd](https://userland.tech/).
I wrote Ublu because I wanted a language to run on OpenBSD/Mac/Linux/Windows to
perform ad-hoc process automation primarily on IBM i. I was
supporting consulting clients by writing individual utility programs using JTOpen
which I have used since 1998 to control the AS/400. I decided to consolidate
the programs in a language, and the result is Ublu. Ublu is a work in progress,
as there is always more one could add.
Additionally, Ublu can call Java directly allowing the user to extend the
language interpretively in nearly any direction desired.
Running Ublu directly on IBM i is especially useful for modelling processes
which you might later wish to code in straight Java. Or maybe you'll leave them
in Ublu. Whatever works!
Ublu is Open Source Software under the BSD-2 license.
The user's guide is [userdoc/ubluguide.html](http://www.softwoehr.com/softwoehr/oss/ubludoc/ubluguide.html)
The full reference is [userdoc/ubluref.html](http://www.softwoehr.com/softwoehr/oss/ubludoc/ubluref.html)
Here's an [example of Ublu code](http://www.softwoehr.com/softwoehr/oss/ubludoc/jobstuff-example.html)
The example is syntax-colored using a [jEdit](https://jedit.org) edit mode provided with Ublu.
The latest release version of Ublu is [version 2.0.0](https://github.com/jwoehr/ublu/releases/tag/v2.0.0).
Ublu is distributed with some of the open source libraries it needs and their license files which permit such distribution.
Others are fetched into the project at build time via `maven`.
Ublu is already a stable and useful tool which has seen much use in the real world. It is neither complete nor perfect,
but what is in this world? As with all open source software, there is NO WARRANTY nor GUARANTEE include as regards
suitability for any given application.
Download the release, unpack and `java -jar ublu.jar` to run Ublu.
Or clone the source for Ublu and do a `maven` build:
* Clone the [Ublu GitHub repository](https://github.com/jwoehr/ublu.git) or download source from the [latest release](https://github.com/jwoehr/ublu/releases)
* Load the project in [NetBeans](http://www.netbeans.org) or [Eclipse](https://www.eclipse.org/) or cd to the top dir of the checkout and type `make clean dist` which will run the appropriate `maven` commands for you.
* `target/ublu.jar` is the runtime system.
* `java -jar target/ublu.jar` to run Ublu as a plain Java console application.
**Note regarding checking out the current source:** Release versions of Ublu come with a standard release of JTOpen.
Between Ublu releases, I build and sometimes modify JTOpen so that Ublu can leverage forthcoming features of JTOpen.
When you check out the source between releases, it is an intermediate version JTOpen that is checked out with Ublu.
## Goublu console support for Ublu
Ublu's interpreter relies on Java's console support, which is very weak.
So I have coded [Goublu](https://github.com/jwoehr/goublu) in [Go language](https://golang.org/).
Goublu is a console front-end that provides an editable Ublu command line. The go command
`go get -u github.com/jwoehr/goublu`
will fetch the source to your `$GOPATH/src` directory. `cd $GOPATH/src/github.com/jwoehr/goublu; ./make.sh` to build Goublu for your architecture.
## Ublu in a Window
You can start Ublu in a window with the `-w [propsfilepath]` switch.
Report bugs or make feature requests in the [Issue Tracker](https://github.com/jwoehr/ublu/issues)
There is some more information in the [Ublu Wiki](https://github.com/jwoehr/ublu/wiki) including zine article references.
Discuss Ublu in the [IBMiOSS Java forum on Ryver](https://ibmioss.ryver.com/index.html#forums/1057363).
Here is the [IBMiOSS signup page for the free Open Source Software on IBM i organization on Ryver](http://ibm.biz/ibmioss-chat)
that hosts the Java forum.
*_Ublu running native on IBM i_*
## Default Branch Renamed
The default branch has been renamed!
`master` is now named `main`
If you have a local clone, you can update it by running:
```
git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a
```
## Software Bill of Materials
The [Software Bill of Materials (SBOM)](https://docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/exporting-a-software-bill-of-materials-for-your-repository) is `SBOM_ublu_jwoehr_*.json`
Jack Woehr 2023-06-07