127 lines
7.7 KiB
HTML
127 lines
7.7 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="ALWROL (Allow Roll) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this record-level keyword to allow your program to page through data in a window on the display when displaying the record format you are defining." />
|
||
|
|
<meta name="description" content="Use this record-level keyword to allow your program to page through data in a window on the display when displaying the record format you are defining." />
|
||
|
|
<meta name="DC.subject" content="ALWROL (Allow Roll) keyword, Allow Roll (ALWROL) keyword" />
|
||
|
|
<meta name="keywords" content="ALWROL (Allow Roll) keyword, Allow Roll (ALWROL) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfrol.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfrnm.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="rzakcmstdfalwr" />
|
||
|
|
<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>ALWROL (Allow Roll) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfalwr"><a name="rzakcmstdfalwr"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">ALWROL (Allow Roll) keyword for display files</h1>
|
||
|
|
<div><p>Use this record-level keyword to allow your program to page through
|
||
|
|
data in a window on the display when displaying the record format you are
|
||
|
|
defining.</p>
|
||
|
|
<div class="section"><p>The window consists of display lines between and including a start
|
||
|
|
line and end line defined in your program. The number of lines to be paged
|
||
|
|
through and the direction in which to page through them are defined in your
|
||
|
|
program.</p>
|
||
|
|
<p>This keyword has no parameters.</p>
|
||
|
|
<p>When your program sends
|
||
|
|
an output operation to this record format, the <span class="keyword">i5/OS™</span> operating
|
||
|
|
system pages through data already in the window up or down the display and
|
||
|
|
then displays the record format. Data paged past the start line or end line
|
||
|
|
is lost. After you page through, your program cannot send an input operation
|
||
|
|
to record formats that were either partially or completely within the window
|
||
|
|
before the page.</p>
|
||
|
|
<p>To use the ALWROL function in COBOL, use the WRITE
|
||
|
|
ROLLING statement.</p>
|
||
|
|
<p>The ALWROL keyword does not allow the display station
|
||
|
|
user to page through data; it only allows your program to page through data
|
||
|
|
on the display. To allow paging of data by the display station user, specify
|
||
|
|
the ROLLUP and ROLLDOWN keywords or specify a subfile with subfile page not
|
||
|
|
equal to subfile size.</p>
|
||
|
|
<p>To prevent deleting paging records, specify the
|
||
|
|
OVERLAY keyword or the CLRL (Clear Line) keyword with the ALWROL keyword.</p>
|
||
|
|
<p>Do not specify the PUTRETAIN keyword at the field level
|
||
|
|
when you also specify the ALWROL keyword. If you do so, the <span class="keyword">i5/OS</span> operating
|
||
|
|
system sends message <tt class="sysout">CPF5014</tt> when
|
||
|
|
your program sends an output operation regardless of your selection of PUTRETAIN.</p>
|
||
|
|
<div class="p">If
|
||
|
|
you specify the ALWROL keyword with the following keywords you must specify
|
||
|
|
option indicators for them: <p>ERRMSG<br />
|
||
|
|
ERRMSGID<br />
|
||
|
|
PUTOVR<br />
|
||
|
|
PUTRETAIN (at the record-level)</p>
|
||
|
|
</div>
|
||
|
|
<p>Your program cannot at the same
|
||
|
|
time select one of these keywords and send an output operation that attempts
|
||
|
|
to use the ALWROL function (the <span class="keyword">i5/OS</span> operating
|
||
|
|
system sends CPF5014).</p>
|
||
|
|
<div class="p">The ALWROL keyword cannot be specified with any
|
||
|
|
of the following keywords: <p>ASSUME<br />
|
||
|
|
KEEP<br />
|
||
|
|
SFL<br />
|
||
|
|
SFLCTL<br />
|
||
|
|
USRDFN</p>
|
||
|
|
</div>
|
||
|
|
<p>A warning message appears at file creation time if the
|
||
|
|
ALWROL keyword is specified on a record with the DSPMOD keyword. At runtime,
|
||
|
|
the ALWROL keyword is ignored when the display mode changes.</p>
|
||
|
|
<p>The ALWROL
|
||
|
|
keyword cannot be specified for the record format specified by the PASSRCD
|
||
|
|
keyword.</p>
|
||
|
|
<p>Option indicators are not valid for this keyword.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
|
the ALWROL keyword.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A <strong>1</strong> R RECORD1 ALWROL OVERLAY <strong>2</strong>
|
||
|
|
00020A FLDA 79 I 23 2CHECK(LC)
|
||
|
|
00030A 44 <strong>3</strong> ERRMSG('Record not found' 44)
|
||
|
|
A</pre>
|
||
|
|
<dl><dt class="dlterm">1</dt>
|
||
|
|
<dd>The application program can send an output operation to RECORD1, displaying
|
||
|
|
FLDA on line 23, position 2. In a subsequent output operation, the program
|
||
|
|
can page through RECORD1 (in this case, FLDA) up or down the display or entirely
|
||
|
|
off the display. A normal case is to page up one line. The originally typed
|
||
|
|
data is then displayed on line 22, and a new input field is displayed on line
|
||
|
|
23. The display station user cannot key into, and the program cannot read,
|
||
|
|
the field on line 22. The field on line 22 can be pushed up the display by
|
||
|
|
subsequent output operations in this way until it passes the start line of
|
||
|
|
the window (as specified in the program) or line 1 of the display.</dd>
|
||
|
|
<dt class="dlterm">2</dt>
|
||
|
|
<dd>The OVERLAY keyword prevents paged records from being deleted.</dd>
|
||
|
|
<dt class="dlterm">3</dt>
|
||
|
|
<dd>The ERRMSG keyword is shown to illustrate how ERRMSG affects the ALWROL
|
||
|
|
function. The program cannot at the same time set option indicator 44 on and
|
||
|
|
send an output operation that requests the ALWROL function. If the program
|
||
|
|
does so, the <span class="keyword">i5/OS</span> operating
|
||
|
|
system sends a notify message CPF5014.</dd>
|
||
|
|
</dl>
|
||
|
|
</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 class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rzakcmstdfsfrol.htm" title="Use this field-level keyword in the subfile control record format to specify that the workstation user can type a value into this field to tell the i5/OS operating system how many records to page up or down when the appropriate paging key is pressed.">SFLROLVAL (Subfile Roll Value) keyword for display files</a></div>
|
||
|
|
<div><a href="rzakcmstdfsfrnm.htm" title="Use this field-level keyword on the subfile control record format to specify that the page of the subfile to be displayed is the page containing the record whose relative record number is in this field.">SFLRCDNBR (Subfile Record Number) keyword for display files</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|