104 lines
3.0 KiB
HTML
104 lines
3.0 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>dspmsg - Display message from 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>dspmsg - Display message from message catalog</h2>
|
||
|
|
|
||
|
|
<p><strong>Synopsis</strong></p>
|
||
|
|
|
||
|
|
<p><strong>dspmsg [-n] [-s</strong> <em>set</em><strong>]</strong>
|
||
|
|
<em>catalog msgid</em> <strong>[</strong> <em>defaultMsg</em>
|
||
|
|
<strong>[</strong> <em>arguments</em> ... <strong>] ]</strong></p>
|
||
|
|
|
||
|
|
<p><strong>Description</strong></p>
|
||
|
|
|
||
|
|
<p>The <strong>dspmsg</strong> utility displays a message from a
|
||
|
|
message catalog created by the GENCAT CL command. The message is
|
||
|
|
written to standard output. The <strong>dspmsg</strong> utility can
|
||
|
|
be used as a replacement for <strong>echo</strong> or <strong>
|
||
|
|
print</strong> when a script needs to display messages that are
|
||
|
|
translated to multiple languages.</p>
|
||
|
|
|
||
|
|
<p><strong>Options</strong></p>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><strong>-n</strong></dt>
|
||
|
|
|
||
|
|
<dd>Display the specified message with no substitution.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-s</strong> <em>set</em></dt>
|
||
|
|
|
||
|
|
<dd>Retrieve the message from the specified <em>set</em> in the
|
||
|
|
message catalog. The default value for <em>set</em> is 1.</dd>
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<p><strong>Operands</strong></p>
|
||
|
|
|
||
|
|
<p>The <em>catalog</em> operand specifies the path name to a
|
||
|
|
message catalog. If the catalog is specified using a relative path
|
||
|
|
name, the NLSPATH variable and the LC_MESSAGES locale catagory are
|
||
|
|
used to find the catalog.</p>
|
||
|
|
|
||
|
|
<p>The <em>msgid</em> operand specifies the message identifier to
|
||
|
|
retrieve from the message catalog.</p>
|
||
|
|
|
||
|
|
<p>When the specified <em>catalog</em> or <em>msgid</em> is not
|
||
|
|
found, the optional <em>defaultMsg</em> is displayed instead. If
|
||
|
|
the <em>defaultMsg</em> operand is not specified, a system
|
||
|
|
generated message is displayed.</p>
|
||
|
|
|
||
|
|
<p>The optional <em>arguments</em> are substituted into the output
|
||
|
|
message if it contains the %s, %n$s, %ld, or %n$ld printf()
|
||
|
|
conversion specifications. Any other conversion specifications are
|
||
|
|
not valid. Also, the normal control character escapes (for example,
|
||
|
|
\n) are supported.</p>
|
||
|
|
|
||
|
|
<p><strong>Exit Status</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>0 if successful</li>
|
||
|
|
|
||
|
|
<li>>0 if an error occurred.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Related information</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="echo.htm">echo - Write arguments to standard
|
||
|
|
output</a></li>
|
||
|
|
|
||
|
|
<li><a href="gencat.htm">gencat - Generate a formatted message catalog</a></li>
|
||
|
|
|
||
|
|
<li><a href="print.htm">print - Write output</a></li>
|
||
|
|
|
||
|
|
<li><a href="printf.htm">printf - Write formatted output</a></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<strong>Examples</strong>
|
||
|
|
|
||
|
|
<ol>
|
||
|
|
<li>Display message 5 from catalog mycat.
|
||
|
|
|
||
|
|
<pre>
|
||
|
|
dspmsg mycat 5 "Message not found" hello
|
||
|
|
</pre>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
|
||
|
|
|
||
|
|
<!-- end ibmbody========================================================= -->
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|