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

86 lines
5.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="PROTECT (Protect) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword with the OVERLAY keyword to specify that when the record you are defining is displayed, all input-capable fields already on the display are to be changed to output-only fields." />
<meta name="description" content="Use this record-level keyword with the OVERLAY keyword to specify that when the record you are defining is displayed, all input-capable fields already on the display are to be changed to output-only fields." />
<meta name="DC.subject" content="PROTECT (Protect) keyword" />
<meta name="keywords" content="PROTECT (Protect) 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="rzakcmstdfptect" />
<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>PROTECT (Protect) keyword for display files</title>
</head>
<body id="rzakcmstdfptect"><a name="rzakcmstdfptect"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">PROTECT (Protect) keyword for display files</h1>
<div><p>Use this record-level keyword with the OVERLAY keyword
to specify that when the record you are defining is displayed, all input-capable
fields already on the display are to be changed to output-only fields.</p>
<div class="section"><p>This protects them from input typing. This keyword does not affect
the record format in which it is specified. The data contents of the affected
fields are not changed, but your program cannot read them unless it first
displays the record formats again in which the input-capable fields are specified.</p>
<p>To
protect a single field from input typing, see the DSPATR(PR) keyword.</p>
<p>This
keyword has no parameters.</p>
<p>The OVERLAY keyword must be specified in
the record format in which PROTECT is specified. Also, either the OVERLAY
keyword or the CLRL keyword must be in effect for PROTECT to be in effect.</p>
<p>You
can use PROTECT to protect input-capable fields in other records only on the
first output operation for which you have selected PUTOVR. On subsequent output
operations, PROTECT is in effect only if the PUTOVR keyword is not in effect.</p>
<p>If
the ERASEINP and PROTECT keywords are both in effect for an output operation,
the <span class="keyword">i5/OS™</span> operating system first
erases the input-capable fields specified on the ERASEINP parameter value,
then protects all input-capable fields on the display from input typing.</p>
<p>A
warning message appears at file creation time if the PROTECT keyword is specified
on a record with the DSPMOD keyword. At run time, the PROTECT keyword is ignored
when the display mode changes.</p>
<p>Option indicators are valid for this
keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the PROTECT keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R RECORD1
00020A FLD1 5 I 5 3
00030A
00040A R RECORD2 OVERLAY
00050A 32 PROTECT
00060A FLDA 10 I 6 3
A</pre>
<p>In this example, RECORD1 has an input-capable field that
has been displayed and read and that should be left on the display while RECORD2
is displayed and read. To prevent further entries in FLD1 in RECORD1, send
an output operation to RECORD2 with PROTECT in effect. When this is done,
FLDA is not protected, but FLD1 is protected.</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>