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

97 lines
6.1 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="Override message files" />
<meta name="abstract" content="You can override message files used in a procedure or program." />
<meta name="description" content="You can override message files used in a procedure or program." />
<meta name="DC.subject" content="message, overriding message file, overriding, message file, OVRMSGF (Override with Message File) command, Override with Message File (OVRMSGF) command, command, CL, OVRMSGF (Override with Message File), Override with Message File (OVRMSGF), overriding with, escape message, CPF2469" />
<meta name="keywords" content="message, overriding message file, overriding, message file, OVRMSGF (Override with Message File) command, Override with Message File (OVRMSGF) command, command, CL, OVRMSGF (Override with Message File), Override with Message File (OVRMSGF), overriding with, escape message, CPF2469" />
<meta name="DC.Relation" scheme="URI" content="smfs.htm" />
<meta name="DC.Relation" scheme="URI" content="exomf.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="omsgf" />
<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>Override message files</title>
</head>
<body id="omsgf"><a name="omsgf"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Override message files</h1>
<div><p>You can override message files used in a procedure or program.
</p>
<div class="section"> <p>The creation (Override Message File command), deletion (Delete
Override command), and display (Display Override command) of message file
overrides is similar to other types of overrides. Here, however, only the
name of the message file, not the attributes, is overridden, and the rules
for applying the overrides are slightly different.</p>
<p>To override a message
file, use the <span class="cmdname">Override Message File (OVRMSGF)</span> command.
The file overridden is specified in the MSGF parameter; the file overriding
it is specified in the TOMSGF parameter.</p>
<p>For example, to override QCPFMSG
with a user message file named USRMSGF, the following command would be used:
</p>
<pre>OVRMSGF MSGF(QCPFMSG) TOMSGF(USRMSGF)</pre>
<p>When a predefined message is retrieved or displayed, the overriding
file is searched for a message description. If the message description is
not found in that file, the overridden file is searched.</p>
<p>There are
several basic reasons to override message files: </p>
<ul><li>To provide changed default replies or dump lists. A message file can
be created with message descriptions for messages with changed default replies
or dump lists because those in the original message descriptions are not satisfactory.
You can establish several operating environments, each with different default
replies.</li>
<li>To change severity levels of the messages.</li>
<li>To provide a default program.</li>
<li>To change the text of a message. If the text is blank, it appears to
the user as if no message was sent. For example, you may not want the status
message sent by the <span class="cmdname">Copy File (CPYF)</span> command
to appear to the user.</li>
<li>To provide translation of messages into national languages. Message files
written in English can be overridden by message files written in other languages.
(If all messages are changed, use the library list for the job to change
the order of the message files instead of overriding the message files.)</li>
</ul>
<p>Another way you can select the message file from which messages are
to be retrieved is by changing the order of the files in the library list
for the job. However, if you use this approach, the search for the message
stops on the first message file found that has the specified name. If the
message is not in that file, the search stops.</p>
<p>For example, assume that
a message file named USRMSG is in library USRLIB1, and another message file
named USRMSG is in library USRLIB2. To use the message file in USRLIB1, USRLIB1
should precede USRLIB2 in the library list:</p>
<br /><img src="rbafn507.gif" alt="In this example assume that a message file named USRMSG is in library USRLIB1, and another message file named USRMSG is in library USRLIB2. To use the message file in USRLIB1, USRLIB1 should precede USRLIB2 in the library list." /><br /><p>The system searches the first
message file found with the correct name. If that file does not contain the
message, the search stops. However, if you use the OVRMSGF command, the system
searches the overriding file, and if the message is not there, it searches
the overridden file.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="exomf.htm">Example: Override a message file</a></strong><br />
This example shows how to change a message used in a job.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="smfs.htm" title="The system searches for the message file from which the message description is retrieved.">Search for message file</a></div>
</div>
</div>
</body>
</html>