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

114 lines
6.0 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="GRDCLR (Grid Clear) keyword" />
<meta name="abstract" content="Use this record-level keyword to define the rectangle on a screen in which all grid structures are cleared." />
<meta name="description" content="Use this record-level keyword to define the rectangle on a screen in which all grid structures are cleared." />
<meta name="DC.subject" content="GRDCLR (Grid Clear) keyword, Grid Clear (GRDCLR) keyword" />
<meta name="keywords" content="GRDCLR (Grid Clear) keyword, Grid Clear (GRDCLR) keyword" />
<meta name="DC.Relation" scheme="URI" content="dspkwd.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="rzakcmstdfgrdc" />
<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>GRDCLR (Grid Clear) keyword</title>
</head>
<body id="rzakcmstdfgrdc"><a name="rzakcmstdfgrdc"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">GRDCLR (Grid Clear) keyword</h1>
<div><p>Use this record-level keyword to define the rectangle on a screen
in which all grid structures are cleared.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>GRDCLR[(*POS ([*DS3][*DS4]
start row | &amp;start-row-field
start column | &amp;start-column-field
depth | &amp;depth-field
width | &amp;width-field))]</pre>
</div>
<p>If no parameters are defined,
GRDCLR keyword will clear all grid lines.</p>
<p>The *POS parameter is an optional
parameter. This parameter display size conditioning on the GRDCLR keyword.
When coding *DS3 or *DS4 within the *POS parameter, you can have 2 different
start row, start column, and length values depending on the display size being
used. DSPSIZ keyword must be coded on the file level.</p>
<p>If a field name
is specified, the field must exist in the record format, data type S, usage
P, length of 3, and zero decimal positions.</p>
<p>Grid line support requires
DBCS equipment. This equipment should have the capability of calling Japanese
DOS.</p>
<p>Option indicators are valid for this keyword.</p>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the GRDCLR keyword.</p>
</div>
<div class="example"> <pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A DSPSIZ(*DS3 *DS4)
A
A R GRDREC1 GRDRCD
A GRDCLR
A
A R GRDREC2 GRDRCD
A 90 DSPMOD(*DS4)
A
A 95 GRDCLR((*POS (*DS3 4 4 10 60) +
A (*DS4 4 4 10 120)))
A
A GRDLIN((*POS (*DS3 6 4 20) +
A (*DS4 6 4 110)) (*TYPE LOWER) +
A (*COLOR RED) (*LINTYP DBL))
A
A R GRDREC3 GRDRCD
A
A 95 GRDCLR((*POS (&amp;SCROW &amp;SCOL &amp;DPTH &amp;WDTH)));
A
A GRDLIN((*POS (6 4 20)) +
A (*TYPE LOWER) +
A (*COLOR RED) (*LINTYP DBL))
A
A SROW 3S 0P
A SCOL 3S 0P
A DPTH 3S 0P
A WDTH 3S 0P
A</pre>
</div>
<div class="section"><p>When the GRDREC1 record is written, the display screen is cleared
of all grid structures.</p>
<p>When the GRDREC2 record is written to a 24 by
80 display or the DSPMOD keyword is turned off and option indicator 95 is
turned on, a rectangle starting at row 4, column 4, depth of 10 rows, and
width of 60 columns will be cleared. If the GRDREC2 record is written to a
27 by 132 display and the DSPMOD keyword is turned on and option indicator
95 is turned on, a rectangle starting a at row 4, column 4, depth of 10 rows,
and width of 120 columns will be cleared. The GRDCLR keyword will be processed
before the GRDLIN keyword so existing grids will be cleared before any new
grids are drawn.</p>
<p>When the GRDREC3 record is written and option indicator
95 is turned on, the GRDCLR keyword is processed. The position and size of
the rectangle for the GRDCLR keyword will be determined at runtime
from the appropriate p-field. The GRDCLR keyword will be processed before
the GRDLIN keyword so existing grids will be cleared before any new grids
are drawn.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dspkwd.htm" title="Some DDS keywords should be avoided in DBCS data fields, and others used with caution.">Keyword considerations for display files that use DBCS</a></div>
</div>
</div>
</body>
</html>