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

84 lines
5.1 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="Considerations for specifying RETKEY and RETCMDKEY keyword" />
<meta name="abstract" content="These rules must be considered when you specify the RETKEY and RETCMDKEY keywords." />
<meta name="description" content="These rules must be considered when you specify the RETKEY and RETCMDKEY keywords." />
<meta name="DC.Relation" scheme="URI" content="s36retkeyretcmd.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="rzakcretkey" />
<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>Considerations for specifying RETKEY and RETCMDKEY keyword</title>
</head>
<body id="rzakcretkey"><a name="rzakcretkey"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Considerations for specifying RETKEY and RETCMDKEY keyword</h1>
<div><p>These rules must be considered when you specify the RETKEY and
RETCMDKEY keywords.</p>
<div class="section"><ul><li>The file must specify a separate indicator area (INDARA keyword).</li>
<li>RETKEY and RETCMDKEY are ignored on the first output operation after a
file is opened. The retain function is valid only between record formats in
the same display file.</li>
<li>The response indicator of the VLDCMDKEY keyword is set by the <span class="keyword">i5/OS™</span> program according to the current
valid command keys, including the keys retained when you specify the RETKEY
and RETCMDKEY keywords.</li>
<li>Neither keyword is allowed on a subfile format (SFL keyword) or on a user-defined
record (USRDFN keyword).</li>
<li>You cannot specify either RETKEY or RETCMDKEY in a file that contains
the ALTHELP, ALTPAGEUP, or ALTPAGEDWN keyword.</li>
</ul>
<p>Option indicators are not valid for these keywords.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the RETKEY and RETCMDKEY keywords.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A INDARA
A R RECORD1 CFO1(01 'EXIT SCREEN')
A CFO2(02 'SET ON IN02')
A ROLLUP(03)
A 08 CLEAR(03 'CLEAR KEY')
A 1 3'COMPANY NAME'
A 1 25'CF01 TO EXIT'
A R RECORD2 RETKEY
A RETCMDKEY
A OVERLAY
A FIELD1 4A B 5 5
A R RECORD3 RETKEY
A CF01(90 'ALTERNATE CF01')
A FIELD1 10A B 7 5
A</pre>
<p>The records are displayed in the following order: RECORD1,
RECORD2, RECORD3.</p>
<p>When RECORD1 is displayed, CF01, CF02, Clear, and
Page Up keys are activated. The same keys are valid for RECORD2, because RETKEY
and RETCMDKEY are specified. Because RECORD3 specifies RETKEY, the Clear and
Page Up keys are valid. CF01 has been redefined for this record. CF02 is not
valid for this record.</p>
<div class="note"><span class="notetitle">Note:</span> The retain function does
not require the record format to be displayed. (RECORD3 uses function keys
defined in RECORD1, but because no OVERLAY keyword is specified in RECORD3,
the display is erased before RECORD3 is displayed.)</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="s36retkeyretcmd.htm" title="Use these record-level keywords to indicate that function keys, command function (CFnn) keys, or command attention (CAnn) keys, which were enabled on a display, should be retained when the record you are defining is displayed.">RETKEY (Retain Function Keys) and RETCMDKEY (Retain Command Keys) keywords</a></div>
</div>
</div>
</body>
</html>