NAME

dspcat − Displays all or part of a message catalog

SYNOPSIS

dspcat [-g] catalog_name [set_number [message_number]]

The dspcat command, part of the OSF/1 Message Facility, displays a particular message, all of the messages in a set, or all of the messages in a catalog. 

FLAGS

-gFormats the output so that it can be used as input to the gencat command.  You cannot use the message_number argument with the -g flag. 

DESCRIPTION

The catalog_name variable specifies a file containing a message catalog.  If the file 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).) 

The set_number variable specifies a set in the catalog.  The message_number variable specifies a particular message in the set. 

If you include all three arguments, dspcat displays a particular message. If you do not include message_number, all the messages in the set are displayed.  If you specify only catalog_name, all the messages in the catalog are displayed.  If you specify either an invalid message_number or and invalid set_number, an error message is displayed.  You must include set_number if you include message_number. 

EXAMPLES

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

dspcat test.cat 1 2

RELATED INFORMATION

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

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