94 lines
5.9 KiB
HTML
94 lines
5.9 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="Names (*NAME)" />
|
||
|
|
<meta name="abstract" content="This describes the rules for creating basic names and basic names in quoted form." />
|
||
|
|
<meta name="description" content="This describes the rules for creating basic names and basic names in quoted form." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6objnamrules.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6label.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6commnames.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6snames.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rbam6names" />
|
||
|
|
<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>Names (*NAME)</title>
|
||
|
|
</head>
|
||
|
|
<body id="rbam6names"><a name="rbam6names"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Names (*NAME)</h1>
|
||
|
|
<div><p>This describes the rules for creating basic names and basic names
|
||
|
|
in quoted form.</p>
|
||
|
|
<div class="section"><h4 class="sectiontitle">*NAME (Basic Name)</h4><p>Every basic name can begin with
|
||
|
|
the characters A-Z, $, #, or @ and can be followed by up to nine characters.
|
||
|
|
The remaining characters can include the same characters as the first but
|
||
|
|
can also include numbers 0-9, underscores (_), and periods (.). Lowercase
|
||
|
|
letters are changed to uppercase letters by the system. Basic names used in IBM<sup>®</sup> -supplied
|
||
|
|
commands can be no longer than 10 characters. However, in your own commands,
|
||
|
|
you can define parameters of type *NAME (specified on the TYPE parameter of
|
||
|
|
the PARM or ELEM statements) with up to 256 characters.</p>
|
||
|
|
<p>Examples of
|
||
|
|
basic names are shown below:</p>
|
||
|
|
<pre>A987@.442# ONE_NAME LIB_0690 $LIBX</pre>
|
||
|
|
<p>Names can be entered in quoted or unquoted form. If you use
|
||
|
|
the quoted form, the following rules and considerations also apply:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">*NAME (Basic Name in Quoted Form)</h4><p>Every quoted name
|
||
|
|
must begin and end with a quotation mark ("). The middle characters of a quoted
|
||
|
|
name can contain any character except , *, ?, ', ", hex 00 through 3F, or
|
||
|
|
hex FF, and is delimited by a slash. Quoted names allow you to use graphic
|
||
|
|
characters in the name. The quoted form of basic names used in IBM-supplied
|
||
|
|
commands can be no longer than 8 characters (not including the double quotes).
|
||
|
|
In your own commands, you can define parameters of type *NAME in quoted form
|
||
|
|
with up to 254 characters (not including the double quotes).</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> Only
|
||
|
|
basic names can be used in quoted form.</div>
|
||
|
|
<p>Examples of quoted names
|
||
|
|
are shown below:</p>
|
||
|
|
<pre>"A" "AA%abc" "ABC%%abc"</pre>
|
||
|
|
<p>When you use quoted names, you should be aware of certain restrictions:</p>
|
||
|
|
<ul><li>Code points in a name might not be addressable from all keyboards.</li>
|
||
|
|
<li>Characters in a quoted name might not be valid in a high-level language.</li>
|
||
|
|
<li>The System/38™
|
||
|
|
environment supports only simple (*SNAME) names. If other characters are used,
|
||
|
|
the objects cannot be accessed as System/38 environment objects.</li>
|
||
|
|
<li>Names that are longer than eight characters cannot be accessed by the System/36™
|
||
|
|
environment unless control language overrides are used.</li>
|
||
|
|
<li>A Structured Query Language (SQL) name that contains a period must be
|
||
|
|
specified in an SQL statement in quotation marks.</li>
|
||
|
|
</ul>
|
||
|
|
<p>If a name enclosed in quotation marks is a valid unquoted basic name,
|
||
|
|
the quotation marks are removed. Thus, "ABC" is equivalent to ABC. Because
|
||
|
|
the quotation marks are removed, they are not included in the length of the
|
||
|
|
name. "ABCDEFGHIJ" is, therefore, a valid name on IBM* commands even though
|
||
|
|
it is longer than 10 characters.</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbam6objnamrules.htm" title="This describes rules for naming i5/OS objects.">Object naming rules</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rbam6commnames.htm" title="This describes the rules for creating communication names.">Communication names (*CNAME)</a></div>
|
||
|
|
<div><a href="rbam6snames.htm" title="This describes the difference between simple names and basic names, and the circumstances when simple names should be used.">Simple Names (*SNAME)</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rbam6label.htm" title="Command labels identify particular commands for branching purposes in a CL program. Labels can also be used to identify statements in CL programs that are being debugged. They can identify statements used either as breakpoints or as starting and ending statements for tracing purposes.">Command label</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|