Index for Section 1

Alphabetical listing for D

Bottom of page

dspmsg(1)
NAME
  dspmsg - Displays a selected message from a message catalog

SYNOPSIS
  dspmsg [-s set_number] catalog_name message_number
  ['default_message'[argument...]]

OPTIONS
  -s set_number
      Specifies the set number. By default, the command searches for messages
      in set 1.

OPERANDS
  catalog_name
      Specifies the name of a message catalog. If catalog_name is not in the
      current directory, dspcat searches for it in the set of directories
      specified by the NLSPATH environment variable.  (For more information
      about NLSPATH, see catopen(3).)

  message_number
      Specifies the number of the message.

  'default_message'
      Specifies the message for the command to display if it cannot find a
      message with the specified number in the catalog. You must enclose the
      default message in single quotes if it includes the %n$s notation for
      message inserts.

  argument ...
      Specifies arguments (up to 10) to be inserted in the catalog message or
      default message if it contains notation for inserts. Note that you must
      also specify a default message in order to specify arguments.

DESCRIPTION
  The dspmsg command, part of the Tru64 UNIX Message Facility, displays a
  particular message from a catalog.

  You must specify the message catalog (catalog_name) and the message
  (message_number).

  If dspmsg cannot find the message, the default_message is displayed. If
  dspmsg cannot find the message, and you do not specify a default message,
  dspmsg displays nothing.

  The dspmsg command allows you to pass up to 10 string arguments for
  substitution into the displayed message if it contains either the %s or the
  %n$s printf() conversion specifications.


EXAMPLES
  To display the set number 1, message number 2, of test.cat, enter:


       dspmsg -s 1 test.cat 2 'Message not found'

  If dspmsg does not find a message number 2 in set number 1 of test.cat, the
  command displays Message not found.

SEE ALSO
  Commands:  dspcat(1), gencat(1), mkcatdefs(1)

  Functions:  catclose(3), catgets(3), catopen(3)

Index for Section 1

Alphabetical listing for D

Top of page