dspcat — Display all or part of a message catalog

Format

dspcat [–gt] CatalogName [SetNumber [MessageNumber]]

Description

dspcat displays a particular message, all of the messages in a set, or all of the messages in a catalog. Messages are displayed as they are specified in the message catalog; no substitution of variables takes place.

It directs the messages to standard output (stdout).

It has the following parameters:
  • The CatalogName parameter specifies a message catalog.
  • The SetNumber parameter specifies a set in the catalog specified by the CatalogName parameter. If you specify a nonexistent SetNumber value, all messages in the catalog are displayed.
  • The MessageNumber parameter specifies a particular message in the set specified by the SetNumber parameter.
If you include all three parameters, dspcat displays a particular message. If you do not include the MessageNumber parameter, or if the MessageNumber value is in error, all the messages in the set are displayed. If you specify only the CatalogName parameter, all the messages in the catalog are displayed. You must include the SetNumber parameter if you include the MessageNumber parameter.

Use the NLSPATH environment variable to find the specified message catalog if slash (/) characters are not used in the value of the CatalogName parameter.

Options

–g
Formats the output so it can be used as input to the gencat command. The MessageNumber parameter is not valid when –g is specified.
–t
Displays the timestamp of the message catalog.

Examples

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