NAME

dspmsg − Displays a selected message from a message catalog

SYNOPSIS

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

The dspmsg command, part of the OSF/1 Message Facility, displays a particular message from a catalog. 

FLAGS

-s set_numberSpecifies a set number other than 1. 

DESCRIPTION

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

You must specify the message catalog (catalog_name) and the message (message_number).  The default set number is 1. Specify another set by using the -s flag followed by the set number. 

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).) 

If dspmsg cannot find the message, the default_message is displayed. You must enclose the default message in single quotes if using the %n$s notation for message inserts.  If dspmsg cannot find the message, and you do not specify a default message, dspmsg displays nothing. 

Follow the default message with up to 10 arguments to substitute into the catalog message (or the default message). 

EXAMPLES

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

dspmsg -s 1 test.cat 2 ’message not found’

If you have not assigned a message, the default Message not found is displayed. 

RELATED INFORMATION

Commands:  dspcat(1), gencat(1), mkcatdefs(1). 

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