8.33. SysGetMessage (Unix only)


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

Retrieves a message from a catalog file and replaces the placeholder %s with the text you specify. SysGetMessage can replace up to 9 placeholders.

This utility is implemented for Unix only.

To create catalog files, consult your system documentation.

Parameters:

num: The message number.
filename: The name of the catalog file containing the message. The default message catalog is rexx.cat. SysGetMessage 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 8.18. RexxUtil - SysGetmessage


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