ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/lower.htm

59 lines
3.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="Case of characters in variables" />
<meta name="abstract" content="There are restrictions on the case used for characters in variables." />
<meta name="description" content="There are restrictions on the case used for characters in variables." />
<meta name="DC.subject" content="variable, lowercase character in, character, lowercase" />
<meta name="keywords" content="variable, lowercase character in, character, lowercase" />
<meta name="DC.Relation" scheme="URI" content="workv.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="lower" />
<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>Case of characters in variables</title>
</head>
<body id="lower"><a name="lower"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Case of characters in variables</h1>
<div><p>There are restrictions on the case used for characters in variables.</p>
<p>Reserved values, such as *LIBL, that can be used as variables must always
be expressed in uppercase letters, especially if they are presented as character
strings enclosed in apostrophes. For instance, if you wanted to substitute
a variable for a library name on a command, the correct code is as follows:
</p>
<pre>DCL VAR(&amp;LIB) TYPE(*CHAR) LEN(10) VALUE('*LIBL')
DLTPGM &amp;LIB/MYPROG;</pre>
<p>However, it would be <em>incorrect</em> to specify the VALUE parameter this
way: </p>
<pre>DCL VAR(&amp;LIB) TYPE(*CHAR) LEN(10) VALUE('*libl')</pre>
<p>Note that if this VALUE parameter had not been enclosed in apostrophes,
it would have been correct, because without the apostrophes it would be translated
to uppercase automatically. This error frequently occurs when the parameter
is passed as input to a procedure or program from a display as a character
string, and the display entry is made in lowercase.</p>
<div class="note"><span class="notetitle">Note:</span> The above paragraph does not take into account the fact that conversion
to uppercase is language dependent. <strong>REMEMBER</strong>: Relying on the system
to convert values to uppercase may produce unexpected results.</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="workv.htm" title="CL procedures consist of CL commands, and the commands themselves consist of the command statement, parameters, and parameter values.">Use variables</a></div>
</div>
</div>
</body>
</html>