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

77 lines
4.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="CLEAR (Clear) keyword for display files" />
<meta name="abstract" content="Use this file- or record-level keyword to specify that your program is to receive control if the workstation user presses the Clear key, and optionally, that the i5/OS operating system is to set on the specified response indicator." />
<meta name="description" content="Use this file- or record-level keyword to specify that your program is to receive control if the workstation user presses the Clear key, and optionally, that the i5/OS operating system is to set on the specified response indicator." />
<meta name="DC.subject" content="CLEAR (Clear) keyword" />
<meta name="keywords" content="CLEAR (Clear) 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="rzakcmstdfclear" />
<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>CLEAR (Clear) keyword for display files</title>
</head>
<body id="rzakcmstdfclear"><a name="rzakcmstdfclear"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">CLEAR (Clear) keyword for display files</h1>
<div><p>Use this file- or record-level keyword to specify that your program
is to receive control if the workstation user presses the Clear key, and optionally,
that the <span class="keyword">i5/OS™</span> operating
system is to set on the specified response indicator.</p>
<div class="section"><p>See the <a href="s36env.htm">System/36 environment considerations for display files</a> topic for special considerations
when you specify the CLEAR keyword in files that are used in the System/36™ environment.</p>
<p>The
format of the keyword is:</p>
<pre>CLEAR[(response-indicator ['text'])]</pre>
<p>The Clear key is processed like a command attention key
(no input data is transmitted from the device). The <span class="keyword">i5/OS</span> operating
system does not clear the display; your program must perform the required
function (such as clearing fields or records from the display).</p>
<p>If you
do not specify this keyword and the display station user presses the Clear
key, the <span class="keyword">i5/OS</span> program
displays a message indicating that it is not valid at that time.</p>
<div class="note"><span class="notetitle">Note:</span> On
display stations with the typewriter-like keyboard, the Clear key is activated
by pressing CMD, then pressing the Shift key and the left arrow above the
Field Exit key. On workstations with the data-entry keyboard, press CMD, then
press the Shift key and the farthest right blank key on the top row.</div>
<p>The
optional text is included on the printout created at program compilation time
to explain the intended use of the indicator. This text has no function in
the file or the program other than as a comment. The single quotation marks
are required. If you specify more than 50 characters between the single quotation
marks, the text is truncated to 50 characters on the program printout.</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 CLEAR keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00101A CLEAR(10 'Clear key pressed')
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>