runcat - Pipe output from mkcatdefs to gencat

Format

runcat CatalogName SourceFile [CatalogFile]

Description

runcat invokes the mkcatdefs command and pipes the message catalog source data (the output from mkcatdefs) to the gencat utility.

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 .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). SourceFile cannot be stdin.

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 filename can also be used in the catopen subroutine.

Examples

To generate a catalog named test.cat from the message source file test.msg, enter:
runcat test test.msg

Related information

dspcat, dspmsg, gencat, mkcatdefs