

ObjectRexx.cmd User's Guide v0.3			        6 Dec 2021
================================

ObjectRexx.cmd is a 4OS2 script that prepares a session to run Object REXX.  
ObjectRexx.cmd allows Object REXX scripts to be run on a system that 
defaults to Classic REXX without running SwitchRx.cmd and rebooting.

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

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

Usage
=====

ObjectRexx.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.  Type "exit" without quotes to terminate the session.  If 
the prompt does not indicate OBJREXX, 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

  ObjectRexx [-h] [args...]

	-h       Display help

the argument options are:

	args...	 Optional command line

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
