94 lines
5.6 KiB
HTML
94 lines
5.6 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="DUP (Duplication) keyword for display files" />
|
|
<meta name="abstract" content="Use this field-level keyword to activate the Dup key on the display station keyboard." />
|
|
<meta name="description" content="Use this field-level keyword to activate the Dup key on the display station keyboard." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfdupprogramming.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="rzakcmstdfdup" />
|
|
<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>DUP (Duplication) keyword for display files</title>
|
|
</head>
|
|
<body id="rzakcmstdfdup"><a name="rzakcmstdfdup"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">DUP (Duplication) keyword for display files</h1>
|
|
<div><p>Use this field-level keyword to activate the Dup key on the display
|
|
station keyboard.</p>
|
|
<p>Press the Dup key when the cursor is in this input-capable
|
|
field. This indicates that data for this field is to be duplicated from the
|
|
record sent in the previous input operation. The actual duplication is the
|
|
responsibility of your program.</p>
|
|
<p>See the <a href="s36env.htm">System/36 environment considerations for display files</a> topic for special considerations
|
|
when specifying the DUP keyword in files that are used in the System/36™ environment.</p>
|
|
<div class="p">The format of the keyword is: <pre>DUP[(response-indicator ['text'])]</pre>
|
|
</div>
|
|
<p>You cannot specify the DUP keyword on a floating-point field (F in position
|
|
35).</p>
|
|
<p>You should specify a response indicator for a numeric field defined with
|
|
this keyword. Hex 1Cs for numeric fields will not be returned to your buffer,
|
|
but hex F0s will be returned for the remaining field positions.</p>
|
|
<p>Option indicators are valid for this keyword.</p>
|
|
<div class="section"><h4 class="sectiontitle">Restrictions on validity checking</h4><p>Validity checking keywords
|
|
(CHECK, COMP, RANGE, and VALUES) can be specified with the DUP keyword. However,
|
|
they have no effect if the Dup key has been pressed.</p>
|
|
<p>If another field
|
|
in the record format fails validity checking, the <span class="keyword">i5/OS™</span> operating
|
|
system tries to read the display again. The DUP response indicator is still
|
|
returned to your program in the on condition, even if the workstation user
|
|
does not type over the DUP characters or presses the Dup key again.</p>
|
|
</div>
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the DUP keyword.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
00010A R RECORD1
|
|
00020A FLDA 5 I 3 2
|
|
00030A 15 DUP(16 'FLDA was duped')
|
|
00040A FLDAH 5 2H
|
|
A</pre>
|
|
<p>FLDA is an input-capable character and hexadecimal field
|
|
for which the workstation user can press the Dup key. In your program, you
|
|
must test the data in FLDA to ensure that it includes only the digits 0 through
|
|
9. In RPG III, you can use the TESTN operation code. In COBOL, you can use
|
|
a numeric class test. In BASIC, you can specify an ON CONV statement earlier
|
|
in the program than the statement with which you assign FLDA to FLDAH. In
|
|
PL/I, you can specify an ON statement with the ERROR condition earlier in
|
|
the program than the statement with which you assign FLDA to FLDAH.</p>
|
|
<p>Field
|
|
FLDAH is a hidden numeric field with the same length as FLDA. When the application
|
|
program reads RECORD1 and finds response indicator 16 set off, the program
|
|
moves FLDA to FLDAH and uses FLDAH (which is a numeric field). When the application
|
|
program reads RECORD1 and finds response indicator 16 set on, the Dup key
|
|
was pressed and FLDA contains hex 1Cs. The program uses FLDAH without changing
|
|
its contents (which are the contents from the previous input received from
|
|
the display device).</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rzakcmstdfdupprogramming.htm">Programming for the Dup key</a></strong><br />
|
|
Read this topic to learn the procedure of duplicating entire fields.</li>
|
|
</ul>
|
|
|
|
<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> |