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

79 lines
4.6 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="HOME (Home) keyword for display files" />
<meta name="abstract" content="Use this file- or record-level keyword to specify that you want to recognize and handle the Home key through your program." />
<meta name="description" content="Use this file- or record-level keyword to specify that you want to recognize and handle the Home key through your program." />
<meta name="DC.subject" content="HOME (Home) keyword" />
<meta name="keywords" content="HOME (Home) 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="rzakcmstdfhome" />
<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>HOME (Home) keyword for display files</title>
</head>
<body id="rzakcmstdfhome"><a name="rzakcmstdfhome"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">HOME (Home) keyword for display files</h1>
<div><p>Use this file- or record-level keyword to specify that you want
to recognize and handle the Home key through your program.</p>
<div class="section"><p>See the <a href="s36env.htm">System/36 environment considerations for display files</a> topic for special considerations
when specifying the HOME keyword in files that are used in the System/36™ environment.</p>
<div class="p">The
format of the keyword is: <pre>HOME[(response-indicator ['text'])]</pre>
</div>
<p>If you press the Home key and the cursor is not already
at the home position, the cursor returns to the home position, even if you
do not specify the HOME keyword.</p>
<p>If the cursor is already at the home
position when the Home key is pressed, the <span class="keyword">i5/OS™</span> operating
system returns control to your program as it does when a command attention
key is pressed (no data is received from the device). In this situation, if
you have not specified the HOME keyword, the <span class="keyword">i5/OS</span> operating
system sends a message indicating that the key is not valid at that time.</p>
<div class="p">The home position is one of the following positions (in
order of priority): <ul><li>The cursor position specified by the last output operation</li>
<li>The first unprotected input field</li>
<li>Position 1, line 1</li>
</ul>
</div>
<p>The optional text is included on the computer printout created
at program compilation time to explain the intended use of the indicator.
This text's only function in the file or the program is 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 computer 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 HOME keyword so that if the cursor is in the home position when the Home
key is pressed, control returns to the program with response indicator 95
set on.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00030A HOME(95 'Home key')
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>