121 lines
8.1 KiB
HTML
121 lines
8.1 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="SFLMSGRCD (Subfile Message Record) keyword for display files" />
|
|
<meta name="abstract" content="Use this record-level keyword on the subfile record format to specify that this subfile is to be a message subfile and that the records displayed when the subfile is displayed are to be messages from a program message queue." />
|
|
<meta name="description" content="Use this record-level keyword on the subfile record format to specify that this subfile is to be a message subfile and that the records displayed when the subfile is displayed are to be messages from a program message queue." />
|
|
<meta name="DC.subject" content="SFLMSGRCD (Subfile Message Record) keyword" />
|
|
<meta name="keywords" content="SFLMSGRCD (Subfile Message Record) keyword" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfl.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfctl.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsflnz.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="rzakcmstdfsfmrc" />
|
|
<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>SFLMSGRCD (Subfile Message Record) keyword for display files</title>
|
|
</head>
|
|
<body id="rzakcmstdfsfmrc"><a name="rzakcmstdfsfmrc"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">SFLMSGRCD (Subfile Message Record) keyword for display files</h1>
|
|
<div><p>Use this record-level keyword on the subfile record format to specify
|
|
that this subfile is to be a message subfile and that the records displayed
|
|
when the subfile is displayed are to be messages from a program message queue.</p>
|
|
<div class="section"><div class="p">The format of the keyword is: <pre>SFLMSGRCD(line-number)</pre>
|
|
</div>
|
|
<p>The
|
|
parameter value specified with SFLMSGRCD specifies the first line on the display
|
|
on which messages are displayed. The value specified must not be greater than
|
|
the maximum line number for the display size being used. The number of messages
|
|
displayed depends on the SFLPAG value specified for the subfile.</p>
|
|
<p>For
|
|
more information about building and displaying message subfiles, see the <a href="rzakcmstdfsfpmq.htm">SFLPGMQ (Subfile Program Message Queue) keyword for display files</a> topic.</p>
|
|
<p>The TEXT keyword is valid
|
|
at the record-level for SFLMSGRCD.</p>
|
|
<div class="p">There can be only two predefined
|
|
fields specified on the subfile record format for a message subfile as follows:
|
|
<ul><li>Message identifier. A 4-position, character data type, hidden field. Your
|
|
program uses this field to pass a message identifier to the <span class="keyword">i5/OS™</span> operating
|
|
system. This field must always be the first field defined in the message subfile.
|
|
You must specify the SFLMSGKEY keyword with this field.</li>
|
|
<li>Program queue name. A 10-position, character data type, hidden field.
|
|
Your program passes the name of the program message queue that contains the
|
|
messages in this field. It must be the second field of a subfile message record
|
|
and must immediately follow the first field. If specified also on the subfile
|
|
control record, it can be anywhere within the record specification. You must
|
|
specify SFLPGMQ with this field.</li>
|
|
</ul>
|
|
</div>
|
|
<p>Display size condition names can be specified for SFLMSGRCD and
|
|
are required if the line number for the first message displayed is to change,
|
|
based on display size.</p>
|
|
<p>Data is not returned in your input buffer if
|
|
your program does an input operation for a message subfile.</p>
|
|
<div class="p">The messages
|
|
are displayed as follows: <ul><li>Each message is displayed on a separate line and is truncated if it is
|
|
longer than the display line length.</li>
|
|
<li>Each message starts in position 2. The maximum message length for the
|
|
24 x 80 display size is 76 characters. The maximum message length for the
|
|
27 x 132 display size is 128 characters.</li>
|
|
<li>Each message is displayed with the high intensity (HI) field attribute.</li>
|
|
</ul>
|
|
</div>
|
|
<p>When a message subfile is paged through the <span class="keyword">i5/OS</span> operating
|
|
system, the cursor is positioned at the same location as it was when the Page
|
|
key was pressed.</p>
|
|
<div class="p">Message help is supported for these messages. The workstation
|
|
user chooses which message help is to be displayed by placing the cursor on
|
|
the line containing the message and pressing the Help key. <div class="note"><span class="notetitle">Notes:</span> <ol><li>When SFLMSGRCD is specified, you cannot specify the SFLINZ keyword without
|
|
specifying SFLPGMQ.</li>
|
|
<li>The message subfile, starting on the line specified on SFLMSGRCD, must
|
|
not overlap any displayable fields in the subfile control record, even if
|
|
option indicators are specified on the displayable fields.</li>
|
|
</ol>
|
|
</div>
|
|
</div>
|
|
<p>Option indicators are not valid for this keyword; display
|
|
size condition names are valid.</p>
|
|
</div>
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the SFLMSGRCD keyword.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
00030A R RCDMSG <strong>SFL SFLMSGRCD</strong>(3)
|
|
00040A FLDKEY <strong>SFLMSGKEY</strong>
|
|
00050A FLDPGM <strong>SFLPGMQ</strong>
|
|
00060A R SFLCTL SFLCTL(RCDMSG)
|
|
00070A SFLPAG(17)
|
|
00080A SFLSIZ(17)
|
|
00090A SFLDSP SFLDSPCTL
|
|
A</pre>
|
|
<p>The highlighted keywords are required on
|
|
the subfile record format for a message subfile. The SFLMSGKEY and SFLPGMQ
|
|
keywords must be specified in the order shown.</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 class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="rzakcmstdfsfl.htm" title="Use this record-level keyword to specify that this record format is to be a subfile record format.">SFL (Subfile) keyword for display files</a></div>
|
|
<div><a href="rzakcmstdfsfctl.htm" title="Use this record-level keyword to specify that this record format is to be a subfile control record format. This record format must immediately follow the subfile record format.">SFLCTL (Subfile Control) keyword for display files</a></div>
|
|
<div><a href="rzakcmstdfsflnz.htm" title="Use this record-level keyword on the subfile control record format to specify that the i5/OS operating system is to initialize all records in the subfile on an output operation to the subfile control record format (identified by the SFLCTL keyword).">SFLINZ (Subfile Initialize) keyword for display files</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |