PPWIZARD is a free preprocessor for HTML, REXX, Visual Basic or any text files.
[Bottom][Contents][Search][Prev]: Rexx Fragments - Kick Start[Next]: Add2()
\ -> Rexx -> Inbuilt PPWIZARD Functions


Any of these PPWIZARD routines may be used by your rexx code:


On PPWIZARD's download page there are many external add-ons which are frequently more powerful than anything I might wish inbuilt into PPWIZARD (such as the sort download) so do not forget to check there if you are after something specific. I do not like to add to the above list of internal functions and will only do so when there is a good reason.

Note that I do not always document return codes in the functions listed above if I do not believe that they will be useful to you.

Rexx has two different ways of calling a function depending on whether or not you wish to process any return code.

The following demonstrates the syntax that should be used when you need the return code:

   ;--- Put return code into the rexx variable "FuncRc" ---
   FunctRc = RexxFunction(parm1, parm2)     ;;Pass 2 parameters

   ;--- Display value -------------------------------------
   call Say 'RC = ' || RexxFunction(parm1)  ;;Pass 1 parameter

The following demonstrates the syntax that should be used when you don't need the return code:

   ;--- Place return code into an unused variable name ---
   Dummy = RexxFunction(parm1, parm2)       ;;Not valid if function does not return a return code

   ;--- Alternate call syntax ----------------------------
   call RexxFunction parm1, parm2           ;;Always valid

The following code does not correctly call AddTempFileToDependancyList():

#evaluate '' ^AddTempFileToDependancyList('NUL')^

As a result of the incorrect call syntax, rexx passed the return code to the operating system for execution. The operating system then displayed (in OS/2):

SYS1041: The name Y is not recognized as an
internal or external command, operable program or batch file.

Note that the results may not always be so obvious, for example in OS/2 it may complain about running out of memory or things may simply run slower.

email me  any feedback, additional information or corrections.
See this page online (look for updates)

[Top][Contents][Search][Prev]: Rexx Fragments - Kick Start[Next]: Add2()

My whole website and this manual itself was developed using PPWIZARD (free preprocessor written by Dennis Bareis)
Saturday May 28 2022 at 2:55pm