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

572 lines
34 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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="DSPATR (Display Attribute) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword to specify one or more display attributes for the field that you are defining." />
<meta name="description" content="Use this field-level keyword to specify one or more display attributes for the field that you are defining." />
<meta name="DC.subject" content="DSPATR (Display Attribute) keyword, Display Attribute (DSPATR) keyword" />
<meta name="keywords" content="DSPATR (Display Attribute) keyword, Display Attribute (DSPATR) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfcolor.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="rzakcmstdfdspat" />
<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>DSPATR (Display Attribute) keyword for display files</title>
</head>
<body id="rzakcmstdfdspat"><a name="rzakcmstdfdspat"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">DSPATR (Display Attribute) keyword for display files</h1>
<div><p>Use this field-level keyword to specify one or more display attributes
for the field that you are defining.</p>
<div class="section"><p>You can specify the DSPATR keyword more than once for the same
field, and you can specify more than one attribute for the same keyword. However,
each attribute (for example, UL), can be specified only once per field.</p>
<div class="note"><span class="notetitle">Note:</span> The effects of attributes might not appear on the display,
depending on the hardware or software emulator that you are using.</div>
<p>The format for the keyword is</p>
<pre>DSPATR(attribute-1 [attribute-2 [attribute-3 [...]]])
<strong>or</strong>
DSPATR(&amp;program-to-system-field);</pre>
<p>If you specify more than
one attribute for the same field, whether in one keyword or in separate keywords,
each attribute that is specified (and in effect when the field is displayed)
affects the field. For example, if you want a field to be displayed with its
image reversed and with high intensity, specify either DSPATR (RI HI), or
DSPATR(RI), and DSPATR(HI).</p>
<p>The program-to-system-field parameter is
required and specifies that the named field must be defined in the record
format, alphanumeric (A in position 35), length of one, and usage P (P in
position 38). The program uses this P-field to set the display attribute for
the field this DSPATR keyword applies to.</p>
<p>The name P-field is used for
multiple fields with the record being defined. One DSPATR P-field is allowed
per field. The P-field contains the display attribute and identifies whether
the field should be protected. See <a href="#rzakcmstdfdspat__pfield">Valid
P-field values</a> in this topic.</p>
</div>
<div class="section"><h4 class="sectiontitle">Valid attributes for the first format of the DSPATR keyword</h4><p>The
following list shows valid attributes for the first format of the DSPATR keyword:</p>
<ul><li><strong>For all fields</strong><dl><dt><strong>Display attribute</strong></dt>
<dd><strong>Meaning</strong></dd>
<dt class="dlterm">BL</dt>
<dd>Blinking field</dd>
<dt class="dlterm">CS</dt>
<dd>Column separator</dd>
<dt class="dlterm">HI</dt>
<dd>High intensity</dd>
<dt class="dlterm">ND</dt>
<dd>Nondisplay</dd>
<dt class="dlterm">PC</dt>
<dd>Position cursor</dd>
<dt class="dlterm">RI</dt>
<dd>Reverse image</dd>
<dt class="dlterm">UL</dt>
<dd>Underline</dd>
</dl>
</li>
<li><strong>For Input-Capable fields only</strong><dl><dt><strong>Display attribute</strong></dt>
<dd><strong>Meaning</strong></dd>
<dt class="dlterm">MDT</dt>
<dd>Set changed data tag when displayed</dd>
<dt class="dlterm">OID</dt>
<dd>Operator identification</dd>
<dt class="dlterm">PR</dt>
<dd>Protect contents of field from input typing</dd>
<dt class="dlterm">SP</dt>
<dd>Select by light pen</dd>
</dl>
</li>
</ul>
<div class="note"><span class="notetitle">Notes:</span> <ol><li>If you specify the UL, HI, and RI attributes on the 5250 display station
for the same field, the result is the same as if you had specified ND.</li>
<li>If OID is specified, then SP™ should not be specified. Neither OID nor SP can
be optioned unless specified with another display attribute.</li>
<li>Display attributes BL, CS, HI, RI, and UL can also be specified at the
file, record, or field level as parameter values on the CHGINPDFT keyword.</li>
<li>Display attributes CS, HI, and BL can cause fields on the 5292, 3477 Model
FC, 3487 Model HC, 3179, 3197 Model C1 and C2, and 3488<a name="fnsrc_1" href="#fntarg_1"><sup>1</sup></a> color display stations to appear
as color fields.</li>
<li>If you are using an IBM<sup>®</sup> Personal System/2 (PS/2<sup>®</sup>) computer that is emulating a 5250
display station and you are directly changing the EBCDIC screen buffer, you
need to set the MDT attribute. See the <cite>IBM Personal Computer Enhanced 5250 Emulation
Program Technical Reference</cite> manual for additional information.</li>
<li>If you are using a PS/2 computer and VGA monitor, the UL attribute does
not work due to hardware specific limitations in the way buffers are used.</li>
</ol>
</div>
<p>Option indicators are valid for this keyword, except when
the attributes OID or SP are the only display attributes specified.</p>
<p>Detailed
descriptions of each of the attributes follow the coding example and sample
display are provided in the following figure.</p>
</div>
<div class="example"> <div class="fignone" id="rzakcmstdfdspat__df5vda"><a name="rzakcmstdfdspat__df5vda"><!-- --></a><span class="figcap">Figure 1. A 5-byte field displayed with various display
attributes</span><br /><img src="rv2f262.gif" alt="A 5-byte field displayed&#xA;with various display attributes, described in the following text." /><br /></div>
</div>
<div class="section"><h4 class="sectiontitle">Display attributes for all fields</h4><p>The following
list shows attributes for all fields:</p>
<dl><dt class="dlterm">BL (Blink)</dt>
<dd>Use this attribute to specify that the field is to blink when it is displayed.</dd>
<dt class="dlterm">CS (Column separator)</dt>
<dd>Use this attribute to specify that each position of the field is to be
displayed with a vertical bar at its left and right edge. When specified for
a nondisplay field, the separators are displayed even though there are no
characters between them. You can use column separators to precisely indicate
cursor positioning within a field and to indicate the length of an otherwise
blank field.</dd>
<dt class="dlterm">HI (High intensity)</dt>
<dd>Use this attribute to specify that the field is to be intensified (highlighted)
when it is displayed on the display.</dd>
<dt class="dlterm">ND (Nondisplay)</dt>
<dd>Use this attribute to specify that the field is not to be displayed; the
display positions for this field appear blank. The attribute can be used for
passwords or other security-sensitive data. If the print function (permitted
by specifying the PRINT keyword) is performed, nondisplay fields are not printed.</dd>
<dt class="dlterm">PC (Position cursor)</dt>
<dd>Use this attribute to position the cursor to the first character position
of the field you are defining. You can specify this attribute for several
fields, and the cursor will be positioned at the first selected field with
this attribute. Note that the fields within a record are ordered in line/position
sequence as they appear on the display and not necessarily in the order you
specify them.</dd>
<dt class="dlterm">RI (Reverse image)</dt>
<dd>Use this attribute to specify that the image of the field is to be reversed
from the other portion of the screen when it is displayed. Whether the screen
is light-on-dark or dark-on-light depends on the status of the display before
the field is displayed. This setting is controlled by the workstation user.</dd>
<dt class="dlterm">UL (Underline)</dt>
<dd>Use this attribute to specify that the field is to be
underlined when it is displayed. All input-capable fields are underlined by
default. Use the CHGINPDFT keyword to prevent the default underlining. (If
CHGINPDFT is specified, DSPATR(UL) must be specified to underline an input-capable
field.) If DSPATR(UL) is specified with option indicators and the option indicators
are not satisfied (DSPATR(UL) is not selected), the field appears without
underline.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Display attributes for input-capable fields</h4><p>The
following list shows attributes for input-capable fields:</p>
<dl><dt class="dlterm">MDT (Set changed data tag)</dt>
<dd>Use this attribute to specify that the <span class="keyword">i5/OS™</span> operating
system is to set on the changed data tag (MDT) for the field you are defining
when the field is written to the display. The attribute ensures that the field
is sent from the device when the record is read from the display. <div class="note"><span class="notetitle">Note:</span> The <span class="keyword">i5/OS</span> program saves output data
for input/output fields or initialized data for fields with the DFT keyword
specified. This causes the saved data to be returned on an input operation
if no new (changed) data is entered into the field.</div>
</dd>
<dt class="dlterm">OID (Operator Identification)</dt>
<dd> <p>Use this attribute to specify that the <span class="keyword">i5/OS</span> operating
system is to allow magnetic stripe reader OID data to be entered into this
field. If it is to be a nondisplay field also, the DSPATR(ND) attribute must
be specified.</p>
<p>A field with the DSPATR(OID) keyword functions like any
other input-capable field; data can be entered from either the keyboard or
the magnetic stripe reader. The DSPATR(OID) keyword can be specified (but
is not required) to indicate that data can be entered using a magnetic stripe
reader. You can key into the field unless the keyboard shift Inhibit Keyboard
Entry (I) is specified. If both DSPATR(OID) and DSPATR(SP) are specified on the same field, DSPATR(SP)
is ignored.</p>
</dd>
<dt class="dlterm">PR (Protect)</dt>
<dd>Use this attribute to specify that the workstation user cannot key into
the input-capable field that you are defining. This attribute is valid for
input-capable fields only. Output-only fields and constant fields are protected
by definition.</dd>
<dt class="dlterm">SP (Select
by light pen)</dt>
<dd> <p>Use this attribute to specify that this input-capable field can be
selected by a light pen. The workstation user can key into a light pen field
unless an I (Inhibit Keyboard Entry) has been specified in position 35 (Data
Type/Keyboard Shift) for the field.</p>
<p>When the field is first displayed,
the contents of the field are set by your program (input/output field) or
in the DDS (input-only field with DFT keyword or character string). If no
new data is typed in by the workstation user, this output data is returned
to your program on an input operation.</p>
<div class="p">A field that can be selected
by a light pen should be at least 3 bytes long. The recommended contents of
this field are: <ul><li>A switch character, either hex 6F (?) or, if the workstation user selects
the field by a light pen, hex 6E (&gt;)</li>
<li>A blank (hex 40)</li>
<li>A target character, which can be any character, such as an asterisk (*)</li>
<li>Another blank</li>
<li>Additional data to identify the field to the workstation user (1 or more
characters)</li>
</ul>
</div>
<p>This attribute is useful only for workstations with a light pen
feature for selecting.</p>
</dd>
</dl>
</div>
<div class="section" id="rzakcmstdfdspat__pfield"><a name="rzakcmstdfdspat__pfield"><!-- --></a><h4 class="sectiontitle">Valid P-field values</h4><p>The DSPATR P-field
does not support the following display attributes:</p>
<dl><dt><strong>Display attribute</strong></dt>
<dd><strong>Meaning</strong></dd>
<dt class="dlterm">MDT</dt>
<dd>Set changed data tag when displayed</dd>
<dt class="dlterm">OID</dt>
<dd>Operator identification</dd>
<dt class="dlterm">PC</dt>
<dd>Position cursor</dd>
<dt class="dlterm">SP</dt>
<dd>Select by light pen</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Valid P-field values (nonprotect)</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><thead align="left"><tr><th valign="top" width="33.33333333333333%" id="d0e327">Hex</th>
<th valign="top" width="33.33333333333333%" id="d0e329">Limited color</th>
<th valign="top" width="33.33333333333333%" id="d0e331">Full color</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">20</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Normal</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Green</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">21</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Green, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">22</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">High intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">White</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">23</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">High intensity, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">White, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">24</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Underscore</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Green, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">25</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Underscore, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Green, underscore, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">26</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Underscore, high intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">White, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">27</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Nondisplay</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">28</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Red</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">29</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Red, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">2A</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, high intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Red, high intensity</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">2B</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, high intensity, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Red, high intensity, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">2C</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, underscore</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Red, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">2D</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, underscore, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Red, underscore, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">2E</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, underscore, high intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Red, underscore, blink</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">2F</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Nondisplay</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">30</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Turquoise, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">31</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Turquoise, column separator, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">32</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">High intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Yellow, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">33</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">High intensity, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">White, reverse image, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">34</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Underscore, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Turquoise, underscore, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">35</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Underscore, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Turquoise, underscore, reverse image, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">36</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Underscore, high intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Yellow, underscore, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">37</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Nondisplay</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">38</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Pink</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">39</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Pink, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">3A</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, high intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Blue</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">3B</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, high intensity, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Blue, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">3C</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, underscore, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Pink, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">3D</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, underscore, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Pink, underscore, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">3E</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Blink, underscore, high intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Blue, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e327 ">3F</td>
<td valign="top" width="33.33333333333333%" headers="d0e329 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e331 ">Nondisplay</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section"><h4 class="sectiontitle">Valid P-field values (protect)</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><caption>Table 1. P-field values (protect)</caption><thead align="left"><tr><th valign="top" width="33.33333333333333%" id="d0e570">Hex</th>
<th valign="top" width="33.33333333333333%" id="d0e572">Limited color</th>
<th valign="top" width="33.33333333333333%" id="d0e574">Full color</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A0</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Normal</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Green</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A1</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Green, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A2</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">High intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">White</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A3</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">High intensity, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">White, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A4</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Underscore</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Green, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A5</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Underscore, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Green, underscore, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A6</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Underscore, high intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">White, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A7</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Nondisplay</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A8</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Red</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">A9</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Red, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">AA</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, high intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Red, high intensity</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">AB</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, high intensity, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Red, high intensity, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">AC</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, underscore</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Red, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">AD</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, underscore, reverse image</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Red, underscore, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">AE</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, underscore, high intensity</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Red, underscore, blink</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">AF</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Nondisplay</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B0</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Turquoise, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B1</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Turquoise, column separator, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B2</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">High intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Yellow, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B3</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">High intensity, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">White, reverse image, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B4</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Underscore, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Turquoise, underscore, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B5</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Underscore, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Turquoise, underscore, reverse image, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B6</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Underscore, high intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Yellow, underscore, column separator</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B7</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Nondisplay</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B8</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Pink</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">B9</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Pink, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">BA</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, high intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Blue</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">BB</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, high intensity, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Blue, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">BC</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, underscore, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Pink, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">BD</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, underscore, reverse image, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Pink, underscore, reverse image</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">BE</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Blink, underscore, high intensity, column separator</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Blue, underscore</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e570 ">BF</td>
<td valign="top" width="33.33333333333333%" headers="d0e572 ">Nondisplay</td>
<td valign="top" width="33.33333333333333%" headers="d0e574 ">Nondisplay</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="example"><h4 class="sectiontitle">Example 1</h4><p>The following example shows how to specify
the DSPATR(SP)
keyword with an input-only field (showing the recommended data contents as
a character string).</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00110A SPFLD 50I I 5 4'? * OPTION 1'
00120A DSPATR(SP)
A</pre>
<p>No data can be typed into field SPFLD. When the field
is selected with the light pen, the data returned in field SPFLD will be: <tt class="sysout">&gt;_*_OPTION_1</tt>,
where _ represents a blank.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example 2</h4><p>The following example shows that when
the workstation user selects a field with the light pen, both the MDT bit
and the first character of that field are changed. When the field is selected,
the MDT bit is set on, changing the first character of the field to &gt;.
If the same field is selected again, the MDT bit is set off and the first
character becomes ?.</p>
<p>By specifying a switch character, your program
prevents the first character of data from being changed to &gt; or ? when
the field is selected by the light pen. If the MDT bit is on when your program
sends an input operation to the record format, the contents of the field are
returned to your program as a user-changed field.</p>
<p>If you use DSPATR(MDT)
to set on the MDT of a field that can be selected by the light pen, then you
should either omit the MDTOFF keyword from other record formats or you should
read that field before displaying any record format with MDTOFF in effect.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R LIGHTPEN
00020A FLD1 10 I 5 2'&gt; * $12.50'
00030A DSPATR(SP MDT)
00040A*
00050A R RCD2 OVERLAY MDTOFF
00060A FLD1 10 B 11 2
A</pre>
<p>If the program displays LIGHTPEN, then displays RCD2,
then reads LIGHTPEN, and the workstation user does not select FLD1 with the
light pen, the MDT of FLD1 is turned off by the display of RCD2.</p>
<p>Also,
the switch character of FLD1 is returned as ?, even though the field was not
selected, and the switch character appears as &gt;. The MDT and the switch
character are in opposing states.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example 3</h4><p>The following example shows how to specify
the DSPATR keyword with P-field usage:</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R RECORD
A FLD1 5A 2 6DSPATR(&amp;PFLD1)
A FLD2 5A 2 6DSPATR(&amp;PFLD2)
A PFLD1 1A P
A PFLD2 1A 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="relref"><strong>Related reference</strong><br />
<div><a href="rzakcmstdfcolor.htm" title="Use this keyword to specify the color of a field on a color display.">COLOR (Color) keyword for display files</a></div>
</div>
</div><div class="p"><a name="fntarg_1" href="#fnsrc_1"><sup>1</sup></a> Dependent on the
monitor attached to the display device.</div>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink