gencat - Generate a formatted message catalog

gencat [-C ccsid] [-m mode ] [-t text] catfile msgfile ...

Description

The gencat utility generates a formatted message catalog catfile from the message text source file msgfile. You can specify up to 300 message text source files. Message text source files are processed in the sequence specified. Each successive source file modifies the catalog. If a message number in the source file already exists in the message catalog, the new message text defined in the source file replaces the old message text in the message catalog file. If a message number in the source file does not already exist in the message catalog, the message information is added to the message catalog.

Options

-C ccsid

Create the message catalog and store the message text in the specified ccsid.

-m mode

Set the file permission bits of the message catalog to the specified mode. The mode argument can be in any of the formats supported by the chmod command. If a symbolic mode is specified, the operation characters + and - are interpreted relative to an initial mode of "a=rw".

-t text

Assign the specified text to the message catalog object. Assigning text to objects is dependent on the support provided by the file system or object type used for the message catalog.

Operands

The catfile operand specifies the path to the message catalog to be changed or created. If the -m option is not specified, the message catalog is created using a default mode that allows read and write permission for the owner, group, and others (0666) as modified by the current file creation mask.

Each msgfile specifies the path to an input message text source file. There is a limit of 300 message text source files.

Exit Status

• 0 when successful
• >0 when unsuccessful

Related information

• dspmsg - Display message from a message catalog

Examples

1. Create a message catalog using one message text source file.

   gencat product.cat msg.src
   

2. Create a message catalog using multiple message text source files.

   gencat product.cat msg1.src msg2.src msg3.src
   

3. Create a message catalog and set the mode and ccsid.

   gencat -C 37 -m a-w product.cat msg.src