
ORexxG.cmd User's Guide v0.1			               18 Feb 2022
============================

ORexxG.cmd is a 4OS2 script that prepares a session to run Dmitry
Stenkenov's (Glassman) Object REXX v5 port.  ORexxG.cmd allows Object REXX
scripts to be run on a system that defaults to Classic REXX or Object
REXX without rebooting.

Dmitry's home page is https://www.5nets.ru and distributions of the Object
REXX port can be found at:

  https://www.5nets.ru/downloads/oorexx/

Installation
============

Install the script in a directory of your choice.  You should probably
install it to a directory in the PATH.

Copy the Object REXX binaries the the directory named by the REXXDIR variable
or edit the script to match your setup.

Usage
=====

ORexxG.cmd can be run with or without arguments.

When run without arguments, the script creates a session set up to run
Object REXX and sets the prompt to report the REXX mode.  The prompt should
indicate OBJREXX 6.05.  Type "exit" without quotes to terminate the session.
If the prompt does not indicate OBJREXX 6.05, the setup failed.  Please
request help.

When run with arguments, the script creates an Object REXX session; passes
the arguments to the session for execution and terminates the session after
the commands are executed.

The command line syntax is

  ORexxG [-h] [-v] [-?] [args...]

    -h -?   Display this message
    -v      Be more verbose

the argument options are:

    args... Optional command line passed to Object REXX session

Switches must begin with a dash (-) and are case-insensitive.

Notes
=====

The script uses LIBPATHSTRICT and BEGINLIBPATH.  Some applications may
refuse to run correctly in a session that defines these settings.  Some
applications may override these settings.  This may result in Classic REXX
being invoked.

License
=======

This program is free software licensed under the terms of the GNU General
Public License.  The GPL Software License can be found in gnugpl2.txt or at
http://www.gnu.org/licenses/licenses.html#GPL

Warranty
========

EXCEPT AS OTHERWISE RESTRICTED BY LAW, THIS WORK IS PROVIDED WITHOUT ANY
EXPRESSED OR IMPLIED WARRANTIES OF ANY KIND, INCLUDING BUT NOT LIMITED TO,
ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY
OR TITLE.  EXCEPT AS OTHERWISE PROVIDED BY LAW, NO AUTHOR, COPYRIGHT HOLDER
OR LICENSOR SHALL BE LIABLE TO YOU FOR DAMAGES OF ANY KIND, EVEN IF THEY
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

ToDo
====

Convert script to REXX, if possible.

Support
=======

Please address support questions and enhancement requests to:

  Steven H. Levine
  steve53@earthlink.net
