HP 9000 User Manual page 110

Programming for Messages
The programming tools for messaging are:
• The findmsg command extracts messages from a C program source file and
writes them to the standard output in a format suitable for input to gencat.
• The dumpmsg command extracts messages from a message catalog file created
by gencat. The messages are written to standard output in a format suitable
for editing and re-input to gencat.
• gencat(l); gencat produces a message catalog from message text source files.
• The catopen function, which locates a named message catalog and prepares
it for use by catgets and cat close.
• The catgets function, which retrieves messages from a message catalog
opened by a call to catopen.
• The cat close function, which closes a message catalog opened by catopen.
Opening a Message Catalog with catopen
catopen opens a message catalog for reading and returns a catalog descriptor
of type nl_catd. (Include nl _types.h at the beginning of your program to
use this type.) Call catopen by:
cat open (" name", oflag)
where:
name
oflag
is a file name enclosed in quotes, indicating the name of the
catalog to open.
is reserved for future use and should be set to
o.
• catopen returns a message catalog descriptor if successful.
• Otherwise, a value of (nl_cat) -1 is returned.
The Message Catalog System 7-3
7