View source for REXX Tips & Tricks:Additional Software for REXX

==Development & Debugging Tools==
This sections contains information about additional usefuls tools for developing REXX programs.

===Samples & skeletons===
====Skeleton - a REXX program skeleton====
{{RTT |Name=SKELETON
|Version=1.0, 03.08.1995
|Author=Bob Rice (Empirical Heuristics)
|Distrib=Shareware, $0 fee
|Type=REXX programs
|Source=SKELETON.*
}}
Description from the author:

"Extremely simple to use, the REXX Skeleton provides: display or extraction of embedded help code, automatic external function registration, automatic initialization of useful "global" variables, automatic trapping of REXX execution time events and errors with dump file generation containing variables and queues, and debug assistance. Needs only the standard OS/2 REXX but has more function with REXXLIB. Great for beginning REXX programmers as well as more advanced programmers. This is Zero-cost Shareware uploaded by the author, Bob Rice."

Note: see also ''Template for a REXX program''

===Preprocessors & Formatting tools===
====PPWIZARD - a pre-processor====
{{RTT |Name=[[PPWizard]] - a generic pre-processor
|Version=03.059
|Author=[[Dennis Bareis]]
|Distrib=Freeware
|Type=EXE
|Source=ppwos2.*
}}
Description from the author:

"This is a generic processor (for any text files) with specific support built in for rexx and html files.

When used with the "/rexx" switch it will by default remove comments and pack rexx code and then perform a syntax check.

You have access to instructions such as #define, #evaluate, #include, #if and #ifdef. You can develop macros that take both optional and mandatory parameters and the macros can conditionally generate output.

The program is extendable through rexx. Commands such as #if tests can be very complex, for example it would be relatively simple to compare environment variables or contents of files etc.

The html capability of this program is the basis of a series of e-Zine! articles (3 so far). Its use for rexx development would have to be at least as important. AWE def files are being developed using PPWIZARD macros and I generate PPWIZARD itself plus the extensive PPWIZARD INF and HTML documentation using PPWIZARD macros."

====MakeREXX - a pre-processor for REXX====
{{RTT |Name=MAKEREXX - pre-processor for REXX
|Version=10/92
|Author=Tony Thigpen
|Distrib=Freeware
|Type=REXX program
|Source=MAKEREXX.*
}}
Description from the author:

"MAKEREXX is a utility that allows a REXX programmer to create a library of generic routines. Those routines are maintained in a subdirectory named 'XXX' and must have a file suffix of '.XXX'. The REXX code produced by MAKEREXX is placed in a subdirectory of '.CMD' and will have a suffix of either '.CMD' or '.ERX'. '.CMD' files are OS/2 REXX routines while the '.ERX' files are EPM editor REXX routines. Mainline REXX routines are maintained in a subdirectory named 'REX' and must have a file suffix of either '.REX' or '.EPM'. '.REX' routines will be expanded into '.CMD' routines while '.EPM' routines will be expanded into '.ERX' routines."

====PrepProc - pre-processor for REXX====
{{RTT |Name=PREPPROC - pre-processor for REXX
|Version=2.00
|Author=Hilbert Computing ([[Gary Murphy]])
|Distrib=Freeware
|Type=REXX program
|Source=PREPRC.*
}}
PrepProc is a simple pre-processor for REXX programs written in REXX. Supported directives in this version are #define, #ifdef, #ifndef and #include.

====RxPrep - REXX pre-processor====
{{RTT |Name=RXPREP
|Version=1.8, 24.11.1993
|Author=Richard Moore
|Distrib=Freeware, DAP Software
|Type=REXX program
|Source=RxPREP.*
}}
This is another pre-processor for REXX programs written in REXX.

RXPREP is only available for DAP members.

====REXX Toolbox and pre-processor====
{{RTT |Name=REXX Toolbox and Preprozessor
|Version=1.1 1995
|Author=Jörg Burdorf
|Distrib=Shareware
|Type=REXX DLL
|Price=20,- DM
|Source=FASTREXX.*
}}
Note: All docs are in German!

FASTREXX is mainly a pre-processor for REXX programs. Also included are various REXX procedures.

====RCF - REXX Code Formatter/2====
{{RTT |Name=RCF - REXX Code Formatter/2
|Version=Release 1.2.9
|Author=RKE Consulting, Inc.
|Distrib=Shareware
|Type=VisPro REXX Executable
|Price=$15
|Source=rcf2102j.*
}}
Description from the author:

REXX Code Formatter/2 Description

The REXX Code Formatter/2 (RCF/2) is an OS/2 REXX application written using VisPro/REXX and VisPro/Reports. It is designed to allow a REXX programmer to format a program in a particular style, insuring that the format of each element of the REXX program conforms to that style.

Features of REXX Code Formatter/2

