dspmsg.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

dspmsg(1) dspmsg(1)

NAME

dspmsg - display a selected message from a message catalog

SYNOPSIS

dspmsg [-e | -E][-s

set_number ] catalog_name message_number [’default_string’[argument ...

]]

DESCRIPTION

The

dspmsg command displays a particular message from a message catalog. The display may include a

message identiﬁer, depending on the presence of the

-e or -E option and settings for the

CAT_MIDSET_catname, CAT_MIDSET, and CAT_MIDFMT environment variables. A message identiﬁer

consists of one of more of the following items: the catalog name, the set number, and the message

number. See the subsection Displaying Message Identiﬁers with Messages below for more information

about these environment variables.

Options

The

dspmsg command recognizes the following options:

-e Speciﬁes that message identiﬁers be displayed along with message strings, but only

for those message sets speciﬁed by the

CAT_MIDSET_catname or CAT_MIDSET

environment variables.

You can override the default format of the message identiﬁer by deﬁning the

CAT_MIDFMT_catname or CAT_MIDFMT environment variable. See the subsection

Using the CAT_MIDFMT* Environment Variables for more information.

-E Speciﬁes that the message identiﬁer is displayed for messages in all message sets

under control of the CAT_MIDFMT environment variable. If you use this option, the

CAT_MIDSET* environment variables have no effect. However, you must explicitly

deﬁne one of the CAT_MIDFMT* environment variables to display the message

identiﬁers. When you use this option, if the message catalog is not found and the

default_string argument is omitted, the message identiﬁer is displayed by itself.

For example, /du/3/2: will be displayed if the catalog_name is du and the

message_number is 2

and the set_number is 3.

-s Speciﬁes the set number. If not speciﬁed, dspmsg searches for messages in the

ﬁrst message set.

Operands

The

dspmsg command recognizes the following operands:

catalog_name Speciﬁes the name of a message catalog. By default

dspmsg searches for the cata-

then in the current directory. The NLSPATH search can be disabled by preﬁxing a

path name to the catalog. For more information about NLSPATH, see environ (5).

message_number

Speciﬁes the message number in the speciﬁed set.

If the

-s option is omitted, dspmsg only searches for the message in the ﬁrst mes-

sage set in the catalog.

default_string Speciﬁes the message for the command to display if

dspmsg cannot ﬁnd a message

with the speciﬁed number in the catalog. If the message includes the %n$s nota-

tion for message inserts, either enclose the default message in single quotes or

escape the $ character in the insertion notation (%n\$s).

argument ... Speciﬁes arguments (up to 10) to be inserted in the catalog message or default mes-

sage if it contains either the

%s or the %n$s printf() conversion speciﬁcations.

You must include the default_string argument in order to specify message insertion

arguments.

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

specify the message set (set_number ) if the catalog has more than one message set and the speciﬁed mes-

sage is not in the ﬁrst set.

The

dspmsg command displays the default_string value if the speciﬁed message is not found in the cata-

log or the catalog cannot be found or opened. Usually default_string is identical to the message in the

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
dspmsg(1) dspmsg(1) NAME dspmsg - display a selected message from a message catalog SYNOPSIS dspmsg [-e | -E] [-s set_number ] catalog_name message_number [’default_string’ [argument ... ]] DESCRIPTION The dspmsg command displays a particular message from a message catalog. The display may include a message identifier, depending on the presence of the -e or -E option and settings for the CAT_MIDSET_catname, CAT_MIDSET, and CAT_MIDFMT environment variables.
PAGE 2
dspmsg(1) dspmsg(1) catalog, except for the language in which the text is printed. If you do not specify default_string, dspmsg displays nothing if the message cannot be retrieved from the catalog. The following example displays message number 2 in set 3 of test.cat: dspmsg -s 3 store.cat 2 ’Sorry, that item is no longer in stock.’ If dspmsg does not find the specified message in the catalog or cannot find or open the catalog, it displays the string "Sorry, that item is no longer in stock.
PAGE 3
dspmsg(1) dspmsg(1) The following subsections discuss the CAT_MIDSET* and CAT_MIDFMT* environment variables in more detail. Using the CAT_MIDSET* Environment Variables The CAT_MIDSET_catname and CAT_MIDSET environment variables are used to control how to activate the message identifier feature. You can use them to specify a space-separated list of numeric identifiers for the sets containing messages that will be displayed with message identifiers.
PAGE 4
dspmsg(1) dspmsg(1) EXTERNAL INFLUENCES Environment Variables LANG provides a default value for the internationalization variables that are unset or null. If LANG is unset or null, it defaults to C (see lang (5)). LC_ALL, when set to a non-empty string value, overrides the values of all other internationalization variables. LC_MESSAGES determines the language in which messages are displayed. NLSPATH determines the path to be used for searching the specified message catalog file.