ibm-information-center/dist/eclipse/plugins/i5OS.ic.dds_5.4.0.1/msgsubexamp.htm

109 lines
5.6 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="concept" />
<meta name="DC.Title" content="Example: A message subfile using DDS" />
<meta name="abstract" content="The display shows the message subfile defined in this example." />
<meta name="description" content="The display shows the message subfile defined in this example." />
<meta name="DC.subject" content="examples of DDS, message subfile" />
<meta name="keywords" content="examples of DDS, message subfile" />
<meta name="DC.Relation" scheme="URI" content="rbafpmstexamp.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="msgsubexamp" />
<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>Example: A message subfile using DDS</title>
</head>
<body id="msgsubexamp"><a name="msgsubexamp"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Example: A message subfile using DDS</h1>
<div><p>The display shows the message subfile defined in this example.</p>
<pre class="screen"> MESSAGE SUBFILE
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
</pre>
<div class="p">The following keywords are important in the example: <p>SFLMSGKEY<br />
SFLPGMQ<br />
SFLMSGRCD</p>
</div>
<p>Records in the subfile are messages from a message file.</p>
<div class="fignone" id="msgsubexamp__o19"><a name="msgsubexamp__o19"><!-- --></a><span class="figcap">Figure 1. Message subfile</span><pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A*
00020A* MESSAGE SUBFILE
00030A*
00040A R SFLR SFL
00050A SFLMSGRCD(3) <strong>(1)</strong>
00060A MSGKEY <strong>(2)</strong> SFLMSGKEY <strong>(2)</strong>
00070A PGMQ <strong>(2)</strong> SFLPGMQ <strong>(2)</strong>
A
00080A R STLCTLR SFLCTL(SFLR)
00090A SFLSIZ(12) <strong>(3)</strong>
00100A SFLPAG(6) <strong>(3)</strong>
00110A 01 SFLDSP
00120A 02 SFLDSPCTL
00130A 03 SFLCLR
00140A 04 SFLEND <strong>(3)</strong>
A
A
00150A 1 32'MESSAGE SUBFILE'
A</pre>
</div>
<div class="p"><strong>Legend:</strong> <dl><dt class="dlterm">(1)</dt>
<dd>Specifying the SFLMSGRCD keyword on the subfile record format identifies
this subfile as a <em>message subfile</em>. The parameter value specified causes
the subfile to appear on line 3 of the display.</dd>
<dt class="dlterm">(2)</dt>
<dd>The fields MSGKEY and PGMQ are user-defined names given to the two fields
required for the subfile record format for a message subfile. The only specifications
allowed for them are their names and the SFLMSGKEY and SFLPGMQ keywords, in
the order shown. <p>This subfile is built by a series of output operations
to SFLR that place messages in the subfile as subfile records. Messages are
truncated to fit single lines (76 characters or 128 characters, depending
on display size), and second-level help is available. This subfile is displayed
by an output operation to SFLCTLR with option indicator 01 set on.</p>
</dd>
<dt class="dlterm">(3)</dt>
<dd>This subfile is paged by the <span class="keyword">i5/OS™</span> operating system when the
display station user presses a Page Up or a Page Down key. The SFLEND keyword
allows the <span class="keyword">i5/OS</span> operating
system to display a plus sign whenever the subfile can be paged up.</dd>
</dl>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbafpmstexamp.htm" title="This topic provides examples of data description specifications (DDS) for each type of file discussed in this topic. If you choose, you can use the examples in this topic with appropriate high-level language programs.">Examples: DDS for each file type</a></div>
</div>
</div>
</body>
</html>