Using this product, users may, for example:
* Define the indentation to be used in general plus the amount for:
**Program statements subordinate to DO and SELECT,
**Statements that begin with THEN/ELSE, and
**Continued statements. 
* Specify whether:
** Lines are to be split at semicolons,
** Redundant spaces are to be removed from program statements,
** New lines are to start before or after THEN/ELSE keywords, and
** END statements are to be indented to align with the corresponding DO/SELECT subordinate statements. 
*Specify the formatting for:
** REXX keyword Instructions,
** REXX keywords besides those that begin a REXX keyword instruction,
** Variables names,
** Function names, and
** Labels.
* Define special formatting for selected function names.
* Check for duplicate labels and insure all labels start on a new line.
* Have RCF/2 create a file of label names as they appear in the program
* so that all references to them in the program (and even other programs) will reflect this same format.
* Align full-line, left-hand, and right-hand comments.
* Generate a listing of the formatted program.
In addition, while RCF/2 is not a syntax-checker or code debugger, it does provide some assistance in program development. It can, for example:
* Identify DO and SELECT instructions missing a corresponding END clause,
* Flag comments that are not started but not closed, and
* Highlight literal strings with a missing quote.
New features in Release 1.2.0 are:
* A cross reference facility for labels, variables, and function names.
* Optional formatting notes if undefined function names are found.
* The ability to add "Commented line numbers" to statements.
* Landscape printing formats.
* Right-hand alignment of full-line comments with extension and truncation to allow for "boxing" of comments.
* Specification of file name and directory for generated associated label files.
* Maintenance of multiple generated associated label file data in a single file.
* Separate formatting specification for the standard REXX built-in functions.
* The specification of the file to be edited as a parameter at RCF invocation.
* The extension of the allowable indentation values to be up to 999.
* Placement of the print specification in a separate page to facilitate changing of printer specifications.
* Use of WARP 4 notebook format for configuration settings when using OS/2 WARP 4.

====RexxComm====
{{RTT |Name=RexxComm - Formats comments in REXX program files
|Version=2000-07-16
|Author=Marcus C. de Geus
|Distrib=Freeware
|Type=REXX program
|Source=rexxcomm.*
}}
This program formats comments in REXX program files according to a user-defined option and reports any uncommented program lines.

