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

121 lines
8.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="concept" />
<meta name="DC.Title" content="Display files" />
<meta name="abstract" content="When a display file object is created, it is tagged with the coded character set identifier (CCSID) of the source file." />
<meta name="description" content="When a display file object is created, it is tagged with the coded character set identifier (CCSID) of the source file." />
<meta name="DC.Relation" scheme="URI" content="rbagsccsidwrkstafunctmansup.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzakc/rzakcmstdfmscon.htm" />
<meta name="DC.Relation" scheme="URI" content="rbagsqchridctluse.htm" />
<meta name="DC.Relation" scheme="URI" content="rbagschngccsidofphysfile.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtdspf.htm" />
<meta name="DC.Relation" scheme="URI" content="rbagsccsidmsgsup2.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzakc/rzakcmstdfems.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzakc/rzakcmstdfsflms.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="rbagsccsiddispfilesup" />
<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>Display files</title>
</head>
<body id="rbagsccsiddispfilesup"><a name="rbagsccsiddispfilesup"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Display files</h1>
<div><p>When a display file object is created, it is tagged with the coded
character set identifier (CCSID) of the source file.</p>
<p> At compile time:</p>
<ul><li>All character data is read from the primary source file without any character
conversion being performed.</li>
<li>User message text (identified by the MSGCON keyword in DDS) remains the
same because it is assumed to be in the same CCSID as the primary source file.</li>
</ul>
<p>At run time, the constant data is converted based on the CHRID parameter
value used to create the display file object. This conversion is optional
and can occur only when the CHRID is set to *JOBCCSID or indirectly with CHRIDCTL.
This conversion is from the display file CCSID to the character identifier
(CHRID) of the device. The field-level keyword NOCCSID (no coded character
set identifier) allows the user to specify fields within the DDS that are
never to be converted.</p>
<div class="note"><span class="notetitle">Note:</span> To use data management support of CCSIDs, you must change source physical
files tagged with CCSID 65535 to a CCSID value that is associated with the
data.</div>
<div class="section" id="rbagsccsiddispfilesup__hdrcrtdspfchridparm"><a name="rbagsccsiddispfilesup__hdrcrtdspfchridparm"><!-- --></a><h4 class="sectiontitle">CHRID parameter on the Create Display
File command</h4><p>The CHRID parameter on the Create Display File (CRTDSPF)
command affects the conversion that occurs for the display file.</p>
<p>If
the *JOBCCSID value is specified on the CHRID parameter of the CRTDSPF command:</p>
<ul><li>Input characters are converted from the device character identifier (CHRID)
to the job CCSID.</li>
<li>Character data is sent to output-capable fields and converted from the
job CCSID to the device CHRID.</li>
<li>Constant text from the display file is converted from the CCSID of the
display file to the CHRID of the device.</li>
<li>All message files are tagged with a CCSID. Message text
is converted from the CCSID of the message file to the CHRID of the device.
When message files are tagged with a CCSID of 65535 (the system default),
it is assumed that the contents of the message files are already in the CHRID
of the device. To ensure that appropriate conversions occur, you can enable
CCSID support for messages.</li>
<li>Message replacement data is converted from the CCSID of the job, or from
the CCSID of the display file, to the CHRID of the device.</li>
<li>All status messages that are tagged with a CCSID other than 65535 are
converted to the CHRID of the device.</li>
<li>Message text for messages on a message line or in a message subfile (identified
by the ERRMSG, ERRMSGID, SFLMSG, and SFLMSGID keywords in DDS) is converted
from the message file CCSID to the device CHRID.</li>
</ul>
<p>If a specific value is specified for the CHRID parameter on the CRTDSPF
command, conversion is done between the CHRID specified on the CRTDSPF command
and the CHRID of the device. This conversion affects only fields defined with
the CHRID DDS keyword.</p>
<p>If the *DEVD value is specified on the CHRID
parameter of the CRTDSPF command, no conversion is performed. This is the
default setting.</p>
</div>
<div class="section" id="rbagsccsiddispfilesup__Header_16"><a name="rbagsccsiddispfilesup__Header_16"><!-- --></a><h4 class="sectiontitle">Migration of display files with CCSID 65535</h4><p>All source files in Version 3 of the i5/OS™ licensed
program have an implicit CCSID value of 65535. To have appropriate CCSID support,
display files must be recompiled with a source file that has a CCSID value
other than 65535 if either of the following conditions are true:</p>
<ul><li>The display file was originally compiled from a source file with a CCSID
value of 65535.</li>
<li>The display file was originally compiled before Version
2 Release 3 Modification 0 of the OS/400<sup>®</sup> licensed program.</li>
</ul>
<p>By recompiling, the display file object is tagged and all necessary
conversions take place when needed.</p>
<p>No conversions take place if the
source files are explicitly tagged CCSID 65535.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbagsccsidwrkstafunctmansup.htm" title="Workstation function management involves working with display files, printer files, as well as panel group objects and user interface manager (UIM) menus.">Workstation function management</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="../rzakc/rzakcmstdfmscon.htm">MSGCON (Message Constant) keyword</a></div>
<div><a href="rbagsqchridctluse.htm" title="The character identifier control (QCHRIDCTL) system value controls the type of CCSID conversion that occurs for display files, printer files, and panel groups.">Character identifier control (QCHRIDCTL) system value</a></div>
<div><a href="rbagschngccsidofphysfile.htm" title="You can use the Change Physical File (CHGPF) command to change the coded character set identifier (CCSID) of a physical file. However, the physical file cannot be changed under certain conditions.">Change the CCSID of a physical file</a></div>
<div><a href="rbagsccsidmsgsup2.htm" title="Use CCSID support for handling messages and message catalogs on i5/OS.">CCSID support for messages</a></div>
<div><a href="../rzakc/rzakcmstdfems.htm">ERRMSG (Error Message) and ERRMSGID (Error Message Identifier) keywords</a></div>
<div><a href="../rzakc/rzakcmstdfsflms.htm">SFLMSG (Subfile Message) and SFLMSGID (Subfile Message Identifier) keywords</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../cl/crtdspf.htm">Create Display File (CRTDSPF) command</a></div>
</div>
</div>
</body>
</html>