ibm-information-center/dist/eclipse/plugins/i5OS.ic.dds_5.4.0.1/ddsform.htm

179 lines
11 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="task" />
<meta name="DC.Title" content="Complete the DDS form" />
<meta name="abstract" content="Use the data description specifications (DDS) form to enter positional and keyword information in the designated columns." />
<meta name="description" content="Use the data description specifications (DDS) form to enter positional and keyword information in the designated columns." />
<meta name="DC.subject" content="completing the DDS form, DDS form, completing" />
<meta name="keywords" content="completing the DDS form, DDS form, completing" />
<meta name="DC.Relation" scheme="URI" content="crtdds.htm" />
<meta name="DC.Relation" scheme="URI" content="entersource.htm" />
<meta name="DC.Relation" scheme="URI" content="createddsfile.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="ddsform" />
<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>Complete the DDS form</title>
</head>
<body id="ddsform"><a name="ddsform"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Complete the DDS form</h1>
<div><p>Use the data description specifications (DDS) form to enter positional
and keyword information in the designated columns.</p>
<div class="section"> <p>A sample DDS form is printed in reduced size in <a href="#ddsform__afig6">Figure 1</a>.</p>
<div class="p">The left side of the DDS form (positions 1 through 44)
is for fixed-format entries called <em>positional</em> entries. Positional entries
define the most common attributes of record formats and fields, such as names
and lengths of fields. For a brief description of the most important positional
entries, see items <span>1</span> through <span>7</span> following the figure. For
more detailed information about positional entries for each of the file types,
see the following topics: <ul><li>Positional entries for <a href="../rzakb/rzakbmstlfpos.htm">physical and logical files</a></li>
<li>Positional entries for <a href="../rzakc/rzakcmstpsnent.htm">display files</a></li>
<li>Positional entries for <a href="../rzakd/rzakdmstposy1.htm">printer files</a></li>
<li>Positional entries for <a href="../rzake/rzakemstcmnpos.htm">ICF files</a></li>
</ul>
</div>
<div class="p">The right side of the DDS form (positions
45 through 80) is for DDS <em>keywords</em>. DDS keywords define less-common
and more-varied attributes of files, record formats, and fields; they follow
a subset of the syntax rules for control language. For a brief description
of keyword entries, see item <span>8</span> following the figure. For more detailed
information about keyword entries for each of the file types, see the following
topics: <ul><li>Keywords for <a href="../rzakb/rzakbmstlfkeyw.htm">physical
and logical files</a></li>
<li>Keywords for <a href="../rzakc/rzakcmstkeyent.htm">display
files</a></li>
<li>Keywords for <a href="../rzakd/rzakdmstprkey.htm">printer
files</a></li>
<li>Keywords for <a href="../rzake/rzakemstckeyw.htm">ICF
files</a></li>
</ul>
</div>
<div class="fignone" id="ddsform__afig6"><a name="ddsform__afig6"><!-- --></a><span class="figcap">Figure 1. Overview of the positional entries and keywords</span><br /><img src="rv2f113.gif" alt="An illustration of a DDS&#xA;coding form. The layout of the form is described in the text that precedes&#xA;this illustration." /><br /></div>
<dl><dt class="dlterm"><span>1</span></dt>
<dd><strong>Sequence Number</strong> and <strong>Form Type</strong> are optional in DDS. The
form type identifies the source as DDS source. The entries are valid for
all types of files.</dd>
<dt class="dlterm"><span>2</span></dt>
<dd>An asterisk in position 7 makes the entire line a comment. This is valid
for all types of files. When A (And), or O (Or), or a blank is in position
7, positions 8 through 16 can provide conditioning for the DDS on or immediately
following the current line. Conditioning is not valid in physical or logical
files.</dd>
<dt class="dlterm"><span>3</span></dt>
<dd><strong>Type of Name or Specification</strong> (position 17) identifies the <strong>Name</strong> entry
(positions 19 through 28) or the specification:
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="90%" frame="void" border="0" rules="none"><thead align="left"><tr><th align="left" valign="bottom" width="20.2020202020202%" id="d0e121">Name entry</th>
<th align="left" valign="bottom" width="46.464646464646464%" id="d0e123">Description</th>
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e125">Type of file</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e121 ">R</td>
<td align="left" valign="top" width="46.464646464646464%" headers="d0e123 ">Specifies a record format name</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e125 ">All</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e121 ">blank</td>
<td align="left" valign="top" width="46.464646464646464%" headers="d0e123 ">Specifies a field name</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e125 ">All</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e121 ">K</td>
<td align="left" valign="top" width="46.464646464646464%" headers="d0e123 ">Specifies a key field name</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e125 ">Physical and logical only</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e121 ">S</td>
<td align="left" valign="top" width="46.464646464646464%" headers="d0e123 ">Specifies a select field name</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e125 ">Logical only</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e121 ">O</td>
<td align="left" valign="top" width="46.464646464646464%" headers="d0e123 ">Specifies an omit field name</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e125 ">Logical only</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e121 ">J</td>
<td align="left" valign="top" width="46.464646464646464%" headers="d0e123 ">Specifies this as a join specification</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e125 ">Join logical only</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e121 ">H</td>
<td align="left" valign="top" width="46.464646464646464%" headers="d0e123 ">Specifies this as a help specification</td>
<td align="left" valign="top" width="33.33333333333333%" headers="d0e125 ">Display only</td>
</tr>
</tbody>
</table>
</div>
</dd>
<dt class="dlterm"><span>4</span></dt>
<dd>R specified in position 29 indicates that the attributes of the field
in <strong>Name</strong> (positions 19 through 28) refer to a field specified elsewhere.
This is ignored for logical files.</dd>
<dt class="dlterm"><span>5</span></dt>
<dd><strong>Length, Data Type,</strong> and <strong>Decimal Positions</strong> specify attributes
of named fields within record formats. These are valid for all types of files.</dd>
<dt class="dlterm"><span>6</span></dt>
<dd><strong>Usage</strong> specifies fields as input, output, output/input, neither
input nor output, hidden, message, or program-to-system fields. Each type
of file has its own restrictions regarding field use.</dd>
<dt class="dlterm"><span>7</span></dt>
<dd><strong>Location</strong> specifies the location of the field on the display or
printed page. This applies for display and printer files only.</dd>
<dt class="dlterm"><span>8</span></dt>
<dd><strong>Functions</strong> specified through the use of keywords apply at different
levels for different file types, as follows:</dd>
</dl>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><thead align="left"><tr><th align="left" valign="top" width="50%" id="d0e227">Keywords apply at this level</th>
<th align="left" valign="top" width="50%" id="d0e229">For these files</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="50%" headers="d0e227 ">File</td>
<td align="left" valign="top" width="50%" headers="d0e229 ">All types of files</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e227 ">Record</td>
<td align="left" valign="top" width="50%" headers="d0e229 ">All types of files</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e227 ">Field</td>
<td align="left" valign="top" width="50%" headers="d0e229 ">All types of files</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e227 ">Join</td>
<td align="left" valign="top" width="50%" headers="d0e229 ">Join logical files only</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e227 ">Key field</td>
<td align="left" valign="top" width="50%" headers="d0e229 ">Physical and logical files</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e227 ">Select or omit field</td>
<td align="left" valign="top" width="50%" headers="d0e229 ">Logical files only</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e227 ">Help</td>
<td align="left" valign="top" width="50%" headers="d0e229 ">Display files only</td>
</tr>
</tbody>
</table>
</div>
<p>For display and printer files, constants specified
within single quotation marks become the default values for displayed or printed
fields.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="crtdds.htm" title="Use these steps to create a file using DDS.">Create a file using data description specifications (DDS)</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="entersource.htm" title="After filling out the forms, enter the source statements into source files.">Enter the DDS source statements</a></div>
<div><a href="createddsfile.htm" title="Create the file by running a CL command that corresponds to the type of DDS file you are creating.">Create the DDS file</a></div>
</div>
</div>
</body>
</html>