Open System Services Shell and Utilities Reference Manual (G06.27+, H06.04+)

User Commands (d - f) dspcat(1)
NAME
dspcat - Displays all or part of a message catalog
SYNOPSIS
dspcat [-g] catalog_name
[set_number [message_number]]
FLAGS
-g formats the output so that it can be used as input to the gencat utility. You can-
not use the message_number operand with the -g flag.
Operands
catalog_name identifies a file containing a message catalog. If you omit this operand, dspcat
searches for the message catalog in the set of directories specified by the
NLSPATH environment variable.
set_number specifies a set in the catalog.
message_number
specifies a message in the set. You cannot use the message_number operand
with the -g flag. You must specify set_number if you specify message_number.
DESCRIPTION
The dspcat utility displays all or part of a message catalog. If you include all three operands,
dspcat displays the specified message. If you do not include message_number, dspcat displays
all the messages in the set. If you specify only catalog_name, dspcat displays all messages in
the catalog. If you specify an invalid message_number or an invalid set_number, dspcatdisplays
an error message.
Environment Variables
These environment variables affect the execution of the dspcat utility: LANG, LC_ALL,
LC_CTYPE, LC_MESSAGES, and NLSPATH.
EXAMPLES
To display message number 2 in set number 1 of test.cat,enter:
dspcat test.cat 1 2
DIAGNOSTICS
The dspcat utility generates these errors:
Usage: dspcat [-g] catname [set#] [msg#]
dspcat: Invalid set number.\n
No message id allowed with -g option.
dspcat: Invalid set number.\n
dspcat: Invalid msg number.\n
Usage: dspcat [-g] catname [set#] [msg#]
Unable to open specified catalog \%d set(s).\n
dspcat: Invalid set - catalog only has \%d set(s).\n
dspcat: Invalid set - set \%d not found.\n
dspcat: Invalid message - message \%d not found.\n
RELATED INFORMATION
Commands: gencat(1), mkcatdefs(1).
527188-004 Hewlett-Packard Company 3−17