ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/dspgen.htm

97 lines
5.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="Additional considerations for describing display files that contain DBCS data" />
<meta name="abstract" content="Be aware of these additional considerations when you describe display files that contain DBCS data." />
<meta name="description" content="Be aware of these additional considerations when you describe display files that contain DBCS data." />
<meta name="DC.Relation" scheme="URI" content="rzakcmstzdbcs.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="dspgen" />
<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>Additional considerations for describing display files that contain
DBCS data</title>
</head>
<body id="dspgen"><a name="dspgen"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Additional considerations for describing display files that contain
DBCS data</h1>
<div><p>Be aware of these additional considerations when you describe display
files that contain DBCS data.</p>
<ul><li>Specify IGCDTA(*YES) on the CRTDSPF command when DBCS data is present
in the file, but not indicated in DDS. For example, specify IGCDTA(*YES) if
the file sends messages that are DBCS (DDS keyword MSGCON).</li>
<li>Prevent users from using display files to insert alphanumeric data into
DBCS database files by specifying the keyboard shift for a field in a field
reference file rather than in a display file. Users cannot type alphanumeric
data in input-capable fields of DBCS display files and, therefore, cannot
type alphanumeric data into the database file. <p>Specify data type J or G
in a database field reference file and R in position 29 of the associated
display file.</p>
<p>Use data type J or G for all fields in a field reference
file to reduce the possibility of incorrectly setting the default keyboard
shift to O (open).</p>
</li>
<li>Describe fields in the file as DBCS fields to cause the system to consider
the file to be DBCS even if you do not specify IGCDTA(*YES) on the CRTDSPF
command.</li>
<li>The system displays the DBCS data that does not fit on one display line
onto the next display line with the following effects: <ul><li>DDS sends a warning message stating that it split DBCS characters for
constant and initialized fields containing DBCS data.</li>
<li>DDS sends a warning message stating that it split DBCS characters if you
specified the J, E, or G data type.</li>
<li>DDS does not send a warning message stating that it split DBCS characters
if you specified the O data type. DDS warns you of the potential for this
problem when the file is created.</li>
<li>The second display line of a continued field might not make sense if the
system must split a DBCS character in order to continue the line.</li>
</ul>
</li>
<li>Text with bracketed-DBCS characters can be used anywhere that comments
and character strings are allowed.</li>
<li>Consider the following rules when you specify subfiles: <ul><li>Use the SFLMSG keyword to create DBCS messages by typing DBCS data for
the character string in the message. <p>Check the length of the message. The
space available to display it must be long enough to contain the message.
DDS warns you when a display field might be truncated. However, the field
might be truncated in the middle of a DBCS character, and the data displayed
following the truncated character will not make sense.</p>
</li>
<li>The system ignores the SFLEND keyword when displaying a plus sign (+)
to indicate that more records exist in the subfile. When displaying the plus
sign, the system writes over a DBCS character.</li>
</ul>
</li>
<li>Consider the following rules when you specify
the MSGID keyword: <ul><li>If the message text contains DBCS characters, and the message length exceeds
the MSGID field length, the message text is truncated so that it ends with
an alphanumeric character. If the truncation occurs in the middle of a DBCS
character, the text truncates after the previous DBCS character and a shift-in
character is added to the end of the text.</li>
<li>If the message text contains DBCS characters, either define the MSGID
field so that it does not wrap to the next line, or make sure the message
text does not wrap in the middle of a DBCS character.</li>
</ul>
</li>
</ul>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstzdbcs.htm" title="Read this topic for information about the DBCS considerations for the positional entries and keyword entries for display files, as well as general considerations for using DBCS data in display files.">Double-byte character set considerations for DDS</a></div>
</div>
</div>
</body>
</html>