128 lines
7.2 KiB
HTML
128 lines
7.2 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="SLNO (Starting Line Number) keyword for display files" />
|
|
<meta name="abstract" content="Use this record-level keyword to specify a starting line number for the record format you are defining." />
|
|
<meta name="description" content="Use this record-level keyword to specify a starting line number for the record format you are defining." />
|
|
<meta name="DC.subject" content="SLNO (Starting Line Number) keyword, Starting Line Number (SLNO) keyword" />
|
|
<meta name="keywords" content="SLNO (Starting Line Number) keyword, Starting Line Number (SLNO) 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="rzakcmstdfslno" />
|
|
<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>SLNO (Starting Line Number) keyword for display files</title>
|
|
</head>
|
|
<body id="rzakcmstdfslno"><a name="rzakcmstdfslno"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">SLNO (Starting Line Number) keyword for display files</h1>
|
|
<div><p>Use this record-level keyword to specify a starting
|
|
line number for the record format you are defining.</p>
|
|
<div class="section"><p>If specified, SLNO adjusts the actual line numbers for each field
|
|
in the record format. If you do not specify SLNO, fields in the record format
|
|
are displayed on the lines you specify for them in positions 39 through 41.</p>
|
|
<div class="p">The
|
|
format of the keyword is: <pre>SLNO(n | *VAR)</pre>
|
|
</div>
|
|
<div class="p">You
|
|
can specify one of two parameter values for this keyword: <ul><li>Specify <em>n</em>, where n is a value between 1 and 27. All fields in the
|
|
record format are offset n-1 lines down the display from their specified locations.
|
|
If SLNO(1) is specified, the record format must not contain a field starting
|
|
at line 1, position 1.</li>
|
|
<li>Specify *VAR to enable your program to set the starting line number at
|
|
runtime before displaying the record format. At file creation time, the <span class="keyword">i5/OS™</span> program sets the starting
|
|
line number to one. A warning message appears at file creation time if the
|
|
record contains a field starting at line 1, position 1. If your program does
|
|
not set the starting line number or sets it to zero, the <span class="keyword">i5/OS</span> operating system
|
|
assumes its value is one. If your program sets the starting line number to
|
|
a value such that the first field in the record format does not all fit on
|
|
the display, or sets it to a negative value, the <span class="keyword">i5/OS</span> operating system
|
|
sends a notify message (CPF5002) to your program, and the record is not displayed.
|
|
If the starting line number is set to one and the record format contains a
|
|
field starting at line 1, position 1, the <span class="keyword">i5/OS</span> operating system
|
|
sends an error message (CPF5398) to your program. The record is not displayed.
|
|
<p>To calculate the line on which a field is actually displayed, subtract
|
|
one from the line number specified in positions 39 through 41 and add the
|
|
starting line number to the result. The record format begins on the line specified
|
|
with SLNO unless a field is defined at line 1, position 1. In that case, the
|
|
beginning attribute byte is in the last position of the previous line and
|
|
the starting line of the format is one less than that specified by SLNO.</p>
|
|
<p>When
|
|
*VAR is specified, no field in the record can occupy the last position on
|
|
the display.</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<p>If a CLRL(nn) or CLRL(*END) keyword is also in effect for this
|
|
record when it is to be displayed, lines on the display are cleared beginning
|
|
with the starting line number for the format.</p>
|
|
<p>If you use the SLNO(*VAR)
|
|
keyword with the OVERLAY keyword but without the CLRL keyword and then write
|
|
the record several times, each time with a different starting number, the
|
|
previous record is deleted before the new record displays.</p>
|
|
<div class="p">The <span class="keyword">i5/OS</span> program checks the starting
|
|
line number to determine whether the previous output operation to the record
|
|
had the same starting line number if you use the SLNO keyword with the following
|
|
keywords: <p>ERRMSG<br />
|
|
ERRMSGID<br />
|
|
PUTOVR<br />
|
|
PUTRETAIN</p>
|
|
</div>
|
|
<p>If the starting numbers are the same, the actions
|
|
specified by the ERRMSG, ERRMSGID, PUTOVR, or the PUTRETAIN keyword is performed.</p>
|
|
<p>If
|
|
the starting line numbers are not the same, the ERRMSG, ERRMSGID, PUTOVR,
|
|
or PUTRETAIN keyword is ignored, and the record format displays with the lines
|
|
adjusted to the new value.</p>
|
|
<div class="p">The SLNO keyword is not allowed in a record
|
|
format that has one of the following keywords specified: <p>ASSUME<br />
|
|
KEEP<br />
|
|
SFL<br />
|
|
SFLCTL<br />
|
|
USRDFN</p>
|
|
</div>
|
|
<p>SLNO 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 SLNO keyword.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
00010A R RECORD1 SLNO(*VAR)
|
|
00020A FIELD1 5 I 2 2
|
|
00030A FIELD2 5 B 3 2
|
|
00040A
|
|
00050A R RECORD2 SLNO(2)
|
|
00060A FIELD3 5 10 2
|
|
00070A FIELD4 5 B 10 13
|
|
A</pre>
|
|
<p>In this example, when the starting line number is zero
|
|
or one, FIELD1 is displayed on line 2 and FIELD2 is displayed on line 3, as
|
|
specified. When the starting line number is set to 2 in your program, FIELD1
|
|
is displayed on line 3 (2 - 1 + 2 = 3) and FIELD2 is displayed on line 4 (2
|
|
- 1 + 3 = 4).</p>
|
|
<p>FIELD3 and FIELD4 are always displayed on line 11 (2 -
|
|
1 + 10 = 11).</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> |