8.30. SysGetMessage (Unix-like systems only)

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

SysGetMessage is implemented on Unix-like systems only. It always retrieves messages from the catalog's message set 1. To retrieve messages from a specified message set, use SysGetMessageX (Unix-like systems only).

To create a Unix message catalog use the gencat command.

Parameters:

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.20. RexxUtil — SysGetMessage

say SysGetMessage(485, "rexx.cat", "foo") -- Class "foo" not found.