Product Site

8.31. SysGetMessageX (Unix-like systems only)

Returns a message retrieved from a Unix message catalog, with placeholders replaced with specified message inserts.

SysGetMessageX is implemented on Unix-like systems only.

To create a Unix message catalog use the gencat command.

Parameters:
set

The message set.
num

The message number.
filename

The name of the catalog file containing the message. If filename is omitted or specified as rexx.cat the internal Rexx message catalog is searched. Otherwise the Unix message catalog is located using the absolute filename path or searched along the NLSPATH environment variable.
str

Zero to nine replacement strings for placeholders in the message. The first replacement string is for placeholder &1, the second for &2, up to placeholder &9. If a placeholder has no replacement string specified, it is replaced by the null string. Any unused replacement string is ignored. Other placeholders like %s are not replaced and are returned unchanged with the message.
Example 8.21. RexxUtil — SysGetMessageX
say SysGetMessageX(1, 485, "rexx.cat", "foo") -- Class "foo" not found.