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

88 lines
5.2 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="reference" />
<meta name="DC.Title" content="RANGE (Range) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword for input-capable fields to specify that the i5/OS operating system is to perform validity checking on the data that the workstation user types into the field." />
<meta name="description" content="Use this field-level keyword for input-capable fields to specify that the i5/OS operating system is to perform validity checking on the data that the workstation user types into the field." />
<meta name="DC.subject" content="RANGE (Range) keyword" />
<meta name="keywords" content="RANGE (Range) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.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="rzakcmstdfrange" />
<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>RANGE (Range) keyword for display files</title>
</head>
<body id="rzakcmstdfrange"><a name="rzakcmstdfrange"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">RANGE (Range) keyword for display files</h1>
<div><p>Use this field-level keyword for input-capable fields to specify
that the <span class="keyword">i5/OS™</span> operating
system is to perform validity checking on the data that the workstation user
types into the field.</p>
<div class="section"><p>The data typed in must be greater than or equal to the lower value,
and less than or equal to the higher value. Note that the <span class="keyword">i5/OS</span> operating
system performs this checking only if the field is changed by the workstation
user or if its changed data tag (MDT) is set on using DSPATR(MDT).</p>
<div class="note"><span class="notetitle">Note:</span> See
the <a href="rzakcmstdfchkme.htm">CHKMSGID (Check Message Identifier) keyword for display files</a> topic for information
about defining user-specified error messages.</div>
<div class="p">The format of the keyword
is: <pre>RANGE(low-value high-value)</pre>
</div>
<p>When the field
is a character field, the parameter values must be enclosed in single quotation
marks. When the field is numeric, single quotation marks must not be specified.</p>
<p>You
cannot specify RANGE on a floating-point field (F in position 35).</p>
<p>Option
indicators are not valid for this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the RANGE keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R RECORD1
00020A* Character fields
00030A FIELD1 1 I 2 2RANGE('B' 'F')
00040A FIELD2 1 I 3 2RANGE('2' '5')
00050A* Numeric fields
00070A FIELD3 1 0I 4 2RANGE(2 5)
00080A FIELD4 4 0B 5 2RANGE(1 1500)
00090A FIELD5 7 2B 6 2RANGE(100 99999.99)
00100A FIELD6 3 0B 7 2RANGE(-100 -50)
00110A FIELD7 3 2I 8 2RANGE(.50 1.00)
00120A FIELD8 3 2I 9 2RANGE(.5 1)
00130A FIELD9 5Y 2I 10 2RANGE(.01 999.99)
A</pre>
<p>FIELD7 and FIELD8 have equivalent RANGE parameter values.
The reason is that for numeric fields, decimal alignment is based on the number
of decimal positions specified in positions 36 through 37. For FIELD7 and
FIELD8, the low value is 0.50 and the high value is 1.00.</p>
<p>Data entered
into a numeric field is aligned on the decimal positions specified (in positions
36 through 37), and leading and trailing blanks are filled with zeros. For
example, if 1.2 is typed into FIELD9, 00120 is returned to your program. If
100 is typed into FIELD9, 10000 is returned to your program.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstkeyent.htm" title="You type the keyword entries that define display files in positions 45 through 80 (functions).">DDS keyword entries for display files (positions 45 through 80)</a></div>
</div>
</div>
</body>
</html>