[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 2

dspcat Command

Purpose

Displays all or part of a message catalog.

Syntax

To Display Messages in a Catalog

dspcat CatalogName [ SetNumber [ MessageNumber ] ]

To Format Output for the gencat Command

dspcat -g CatalogName [ SetNumber ]

Description

The dspcat command displays a particular message, all the messages in a set, or all the messages in a catalog. The dspcat command directs the messages to standard output.

The CatalogName parameter specifies a message catalog. The SetNumber parameter specifies a set in the catalog specified by the CatalogName parameter. The MessageNumber parameter specifies a particular message in the set specified by the SetNumber parameter. If you include all three parameters, the dspcat command displays the specified message. If you do not include the MessageNumber parameter, the dspcat command displays all the messages in the set. If you specify a nonexistent value for the SetNumber or MessageNumber parameter, the dspcat command displays an error message and returns a nonzero return value. If you specify only the CatalogName parameter, the dspcat command displays all the messages in the catalog. You must include the SetNumber parameter if you include the MessageNumber parameter.

The dspcat command uses the NLSPATH environment variable and the LC_MESSAGES category to find the specified message catalog if you do not use / (slash) characters in the value of the CatalogName parameter.

Flags

-g Formats output to be used as input to the gencat command. The MessageNumber parameter is not valid when you use the -g flag.

Examples

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

dspcat test.cat 1 2

Files

/usr/bin/dspcat Contains the dspcat command.

Related Information

The dspmsg command, gencat command, mkcatdefs command, runcat command.

The catclose subroutine, catgets subroutine, catopen subroutine.

For more information about the Message Facility, see Message Facility Overview for System Management in AIX Version 4.3 System Management Guide: Operating System and Devices.


[ Previous | Next | Contents | Glossary | Home | Search ]