168 lines
10 KiB
HTML
168 lines
10 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="PUTOVR (Put with Explicit Override) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this record-level keyword to permit the override of either display attributes or data contents (or both) of specific fields within a record displayed on a workstation device. By using PUTOVR, you can reduce the amount of data sent to the display device." />
|
||
|
|
<meta name="description" content="Use this record-level keyword to permit the override of either display attributes or data contents (or both) of specific fields within a record displayed on a workstation device. By using PUTOVR, you can reduce the amount of data sent to the display device." />
|
||
|
|
<meta name="DC.subject" content="PUTOVR (Put with Explicit Override) keyword, Put with Explicit Override (PUTOVR) keyword" />
|
||
|
|
<meta name="keywords" content="PUTOVR (Put with Explicit Override) keyword, Put with Explicit Override (PUTOVR) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfdft.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfovdta.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="rzakcmstdfputov" />
|
||
|
|
<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>PUTOVR (Put with Explicit Override) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfputov"><a name="rzakcmstdfputov"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">PUTOVR (Put with Explicit Override) keyword for display files</h1>
|
||
|
|
<div><p>Use this record-level keyword to permit the override of either
|
||
|
|
display attributes or data contents (or both) of specific fields within a
|
||
|
|
record displayed on a workstation device. By using PUTOVR, you can reduce
|
||
|
|
the amount of data sent to the display device.</p>
|
||
|
|
<div class="section"><p>This keyword has no parameters.</p>
|
||
|
|
<p>If you use the PUTOVR keyword
|
||
|
|
and subfiles, certain restrictions apply. See the <a href="../books/sc415715.pdf" target="_blank">Application Display Programming book</a><img src="wbpdf.gif" alt="Link to PDF" /> for more information about these
|
||
|
|
restrictions and how to use PUTOVR in files that are used in the System/36™ environment..</p>
|
||
|
|
<p>When
|
||
|
|
selected fields in a record that has already been displayed are to be changed,
|
||
|
|
an output or an input/output operation sent to the record with the PUTOVR,
|
||
|
|
OVRDTA, and OVRATR keywords in effect changes only the fields for which the
|
||
|
|
OVRDTA or OVRATR keyword is in effect. The OVRDTA keyword permits a change
|
||
|
|
in the data contents of the field and the OVRATR keyword permits a change
|
||
|
|
in the display attributes of the field. The way in which fields are to be
|
||
|
|
changed is controlled by setting option indicators.</p>
|
||
|
|
<div class="p">The following conditions
|
||
|
|
cause the Put-Override keywords to be ignored and no error to occur: <ul><li>PUTOVR is not in effect at the time of the output operation.</li>
|
||
|
|
<li>Neither the OVRDTA nor OVRATR keyword is in effect at the time of the
|
||
|
|
output operation.</li>
|
||
|
|
<li>The record format is not already on the display.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>The PUTOVR and OVRDTA keywords must be specified when DFT is specified
|
||
|
|
for a named output-capable field. When the PUTOVR and OVRDTA keywords are
|
||
|
|
both in effect for a field, the default value specified with the DFT keyword
|
||
|
|
is displayed only on the first display of the field. On subsequent displays
|
||
|
|
with the PUTOVR and OVRDTA keywords in effect, the program value is displayed.</p>
|
||
|
|
<div class="p">If
|
||
|
|
a field is not displayed on the first output operation to a record format,
|
||
|
|
certain restrictions apply. These restrictions apply when, on a subsequent
|
||
|
|
output operation, the field is selected for display and the put-override keywords
|
||
|
|
are also in effect: <ul><li>For output-only fields for which the OVRDTA or OVRATR keyword is selected,
|
||
|
|
the <span class="keyword">i5/OS™</span> operating system
|
||
|
|
does not send an ending attribute character. Any display attributes (such
|
||
|
|
as reverse image) are continued across the display until the beginning attribute
|
||
|
|
character of the next field on the display. You should display output-only
|
||
|
|
fields on the first output operation (perhaps with the DSPATR(ND) keyword
|
||
|
|
so they cannot be seen) in order to provide an ending attribute character
|
||
|
|
for later overrides.</li>
|
||
|
|
<li>For input-capable or message fields for which the OVRDTA or OVRATR keyword
|
||
|
|
is selected, the <span class="keyword">i5/OS</span> operating
|
||
|
|
system sends an ending attribute character. This field must be displayed on
|
||
|
|
the initial output operation.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>The PUTRETAIN keyword and the PUTOVR keyword cannot be specified
|
||
|
|
on the same record format.</p>
|
||
|
|
<p>The OVRDTA keyword is permitted
|
||
|
|
only with output-only (usage O), input/output (usage B), program-to-system
|
||
|
|
(usage P), or message (usage M) fields.</p>
|
||
|
|
<p>The OVRATR keyword is permitted
|
||
|
|
only with output-only (usage O), input-only (usage I), or input/output (usage
|
||
|
|
B) fields.</p>
|
||
|
|
<p>If you specify PUTOVR, you should also specify RSTDSP(*YES)
|
||
|
|
on the Create Display File (CRTDSPF) or Change Display File (CHGDSPF) command.
|
||
|
|
Otherwise, data on the display can be lost if the file is suspended.</p>
|
||
|
|
<p>A
|
||
|
|
warning message is sent at file creation time if the PUTOVR keyword is specified
|
||
|
|
on a record with the DSPMOD keyword. At run time, the PUTOVR keyword is ignored
|
||
|
|
when the display mode changes.</p>
|
||
|
|
<div class="p">The OVRATR keyword can be used only to
|
||
|
|
override the following display attributes: <p>CHECK(ER)<br />
|
||
|
|
CHECK(ME)<br />
|
||
|
|
DUP<br />
|
||
|
|
DSPATR (all except OID and SP)</p>
|
||
|
|
</div>
|
||
|
|
<p>An output operation
|
||
|
|
with the OVRDTA keyword in effect does not need to have the OVRATR keyword
|
||
|
|
in effect to override display attributes, as well as data contents, of the
|
||
|
|
field or fields being overridden.</p>
|
||
|
|
<p>Option indicators are valid for the
|
||
|
|
PUTOVR, OVRATR, and OVRDTA keywords.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
|
the PUTOVR, OVRATR, and OVRDTA keywords.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A R INVRCD PUTOVR
|
||
|
|
00020A FLD1 1 26'INVENTORY REMAINING IN WAREHOUSE 1'
|
||
|
|
00030A*
|
||
|
|
00040A 3 2'Remaining on hand:'
|
||
|
|
00050A OVRATR
|
||
|
|
00060A 11 DSPATR(HI)
|
||
|
|
00070A*
|
||
|
|
00080A INVBAL 5Y 0 +2
|
||
|
|
00090A 12 OVRDTA
|
||
|
|
00100A*
|
||
|
|
00110A +2'Low on stock' OVRATR
|
||
|
|
00120A N70 DSPATR(ND)
|
||
|
|
00130A 70 DSPATR(HI)
|
||
|
|
00140A*
|
||
|
|
00150A SUPPPL 20 B 5 2DFT('INTERNAL')
|
||
|
|
00160A 13 OVRDTA
|
||
|
|
00170A*
|
||
|
|
00180A ACCT 20 6 2OVRDTA
|
||
|
|
00190A DSPATR(HI)
|
||
|
|
00200A 14 DSPATR(RI)
|
||
|
|
A</pre>
|
||
|
|
<div class="p">An initial output operation generates a full display
|
||
|
|
of information; on a second output operation, PUTOVR is in effect and the
|
||
|
|
program can set option indicators to make the following changes to the display:
|
||
|
|
<ul><li>If option indicator 11 is set on, the <em>Remaining on hand:</em> constant
|
||
|
|
field will be changed to a highlighted field. To reset the display attribute
|
||
|
|
to normal, display the record format again with option indicator 11 off.</li>
|
||
|
|
<li>If option indicator 12 is set on, the program can change the displayed
|
||
|
|
value of the field INVBAL.</li>
|
||
|
|
<li>If option indicator 70 is set off, the <em>Low on stock</em> constant field
|
||
|
|
is a nondisplay field. If option indicator 70 is set on, the field is changed
|
||
|
|
to a highlighted field.</li>
|
||
|
|
<li>If option indicator 13 is set on, the program can set the value of the
|
||
|
|
field SUPPL to override the default value (INTERNAL). The first displayed
|
||
|
|
value is always INTERNAL; to display the value INTERNAL again after changing
|
||
|
|
it to something else, the program must set the value of the field to INTERNAL
|
||
|
|
before displaying it again.</li>
|
||
|
|
<li>If option indicator 14 is set on, the display attribute of the field ACCT
|
||
|
|
is changed from highlight to highlight and reverse image at the same time
|
||
|
|
that new data is sent to the field. If option indicator 14 is set off, the
|
||
|
|
display attribute is changed back to highlight. New data is sent to the display
|
||
|
|
on each output operation.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
</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="rzakcmstdfdft.htm" title="Use this field-level keyword to specify the constant value for constant fields (unnamed fields) and to specify a default value for named fields.">DFT (Default) keyword for display files</a></div>
|
||
|
|
<div><a href="rzakcmstdfovdta.htm" title="Use this field- or record-level keyword with the PUTOVR keyword to override the existing data contents of a field or record already on the display.">OVRDTA (Override Data) keyword for display files</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|