Pipes output data from the mkcatdefs command to the gencat command.
runcat CatalogName SourceFile [ CatalogFile ]
The runcat command invokes the mkcatdefs command and pipes the message catalog source data (the output from mkcatdefs) to the gencat program.
The file specified by the SourceFile parameter contains the message text with your symbolic identifiers. The mkcatdefs program uses the CatalogName parameter to generate the name of the symbolic definition file by adding _msg.h to the end of the CatalogName value, and to generate the symbolic name for the catalog file by adding MF_ to the beginning of the CatalogName value. The definition file must be included in your application program. The symbolic name for the catalog file can be used in the library functions (such as the catopen subroutine).
The CatalogFile parameter is the name of the catalog file created by the gencat command. If you do not specify this parameter, the gencat command names the catalog file by adding .cat to the end of the CatalogName value. This file name can also be used in the catopen library function.
To generate a catalog named test.cat from the message source file test.msg, enter:
runcat test test.msg
| /usr/bin/runcat | Contains the runcat command. |
The dspcat command, dspmsg command, gencat command, mkcatdefs command.
The catclose subroutine, catgets subroutine, catopen subroutine.
Message Facility Overview for System Management in AIX 5L Version 5.1 System Management Guide: Operating System and Devices.