95 lines
5.9 KiB
HTML
95 lines
5.9 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="VALUES (Values) keyword for display files" />
|
|
<meta name="abstract" content="Use this field-level keyword to specify a list of values that are valid for the user to type into the field." />
|
|
<meta name="description" content="Use this field-level keyword to specify a list of values that are valid for the user to type into the field." />
|
|
<meta name="DC.subject" content="VALUES (Values) keyword" />
|
|
<meta name="keywords" content="VALUES (Values) keyword" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfchkme.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="rzakcmstdfval" />
|
|
<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>VALUES (Values) keyword for display files</title>
|
|
</head>
|
|
<body id="rzakcmstdfval"><a name="rzakcmstdfval"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">VALUES (Values) keyword for display files</h1>
|
|
<div><p>Use this field-level keyword to specify a list of values that are
|
|
valid for the user to type into the field.</p>
|
|
<div class="section"><p>The <span class="keyword">i5/OS™</span> operating
|
|
system performs an implied equals test on the data typed in against the value(s)
|
|
you specify here. 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 modified data tag (MDT) is set on using DSPATR(MDT).</p>
|
|
<div class="note"><span class="notetitle">Note:</span> The
|
|
CHKMSGID keyword information defines user-specified error messages.</div>
|
|
<div class="p">The
|
|
format of the keyword is: <pre>VALUES(value-1 [value-2... [value-100]])</pre>
|
|
</div>
|
|
<p>There
|
|
can be 1 to 100 values; specify them as parameter values with the keyword
|
|
and separate them by at least one blank.</p>
|
|
<div class="note"><span class="notetitle">Note:</span> You cannot specify more
|
|
than 5000 characters in a single DDS statement. Therefore, you cannot specify
|
|
character values that cause VALUES to be longer than 5000 characters. If you
|
|
specify other keywords for the same field, they also count toward the 5000-character
|
|
limit. For example, specifying DSPATR(HI) for the field reduces the number
|
|
of characters left for VALUES.</div>
|
|
<p>A value can be a numeric or a character
|
|
value, corresponding in length to the field that is to be tested. A character
|
|
value must be enclosed in single quotation marks. A numeric value is restricted
|
|
to the digits 0 through 9 and can be preceded by a minus sign (-) for negative
|
|
values. Alignment is on the low-order character position.</p>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Define a numeric field for display files</h4><p>When a
|
|
workstation user types in data, the <span class="keyword">i5/OS</span> operating
|
|
system aligns the entered characters according to the number of decimal positions
|
|
in the field. Leading and trailing blanks are filled with zeros when the field
|
|
is passed to your program. If no decimal character is typed, the <span class="keyword">i5/OS</span> program places a decimal character
|
|
to the right of the farthest right character typed in. For example, for a
|
|
numeric field with a length of 5 (specified in position 34) and 2 decimal
|
|
positions (specified in position 37), 1.2 is interpreted as 001.20, and 100
|
|
is interpreted as 100.00.</p>
|
|
<p>The compare is based on the value as it is
|
|
passed to your program (for example, right-aligned and padded or left-aligned
|
|
and padded).</p>
|
|
<p>You cannot specify VALUES 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 VALUES keyword for a character and numeric values test.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
00010A RESPC 11 I 8 2VALUES('A' 'B' 'C' 'D')
|
|
00020A RESPN 31 0I 9 2VALUES(33 -42 01)
|
|
00030A DECFLD 1 2I 11 2VALUES(1.2 100)
|
|
A</pre>
|
|
</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 class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="rzakcmstdfchkme.htm" title="Use this field-level keyword to identify an error message that is issued when a validity check error is detected.">CHKMSGID (Check Message Identifier) keyword for display files</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |