ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcdisplaysize.htm

213 lines
13 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="Display size condition names" />
<meta name="abstract" content="If you want your program to open this file to display devices with display sizes other than 24 lines x 80 characters, specify the DSPSIZ (Display Size) keyword at the file level." />
<meta name="description" content="If you want your program to open this file to display devices with display sizes other than 24 lines x 80 characters, specify the DSPSIZ (Display Size) keyword at the file level." />
<meta name="DC.Relation" scheme="URI" content="rzakcconditionfield.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="rzakcdisplaysize" />
<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>Display size condition names</title>
</head>
<body id="rzakcdisplaysize"><a name="rzakcdisplaysize"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Display size condition names</h1>
<div><p>If you want your program to open this file to display devices with
display sizes other than 24 lines x 80 characters, specify the DSPSIZ (Display
Size) keyword at the file level.</p>
<div class="section"><p>You can then condition the use of keywords and the location of
fields with the display size condition names specified for the DSPSIZ keyword.
If you do not specify the DSPSIZ keyword, your program can only open this
file to display devices with a 24 x 80 display.</p>
<p>The following table
shows the display size condition name for each display device.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="bottom" width="61.75710594315246%" id="d0e24">Device</th>
<th align="left" valign="bottom" width="21.963824289405682%" id="d0e26">Display size</th>
<th align="left" valign="bottom" width="16.27906976744186%" id="d0e28">Display size condition name (see Note)</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="61.75710594315246%" headers="d0e24 "><p>3179<br />
3180<br />
3196<br />
3197 (Models C1 and C2)<br />
3476<br />
3487 (Models HA, HC, HG, and HW)<br />
3488 (depending on the monitor that is attached to the display device)<br />
3486 (Models BA and BG)<br />
5251 (Models 11 and 12)<br />
5291<br />
5292</p>
</td>
<td align="left" valign="top" width="21.963824289405682%" headers="d0e26 ">24 x 80 characters (1920 characters)</td>
<td align="left" valign="top" width="16.27906976744186%" headers="d0e28 ">*DS3</td>
</tr>
<tr><td align="left" valign="top" width="61.75710594315246%" headers="d0e24 "><p>3180<br />
3197 (Models D1, D2, W1, and W2)<br />
3477 (Models FA, FC, FD, and FG)<br />
3487 (Models HA, HC, HG, and HW)</p>
</td>
<td align="left" valign="top" width="21.963824289405682%" headers="d0e26 ">27 x 132 characters (3564 characters)</td>
<td align="left" valign="top" width="16.27906976744186%" headers="d0e28 ">*DS4</td>
</tr>
<tr><td colspan="3" align="left" valign="top" headers="d0e24 d0e26 d0e28 "><div class="note"><span class="notetitle">Note:</span> You can
specify a user-defined display size condition name instead of *DS3 or *DS4.
See the <a href="rzakcmstdfdspsz.htm">DSPSIZ (Display Size) keyword for display files</a> topic for an explanation
of how to specify user-defined condition names.</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="example"><p><a href="#rzakcdisplaysize__tbl3">Figure 1</a> shows how to specify
the DSPSIZ keyword and display size condition names.</p>
<div class="fignone" id="rzakcdisplaysize__tbl3"><a name="rzakcdisplaysize__tbl3"><!-- --></a><span class="figcap">Figure 1. Specify
the DSPSIZ keyword and display size condition names</span><pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A <strong>1</strong> <strong>2</strong>
00010A DSPSIZ(27 132 *LARGE 24 80 *NORMAL)
00020A R RECORDA
00030A FIELDA 10 0 1 2
00040A FIELDB 10 0 1120
00050A *NORMAL 1 49
00060A FIELDC 10 0 27 1
00070A *NORMAL 15 1
A</pre>
</div>
</div>
<div class="section"><p>In <a href="#rzakcdisplaysize__tbl3">Figure 1</a>, the display size
condition name for the primary display size is defined as *LARGE <strong>1</strong> (column
52 to 64) and the display size condition name for the secondary display size
is defined as *NORMAL <strong>2</strong> (column 66 to 75). FIELDA appears on line 1,
position 2 for both display sizes. FIELDB appears on line 1, position 120
for the primary display size (*LARGE by default), and on line 1, position
49 for the secondary display size (*NORMAL specified in positions 9 through
16). FIELDC appears on line 27, position 1 for the primary display size and
on line 15, position 1 for the secondary display size. Only secondary display
sizes (in this example, *NORMAL) can be used to condition field locations.</p>
<div class="p">Use
display size condition names similar to the way you use option indicators,
except that display size condition names do not appear in your program and
do not appear in the output record. A display size condition is on if the
display file is opened to the corresponding display size. When you use display
size condition names, the following rules apply: <ul><li>Specify the DSPSIZ keyword to designate the primary display size and the
secondary display size. If you do not specify the DSPSIZ keyword, the default
is DSPSIZ(*DS3).</li>
<li>You can specify only one display size condition name for a condition.
You cannot specify AND or OR with other display size condition names or option
indicators.</li>
<li>The display size condition name must start in position 9.</li>
<li>The display size condition name can be user-defined. See the keyword description
for DSPSIZ (Display Size) keyword for display files for more details.</li>
<li>You can specify N in position 8 to designate a NOT condition (for the
primary display size). <div class="note"><span class="notetitle">Note:</span> Specifying N in position 8 implies an OR relationship
between the remaining display size condition names. For example, N*DS4 implies
*DS3 when *DS3 is specified as a secondary display size on the DSPSIZ keyword.</div>
</li>
<li>You must not use display size condition names that alter the line or position
sequence of a field within a record. Fields are ordered in the display file
by primary locations. A severe error occurs at file creation time if the secondary
location alters this primary sequence. <p>For example,
FLD1 and FLD2 are on the primary display. FLD1 is located on line 2, position
2 and FLD2 on line 4, position 2. You cannot use a display size condition
name to display FLD2 before FLD1 on the display (on line 1) for a secondary
display size.</p>
</li>
<li>When you specify the location of a field on a secondary display size,
you can only specify positions 8 through 16 (conditioning) and 39 through
44 (location).</li>
<li>If you do not specify a condition name for a keyword for which condition
names are valid, the primary condition name specified on the DSPSIZ keyword
is the default.</li>
</ul>
</div>
<p><a href="#rzakcdisplaysize__vssc">Table 1</a> shows
the correct and incorrect combinations of display size condition names and
primary display sizes, when both display sizes are specified on the DSPSIZ
keyword and the first one specified varies.</p>
<div class="tablenoborder"><a name="rzakcdisplaysize__vssc"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzakcdisplaysize__vssc" width="100%" frame="border" border="1" rules="all"><caption>Table 1. Valid display size condition specifications</caption><thead align="left"><tr><th align="left" valign="bottom" width="33.33333333333333%" id="d0e118">Display size condition name<sup>1</sup></th>
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e122">24 x 80 DSPSIZ(*DS3...) or DSPSIZ(24 80...)
primary display size</th>
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e124">27 x 132 DSPSIZ(*DS4...) or DSPSIZ(27
132...) primary display size</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e118 ">*DS3</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e122 ">Error<sup>2</sup></td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e124 ">Valid</td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e118 ">*DS4</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e122 ">Valid</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e124 ">Error<sup>2</sup></td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e118 ">N*DS3</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e122 ">Valid</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e124 ">Error<sup>3</sup></td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e118 ">N*DS4</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e122 ">Error<sup>3</sup></td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e124 ">Valid</td>
</tr>
<tr><td colspan="3" align="left" valign="top" headers="d0e118 d0e122 d0e124 "><div class="note"><span class="notetitle">Notes:</span> </div>
<ol><li>See the DSPSIZ keyword description for user-defined names for these display
size condition names.</li>
<li>The display size condition names are in error because that display size
is the primary display size.</li>
<li>These display size condition names are in error because a primary and
a secondary location are implied for the same display size. A condition name
specified with the NOT condition implies an OR relationship. For example,
N*DS4 implies *DS3.</li>
</ol>
</td>
</tr>
</tbody>
</table>
</div>
<p><a href="#rzakcdisplaysize__scsiz1">Figure 2</a> and <a href="#rzakcdisplaysize__scsiz2">Figure 3</a> show
display size conditioning for a keyword (in this case, MSGLOC, Message Location).</p>
</div>
<div class="example"> <div class="fignone" id="rzakcdisplaysize__scsiz1"><a name="rzakcdisplaysize__scsiz1"><!-- --></a><span class="figcap">Figure 2. Display size conditioning (example 1)</span><pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00030A DSPSIZ(*DS3 *DS4)
00040A *DS4 MSGLOC(26)
A</pre>
</div>
<p>In <a href="#rzakcdisplaysize__scsiz1">Figure 2</a>, the display size
condition name *DS4 is specified, so that the message line is line 26 for
a 27 x 132 display and line 25 (the default) for a 24 x 80 display.</p>
</div>
<div class="example"> <div class="fignone" id="rzakcdisplaysize__scsiz2"><a name="rzakcdisplaysize__scsiz2"><!-- --></a><span class="figcap">Figure 3. Display size conditioning (example 2)</span><pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00080A DSPSIZ(*DS4 *DS3)
00081A MSGLOC(26)
A</pre>
</div>
<p>In <a href="#rzakcdisplaysize__scsiz2">Figure 3</a>, the message line
is also line 26 for the 27 x 132 display and line 25 (the default) for the
24 x 80 display, even though no display size condition name is specified,
because the primary display size (*DS4) specified with the DSPSIZ keyword
is the default.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcconditionfield.htm" title="If you are conditioning a field, the field name (or the constant) and the last (or only) indicator must be on the same line.">Conditioning a field for more than one keyword</a></div>
</div>
</div>
</body>
</html>