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

111 lines
6.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="ERASEINP (Erase Input) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword with the OVERLAY keyword to erase unprotected input-capable fields already on the display. (Unprotected input-capable fields are fields for which the DSPATR(PR) keyword is not in effect.)" />
<meta name="description" content="Use this record-level keyword with the OVERLAY keyword to erase unprotected input-capable fields already on the display. (Unprotected input-capable fields are fields for which the DSPATR(PR) keyword is not in effect.)" />
<meta name="DC.subject" content="ERASEINP (Erase Input) keyword, Erase Input (ERASEINP) keyword" />
<meta name="keywords" content="ERASEINP (Erase Input) keyword, Erase Input (ERASEINP) 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="rzakcmstdferinp" />
<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>ERASEINP (Erase Input) keyword for display files</title>
</head>
<body id="rzakcmstdferinp"><a name="rzakcmstdferinp"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">ERASEINP (Erase Input) keyword for display files</h1>
<div><p>Use this record-level keyword with the OVERLAY keyword to erase
unprotected input-capable fields already on the display. (Unprotected input-capable
fields are fields for which the DSPATR(PR) keyword is not in effect.)</p>
<div class="section"><p>The fields are erased before the record format you are defining
is displayed. Input-capable fields in the record format you are defining are
not erased.</p>
<p>See the <a href="../books/sc415715.pdf" target="_blank">Application Display Programming book</a><img src="wbpdf.gif" alt="Link to PDF" /> for information about how to
use ERASEINP in files that are used in the System/36™ environment.</p>
<div class="p">The format
of the keyword is: <pre>ERASEINP[(*MDTON | *ALL)]</pre>
</div>
<p>To
erase all input-capable fields already on the display, specify the *ALL parameter.
To erase only input-capable fields that have their changed data tags (MDTs)
set on, specify the *MDTON parameter. Specifying ERASEINP(*MDTON) or ERASEINP
has the same effect as pressing the Erase Input key.</p>
<p>The OVERLAY keyword
must be specified whenever ERASEINP is specified.</p>
<p>When the MDTOFF keyword
is specified on the same record format as ERASEINP, two conditions can occur:</p>
<ul><li>ERASEINP(*ALL) implies MDTOFF(*UNPR), unless the MDTOFF(*ALL) keyword
is specified.</li>
<li>If the ERASEINP or ERASEINP(*MDTON) is specified with MDTOFF(*ALL), the
end effect is as if ERASEINP(*ALL) and MDTOFF(*ALL) are both specified.</li>
</ul>
<p>If the ERASEINP and PROTECT keywords are both in effect for an output
operation, the <span class="keyword">i5/OS™</span> operating
system first erases the input-capable fields specified on the ERASEINP parameter
value, and then protects all input-capable fields on the display from input
typing.</p>
<p>ERASEINP reduces line traffic because record formats already
displayed can be reused and do not need to be sent to the display again.</p>
<p>A
warning message appears at file creation time if the ERASEINP keyword is specified
in a record with the DSPMOD keyword. At run time, the ERASEINP keyword is
ignored when the display mode changes.</p>
<p>Option indicators are valid for
this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the ERASEINP keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A*
00020A*
00030A*
00040A R RECORD1 OVERLAY
00050A : ERASEINP
00060A :
00070A :
00080A* (All changed input-capable fields on the screen are erased)
00090A :
00100A :
00110A :
00120A R RECORD2 OVERLAY
00130A : ERASEINP(*ALL)
00140A :
00150A :
00160A* (All unprotected input-capable fields on the screen are erased
00170A* whether changed or not)
00180A
00190A
00200A R RECORD3 OVERLAY
00210A 32 ERASEINP(*MDTON)
00220A N32 ERASEINP(*ALL)
00230A FIELD1 5 I DSPATR(PR)
00240A :
00250A :
00260A :
00270A* (FIELD1 is never erased)
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>
</body>
</html>