155 lines
9.7 KiB
HTML
155 lines
9.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="SFLMSG (Subfile Message) and SFLMSGID (Subfile Message Identifier) keywords for display files" />
|
||
|
|
<meta name="abstract" content="Use these record-level keywords on the subfile control record format to identify a message to be displayed on the message line when your program does an output operation to the subfile control record format." />
|
||
|
|
<meta name="description" content="Use these record-level keywords on the subfile control record format to identify a message to be displayed on the message line when your program does an output operation to the subfile control record format." />
|
||
|
|
<meta name="DC.subject" content="SFLMSGID (Subfile Message Identifier) keyword, SFLMSG (Subfile Message) keyword, Subfile Message Identifier (SFLMSGID) keyword, Subfile Message (SFLMSG) keyword" />
|
||
|
|
<meta name="keywords" content="SFLMSGID (Subfile Message Identifier) keyword, SFLMSG (Subfile Message) keyword, Subfile Message Identifier (SFLMSGID) keyword, Subfile Message (SFLMSG) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../rbam6/rbam6clmain.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="rzakcmstdfsflms" />
|
||
|
|
<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>SFLMSG (Subfile Message) and SFLMSGID (Subfile Message Identifier)
|
||
|
|
keywords for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfsflms"><a name="rzakcmstdfsflms"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">SFLMSG (Subfile Message) and SFLMSGID (Subfile Message Identifier)
|
||
|
|
keywords for display files</h1>
|
||
|
|
<div><p>Use these record-level keywords on the subfile control record format
|
||
|
|
to identify a message to be displayed on the message line when your program
|
||
|
|
does an output operation to the subfile control record format.</p>
|
||
|
|
<div class="section"><p>Your program has the responsibility to reverse the images of any
|
||
|
|
fields and to position the cursor appropriately in the subfile being displayed.</p>
|
||
|
|
<div class="p">The
|
||
|
|
formats of the keywords are: <pre>SFLMSG('message-text' [response-indicator])</pre>
|
||
|
|
<pre>SFLMSGID(msgid [library-name/]msg-file [response-indicator] [&msg-data])</pre>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">SFLMSG keyword</h4><p>Specify SFLMSG
|
||
|
|
as you do the ERRMSG keyword. The parameters specify a message text and, optionally,
|
||
|
|
a response indicator. The message text is the message to be displayed.</p>
|
||
|
|
<p>If you specify a response indicator, it should be the same
|
||
|
|
as the option indicator used to condition SFLMSG. On the input operation that
|
||
|
|
follows the display of the error message, the <span class="keyword">i5/OS™</span> operating
|
||
|
|
system turns off the indicator. If the response and option indicators are
|
||
|
|
the same, they are both turned off. One exception to this rule is that if
|
||
|
|
the response indicator is also specified for another keyword, such as CHANGE,
|
||
|
|
CAnn, or CFnn, the on/off setting of the response indicator is based on the
|
||
|
|
results of the function provided by the CHANGE or CFnn keyword.</p>
|
||
|
|
<p>When
|
||
|
|
a response indicator is specified, the first 50 characters of the message
|
||
|
|
text are also used as indicator text. Separate response indicator text is
|
||
|
|
not valid for SFLMSG.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">SFLMSGID keyword</h4><p>Specify SFLMSGID
|
||
|
|
as you do the ERRMSGID keyword.</p>
|
||
|
|
<div class="p">For SFLMSGID, the parameters specify:
|
||
|
|
<ul><li>The message identifier for the message to be displayed</li>
|
||
|
|
<li>The message file and, optionally, the library</li>
|
||
|
|
<li>A response indicator</li>
|
||
|
|
<li>A msg-data field name</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>The response indicator, if specified, should be the same as the
|
||
|
|
option indicator used to condition the SFLMSGID keyword. On the subsequent
|
||
|
|
input operation, after the display of the error message, the <span class="keyword">i5/OS</span> operating
|
||
|
|
system turns off the indicator. However, if the response indicator is also
|
||
|
|
specified on another keyword, such as CHANGE, CAnn, or CFnn, the on/off setting
|
||
|
|
of the response indicator is based on the results of the function provided
|
||
|
|
by the CHANGE, CAnn, or CFnn keyword.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> Indicator text cannot be specified
|
||
|
|
on the SFLMSGID keyword.</div>
|
||
|
|
<p>The msg-data field, if specified, contains
|
||
|
|
the replacement text for the specified message. The field must exist in the
|
||
|
|
record format, and the field must be defined as a character field (data type
|
||
|
|
A) with usage P. For more information about how replacement text works, see
|
||
|
|
the SNDPGMMSG (Send Program Message) command in the Control language topic
|
||
|
|
in the <strong>Programming</strong> category of the <span class="keyword">iSeries™ Information Center</span>.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Conditions occurring during message display</h4><p>The
|
||
|
|
display of messages using SFLMSG and SFLMSGID is similar to the display of
|
||
|
|
messages by the <span class="keyword">i5/OS</span> operating
|
||
|
|
system when field validation errors are detected. An important difference
|
||
|
|
from ERRMSG and ERRMSGID is that the program, and not the <span class="keyword">i5/OS</span> operating
|
||
|
|
system, must position the cursor to the appropriate field within the subfile,
|
||
|
|
reverse the image of that field within the subfile, and also optionally reverse
|
||
|
|
the image of more than one field at a time. On the 5250 workstation, blinking
|
||
|
|
cursor and message highlighting are allowed.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> The SFLDSP keyword must
|
||
|
|
be in effect for SFLMSG and SFLMSGID to be processed.</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Restoration of reversed image fields</h4><p>See the Restoration of reversed
|
||
|
|
image fields section in the <a href="rzakcmstdfems.htm">ERRMSG (Error Message) and ERRMSGID (Error Message Identifier) keywords for display files</a> topic.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Priority among selected keywords</h4><p>You can specify
|
||
|
|
either SFLMSG or SFLMSGID several times for a single subfile control record
|
||
|
|
format. In your program, set option indicators to select a particular message
|
||
|
|
to be displayed and to select particular fields to be displayed in reverse
|
||
|
|
image. Several fields can be displayed in reverse image in different records
|
||
|
|
of a subfile when the subfile is displayed again. However, only one message
|
||
|
|
can be displayed at one time.</p>
|
||
|
|
<p>If more than one error
|
||
|
|
message is selected at a time, the <span class="keyword">i5/OS</span> operating
|
||
|
|
system displays the first of the following keywords:</p>
|
||
|
|
<ol><li>ERRMSG (If more than one ERRMSG keyword is selected, the first one selected
|
||
|
|
is displayed.)</li>
|
||
|
|
<li>ERRMSGID (If more than one ERRMSGID keyword is selected, the first one
|
||
|
|
selected is displayed.)</li>
|
||
|
|
<li>SFLMSG (If more than one SFLMSG keyword is selected, the first one selected
|
||
|
|
is displayed.)</li>
|
||
|
|
<li>SFLMSGID (If more than one SFLMSGID keyword is selected, the first one
|
||
|
|
selected is displayed.)</li>
|
||
|
|
<li>Message fields (M in position 38) (If more than one message field is selected,
|
||
|
|
the first one selected is displayed.)</li>
|
||
|
|
</ol>
|
||
|
|
<p>Multiple subfile messages (SFLMSG and SFLMSGID) are allowed on error
|
||
|
|
subfiles.</p>
|
||
|
|
<p>Option indicators are valid for these keywords.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
|
the SFLMSG and SFLMSGID keywords.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A R SFLR SFL
|
||
|
|
00020A*
|
||
|
|
00030A* (at least one displayable field)
|
||
|
|
00040A*
|
||
|
|
00050A R SFLCTLR SFLCTL(SFLR)
|
||
|
|
00060A SFLPAG(17)
|
||
|
|
00070A SFLSIZ(17)
|
||
|
|
00080A SFLDSP SFLDSPCTL
|
||
|
|
00090A 11 SFLMSGID(USR0006 PAYROLL/UMSGF1 +
|
||
|
|
00100A 11 &RPLTXT);
|
||
|
|
00110A 12 SFLMSGID(USR0007 PAYROLL/UMSGEF1 +
|
||
|
|
00120A 12 &RPLTXT);
|
||
|
|
00130A RPLTXT 78A P
|
||
|
|
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 class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../rbam6/rbam6clmain.htm">Control language (CL)</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|