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

85 lines
5.8 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<?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="Message file with a specific CCSID" />
<meta name="abstract" content="If the CCSID of the message file is something other than 65535 or 65534, the first- and second-level text of the message description is converted from the CCSID specified to the CCSID of the message file. It is then tagged with the CCSID of the message file." />
<meta name="description" content="If the CCSID of the message file is something other than 65535 or 65534, the first- and second-level text of the message description is converted from the CCSID specified to the CCSID of the message file. It is then tagged with the CCSID of the message file." />
<meta name="DC.Relation" scheme="URI" content="rbagsmsgdescriplevelccsid.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/rtvmsg.htm" />
<meta name="DC.Relation" scheme="URI" content="../apis/QMHRTVM.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="rbagsmsgfilespecififccsid" />
<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>Message file with a specific CCSID</title>
</head>
<body id="rbagsmsgfilespecififccsid"><a name="rbagsmsgfilespecififccsid"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Message file with a specific CCSID</h1>
<div><p>If the CCSID of the message file is something other than 65535
or 65534, the first- and second-level text of the message description is converted
from the CCSID specified to the CCSID of the message file. It is then tagged
with the CCSID of the message file.</p>
<p>For example, message file MYMSGF has a CCSID of 00277. The job that is
running is in CCSID 00037. You enter the following command:</p>
<pre>ADDMSGD MSG('MSG #2') MSGID(TST0002) MSGF(MYMSGF) CCSID(37)</pre>
<p>Message 'MSG #2' is converted from CCSID 00037 to CCSID 00277 before it
is added to the message file. The number sign (#), X'7B' on code page 00037,
is converted to the number sign (#), X'4A', on code page 00277. No other code
points change during the conversion because they are the same on both code
page 00037 and code page 00277.</p>
<p>When the text of a message description is specified as 65535 and it is
added to a message file, no conversion occurs. If the CCSID of the message
file is not 65535 or 65534, the message text is tagged with the CCSID of the
message file.</p>
<p>When the message file CCSID is not 65535 or 65534, the message file CCSID
overrides message description CCSIDs. Keep this rule in mind when adding and
changing message descriptions to a message file with a CCSID other than 65535
or 65534. Otherwise, a message description can be marked incorrectly.</p>
<p>For example, message file MYMSGF has a CCSID of 00277. You enter the following
command:</p>
<pre>ADDMSGD MSG('MSG #2') MSGID(TST0002) MSGF(MYMSGF) CCSID(*HEX)</pre>
<p>Message text 'MSG #2' is not converted before it is added to the message
file. Because the CCSID of the message file is 00277, the message text is
tagged with CCSID 00277.</p>
<p>If the command was run in a job CCSID where the number sign (#) occupies
a code point different than the code point for the number signon
code page 00277, the message is displayed incorrectly.</p>
<p>A conversion error may occur while adding or changing a message description
in a message file. If a conversion error occurs, the message description is
still either added to or changed in the message file. The text of the message
description, however, is not converted. A diagnostic message is sent and the
message description is tagged with the CCSID specified, not with the CCSID
of the message file.</p>
<p>When a conversion error occurs, you can recover the correct CCSID tagging
for the message description by setting the message file CCSID to 65534. Then
you can retrieve the correct CCSID for the message description using the Retrieve
Message (RTVMSG) command or the Retrieve Message (QMHRTVM) API.</p>
<p>The CCSID of a message description applies only to first- and second-level
message text.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbagsmsgdescriplevelccsid.htm" title="When a message description is added to a message file, the CCSID of the message text must be communicated to the operating system. These topics also discuss how the CCSID of a message description is set and how to change the CCSID of a message description.">Message description-level support</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../cl/rtvmsg.htm">Retrieve Message (RTVMSG) command</a></div>
<div><a href="../apis/QMHRTVM.htm">Retrieve Message (QMHRTVM) API</a></div>
</div>
</div>
</body>
</html>