Open Object Rexx™: Reference
Prev	Chapter 8. Rexx Utilities (RexxUtil)	Next

SysGetMessageX (Unix only)

>>-SysGetMessageX(set,num--+-------------------------------+--)-><
                           +--,--filename--+---------------+
                           |               |  +---------+  |
                           |               |  V         |  |
                           |               +----,--str--+--+
                           |   +---------+                 |
                           |   V         |                 |
                           +-----,--str--+-----------------+

Retrieves a message from a specific set of Unix catalog file and replaces the placeholder %s with the text you specify. SysGetMessageX can replace up to 9 placeholders.

This utility is implemented for Unix only. Do not use it for platform-independent programs.

To create catalog files, consult your system documentation.

Parameters:

set: The message set.
num: The message number.
filename: The name of the catalog file containing the message. The default message catalog is rexx.cat. SysGetMessageX searches along the NLSPATH or uses the absolute path name.
str: The test for a placeholder (%) in the message. The message can contain up to 9 placeholders. You must specify as many strings as there are placeholders in the message.

Example:

/* sample code segment using SysGetMessage */
msg = SysGetMessageX(1, 485, "rexx.cat", foo)
say msg
/*** Output ***/
Class "foo" not found.