94 lines
6.8 KiB
HTML
94 lines
6.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="Length for display files (positions 30 through 34)" />
|
||
|
|
<meta name="abstract" content="You must specify a length for each named field unless you are copying the length from a referenced field." />
|
||
|
|
<meta name="description" content="You must specify a length for each named field unless you are copying the length from a referenced field." />
|
||
|
|
<meta name="DC.subject" content="length positional entry" />
|
||
|
|
<meta name="keywords" content="length positional entry" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstpsnent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfdt.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="pos3944.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstpos29.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="pos3034" />
|
||
|
|
<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>Length for display files (positions 30 through 34)</title>
|
||
|
|
</head>
|
||
|
|
<body id="pos3034"><a name="pos3034"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Length for display files (positions 30 through 34)</h1>
|
||
|
|
<div><p>You must specify a length for each named field unless you are copying
|
||
|
|
the length from a referenced field.</p>
|
||
|
|
<p>The length is the number of bytes of data to pass to or receive from your
|
||
|
|
program when I/O operations are done for the field. This is called the <dfn class="term">program
|
||
|
|
length</dfn> of the field.</p>
|
||
|
|
<p>The length of a field when it appears on the display is called the <dfn class="term">display
|
||
|
|
length</dfn>. The display length is greater than or equal to the program
|
||
|
|
length. The display length of a field is determined by the keyboard shift
|
||
|
|
(specified in position 35) and other field specifications, such as decimal
|
||
|
|
positions (positions 36 and 37), and editing functions.</p>
|
||
|
|
<p>The display length does not include beginning and ending attribute characters
|
||
|
|
of a field. However, you must consider these attribute characters when planning
|
||
|
|
the display layout for field locations. Within a record, the ending attribute
|
||
|
|
character of a field can overlap the beginning attribute character of the
|
||
|
|
next field, requiring only one space between fields.</p>
|
||
|
|
<p>The maximum length of a character field is equal to the display size minus
|
||
|
|
one. (This allows space for the beginning attribute character.) The maximum
|
||
|
|
length of a numeric (zoned decimal) field is 63 positions. The maximum length
|
||
|
|
of a single-precision floating-point field is 9 digits. The maximum length
|
||
|
|
of a double-precision floating-point field is 17 digits.</p>
|
||
|
|
<p>You must not specify a field length for a constant field. See the <a href="rzakcmstdfdate.htm">DATE (Date) keyword for display files</a>, <a href="rzakcmstdfdft.htm">DFT (Default) keyword for display files</a>, <a href="rzakcmstdfmscon.htm">MSGCON (Message Constant) keyword for display files</a>, or <a href="rzakcmstdftime.htm">TIME (Time) keyword for display files</a> topics
|
||
|
|
for explanations of the lengths of constant fields.</p>
|
||
|
|
<p>If you specify length, it must be right-aligned. Leading zeros are optional. <a href="#pos3034__vlnoval">Figure 1</a> shows incorrect and correct field length specifications.</p>
|
||
|
|
<div class="fignone" id="pos3034__vlnoval"><a name="pos3034__vlnoval"><!-- --></a><span class="figcap">Figure 1. Incorrect and correct length specifications</span><pre>|...+....1....+....2....+....3....+....4....+....5
|
||
|
|
00010A FIELD1 7
|
||
|
|
A
|
||
|
|
00020A FIELD2 7
|
||
|
|
A
|
||
|
|
00030A FIELD3 R +7
|
||
|
|
A</pre>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> FIELD1 shows the field length specified incorrectly. FIELD2 and FIELD3
|
||
|
|
show the field length specified correctly.</div>
|
||
|
|
</div>
|
||
|
|
<p>If you use a referenced field, you can override the length of the field
|
||
|
|
by specifying a new value or by specifying the increase or decrease in length.
|
||
|
|
To increase the length, specify <em>+n</em>, where n is the increase. To decrease
|
||
|
|
the length, specify <em>-n</em>, where n is the decrease. For example, an entry
|
||
|
|
of +4 for a numeric field indicates a field that is 4 digits longer than the
|
||
|
|
referenced field.</p>
|
||
|
|
<p>In some cases, some keywords specified with the field in the database file
|
||
|
|
are not included in the display file if you specify a value for length.</p>
|
||
|
|
<p>A field cannot occupy the first position on the display. The first position
|
||
|
|
is reserved for an attribute character. For example, on a 24 by 80 display,
|
||
|
|
an entry of 1 in positions 39 through 41 (line), and 1 in positions 42 through
|
||
|
|
44 (position) is not allowed for a signed numeric field since the field starts
|
||
|
|
in position 1.</p>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstpsnent.htm" title="Use this information to specify the first 44 positions of the data description specifications (DDS) form for display files.">Positional entries for display files (positions 1 through 44)</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzakcmstdfdt.htm" title="The entry you make in position 35 is the data type/keyboard shift attribute for display files.">Data type/keyboard shift for display files (position 35)</a></div>
|
||
|
|
<div><a href="pos3944.htm" title="Use these positions to specify the exact location on the display where each field begins.">Location for display files (positions 39 through 44)</a></div>
|
||
|
|
<div><a href="rzakcmstpos29.htm" title="You can specify R in this position to use the reference function of the i5/OS operating system to copy the attributes of a previously defined named field (called the referenced field) to the field you are defining.">Reference for display files (position 29)</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|