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

67 lines
4.8 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="Message-level CCSID with a specific message queue CCSID" />
<meta name="abstract" content="When a message is sent to the message queue and the CCSID of the message queue is something other than 65535 or 65534, the replacement data or immediate message text is converted to the CCSID of the message queue. The message is then tagged with the CCSID of the message queue." />
<meta name="description" content="When a message is sent to the message queue and the CCSID of the message queue is something other than 65535 or 65534, the replacement data or immediate message text is converted to the CCSID of the message queue. The message is then tagged with the CCSID of the message queue." />
<meta name="DC.Relation" scheme="URI" content="rbagsmessagelevelccsid.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="rbagsmsglevspecmsgque" />
<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-level CCSID with a specific message queue CCSID</title>
</head>
<body id="rbagsmsglevspecmsgque"><a name="rbagsmsglevspecmsgque"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Message-level CCSID with a specific message queue CCSID</h1>
<div><p>When a message is sent to the message queue and the CCSID of the
message queue is something other than 65535 or 65534, the replacement data
or immediate message text is converted to the CCSID of the message queue.
The message is then tagged with the CCSID of the message queue.</p>
<p>For example, message queue MYMSGQ has a CCSID of 00277. The replacement
data for TST0002 is defined as *CCHAR data. You enter the following Send Program
Message command:</p>
<pre>SNDPGMMSG MSGDTA(X'0006D4E2C7407BF2') MSGID(TST0002) MSGF(MYMSGF)
CCSID(37) TOMSGQ(MYLIB/MYMSGQ)</pre>
<p>The replacement data is converted from CCSID 00037 to CCSID 00277 before
it is sent to the message queue. X'0006' is the length required for variable-length
fields. X'D4E2C7407BF2' is <var class="varname">MSG #2</var> on code page 00037. The
number sign (#), X'7B' on code page 00037, is converted to a number sign,
X'4A' on code page 00277. All other code points do not change during the conversion
because they are the same on both code page 00037 and code page 00277.</p>
<p>When the replacement data or immediate message text of a message is 65535
and it is sent to a message queue with a CCSID other than 65535 or 65534,
no conversion occurs. However, the message is tagged with the CCSID of the
message queue. Therefore, messages can be tagged with an incorrect CCSID when
you send them to a message queue with a CCSID that overrides the message-level
CCSID.</p>
<p>For example, message queue MYMSGQ has a CCSID of 00277. You enter the following
Send Message command:</p>
<pre>SNDMSG MSG('MSG #2') TOMSGQ(MYLIB/MYMSGQ) CCSID(*HEX)</pre>
<p>The immediate message text <var class="varname">MSG #2</var> is not converted before
it is sent to the message queue. Although the immediate message text is not
converted to CCSID 00277, it is displayed using CCSID 00277. Unless you entered
the Send Message command from a device configured to support code page 00277,
you lost the integrity of the immediate message text.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbagsmessagelevelccsid.htm" title="When a message is sent to a message queue, you must communicate the CCSID of the replacement data or the immediate message text to the operating system. Use the CCSID parameter on any of the send message commands or APIs to communicate this CCSID to the operating system.">Message-level support</a></div>
</div>
</div>
</body>
</html>