ibm-information-center/dist/eclipse/plugins/i5OS.ic.nls_5.4.0.1/rbagsprogrammessagedesign.htm

84 lines
4.7 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Program message design" />
<meta name="abstract" content="A message can be predefined or immediate." />
<meta name="description" content="A message can be predefined or immediate." />
<meta name="DC.Relation" scheme="URI" content="rbagsuseint.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtmsgf.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addmsgd.htm" />
<meta name="DC.Relation" scheme="URI" content="../rbam6/rbam6clmain.htm" />
<meta name="DC.Relation" scheme="URI" content="rbagsccsidmsgsup2.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbagsprogrammessagedesign" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Program message design</title>
</head>
<body id="rbagsprogrammessagedesign"><a name="rbagsprogrammessagedesign"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Program message design</h1>
<div><p>A message can be predefined or immediate.</p>
<p>Consider the following information when you design and
code:</p>
<ul><li>Do not use immediate messages. They are created by the sender or program
at the time they are sent and are not stored in a message file. Therefore,
they cannot be translated by the translator.</li>
<li>Use predefined message descriptions that can both: <ul><li>Exist outside of the program that uses them.</li>
<li>Be stored in a message file.</li>
</ul>
</li>
<li>Do not specify the maximum size for a message file. When the message file
becomes full, you cannot change the size of the message file. You need to
create another message file and add the message description again. <p>Use
the Create Message File (CRTMSGF) command to create a message file to hold
the predefined message description. The contents of the predefined message
description can be put into a message file by the Add Message Description
(ADDMSGD) command.</p>
</li>
<li>Use substitution variables with care. Different languages have different
orders for substitution variables. For example, in the English message: <pre>File &amp;1 in Library &amp;2 not found.</pre>
<p>&amp;1;
and &amp;2; are the substitution variables. Those substitution variables can
appear in different positions for different languages.</p>
</li>
<li>Make your design and coding able to understand a reply code for different
languages. For example, <pre>English Y = Yes
Danish J = Ja (means Yes)</pre>
</li>
</ul>
<p>The following figure shows the creation of different NLV messages from
message files.</p>
<br /><img src="rbags509.gif" alt="Creating different NLV messages from message files" /><br /><p>A program can directly access the message file for program messages, or
it can indirectly access the message file through display files for program
messages.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbagsuseint.htm" title="A user interface is the part of a software product that your customer actually sees.">User interfaces</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbagsccsidmsgsup2.htm" title="Use CCSID support for handling messages and message catalogs on i5/OS.">CCSID support for messages</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../cl/crtmsgf.htm">Create Message File (CRTMSGF) command</a></div>
<div><a href="../cl/addmsgd.htm">Add Message Description (ADDMSGD) command</a></div>
<div><a href="../rbam6/rbam6clmain.htm">Control language</a></div>
</div>
</div>
</body>
</html>