114 lines
6.6 KiB
HTML
114 lines
6.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="DDS naming conventions" />
|
|
<meta name="abstract" content="DDS requires that files, records, fields, and other labels and identifiers that are described in DDS keywords should follow specific rules." />
|
|
<meta name="description" content="DDS requires that files, records, fields, and other labels and identifiers that are described in DDS keywords should follow specific rules." />
|
|
<meta name="DC.subject" content="naming conventions, DDS naming conventions" />
|
|
<meta name="keywords" content="naming conventions, DDS naming conventions" />
|
|
<meta name="DC.Relation" scheme="URI" content="coderules.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="ddsnam" />
|
|
<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>DDS naming conventions</title>
|
|
</head>
|
|
<body id="ddsnam"><a name="ddsnam"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">DDS naming conventions</h1>
|
|
<div><p>DDS requires that files, records, fields, and other labels and
|
|
identifiers that are described in DDS keywords should follow specific rules.</p>
|
|
<p>The naming conventions used in DDS are as follows: </p>
|
|
<ul><li>Qualified names <ul><li>Use a slash to separate the parts of a qualified name. Embedded blanks
|
|
are not allowed. For example: <pre>KEYWORD(library/file)</pre>
|
|
</li>
|
|
<li>For most keywords with a qualified name parameter value, you can code
|
|
*LIBL or *CURLIB for the library name. If you do not specify a library name,
|
|
*LIBL is used. You cannot code *USRLIBL for the library name. This rule
|
|
differs from that in CL, which often allows *USRLIBL.</li>
|
|
<li>Code a maximum of 10 characters for object names.
|
|
If you enclose the name in quotation marks, you may specify up to 8 characters
|
|
between the quotation marks. This rule is different from that in CL, which
|
|
allows a basic name of up to 10 characters to be specified between the quotation
|
|
marks. Refer to the <a href=" ../rbam6/rbam6clmain.htm">Control
|
|
language (CL)</a> topic collection for syntax rules for object names.</li>
|
|
</ul>
|
|
</li>
|
|
<li>Record and field names <ul><li>The DDS syntax rules for record and field names are: <ul><li>Names must be 10 characters or less.</li>
|
|
<li>Names must begin with an alphabetic character (A through Z, @, $, and
|
|
#). All subsequent characters can be alphanumeric (A through Z, 0 through
|
|
9, @, $, #, and _ (underscore)). There can be no embedded blanks.</li>
|
|
<li>In ICF files, record names cannot start with $$.</li>
|
|
</ul>
|
|
</li>
|
|
<li>Specify qualified field names similar to qualified names. For example:
|
|
<pre>KEYWORD(record-name/field-name)</pre>
|
|
</li>
|
|
</ul>
|
|
<p>High-level languages can impose specific length and value restrictions
|
|
on the name. Check the appropriate high-level language reference guide for
|
|
the syntax requirements for your high-level language processor.</p>
|
|
</li>
|
|
<li>ALIAS (alternative field) names <ul><li>The length of an alternative field name is 1 to 30 characters. The first
|
|
character must be A through Z. Subsequent characters must be A through Z,
|
|
0 through 9, or the underscore (_).</li>
|
|
<li>Because DDS does not perform any language-specific syntax checking, you
|
|
must make sure that the alternative field names you specify conform to the
|
|
naming conventions of the high-level language that uses the names. The high-level
|
|
language compiler checks the syntax of the names when they are brought into
|
|
the program.</li>
|
|
</ul>
|
|
</li>
|
|
<li>Message identifiers <ul><li>Message identifiers must be 7 characters long. The first 3 characters
|
|
are the message prefix.</li>
|
|
<li>The first character of the message prefix must be an alphabetic character
|
|
(A through Z, @, $, and #). The next 2 characters of the message prefix must
|
|
be alphanumeric (A through Z, @, $, #, _, 0 through 9).</li>
|
|
<li>The last 4 characters must be a hexadecimal value (0 through 9, A through
|
|
F).</li>
|
|
</ul>
|
|
</li>
|
|
<li>Label, document, and folder names <ul><li>An online help information label name must be from 1 to 10 characters
|
|
long and must begin with an uppercase alphabetic character (A through Z, @,
|
|
#, or $). The label name cannot contain a comma, a single quotation mark,
|
|
or an embedded blank.</li>
|
|
<li>A document name (and a simple folder name) must be a 1 to 8 character
|
|
part. It can be followed by a period and a 1 to 3 character part called an
|
|
extender. The characters used most often are A through Z, 0 through 9, @,
|
|
#, $, and _.</li>
|
|
<li>If a folder name is concatenated, each simple folder name is separated
|
|
by a forward slash (/). The total length of the folder name cannot exceed
|
|
63 characters.</li>
|
|
<li>In DDS, a document, simple folder name, or online help information label
|
|
name can be enclosed in single quotation marks. The enclosing single quotation
|
|
marks are required when the name contains an opening or closing parenthesis
|
|
or a single quotation mark character. When the name is enclosed
|
|
in single quotation marks, specify two single quotation marks for each single
|
|
quotation mark character within the name. If a folder name is concatenated,
|
|
the enclosing single quotation marks, if specified, must be around the entire
|
|
concatenated name.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="coderules.htm" title="When you describe data attributes with DDS, you need to be aware of specific coding rules, naming conventions, and terminology.">DDS coding rules, conventions, and terms</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |