Content-type: text/html Man page of dspmsg

dspmsg

Section: User Commands (1)
Index Return to Main Contents
 

NAME

dspmsg - Displays a selected message from a message catalog  

SYNOPSIS

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


 

OPTIONS

Specifies the set number. By default, the command searches for messages in set 1.
 

OPERANDS

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).) Specifies the number of the 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. 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

NAME
SYNOPSIS
OPTIONS
OPERANDS
DESCRIPTION
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:43:01 GMT, October 02, 2010