DSPCAT(1,C)                 AIX Commands Reference                  DSPCAT(1,C)



-------------------------------------------------------------------------------
dspcat



PURPOSE

Displays messages from a catalog.

SYNTAX


         +-------------- -g ----- catfile ------------------+
dspcat---|             +----------------+  +-------------+  |---|
         +-- catfile --|                |--|             |--+
                       +-- set-number --+  +-- msg-num --+


DESCRIPTION

The dspcat command displays part or all of the contents of a message catalog.
Use it from the command line to visually verify the contents of a message
catalog.  A separate command, dspmsg (page dspmsg-1), provides the means to
display one message at a time, and is usually run from within a shell script
program.

The dspcat command first searches the directory
/usr/lib/mbcs/msg/language.codeset/ for catfile.  The language.codeset depends
on the current locale.  (The locale may be changed using the LANG environment
variable.)  For example, if the current locale is English, the default search
directory would be /usr/lib/mbcs/msg/En.pc850/.  If catfile is not found in the
default search directory, dspcat searches the current directory for catfile.

The catfile parameter refers to the message catalog being accessed.  If you
specify a set-number, all messages within a set in the catalog are displayed.
The combination of set number and message number displays only the message that
is uniquely identified by the message number residing in the specified set.
The format of the output is as follows:

  set-number:msg-number:text

If both message and set numbers are specified, only the text is displayed as
output.

Note:  Message catalog files are binary files which must be created by the
       gencat command.

FLAGS







Processed November 8, 1990        DSPCAT(1,C)                                 1

DSPCAT(1,C)                 AIX Commands Reference                  DSPCAT(1,C)



-g      Outputs a message text source file using the messages in the specified
        catalog.  If you redirect the output into a file, you can edit the
        messages, and later process them back into a message catalog using the
        gencat command.

EXAMPLE

To display the entire contents of the "mymessages.cat" message file, type:

  dspcat mymessages.cat

The contents of "mymessages.cat" will be displayed on standard output.

RELATED INFORMATION

In this book, see the following commands:  "gencat" and "dspmsg."

See the catopen subroutine in the AIX Technical Reference.

See the "Message Catalog Generation" section of the "International Character
Support" chapter of the AIX Operating System Programming Tools and Interfaces.

See the "Messages" chapter in the AIX MBCS Guide.
































Processed November 8, 1990        DSPCAT(1,C)                                 2