OSF

NAME

dspmsg − Displays a selected message from a message catalog

SYNOPSIS

dspmsg catalog_name [-s set_number] 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 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, a system-generated error message is displayed. 

Follow the default message with up to 10 arguments to substitute into the catalog message (or the default message).  Missing arguments for conversion specifications are replaced by null strings. 

EXAMPLES

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

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

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

RELATED INFORMATION

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

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