ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/amsgi.htm

79 lines
5.2 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="task" />
<meta name="DC.Title" content="Assign a message identifier" />
<meta name="abstract" content="The message identifier you specify on the Add Message Description (ADDMSGD) command is used to refer to the message and is the name of the message description." />
<meta name="description" content="The message identifier you specify on the Add Message Description (ADDMSGD) command is used to refer to the message and is the name of the message description." />
<meta name="DC.subject" content="message, assigning message identifier, message identifier, specifying, monitoring, numeric subtype code" />
<meta name="keywords" content="message, assigning message identifier, message identifier, specifying, monitoring, numeric subtype code" />
<meta name="DC.Relation" scheme="URI" content="amsgf.htm" />
<meta name="DC.Relation" scheme="URI" content="monmg.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addmsgd.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="amsgi" />
<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>Assign a message identifier</title>
</head>
<body id="amsgi"><a name="amsgi"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Assign a message identifier</h1>
<div><p>The message identifier you specify on the <span class="cmdname">Add Message
Description (ADDMSGD)</span> command is used to refer to the message and
is the name of the message description. </p>
<div class="section"> <p>The message identifier must be 7 characters: </p>
<pre> pppmmnn</pre>
<p>where <samp class="codeph">ppp</samp> is the product or application code, <samp class="codeph">mm</samp> is
the numeric group code, and <samp class="codeph">nn</samp> is the numeric subtype code.
The number specified as <samp class="codeph">mmnn</samp> can be used to further divide
a set of product or application messages. Numeric group and subtype codes
consist of decimal numbers 0 through 9 and the characters A through F.</p>
<p>For
example, the following is message 1234 of CPF.: </p>
<pre> CPF1234</pre>
<p>When you create your own messages, using the letter U as the
first character in the product code is a good way to distinguish your messages
from system messages. For example: </p>
<pre> USR3567</pre>
<p>The first character of the code must be alphabetic, the second
and third characters can be alphanumeric; the group code and the subtype code
must consist of decimal numbers 0 through 9 and the characters A through F.
Note that although this range can be called a set of hexadecimal numbers,
any sorting of the message numerics treats A through F as characters.</p>
<p>For
example, when displaying a range of message descriptions, CPFA000 precedes
CPF1000.</p>
<p>You should use care in using a numeric subtype code of 00 in
the message identifier. If you use a numeric subtype code of 00 for a message
that can be sent as an escape, notify, or status message and that can, therefore,
be monitored, a subtype code of 00 in the <span class="cmdname">Monitor Message (MONMSG)</span> command
causes all messages in the numeric group to be monitored.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="amsgf.htm" title="You use the Add Message Description (ADDMSGD) command to describe your predefined messages and to add them to the message file you created.">Add messages to a file</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="monmg.htm" title="You can monitor for exception messages. Exception messages include escape, notify, and status messages that are sent to your CL procedure's or program's call message queue by the commands in your procedure or program or by commands in another procedure or program. Diagnostic messages cannot be monitored.">Monitor for messages in a CL program or procedure</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/addmsgd.htm">Add Message Description (ADDMSGD) command</a></div>
</div>
</div>
</body>
</html>