8.34. 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 8.19. RexxUtil - SysGetmessagex


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