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

145 lines
9.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="INZINP (Initialize Input) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword to initialize input/output fields without necessarily sending the initialized data to the display when the PUTOVR and ERASEINP(*ALL) keywords are both in effect." />
<meta name="description" content="Use this record-level keyword to initialize input/output fields without necessarily sending the initialized data to the display when the PUTOVR and ERASEINP(*ALL) keywords are both in effect." />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfinzeraseinp.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="rzakcmstdfinz" />
<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>INZINP (Initialize Input) keyword for display files</title>
</head>
<body id="rzakcmstdfinz"><a name="rzakcmstdfinz"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">INZINP (Initialize Input) keyword for display files</h1>
<div><p>Use this record-level keyword to initialize input/output fields
without necessarily sending the initialized data to the display when the PUTOVR
and ERASEINP(*ALL) keywords are both in effect.</p>
<p>This keyword has no parameters.</p>
<p>INZINP is particularly useful for applications that perform data entry
from remote workstations. It can reduce line traffic between the system unit
and the remote workstation.</p>
<p>The following steps describe how this keyword is used:</p>
<ol><li>An output operation displays an input/output field for which the OVRDTA
or OVRATR keyword is in effect. The system initializes the input save area
to the program value of the field. For example, if the program sets NAME1
to the name Bob, the input save area contains the name Bob.</li>
<li>An input operation places data from the workstation in an input buffer.
If the workstation user did not key into the input-capable field and the DSPATR(MDT)
keyword is not in effect for the field, the field does not return data from
the workstation. The system retrieves data from the input save area and places
it in the input buffer for use by the program. Thus, all input-capable fields
have data in the input buffer, either from the workstation or from the input
save area.</li>
<li>On another output operation, the following cases might occur:<ul><li>If the INZINP and OVRDTA keywords are not in effect,
the input save area is unchanged, even if the program changed the field value.
For example, if the program changes the field value to the name Tom, the input
save area will still have either the value entered by the workstation user
or the name Bob, the earlier program value.</li>
<li>If INZINP is in effect, the input save area will have
the current program value. The current program value is sent to the display
for fields for which the OVRDTA keyword is in effect. <p>If the OVRDTA keyword
is not in effect on an output operation, the program must clear the output
buffer for the fields with the OVRDTA keyword specified to ensure that the
input save area matches the fields on the display (which are all blanks after
the output operation).</p>
</li>
</ul>
</li>
</ol>
<div class="note"><span class="notetitle">Note:</span> If the ERASEINP(*ALL) keyword is in effect for the output operation,
input-capable fields are cleared at the display device (on the display), but
the input save area is not cleared. For the contents of the input save area,
see <a href="#rzakcmstdfinz__exoutin">Table 1</a> and <a href="#rzakcmstdfinz__exinout">Table 2</a>.
Fields with the DFT keyword specified are initialized with the value specified
for the DFT keyword even if the fields are not selected for display. The values
are maintained unless the application program selects the fields for display,
then changes their data values. This keyword requires the PUTOVR, OVERLAY,
and ERASEINP(*ALL) keywords to be specified at the record level.</div>
<p>The following tables show the effect of the ERASEINP(*ALL) and PUTOVR keywords
with and without the INZINP keyword.</p>
<div class="tablenoborder"><a name="rzakcmstdfinz__exoutin"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzakcmstdfinz__exoutin" width="100%" frame="hsides" border="0" rules="none"><caption>Table 1. INZINP Input/output
fields</caption><thead align="left"><tr><th align="left" valign="bottom" width="33.33333333333333%" id="d0e51">OVRATR or OVRDTA keyword</th>
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e53">INZINP keyword</th>
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e55">Contents of input save area</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e51 ">Not specified</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e53 ">Does not apply</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e55 ">Previous contents</td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e51 ">Specified but not in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e53 ">Specified but not in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e55 ">Previous contents</td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e51 ">Specified but not in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e53 ">Specified and in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e55 ">Program value (not sent to display)</td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e51 ">OVRATR specified and in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e53 ">Does not apply</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e55 ">Program value (also sent to display)</td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e51 ">OVRATR specified and in effect; OVRDTA not
specified or not in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e53 ">Does not apply</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e55 ">Previous contents (not sent to display)</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="rzakcmstdfinz__exinout"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzakcmstdfinz__exinout" width="100%" frame="hsides" border="0" rules="none"><caption>Table 2. INZINP input-only
fields</caption><thead align="left"><tr><th align="left" valign="bottom" width="33.33333333333333%" id="d0e102">OVRATR keyword</th>
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e104">INZINP keyword</th>
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e106">Contents of input save area</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e102 ">Not specified</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e104 ">Does not apply</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e106 ">Previous contents</td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e102 ">Specified and in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e104 ">Does not apply</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e106 ">Previous contents</td>
</tr>
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e102 ">Specified but not in effect</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e104 ">Does not apply</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e106 "><p>Character fields: blanks <br />
Numeric fields: zeros</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rzakcmstdfinzeraseinp.htm">ERASEINP(*ALL) keyword</a></strong><br />
Follow the instructions in this topic to set the input save area to blanks and zeros to match the fields cleared at the workstation by the ERASEINP(*ALL) keyword.</li>
</ul>
<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>