friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstdfsflms.htm

155 lines
9.7 KiB
HTML
Raw Blame History

<?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] [&amp;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 &amp;RPLTXT);
00110A 12 SFLMSGID(USR0007 PAYROLL/UMSGEF1 +
00120A 12 &amp;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>
Reference in New Issue View Git Blame Copy Permalink