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

177 lines
8.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="ALTPAGEDWN/ALTPAGEUP (Alternative Page Down/Alternative Page Up) keyword for display files" />
<meta name="abstract" content="Use these file-level keywords to assign command function (CF) keys as alternative Page Down/Page Up keys." />
<meta name="description" content="Use these file-level keywords to assign command function (CF) keys as alternative Page Down/Page Up keys." />
<meta name="DC.subject" content="ALTPAGEDWN/ALTPAGEUP (Alternative Page Down/Alternative Page Up) keywords, Alternative Page Down/Alternative Page Up (ALTPAGEDWN/ALTPAGEUP) keywords" />
<meta name="keywords" content="ALTPAGEDWN/ALTPAGEUP (Alternative Page Down/Alternative Page Up) keywords, Alternative Page Down/Alternative Page Up (ALTPAGEDWN/ALTPAGEUP) keywords" />
<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="rzakcmstdfalpud" />
<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>ALTPAGEDWN/ALTPAGEUP (Alternative Page Down/Alternative Page Up) keyword
for display files</title>
</head>
<body id="rzakcmstdfalpud"><a name="rzakcmstdfalpud"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">ALTPAGEDWN/ALTPAGEUP (Alternative Page Down/Alternative Page Up) keyword
for display files</h1>
<div><p>Use these file-level keywords to assign command function (CF) keys
as alternative Page Down/Page Up keys.</p>
<div class="section"><p>When either the Page keys or the CF keys are pressed, the page
function is called. The alternative Page Down and Page Up keys function only
on the displays defined in the file with the ALTPAGEDWN or ALTPAGEUP keyword.
They do not function on system displays, such as message help.</p>
<div class="p">The format
for each of these keywords is: <pre>ALTPAGEDWN[(CFnn)]
ALTPAGEUP[(CFnn)]</pre>
</div>
<p>The valid values for the optional parameters
are CF01 through CF24. If the parameter is not specified, CF08 is the default
for ALTPAGEDWN and CF07 is the default for ALTPAGEUP.</p>
<div class="p">The PAGEDOWN/PAGEUP
keyword should also be specified if you want your program to handle any situation
where the user has pressed a Page key or the alternative CFnn key and the <span class="keyword">i5/OS™</span> program cannot move the text
lines on the display. If you do not specify the PAGEDOWN/PAGEUP keyword, a
message indicating the key is not valid is displayed when either a Page key
or the alternative CFnn key is pressed and the <span class="keyword">i5/OS</span> operating
system cannot move the text lines on the display. See the PAGEDOWN/PAGEUP
keywords topic for more information about how to specify PAGEDOWN/PAGEUP. <div class="note"><span class="notetitle">Note:</span> Throughout
this keyword description, PAGEDOWN means the PAGEDOWN or the ROLLUP keyword.
PAGEUP means the PAGEUP or the ROLLDOWN keyword.</div>
</div>
<p>If you specify
a response indicator on the PAGEDOWN or PAGEUP keyword, the response indicator
is set on and returned to your program when either the Page key or the alternative
CFnn key is pressed and the <span class="keyword">i5/OS</span> operating
system cannot move the text lines on the display.</p>
<p>If you specify option
indicators on the PAGEDOWN or PAGEUP keyword, the same option indicators apply
to the ALTPAGEDWN or ALTPAGEUP keyword, in the order given. That is, when
the indicator condition is true, control will be returned to your program
when either the Page key or the CFnn key is pressed and the <span class="keyword">i5/OS</span> operating
system cannot move the text lines on the display.</p>
<p>The
following keywords cannot be specified in a file with an ALTPAGEDWN keyword
that has no parameter (CF08 default):</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><tbody><tr><td valign="top" width="50%"><p>ALTHELP(CA08)<br />
ALTPAGEUP(CF08)<br />
CA08<br />
CF08<br />
MNUCNL(CA08)<br />
MNUBARSW(CA08)<br />
MOUBTN(...CA08)</p>
</td>
<td valign="top" width="50%"><p>PSHBTNCHC(...CA08)<br />
SFLDROP(CA08)<br />
SFLDROP(CF08)<br />
SFLENTER(CA08)<br />
SFLENTER(CF08)<br />
SFLFOLD (CA08)<br />
SFLFOLD (CF08)</p>
</td>
</tr>
</tbody>
</table>
</div>
<p>The following keywords cannot be specified in
a file with an ALTPAGEUP keyword that has no parameter (CF07 default):</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><tbody><tr><td valign="top" width="50%"><p>ALTHELP(CA07)<br />
ALTPAGEDWN(CF07)<br />
CA07<br />
CF07<br />
MNUCNL(CA07)<br />
MNUBARSW(CA07)<br />
MOUBTN(...CA07)</p>
</td>
<td valign="top" width="50%"><p>PSHBTNCHC(...CA07)<br />
SFLDROP(CA07)<br />
SFLDROP(CF07)<br />
SFLENTER(CA07)<br />
SFLENTER(CF07)<br />
SFLFOLD (CA07)<br />
SFLFOLD (CF07)</p>
</td>
</tr>
</tbody>
</table>
</div>
<p>Similarly, the following keywords cannot be specified
in a file with ALTPAGEDWN(CF<var class="varname">nn</var>) or ALTPAGEUP(CF<var class="varname">nn</var>)
(where <var class="varname">nn</var> is the same number):</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><tbody><tr><td valign="top" width="50%"><p>ALTHELP(CA<var class="varname">nn</var>)<br />
CA<var class="varname">nn</var><br />
CF<var class="varname">nn</var><br />
MNUCNL(CA<var class="varname">nn</var>)<br />
MNUBARSW(CA<var class="varname">nn</var>)<br />
MOUBTN(...CA<var class="varname">nn</var>)<br />
PSHBTNCHC(...CA<var class="varname">nn</var>)</p>
</td>
<td valign="top" width="50%"><p>SFLDROP(CA<var class="varname">nn</var>)<br />
SFLDROP(CF<var class="varname">nn</var>)<br />
SFLENTER(CA<var class="varname">nn</var>)<br />
SFLENTER(CF<var class="varname">nn</var>)<br />
SFLFOLD (CA<var class="varname">nn</var>)<br />
SFLFOLD (CF<var class="varname">nn</var>)</p>
</td>
</tr>
</tbody>
</table>
</div>
<p>Also, you cannot specify the same command function (CF) key on
both the ALTPAGEDWN and the ALTPAGEUP keywords.</p>
<p>You cannot specify RETKEY
or RETCMDKEY in a file with the ALTPAGEDWN or ALTPAGEUP keyword.</p>
<p>The
ALTPAGEDWN and ALTPAGEUP keywords are allowed only in files containing a pageable
area (either a subfile or a PAGEDOWN/PAGEUP keyword).</p>
<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 ALTPAGEDWN and ALTPAGEUP keywords.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A ALTPAGEUP
A ALTPAGEDWN
A R SUBFILE SFL
A FIELD1 20A 5 5
A R CONTROL SFLCTL(SUBFILE)
A SFLSIZ(30)
A SFLPAG(10)
A SFLDSP
A</pre>
<p>The CF07 and CF08 keys are alternative page keys. During
display of the subfile, if the user presses the CF07/CF08 key or a Page key,
the <span class="keyword">i5/OS</span> operating system
pages the subfile. If the <span class="keyword">i5/OS</span> operating
system cannot page the subfile without going beyond the end or beyond the
beginning, a message is displayed indicating the key is not valid at that
time (PAGEDOWN/PAGEUP not specified).</p>
</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>