174 lines
9.8 KiB
HTML
174 lines
9.8 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="GRDLIN (Grid Line) keyword" />
|
|
<meta name="abstract" content="Use this record-level keyword to define the shape, positioning, and attributes for the line structure. This keyword defines whether the line is erased, display, or not processed." />
|
|
<meta name="description" content="Use this record-level keyword to define the shape, positioning, and attributes for the line structure. This keyword defines whether the line is erased, display, or not processed." />
|
|
<meta name="DC.subject" content="GRDLIN (Grid Line) keyword, Grid Line (GRDLIN) keyword" />
|
|
<meta name="keywords" content="GRDLIN (Grid Line) keyword, Grid Line (GRDLIN) 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="rzakcmstdfgrdl" />
|
|
<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>GRDLIN (Grid Line) keyword</title>
|
|
</head>
|
|
<body id="rzakcmstdfgrdl"><a name="rzakcmstdfgrdl"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">GRDLIN (Grid Line) keyword</h1>
|
|
<div><p>Use this record-level keyword to define the shape, positioning,
|
|
and attributes for the line structure. This keyword defines whether the line
|
|
is erased, display, or not processed.</p>
|
|
<div class="section"><div class="p">The format of the keyword is: <pre>GRDLIN((*POS([*DS3] [*DS4]
|
|
start line | &start-line-field
|
|
start column | &start-column-field
|
|
length | &length-field
|
|
[(*TYPE type of line
|
|
[repeat | &repeat-field]
|
|
[interval rule | &interval-field])]
|
|
[(*COLOR color of line | &color-field)]
|
|
[(*LINTYP type of line | &lintyp-field)]
|
|
[(*CONTROL | &control-field)]</pre>
|
|
</div>
|
|
<p>The *POS parameter is
|
|
a required parameter. This parameter allows display size and conditioning
|
|
of the GRDLIN keyword. Coding *DS3 or *DS4 with 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>
|
|
<div class="p">The type parameter
|
|
is a required parameter. The valid values for the type parameter are: <dl><dt><strong>Value</strong></dt>
|
|
<dd><strong>Meaning</strong></dd>
|
|
<dt class="dlterm">UPPER</dt>
|
|
<dd>Horizontal line on the upper character border</dd>
|
|
<dt class="dlterm">LOWER</dt>
|
|
<dd>Horizontal line on the lower character border</dd>
|
|
<dt class="dlterm">RIGHT</dt>
|
|
<dd>Vertical line on the right character border</dd>
|
|
<dt class="dlterm">LEFT</dt>
|
|
<dd>Vertical line on the left character border</dd>
|
|
</dl>
|
|
</div>
|
|
<p>The repeat parameter specifies the number of times the
|
|
line is to be repeated. The interval parameter specifies the number of character
|
|
spaces between the repeated lines.</p>
|
|
<p>The default for the type parameter
|
|
is upper. If neither the repeat value nor the interval value is coded, a single
|
|
grid line is drawn. The repeat and interval defaults are 1.</p>
|
|
<p>If a field
|
|
name is specified, the field must exist in the record format and must be defined
|
|
as data type S, usage P, and length greater than 3.</p>
|
|
<p>The *COLOR and *LINTYP
|
|
parameter defines the color and attributes of the box. P-fields
|
|
can be used to define or change the attributes at run time.</p>
|
|
<p>For more
|
|
information about the *COLOR and *LINTYP parameter, see the <a href="rzakcmstdfgrda.htm">GRDATR (Grid Attribute) keyword</a> topic.</p>
|
|
<p>If
|
|
NONE is defined by the GRDLIN keyword, the color set by the GRDATR keyword
|
|
will be used.</p>
|
|
<p>If a p-field is specified for either the COLOR or LINTYP
|
|
parameter, the field must exist in the record format. The field is defined
|
|
as data type A, usage P, and length of 1.</p>
|
|
<p>The *CONTROL parameter specifies
|
|
the whether the GRDLIN is to be displayed, erased from the screen, or ignored
|
|
(similar to optioning off the keyword). The field must exist in the record
|
|
format and must be defined as data type S, usage P, and length of 1. If the
|
|
p-field is set to 0, the grid line will be displayed. If the p-field is set
|
|
to 1, the GRDLIN keyword will not be processed. If the p-field is set to -1,
|
|
the grid line record currently shown will be cleared. If the p-field is set
|
|
to something other than the defined values, then the default 0 will be used.</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="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the GRDLIN keyword.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
A DSPSIZ(*DS3 *DS4)
|
|
A GDRATR((*COLOR WHT) (*LINTYP SLD))
|
|
A R GRDREC1 GRDRCD
|
|
A DSPMOD(*DS4)
|
|
A GRDLIN((*POS (*DS3 2 1 80) +
|
|
A (*DS4 2 1 132)) (*TYPE LOWER))
|
|
A GRDLIN((*POS (*DS3 4 6 20) +
|
|
A (*DS4 4 6 22)) (*TYPE RIGHT 4 15) +
|
|
A (*COLOR RED) (*LINTYP DBL) +
|
|
A (*CONTROL &CNTL1));
|
|
A
|
|
A GRDLIN((*POS (8 1 &LEN1); +
|
|
A (*TYPE LOWER 3 6) +
|
|
A (*COLOR &CLR1); (*LINTYP &LNTP1); +
|
|
A (*CONTROL &CNTL2));
|
|
A CNTL1 1S 0P
|
|
A CNTL2 1S 0P
|
|
A LEN1 3S 0P
|
|
A LNTP1 1A P
|
|
A CLR1 1S 0P
|
|
A</pre>
|
|
<div class="p">When the GRDREC1 record is written:<ul><li>If record is written to a 24 by 80 display or DSPMOD is turned off, then:
|
|
<ol><li>A horizontal line is drawn on the bottom character edge starting at row
|
|
2 and column 1. The length of the line is 80 columns long. The lines of the
|
|
grid are white in color and have a solid line type defined by the file-level
|
|
GRDATR keyword.</li>
|
|
<li>If the value in the p-field CNTL1 equals 0, 4 vertical lines are drawn
|
|
on the right border of characters in column 6, 21, 36, and 51. Each line is
|
|
20 rows long. The grid line is red using double lines. If the p-field CNTL1
|
|
value is a -1, the box is erased. If the p-field CNTL1 value is a 1, no action
|
|
is taken by the GRDLIN keyword.</li>
|
|
<li>If the value in the p-field CNTL2 equals 0, 3 horizontal lines are drawn
|
|
at the bottom character edge of rows 8, 14, and 20. The length of the lines
|
|
is determined at run time from the value in the p-field LEN1. If the value
|
|
in that p-field is greater than the width of the display, the value is truncated
|
|
to the display width. The color and line value is determined at run time from
|
|
the p-field CLR1 and LNTP1. If the p-field CNTL2 value is 1, no action is
|
|
taken by the GRDLIN keyword.</li>
|
|
</ol>
|
|
</li>
|
|
<li>If record is written to a 27 by 132 display and DSPMOD is turned on, then:
|
|
<ol><li>A horizontal line is drawn on the bottom character edge starting at row
|
|
2 and column 1. The length of the line is 132 columns long. The lines of the
|
|
grid are white in color and have a solid line type defined by the file-level
|
|
GRDATR keyword.</li>
|
|
<li>If the value in the p-field CNTL1 equals 0, 4 vertical lines are drawn
|
|
on the right border of characters in column 6, 21, 36, and 51. Each line is
|
|
22 rows long. The grid line is red using double lines. If the p-field CNTL1
|
|
value is a -1, the box is erased. If the p-field CNTL1 value is a 1, no action
|
|
is taken by the GRDLIN keyword.</li>
|
|
<li>If the value in the p-field CNTL2 equals 0, 3 horizontal lines are drawn
|
|
at the bottom character edge of rows 8, 14, and 20. The length of the lines
|
|
is determined at run time from the value in the p-field LEN1. If the value
|
|
in that p-field is greater than the width of the display, the value is truncated
|
|
to the display width. The color and line value are determined at run time
|
|
from the p-field CLR1 and LNTP1. If the p-field CNTL1 value is a -1, the box
|
|
is erased. If the p-field CNTL2 value is 1, no action is taken by the GRDLIN
|
|
keyword.</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</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> |