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

109 lines
5.8 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="ERRSFL (Error Subfile) keyword for display files" />
<meta name="abstract" content="Use this file-level keyword to specify that messages should be displayed using a system-supplied error subfile." />
<meta name="description" content="Use this file-level keyword to specify that messages should be displayed using a system-supplied error subfile." />
<meta name="DC.subject" content="ERRSFL (Error Subfile) keyword, Error Subfile (ERRSFL) keyword" />
<meta name="keywords" content="ERRSFL (Error Subfile) keyword, Error Subfile (ERRSFL) 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="rzakcmstdferrsf" />
<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>ERRSFL (Error Subfile) keyword for display files</title>
</head>
<body id="rzakcmstdferrsf"><a name="rzakcmstdferrsf"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">ERRSFL (Error Subfile) keyword for display files</h1>
<div><p>Use this file-level keyword to specify that messages should be
displayed using a system-supplied error subfile.</p>
<div class="section"><p>Messages that display in the error subfile are system validity
check messages and messages associated with the following keywords:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="1" rules="rows"><tbody><tr><td align="left" valign="top" width="50%"><p>ERRMSG<br />
ERRMSGID<br />
SFLMSG<br />
SFLMSGID<br />
CHECK(M10)<br />
CHECK(M11)</p>
</td>
<td align="left" valign="top" width="50%"><p>CHECK(VN)<br />
CHECK(VNE)<br />
COMP<br />
RANGE<br />
VALUES</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="p">Validity check messages associated with the following input errors
are also displayed in the error subfile: <ul><li>Errors in floating point operations</li>
<li>Decimal position entry errors</li>
</ul>
</div>
<p>This allows you to page through all the error messages issued
when a record is written to the display, and all the validity check error
messages issued when a record is read from the display. The system displays
the error subfile on the message line. If the message line overlaps a record
already displayed on the screen, the ERRSFL keyword is ignored.</p>
<p>This
keyword has no parameters.</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 ERRSFL keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A MSGLOC(24)
00020A ERRSFL
00030A R RCD1
00040A FIELD1 5A B 2 3
00050A 10 ERRMSGID(MSG0001 MSGF1 10 &amp;MDTA);
00060A FIELD2 5A B 5 7
00070A ERRMSG('ERROR MSG 1' 11)
00080A FIELD3 4S I 7 7RANGE(1000 9999)
00090A CHKMSGID(MSG0002 MSGF1 &amp;MDTA1);
00100A FIELD4 10A B 8 7CHECK(VN)
00110A MDTA 78A P
00120A MDTA1 4A P
A</pre>
<p>In this example, when RCD1 is read from the display,
any previous messages in the error subfile are cleared. Then, if FIELD3 does
not contain a value in the range 1000 to 9999 and FIELD4 does not contain
a valid name, the system places the message MSG0002 and the system message
associated with CHECK(VN) in the error subfile and displays the error subfile
on line 24 of the display. The user can view the messages by pressing the
Page Up and Page Down keys.</p>
<p>When RCD1 is read again from the display,
the previous messages in the error subfile are cleared. Then, if FIELD3 and
FIELD4 are valid, control returns to the application. If FIELD1 and FIELD2
are not valid, when the application writes RCD1 to the display with indicators
10 and 11 on, the system places the message MSG0001 and the text <samp class="codeph">ERROR
MSG 1</samp> in the error subfile and displays the error subfile on line
24 of the display. The user can view the messages by pressing the Page Up
and Page Down keys.</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>