Open System Services Shell and Utilities Reference Manual (G06.25+, H06.03+)

User Commands (p - r) runcat(1)
NAME
runcat - Invokes the mkcatdefs utility and pipes the resulting message-catalog source data to the
gencat utility
SYNOPSIS
runcat catalog_name source_file catalogfile
FLAGS
Operands
catalog_name is the name of the message catalog to be used by the mkcatdefs utility to gen-
erate the name of the symbolic definition file.
source_file identifies the message text containing symbolic identifiers.
catalogfile is the name of the catalog file to be created by the gencat utility.
DESCRIPTION
The runcat utility invokes the mkcatdefs utility and pipes the resulting message-catalog source
data to the gencat utility.
source_file contains the message text containing symbolic identifiers. The mkcatdefs utility
uses the catalog_name argument to generate the name of the symbolic definition file by adding
_msg.h to the end of the catalog_name value. mkcatdefs also uses the catalog_name value to
generate the symbolic name for the catalog file by adding MF_ to the beginning of the
catalog_name value.
The symbolic definition file must be included in your application. The symbolic name for the
catalog file can be used in library functions such as the catopen function. The catalogfile argu-
ment is the name of the catalog file created by the gencat utility. If you do not specify this argu-
ment, the gencat utility appends .cat to the end of the catalog_name value. This filename can
also be used in the catopen library function.
EXAMPLES
To generate a catalog named test.cat from a message source file named test.msg,enter:
runcat test test.msg
DIAGNOSTICS
The runcat utility generates these error messages:
Usage: runcat catname srcfile [catfile]\n
Can´t open \%s\n
RELATED INFORMATION
Commands: gencat(1), mkcatdefs(1).
STANDARDS CONFORMANCE
The runcat() utility is an extension to the XPG4 specification.
527188-003 Hewlett-Packard Company 7−63