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

90 lines
5.5 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="Create a message file" />
<meta name="abstract" content="To create your own predefined messages, you must first create the message file into which the messages are to be placed." />
<meta name="description" content="To create your own predefined messages, you must first create the message file into which the messages are to be placed." />
<meta name="DC.subject" content="CRTMSGF (Create Message File) command, Create Message File (CRTMSGF) command, command, CL, CRTMSGF (Create Message File), Create Message File (CRTMSGF), message file, creating" />
<meta name="keywords" content="CRTMSGF (Create Message File) command, Create Message File (CRTMSGF) command, command, CL, CRTMSGF (Create Message File), Create Message File (CRTMSGF), message file, creating" />
<meta name="DC.Relation" scheme="URI" content="msghd.htm" />
<meta name="DC.Relation" scheme="URI" content="msgfiasp.htm" />
<meta name="DC.Relation" scheme="URI" content="dmsgf.htm" />
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addmsgd.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtmsgf.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="cmsgf" />
<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>Create a message file</title>
</head>
<body id="cmsgf"><a name="cmsgf"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Create a message file</h1>
<div><p>To create your own predefined messages, you must first create the
message file into which the messages are to be placed. </p>
<div class="section"> <p>Use the <span class="cmdname">Create Message File (CRTMSGF)</span> command
to create the message file. You then use the <span class="cmdname">Add Message Description
(ADDMSGD)</span> command to describe your messages and place them in the
message file.</p>
<p>On the <span class="cmdname">Create Message File (CRTMSGF)</span> command,
you can specify the maximum size in K bytes on the SIZE parameter. The following
formula can be used to determine the maximum: </p>
<pre>S + (I x N)</pre>
<p>where the following variables are true:</p>
<dl><dt class="dlterm">S</dt>
<dd>Is the initial amount of storage</dd>
<dt class="dlterm">I</dt>
<dd>Is the amount of storage to add each time</dd>
<dt class="dlterm">N</dt>
<dd>Is the number of times to add storage</dd>
</dl>
<p>The defaults for S, I, and N are 10, 2, and *NOMAX, respectively.</p>
<p>For
example, you specify S as 5, I as 1, and N as 2. When the file reaches the
initial storage amount of 5K, the system automatically adds another 1K to
the initial storage. The amount added (1K) can be added to the storage two
times to make the total maximum of 7K. If you specify *NOMAX as N, the maximum
size of the message file is 16M.</p>
<p>When you specify a maximum size for
a message file and the message file becomes full, you cannot change the size
of the message file. You then need to create another message file and recreate
the messages in the new file. The <span class="cmdname">Merge Message File (MRGMSGF)</span> command
can be used to copy message descriptions from one message file to another.
Since you will want to avoid this step, it is important to calculate the
size needed for your message file when you create it, or specify *NOMAX.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="msgfiasp.htm">Message files in independent ASPs</a></strong><br />
Message files can be created in an independent auxiliary storage pool (ASP), but it is not recommended because the independent ASP can be taken offline.</li>
<li class="ulchildlink"><strong><a href="dmsgf.htm">Determine the size of a message file</a></strong><br />
Use this topic to determine the size of a message file.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="msghd.htm" title="Predefined messages are stored in a message file.">Define message descriptions</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../clfinder/finder.htm">CL command finder</a></div>
<div><a href="../cl/addmsgd.htm">Add Message Description (ADDMSGD) command</a></div>
<div><a href="../cl/crtmsgf.htm">Create Message File (CRTMSGF) command</a></div>
</div>
</div>
</body>
</html>