115 lines
6.3 KiB
HTML
115 lines
6.3 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="MSGLOC (Message Location) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this file-level keyword to move the message line to the specified line number." />
|
||
|
|
<meta name="description" content="Use this file-level keyword to move the message line to the specified line number." />
|
||
|
|
<meta name="DC.subject" content="MSGLOC (Message Location) keyword, Message Location (MSGLOC) keyword" />
|
||
|
|
<meta name="keywords" content="MSGLOC (Message Location) keyword, Message Location (MSGLOC) 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="rzakcmstdfmsloc" />
|
||
|
|
<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>MSGLOC (Message Location) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfmsloc"><a name="rzakcmstdfmsloc"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">MSGLOC (Message Location) keyword for display files</h1>
|
||
|
|
<div><p>Use this file-level keyword to move the message line to the specified
|
||
|
|
line number.</p>
|
||
|
|
<div class="section"><div class="p">The format of the keyword is: <pre>MSGLOC(line-number)</pre>
|
||
|
|
</div>
|
||
|
|
<p>The
|
||
|
|
parameter value is required and must be in the range 1 through 28. Any of
|
||
|
|
these numbers are always valid, regardless of the display sizes specified
|
||
|
|
on the DSPSIZ keyword. A diagnostic will be issued when the file is opened
|
||
|
|
if a message location is in the 26 to 28 range for a 24 x 80 display size.</p>
|
||
|
|
<div class="p">If
|
||
|
|
MSGLOC is not specified, the message line is the last line of the display.
|
||
|
|
The message line is the display location for the following messages: <ul><li>Validity check errors</li>
|
||
|
|
<li>Invalid function key messages</li>
|
||
|
|
<li>Messages defined as parameter values for the ERRMSG and SFLMSG keywords</li>
|
||
|
|
<li>Messages identified by the ERRMSGID and SFLMSGID keywords (the entire
|
||
|
|
display is used for message help)</li>
|
||
|
|
<li>Message fields</li>
|
||
|
|
<li>Operator error codes and their associated messages</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>Display size condition names must be specified if the message
|
||
|
|
line for the secondary display size is different from the default message
|
||
|
|
line.</p>
|
||
|
|
<div class="p">If you do not specify the MSGLOC keyword, the following default
|
||
|
|
values are to be established: <dl><dt class="dlterm">24 x 80 display size:</dt>
|
||
|
|
<dd>line 25</dd>
|
||
|
|
<dt class="dlterm">27 x 132 display size:</dt>
|
||
|
|
<dd>line 28</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="p">The default of line 25 for the 24
|
||
|
|
x 80 display size gives the following results: <ul><li>If the display is sent to a 5250 device or a 5251 model 12, line 24 is
|
||
|
|
used as the message line.</li>
|
||
|
|
<li>If the display is sent to a 3180-2 device or a 3197 model D1, D2, W1,
|
||
|
|
or W2 attached to a local 6040 or 6041 controller, or remotely attached to
|
||
|
|
a 5294 or 5394 controller, line 25 is used as the message line.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="p">If the ERRSFL keyword is specified in the file, you cannot specify
|
||
|
|
a message location value of 25 for the 24 x 80 display size or 28 for the
|
||
|
|
27 x 132 display size. When the ERRSFL keyword is in the file, but MSGLOC
|
||
|
|
is not specified, the following default values are to be established: <dl><dt class="dlterm">24 x 80 display size:</dt>
|
||
|
|
<dd>line 24</dd>
|
||
|
|
<dt class="dlterm">27 x 132 display size:</dt>
|
||
|
|
<dd>line 27</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<p>The MSGLOC keyword specification is in effect continuously
|
||
|
|
from file opening to file closing. It can be temporarily overridden if the
|
||
|
|
file you are defining is suspended while another file is opened to the same
|
||
|
|
workstation device. The message location in effect for the other file is used
|
||
|
|
until the file that you are defining is restored.</p>
|
||
|
|
<p>Any data
|
||
|
|
on the message line before the message appears is saved and restored after
|
||
|
|
the Reset key is pressed.</p>
|
||
|
|
<p>Option indicators are not valid for this keyword.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Examples</h4><p>The following examples show how to specify
|
||
|
|
the MSGLOC keyword.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example 1</h4><pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
A MSGLOC(1)
|
||
|
|
A</pre>
|
||
|
|
<p>In this example, the message line is moved to line 1
|
||
|
|
for the primary display size. (Without the DSPSIZ keyword, the primary display
|
||
|
|
size is the 24 x 80 display.)</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example 2</h4><pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
A DSPSIZ(*DS3 *DS4)
|
||
|
|
A MSGLOC(1)
|
||
|
|
A *DS4 MSGLOC(1)
|
||
|
|
A</pre>
|
||
|
|
<p>The message line is moved to line 1 for both the primary
|
||
|
|
display size 1 and the secondary display size 2.</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>
|