HP-UX Reference (11i v3 07/02) - 1 User Commands A-M (vol 1)

m
mkcatdefs(1) mkcatdefs(1)
Note that mkcatdefs also created the symbol MF_SYMB by prepending MF_ to catname using uppercase
letters. The
mkcatdefs command assumes that the name of the generated catalog should be
catname.cat, and generates this symbol for your use with the
catopen function.
Because this include file contains include statements for limits.h and nl_types.h, you do not need to expli-
citly include these files in your application program. (The nl_types.h header file defines special data types
required by the message facility routines.)
The following set of examples shows how to enable and use symbolic identifiers for sets, messages, and
default message strings. The message source file PFF.src used for this set of examples contains the follow-
ing lines:
$quote "
$set INFO
GREET "Welcome to the Fact Finder program!\n"
BYE "Good-bye. Please come again.\n"
ENTER "Please enter the type of product \
you are interested in: "
$set RESULTS
NADA "Sorry, we have no information on that \
kind of product.\n"
FOUND "The following products were found: "
$set PROBLEMS
SERVCONN "Cannot connect to server. Try again later.\n"
BUSYDAY "Still searching. Please wait...\n"
The following command creates a message catalog that includes a .sh file that can be executed in a POSIX,
Bourne, or Korn shell script to define symbolic identifiers for default message strings:
% mkcatdefs -h -m -e sh PFF PFF.src | gencat PFF.cat -
mkcatdefs: PFF_msg.h is created.
mkcatdefs: PFF_msg.sh is created.
The following command creates an include file for use in program source code, as well as a copy of the
preprocessed source code that was input directly to the gencat command in the preceding example:
% mkcatdefs -m -e h PFF PFF.src > PFF.msg
mkcatdefs: PFF_msg.h is created
The following cat and dspcat commands show what is included in the .sh, .h, and message catalog files
created from these commands:
% cat PFF_msg.sh
#
# Default messages generated from PFF.src
#
DEF_GREET=’Welcome to the Product Fact Finder program!\n’
DEF_BYE=’Good-bye. Please come again.\n’
DEF_ENTER=’Please enter the type of product you are interested in: ’
DEF_NADA=’Sorry, we have no information on that kind of product.\n’
DEF_FOUND=’The following products were found: ’
DEF_SERVCONN=’Cannot connect to server. Try again later.\n’
DEF_BUSYDAY=’Still searching. Please wait...\n’
% cat PFF_msg.h
#ifndef _H_PFF_MSG
#define _H_PFF_MSG
#include <limits.h>
#include <nl_types.h>
#define MF_PFF "PFF"
/* The following was generated from PFF.src. */
/* definitions for set INFO */
#define INFO 1
HP-UX 11i Version 3: February 2007 − 4 − Hewlett-Packard Company 659