===Syntax check programs===
====RXCALLLST - show the CALL structure of a program====
{{RTT |Name=RXCALLST
|Version=2017-12-22
|Author=Wilfried Eike
|Distrib=Freeware
|Type=VisPro/REXX EXE
|Source=[http://www.ibe-gmbh.net/download/RXCALLST.ZIP RXCALLST.ZIP]
}}
RXCALLST is a tool to show the CALL structure of REXX programs.

RXCALLLST shows the call structure of a REXX program in a TOP-DOWN-view and a BOTTOM-UP view. It can also detect recursive code and dead code.

(see also [[#Checkfunc - Function analysis of a REXX program]] and [[#Codeanalizer]])

====Checkfunc - Function analysis of a REXX program====
{{RTT |Name=CheckFunc
|Version=1.04 (2004-08-12)
|Author=Toby Thurston
|Distrib=Freeware
|Type=REXX CMD
|Source=[http://hobbes.nmsu.edu/download/pub/os2/dev/rexx/checkfunc104.zip checkfunc104.zip]
}}
Checkfunc is a handy routine to help you develop correct and portable REXX code. It contains a mini-parser for REXX that finds all the function calls in a program and lists them out for you to see. The output listing shows:
* BIFs Used
* Internal functions
* Duplicate (and therefore unreachable) labels
* Rexxutil common functions
* Rexxutil OS/2 only functions
* Rexxutil Windows only functions
* Rexxutil Version 2 functions
* External functions
* External commands
(see also [[#RXCALLLST - show the CALL structure of a program]] and [[#Codeanalizer]])

====CodeAnalyzer====
{{RTT |Name=CodeAnalyzer
|Version=0.07 (2003)
|Author=Doug Rickman
|Distrib=Freeware
|Type=REXX CMD
|Source=[http://hobbes.nmsu.edu/download/pub/os2/dev/rexx/codeanalyzer007.zip codeanalyzer007.zip]
}}
Description from the author:

"CodeAnalyzer is a generic engine for analyzing and formatting REXX code. This is a tool for the REXX programmer who works with large complex programs."

(see also [[#Checkfunc - Function analysis of a REXX program]] and [[#RXCALLLST - show the CALL structure of a program]])

===Debugger===
====RXD - Rexx Debugger====
{{RTT |Name=RxD
|Version=1.4
|Author=[[Patrick J. Mueller]] (IBM)
|Distrib=Freeware, IBM EWS
|Type=REXX Debugger (PM)
|Source=[http://hobbes.nmsu.edu/download/pub/os2/dev/rexx/rxd.zip rxd.zip]
}}
RxD is a very useful debugger for OS/2 REXX programs. RxD supports Breakpoints, single stepping and watch variables. RxD is a PM program.

Note that RXD is an older 16-bit app and, according to the author, there may be some errors or unexpected conditions using it on 32-bit OS/2 (like WARP).

==="Compiler" & Translator===
====Rexx/Wrapper====
{{RTT |Name=REXX/Wrapper
|Version=1.4
|Author=[[Mark Hessling]]
|Distrib=GPL (GNU)
|Type=REXX cmd & more
|Source=rxwrap14.*
}}
Description from the author:

"Rexx/Wrapper is a tool that wraps a Rexx source file, or tokenised code into an executable program. The Rexx source code can be optionally compressed and encoded to ensure that the original Rexx code cannot be viewed (unless you have the original encryption key).

To use Rexx/Wrapper you need two extra bits of software:
#A supported Rexx interpreter
#A supported C compiler
The Rexx interpreter that is linked with the executable must be capable of executing an "instore" Rexx macro via the SAA API.
The Rexx interpreter used to build the executable wrapper can be different from the interpreter used to run the executable program.
If wrapping tokenised code, then the Rexx interpreter that creates the tokenised code, MUST be the same interpreter that runs the tokenised code.

All suppliers of Rexx interpreters provide access to their interpreter via a shared or dynamic library. This means that it is not possible to build a completely stand-alone executable; you will always have to include the shared or dynamic library with the executable built with Rexx/Wrapper.

There is one exception to this rule; Regina. Regina also provides a static library, which means you can link your program with Regina's static library, and you will get a completely stand-alone executable.

There is a catch however with using the Regina static library :-(. The Rexx program that you wrap, cannot dynamically load an external function package. This is because the Regina static library does not (and cannot) support the dynamic loading of external functions. External functions, by their very nature, require the presence of a dynamic or shared library to operate.

Rexx/Wrapper supports all C compilers that support ANSI prototypes. Rexx/Wrapper will not work with older K&R C Compilers.

For a list of the supported C compilers for the current platform, run rexxwrap.cmd with the '-help' switch and see the list below."

see also [[#RxCLS - a REXX 'compiler']], [[#REXXCC - a REXX "compiler"]] and [[#REXX2EXE a REXX "compiler"]]

====REXXCC - a REXX "compiler"====
{{RTT |Name=REXXCC - a REXX "compiler"
|Version=3.22
|Author=[[Bernd Schemmer]]
|Distrib=Freeware
|Type="compiled" REXX program
|Source=RCnnn.*
}}
REXXCC "compiles" an OS/2 REXX program by substituting the source code with any text. This is possible because the OS/2 REXX interpreter stores a tokenized copy of each executed REXX program in the EAs of the program. If you execute an OS/2 REXX program, the OS/2 REXX interpreter first checks, if the tokenized copy in the EAs is still valid and, if so, executes the tokenized copy and ignores the source code.

Beginning with version 3.00 REXXCC can also compress REXX programs (this means: delete all leading and trailing whitespaces, all linefeeds and all comments).

Beginning with version 3.10 REXXCC also contains a REXX program to unpack packed or compressed REXX files.

Beginning with version 3.20 REXXCC also contains a REXX program to use the macro space for creating token images of REXX programs.

REXXCC is a command line program. But there is also a PM front-end for REXXCC called REXXCC/2 in the archive. REXXCC/2 uses Rexx Dialog for the PM interface.

The current version of REXXCC is always available at Hobbes in the same library as RXT&T (see Distribution)

Note: The format of the token image for REXX programs is the same since OS/2 version 2.1. So you can use a REXX program "compiled" with REXXCC on any OS/2 version since 2.1.
But: You can't use a "compiled" REXX program with the new Object-Oriented REXX (see also "Compiling" REXX programs).

see also [[#Rexx/Wrapper]], [[#RxCLS - a REXX 'compiler']] and [[#REXX2EXE a REXX "compiler"]]

====RxCLS - a REXX 'compiler'====
{{RTT |Name=RXCLS - a REXX 'compiler'
|Version=1.0, 1/1996
|Author=Steven Higgins
|Distrib=Shareware
|Type=EXE
|Price=registered version: $10
|Source=RXCLS.*
}}
Description from the author:

"RXCLS is a shareware program which compiles a REXX programs into a stand alone executable. RXCLS is a 32bit program designed to run on OS/2* version 2.x or greater."

Well, the author did not say all: RXCLS does NOT compile REXX programs into machine readable code like other compilers. The only thing it does is: Create the token image of the REXX program and bind it with a little stub together to an EXE file. If called, the stub of the EXE calls the REXX interpreter to execute the included token image.

To verify this you may set the environment variable TRACE to ON and call an EXE 'compiled' by RXCLS.

But nevertheless RXCLS is fine done and useful if you want to hide your REXX source code. And this method does not have any compatibility problems through converting the REXX code, of course.

The advantage of the method used by RXCLS compared to my free REXX "compiler" REXXCC: It avoids the 64 K limit and you don't have problems with the EAs.

see also [[#Rexx/Wrapper]], [[#REXXCC - a REXX "compiler"]] and [[#REXX2EXE a REXX "compiler"]]

====REXX2EXE - a REXX "compiler"====
{{RTT |Name=REXX2EXE - a REXX "compiler"
|Version=98.349
|Author=Dennis Bareis
|Distrib=Freeware
|Type=EXE
|Source=REXX2EXE.*
}}
Description from the author:

"This program will "compile" a rexx program in 2 main ways. It will tokenise the rexx (no 64K limit) or will simply wrap up the source (the default). The default action is to encrypt and compress the resultant image and attach it to an EXE stub. There are all sorts of options to control the stub, for example you can have a runtime DLL or standalone EXE. You can choose to have a compact EXE which will run in Warp onwards or a larger one which will also run in 2.0+. You can generate the stub as a PM program eliminating all the hassle of using 'RxMsgBox'."

see also [[#Rexx/Wrapper]], [[#RxCLS - a REXX 'compiler']] and [[#REXXCC - a REXX "compiler"]]

====Arc====
{{RTT |Name=ARC (Alexander's REXX Cruncher)
|Version=2.00
|Author=[[Alexander Mai]]
|Distrib=Freeware
|Type=REXX cmd
|Source=arc.*
}}
This is a REXX program to "crunch" (remove all not necessary parts) REXX programs

====Rexx2Nrx====
{{RTT |Name=Rexx2Nrx - REXX to NetREXX converter
|Version=2.23
|Author=Thomas Schneider
|Distrib=Freeware
|Type=Java program
|Source=rexx2nrx.*
}}
This program converts Classic REXX programs to NetRexx.

===EXE & DLL tools===
====ExeHdr====
{{RTT |Name=ExeHdr
|Version=
|Author=misc.
|Distrib=
|Type=EXE program
|Source=EXEHDR.*
}}
An ExeHdr tool is also included in the OS/2 Developers Toolkit and in nearly all C/C++ Compiler packages.

An ExeHdr tool shows the names of the functions exported by a DLL. This is useful to get the propper spellings for functions exported by a REXX DLL if the DLL was linked in a case-sensitive manner (see DLL loading failed).

====PMDLL====
{{RTT |Name=PMDLL
|Version=2.12
|Author=Arthur van Beek<br/>maintained by Steven Levine
|Distrib=Freeware
|Type=PM program
|Source=[http://hobbes.nmsu.edu/download/pub/os2/util/system/pmdll-2.12.zip pmdll-2.12.zip]
}}
Description from the author:

"[[PMDLL]] is an OS/2 presentation manager program that shows you the complete tree of DLLs loaded by an OS/2 executable file or by a DLL (both 16 and 32 bit formats are supported). Sometimes it's uncertain why a program won't start (correctly) or behaves strange when running. When this program is using DLLs one of the causes can be that DLLs can't be found or that DLLs are loaded from unexpected directories which contain an incorrect version of the DLL. PMDLL gives you an easy way to detect these kind of problems."

PMDLL is a very useful tool to detect the further DLLs needed by a REXX DLL (see DLL loading failed).

There is also a command line tool named '''ckkdll32.exe''' from IBM for this purpose.

====LX lite - a compressor for OS/2 executables====
{{RTT |Name=LX lite - a compressor for OS/2 executables
|Version=1.3.3
|Author=Andrew Zabolotny
|Distrib=Freeware
|Type=EXE program
|Source=[http://hobbes.nmsu.edu/download/pub/os2/util/archiver/lxlt133.zip lxlt133.zip]
}}
This is a fantastic program to pack OS/2 executables in Linear Executable (LX) format. OS/2 uses the LX format for .EXE, .DLL, .PDR, .QPR, .DRV, .FON and .SYS files. Virtual Device Drivers (VDDs) for DOS sessions are also in LX format. You can even compress the OS/2 kernel (os2krnl)!
LX compresses the files in the same way as LINK386 does. The decompression algorithm is part of the OS/2 WARP program loader. So files compressed with LX are "simple" OS/2 executables. There's no additional stub program necessary to uncompress the compressed files.

The only drawback of this tool:

You cannot execute compressed executables under OS/2 prior to WARP because the decompression code was first introduced in WARP. But that's no great problem because LxLite can also decompress compressed files again.

Conclusion:

LxLite is one of the most useful tools for OS/2 I've seen so far.

(see ''Using REXX if booted from diskette'' for one use of LxLite)

Another useful tool contained in this package is UNLOCK.EXE:

"unLock is a simple utility which allows to 'unlock' application executables which are currently in use. Normally when an executable is loaded by OS/2 its file is open with a deny-write sharing mode. This is done because LX format structure is designed not to swap out unused pages in executables each time when they aren't needed anymore, but rather to discard them. When a discarded page is needed OS/2 simply reads it again from the executable.
However, there is still a way to replace executables 'on-the-fly' even if they are currently running. There is an so-called 'well-known-undocumented' function (which in fact means that it won't be necessarily supported in future versions of OS/2) which allow to disable sharing protection on such files. Before doing that OS/2 reads entire executable in swap file, then page swapping is done as with usual memory. If you'll 'unlock' many running executables at the same time you can notice an increase in swap file size.
So, this is just an temporary workaround, you have better to reboot after doing all necessary things on former locked files. The command-line format of unLock is much like lxLite's, except that it have much less options :-)"

====lsof - list open files====
{{RTT |Name=lsof - list open files
|Version=07/2000
|Author=Shaun Tancheff
|Distrib=Freeware (?)
|Type=EXE program (w/ source)
|Source=lsof.*
}}
You can use lsof to find out if your REXX program opens files without closing them.

You can also use the program psfiles.exe to get a list of open files (available in Warp 4 Fixpak 13) - but it's not as comfortable as lsof.

====XWorkplace====
{{RTT |Name=XWorkplace
|Version=1.0.0
|Author=[[Ulrich Möller]]
|Distrib=GPL (freeware)
|Type=WPS Extension (DLL)
|Source=xwp.n.m.r.* - where n is the major version; n is the minor version and r is the revision
}}
XWorkplace (or its predecessor XFolder) is not only the best WPS enhancer for OS/2 - it's also a very good tool to examine the internals of the WPS.

XWorplace is a must have for OS/2 users and developers.

====XRay - a PM window peeker====
{{RTT |Name=XRay - a window peeker
|Version=1.0
|Author=[[CodeSmith Software]]
|Distrib=Freeware
|Type=EXE program (w/ source)
|Source=[http://hobbes.nmsu.edu/download/pub/os2/util/wps/xray10.zip xray10.zip]
}}
Xray is an utility to display window info of window under the mouse pointer.

You can use this tool to get the IDs necessary for the new setup string MENUITEMSELECTED in WARP 4.

====PSPM====
{{RTT |Name=psPM - Process Status Presentation Manager
|Version=5.20
|Author=Seth A. Eilbott
|Distrib=IBM internal
|Type=PM program
|Source=PSPM.*
}}
Description from the author:

"PSPM graphically displays the status of all processes running in OS/2. PSPM allows you to display information about any process, including thread information, to terminate a process or an entire process tree, or to switch to a running process."

PSPM (or a similar tool) is necessary if a program using VREXX crashes without calling VEXIT. In this case you must delete the invisible process created by VREXX manually before you can use VREXX in other REXX programs.

===Misc. develop tools===
====ConfigTool====
{{RTT |Name=Configtool
|Version=1.30
|Author=Program: Goran Ivankovic<br/>Database: Klaus Staedtler
|Distrib=Freeware
|Type=Database/INF file
|Source=[http://hobbes.nmsu.edu/download/pub/os2/util/config/cfgtool130.zip cfgtool130.zip]
}}
ConfigTool is AFAIK the best database with various information about the CONFIG.SYS of OS/2. It includes also a tool to check and optimize the CONFIG.SYS.

==WPS Tools==
===DMrxWPS===
{{RTT |Name=DMRxWPS
|Version=08/03/1996
|Author=David MacMahon
|Distrib=Freeware for privat use
|Type=REXX DLL
|Note=for WARP & above only 
|Source=DMXRWPS.*
}}
Description from the author: 

"DMrxWPS.dll is a REXX library that provides a bridge between REXX scripts and some of the WPS related OS/2 API functions, referred to as "Win functions". Its main purpose is to facilitate the installation and the reinstallation or updating of WPS classes. The current version of DMrxWPS supports only three Win functions in addition to its own two "helper functions". One of the Win functions, WinQueryObjectPath, is only available on WARP or above. Calling its corresponding DMrxWPS function, WpsQueryObjectPath, will not work on version of OS/2 before WARP.

Many of the Win functions are available in the RexxUtil REXX library. DMrxWPS is intended to supplement RexxUtil, not replace it. The three Win functions included in DMrxWPS are WpsQueryObject, WpsQueryObjectPath, and WpsSetObjectData. The first two functions were chosen because they can be used together to obtain the path to a WPFileSystem derived template in the Templates folder without knowing the path of the Templates folder itself. This path can then be used to manipulate the template using functions from RexxUtil. The sample script DelTmplt.cmd (included with DMrxWPS and described in section 3) shows how this can be done."

The dll provides the following functions:
*WpsLoadFuncs Make the functions in DMRXWPS.DLL available to REXX. 
*WpsDropFuncs Unload the DLL DMRXWPS.DLL
*WpsQueryObject Get the object handle of an object with an object ID 
*WpsQueryObjectPath Get the path of an object 
*WpsSetObjectData Set the data of an object

===GetObj - Get the data of WPS objects===
{{RTT |Name=GetObj - Get the data of WPS objects
|Version=1.11, 1/97
|Author=Bernd Schemmer
|Distrib=Freeware
|Type=REXX program 
|Source=GBJ111.*
}}
GETOBJ creates a list containing the data for all objects in a folder (and it's sub folder) for example your desktop folder. For each object the title, the class, the setup string and the location is shown.

GETOBJ can also create a REXX program with SysCreateObject calls to recreate the objects.

GETOBJ needs the DLL WPTOOLS.DLL from the WPTOOLS package. This DLL is included in this package.

===RXOD - REXX Object Data===
{{RTT |Name=RXOD REXX Object Data
|Version=1.0, 09.06.1995
|Author=Bruce Eric Högman
|Distrib=Freeware
|Type=REXX DLL & program 
|Source=RXOD.*
}}
Description from the author:

"These external functions extend the ability of OS/2 REXX programmers to handle OS/2 Workplace objects with the following functions:
*Return persistent object handle for an object, given the object's OBJECTID or file system name.
*Return file system name for object given OBJECTID or handle
*Set OBJECTID for an object, given its object handle.
*Return object title given object handle for WPAbstract objects such as program references. (RXODTITL)"

===WPTOOLS===
{{RTT |Name=WPTOOLS
|Version=WPTOOLS package 3.1<br/>WPTOOLS.DLL version 2.12
|Author=Henk Kelder
|Distrib=Freeware
|Type=Tool to repair the OS/2 INI files
|Source=WPTOOL31.*br/>(note: 31 is the version number)
}}
WPTOOLS is a set of programs to (partially) backup and restore a customized WPS, remove obsolete WPS related information from the ini-files, repair some WPS problems, etc.

It is mentioned in this document because it contains a DLL named WPTOOLS.DLL. WPTOOLS.DLL is a dynamic link library that exports some functions to query the settings of WPS objects in REXX:
*WPToolsLoadFuncs Make the functions in WPTOOLS.DLL available to REXX.
*WPToolsQueryObject Query object data
*WPToolsFolderContent Query abstract (non-disk) objects in a specific folder
*WPToolsSetObjectData Change the settings of an object; this functions works with object IDs, file names and object handles.
*WPToolsVersion Query version of WPTOOLS.DLL (DLL version v1.01+)
Note:  See List all associations for an example for using this DLL. You might also download GETOBJ.CMD to get an example for using WPTOOLS.DLL.

===SysSet===
{{RTT |Name=SysSet manage Keyboard, Mouse and System settings with REXX
|Version=1.2 3-6-00
|Author=Paul Ratcliffe
|Distrib=Freeware
|Type=WPS Extension
|Source=SYSSET11.*
}}
Description from the author:

"This program contains an OS/2 WPS class which give the ability to set up systems components such as Keyboard, Mouse and System from a REXX command file."

===ICONRESOURCE===
{{RTT |Name=Demo on how to use ICON(N)RESOURCE properly
|Version=1.00
|Author=Christian Langanke
|Distrib=Freeware w/ source
|Type=REXX DLL
|Source=ICONRESOURCE*.*
}}
This package shows how to properly use the WPS object setting ICON(N)RESOURCE when refering to icons delivered in resource DLLs. It is also taking care for the differences between Warp 3 and Warp 4. The package includes a REXX sample cmd and source for a REXX-DLL, which is required for using ICONRESOURCE under WARP 3.

(see also The keyword ICONRESOURCE)

===ZipShell===
{{RTT |Name=ZipShell
|Version=2.1 for OS/2 (8/1998)
|Author=Martin Vieregg
|Distrib=Freeware 
|Type=REXX CMD/DLL
|Source=ZipShell*.* 
}}
Description from the author:

"A handful tiny batchfiles and WP-objects for handling ZIP- and ARJ-files with the WPS. Content and unpacking of ZIP and ARJ files. Packing ZIP files. With nice icons and REXX programs for installation and deinstallation. Freeware. English and German."

ZipShell is mentioned here because it contains a program called SendMsg.EXE. SendMsg can be used to send windows messages to running PM Programs and open PM folders. E.g. it's possible to use 
 SendMsg Programs WM_CLOSE
to close a folder from the command line.

See ''IDs for the setup string MENUITEMSELECTED'' for a list of possible windows messages.

===CWHelp class===
{{RTT |Name=CWHelp class
|Version=0.1.0 (2002)
|Author=Chris Wohlgemuth
|Distrib=Freeware under BSD license
|Type=WPS DLL
|Source=cwhelp-0_1_0..*
}}
Description from the author:

"WPS class to display help from any program or REXX script without fighting with the OS/2 help system. Use setup strings to display a help panel."

==PM Tools==
* APMT - A PM automation Tool
* [[DrDialog]]
* User control for DrDialog
* [[EVRexx]]
* PMPopup/2
* Rexx Dialog
* [[VREXX]]
* RxTitle
* [[Rexx/Tk]]
* RxMsgBox
* [[REXX/DW]]

==Misc. Tools==

==Application Program Interfaces==

==BBS & Mailboxes==

==CM/2==

==Compressing & Decompressing==

==Database==

==Data Converting==

==Date & Time==
===DsDate - date function===
{{RTT |Name=DsDATE - date function
|Version=9/1995
|Author=Dan Statkus
|Distrib=Freeware
|Type=REXX routine
|Source=DSDATE.*
}}
Description of the author: 

"dsDate provides enhancements to all switches of the DATE() function provided by REXX/2, and also provides additional date switches.

The dsDate function emulates ALL of the switches of the native REXX/2 DATE() function. dsDate() solves the following anamolies of the REXX/2 native function:
#DATE() only returns data concerning the current system date. dsDate() allows you to specify ANY date and obtain the same information using the same optional parameters used by DATE(). If you do not provide a date, then (by default) dsDate() will act on the current system date. See examples.
#DATE() will generate a runtime error if you attempt to use either the 'C' or 'J' switches in native OS/2. Personal Rexx must be available in order for these switches to function. dsDate() solves this problem.
You may use either switch at will.
  
Other switches provided by dsDate() and not native to REXX/2 are:
#dsDate()'s 'T' switch will return a full text string representation of the supplied date; eg. "January 15, 1979".
#DATE() has no native support to validate a date. dsDate() provides the 'V' option to validate a date. This is very useful with data entry applications to ensure data integrity of dates entered by application users. 
#DATE() has no abilities to increment or compare dates. dsDate() provides the 'I' (increment) option to add/subtract to/from a desired date. e.g. Obtain the date of the day 15 days ago or project a date 15 days in the future.
#dsDate() provides the 'P'(Passed) switch to calculate the number of days between any two provided dates. eg. Return the # of days passed between DateParam1 and Dateparam2.
#dsDate() provides the 'Q' (Quarter) switch to calculate the quarter of the calendar year for the given date. Returns integer (1-4).
#dsDate() can return a Gregorian date in US format from a Julian date using the 'G' (Gregorian) switch. This is the counterpart to the 'J' switch of both DATE() and dsDate().
#dsDate() can return an integer representing the week day of any given date using its 'Y' (daY) switch. Unlike the 'W' switch which returns a text label, the 'Y' switch will produce a numeric suitable for calculations."

===RexxDate Function Package for OS/2===
{{RTT |Name=RexxDate Function Package for OS/2
|Version=2.1, 2000
|Author=Barry Pederson
|Distrib=Freeware (?)
|Type=DLL
|Source=[http://hobbes.nmsu.edu/download/pub/os2/dev/rexx/rxdate21.zip rxdate21.zip]
}}
RexxDate is a REXX function package for manipulating calendar dates.

===RxDate - Date function library===
{{RTT |Name=RXDATE - date function library
|Version=1995
|Author=Sublime Software 
|Distrib=Freeware (?)
|Type=REXX routines 
|Source=RXDATE.* 
}}
RxDate is a REXX CMD containing some useful functions for working with dates:
*Weekday
*MonthName
*Dow (= DayOfWeek)
*IsLeap
*DayOfYear
*DaysInYear
*DateDiff

==File & Disk I/O==
===FileREXX - File I/O & IOCTL for REXX===
{{RTT |Name=FileREXX - Datei I/O & IOCTL
|Version=2/95
|Author=Jeff Glatt
|Distrib=Freeware
|Type=REXX DLL
|Source=FILERE.*
}}
Description from the author:

"FILEREXX.DLL is a REXX Function Library. It adds "commands" to the REXX language, which a REXX script (i.e., program) can call. These commands offer alternatives to the REXX file reading/writing routines which make it possible to access the same files from multiple running scripts (i.e., allow file sharing).

FileRexx also makes it much easier to read/write files containing binary values. There are also routines which vastly simplify device (i.e., driver) I/O, and make some driver control possible which standard REXX doesn't allow. Finally, FileRexx offers a lot more parsing options when reading a line, thus eliminating the need to parse a line into separate pieces, or using TRANSLATE to change the case."

FILEREXX provides the following functions:
*FileAddFuncs
*FileDropFuncs
*FileOpen
*FileClose
*FileRead
*FileGets
*FileReadValue
*FileWrite
*FilePuts
*FileWriteValue
*FileSeek
*FileDevIOCtl
*FileGetInfo
*FileDeleteFile
*FileMovefile
*FileCopyFile
*FileMkDir
*FileRmDir
*FileMatchFile
*FileSearchPath
*FileDriveMap
*FileDevInfo
*FileGetPath
*FileEditName
*FileSysInfo
*FileIterateExe
*FileBit
*FileDoSleep

===Read/Write disk sectors===
{{RTT |Name=SECTOR.DLL - read/write disk sectors
|Version=4/94
|Author=Thomas Christinck<br/>Braunschweig, Germany
|Distrib=Freeware 
|Type=REXX DLL 
|Source=SECTOR.*
}}
SECTOR.DLL provides functions to read and write disk sectors:
*qDrive
*ReadSect
*WriteSect

===Display File Systems===
{{RTT |Name=Display File Systems
|Version=2.91
|Author=Jan van Wijk
|Distrib=Freeware 
|Type|EXE with an REXX ADDRESS environment
|Source=DFSnnn.*
}}
Description from the author:

"File-system display & analysis utility. Shows partition-tables and bootsectors. Shows all HPFS internal disk structures like Superblock, Fnodes, Dirblocks etc. Check allocation integrity for volume. Can find any data-sequence on the disk and identify the file it belongs to. Display allocation maps for entire disk and for the directory-band."

DFS has an REXX ADDRESS envrionment thus you can use it from REXX programs.

===Rexx procedures to implement the rsync differencing protocol===
{{RTT |Name=Rexx procedures to implement the rsync differencing protocol
|Version=1.03 (2000-05-15)
|Author=Daniel Hellerstein
|Distrib=Freeware
|Type=DLL /w source
|Source=[http://www.srehttp.org/distrib/RxRsync.zip rxrsync.zip]
}}
RxRsync contains two implementations of the rsync "differencing" protocol - one using a DLL and one in plain REXX.

===EADump===
{{RTT |Name=EADump
|Version=1.0 (Aug 96)
|Author=Dennis Bareis
|Distrib=Freeware
|Type=REXX CMD
|Source=[https://dennisbareis.com/zips_fw/ead94216.zip ead94216.zip]
}}
This is a REXX program to extract all Extended Attributes from a file or directory into a file and convert them to ASCII format. EADUMP.CMD parses the output of the OS/2 program EAUTIL.EXE.

===Touch function for REXX===
{{RTT |Name=Touch function for REXX
|Version=1.0.1 (1995)
|Author=A.S.V. (?)
|Distrib=Freeware (?) w/ source
|Type=REXX DLL
|Source=rx2ut101.*
}}
This DLL contains a function to change the time stamp of a file. The function will only work for dates between 1940 and 1999.

===RexxFile===
{{RTT |Name=File Functions for REXX
|Version=0.2
|Author=Janosch R. Kowalcyk
|Distrib=Freeware w/ source
|Type=REXX DLL
|Source=rexxfile.*
}}
"RexxFile is a small REXX function package (DLL) to show some file attributes and information."

RexxFile exports the following functions:
*RFLoadFuncs initialize RexxFile support
*RFDeregFuncs deregister RexxFile external functions
*RFFuncList show a list of all RexxFile external functions
*RFFileInfo get the full file information record
*RFFileSize get the size of the entire file
*RFEASize get the size of the extended attributes
*RFLastWriteTime get the time when the file was last written
*RFLastWriteDate get the date when the file was last written
*RFLastWrite get the date and time when the file was last written
*RFLastAccessTime get the time when the file was last accessed
*RFLastAccessDate get the date when the file was last accessed
*RFLastAccess get the date and time when the file was last accessed
*RFCreateTime get the time when the file was created
*RFCreateDate get the date when the file was created
*RFCreated get the date and time when the file was created
*RFFileAttrib get the file attributes: AHRS
*RFAuthor show the author information
*RFVersion get the version of this package
*RFCopyright show the copyright information

===Rexx File Utilities (FileUt)===
{{RTT |Name=Rexx File Utilities (FileUt)
|Version=1.0.1
|Author=Patrick TJ McPhee
|Distrib=Freeware w/ source
|Type=REXX DLL
|Source=[http://hobbes.nmsu.edu/download/pub/os2/dev/rexx/rexxfile101.zip rexxfile101.zip]
}}
Description from the author:

"FileUt is a set of functions which provide special kinds of file handling to rexx programs, roughly following the Rexx IO model. It gives functions filelinein, filelineout, filecharin, and filecharout, which work essentially the same way as the standard linein, lineout, charin, and charout functions, except they read and write special kinds of files.

In version 1.0, the library provides access to the standard input and output streams of running processes using pipes. The effect is much like the pipe operator in awk. In the future, it will possibly include access to various file archives and files compressed with gzip. Note that three years after the initial release, I haven't felt the need to do any of this."

The DLL exports the following functions:
*value = filelinein( command[,[line][,[count]][,stream]] )
*count = filelineout (command[,[string][,line]] )
*value = filecharin( command[,[line][,[count]][,stream]] )
*count = filecharout( command[,[string][,line]] )
*handle = fileopen( command, how )
*rc = fileclose( command[,stream] )
*count = filelines( command[, stream] )
Please note that I did not get this DLL to work as of 05/06/2003. I already asked the author about this. He will look into it as soon as possible.

==REXX Interpreter & Tools for DOS==
This section lists all REXX Interpreter & Tools for MS-DOS and PC-DOS.

[[Category:REXX Tips & Tricks]]