ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahz_5.4.0.1/gencat.htm

112 lines
3.4 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8">
<title>gencat - Generate a formatted message catalog</title>
<LINK rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</HEAD>
<body bgcolor="#FFFFFF">
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h2>gencat - Generate a formatted message catalog</h2>
<strong>Synopsis</strong>
<p><strong>gencat [-C</strong> <em>ccsid</em><strong>] [-m</strong> <em>mode</em>
<strong>] [-t</strong> <em>text</em><strong>]</strong> <em>catfile msgfile</em> ...</p>
<p><strong>Description</strong></p>
<p>The <strong>gencat</strong> utility generates a formatted message catalog
<em>catfile</em> from the message text source file <em>msgfile</em>. 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.</p>
<p><strong>Options</strong></p>
<dl>
<dt><strong>-C</strong> <em>ccsid</em></dt>
<dd>Create the message catalog and store the message text in the specified <em>ccsid</em>.</dd>
<dt><strong>-m</strong> <em>mode</em></dt>
<dd>Set the file permission bits of the message catalog to
the specified <em>mode</em>. The mode argument can be in any of the
formats supported by the <a href="chmod.htm">chmod</a> command. If
a symbolic mode is specified, the operation characters + and - are
interpreted relative to an initial mode of "a=rw".</dd>
<dt><strong>-t</strong> <em>text</em></dt>
<dd>Assign the specified <em>text</em> 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.</dd>
</dl>
<p><strong>Operands</strong></p>
<p>The <em>catfile</em> operand specifies the path to the message catalog to
be changed or created. If the <strong>-m</strong> 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.</p>
<p>Each <em>msgfile</em> specifies the path to an input message text source file.
There is a limit of 300 message text source files.</p>
<p><strong>Exit Status</strong></p>
<ul>
<li>0 when successful</li>
<li>&gt;0 when unsuccessful</li>
</ul>
<p><strong>Related information</strong></p>
<ul>
<li><a href="dspmsg.htm">dspmsg - Display message from a message catalog</a></li>
</ul>
<p><strong>Examples</strong></p>
<ol>
<li>Create a message catalog using one message text source file.
<pre>
gencat product.cat msg.src
</pre>
</li>
<li>Create a message catalog using multiple message text source files.
<pre>
gencat product.cat msg1.src msg2.src msg3.src
</pre>
</li>
<li>Create a message catalog and set the mode and ccsid.
<pre>
gencat -C 37 -m a-w product.cat msg.src
</pre>
</li>
</ol>
</body>
</html>