iecho(1)                                                           iecho(1)

NAME
     iecho - echo message from message catalog

SYNOPSIS
     iecho [-n] [[catalog] set-number] message-number default-text

DESCRIPTION
     iecho writes a message to standard output, by default appending a new-
     line character.

OPTIONS
     -n   By default a newline character is appended to the message text.
          The -n option suppresses this newline character.

     catalog
          The message catalog to be searched. If catalog is not specified,
          iecho tries to use the value of the NLCATD environment variable.
          If NLCATD is not set, iecho reports an error and exits.

     set-number
          If set-number is not specified, iecho tries to use the value of
          the NLSETNR environment variable. If NLSETNR is not set, iecho
          reports an error and exits.

     message-number
          iecho tries to read the message with the specified message-number
          in the specified set of the specified message catalog. If it
          finds the message, it echos it to standard output. If not, it
          echos the error message default-text and exits.

     default-text
          If iecho fails to find the message, it echos the error message
          default-text and exits. iecho can only process one text argument
          at a time.

EXIT STATUS
     0  on success

     1  on error

ENVIRONMENT VARIABLES
     NLCATD
          Defines the name of the message catalog

     NLSETNR
          Defines the number of the message set

LOCALE
     The LCMESSAGES environment variable governs the language in which mes-
     sage texts are displayed. If LCMESSAGES is undefined or is defined as
     the null string, it defaults to the value of LANG. If LANG is likewise
     undefined or null, the system acts as if it were not internationalized.



Page 1                       Reliant UNIX 5.44                Printed 11/98

iecho(1)                                                           iecho(1)

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.

EXAMPLES
     You need to internationalize the following output:

     $ echo Hi $USER, the latest recipes are in $PATH !

     Proceed as follows:

     $ NLCATD=foo; NLSETNR=2; export NLCATD NLSETNR

     $ iecho -n l "Hi "

     $ echo -n $USER

     $ iecho -n 2 ", the latest recipes are in "

     $ echo $PATH !

SEE ALSO
     iput(1).

     Programmer's Guide, Internationalization - Localization.





























Page 2                       Reliant UNIX 5.44                Printed 11/98