ibm-information-center/dist/eclipse/plugins/i5OS.ic.ddp_5.4.0.1/rbal1localentry.htm

69 lines
4.3 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="The *LOCAL directory entry" />
<meta name="DC.Relation" scheme="URI" content="rbal1workwith.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgddmtcpa.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="rbal1localentry" />
<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>The *LOCAL directory entry</title>
</head>
<body id="rbal1localentry"><a name="rbal1localentry"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">The *LOCAL directory entry</h1>
<div><p>The directory entry containing *LOCAL is unique in that there is only one
such entry in the directory, and it specifies the name of the local system
database. The associated RDB name can be used in the SQL statement CONNECT
TO x (where x is the local server name) to connect to the local database.
The effect of CONNECT TO x (where x is the local server name) is equivalent
to using the SQL statement CONNECT RESET.</p>
<p>If you want to make a DRDA<sup>®</sup> connection to the local server database, such as
for program testing, there are two special RDB names that can be used for
that purpose: ME and MYSELF. An example usage would be a programmer adding
a directory entry with an RDB name of ME, with type of *IP, and with Remote
Location name of LOOPBACK. He could then, in a program, do an SQL CONNECT
TO ME and establish a sockets DRDA connection to the local system. However,
general use of these RDB names is discouraged and they are documented only
to warn that unexpected behavior can result from their use in some situations.</p>
<p> However, if you must change the name of the local RDB entry, the procedure
includes doing the remove and add operation. But there are special considerations
for removing the local entry, because that entry contains some system-wide DRDA attribute
information. If you try to remove the entry, you will get message CPA3E01
(Removing or changing *LOCAL directory entry might cause loss of configuration
data (C G)), and you will be given the opportunity to cancel (C) the operation
or continue (G). The message text goes on to tell you that the entry is used
to store configuration data entered with the <span class="cmdname">Change DDM TCP/IP Attributes
(CHGDDMTCPA)</span> command. If the *LOCAL entry is removed, configuration
data might be destroyed, and the default configuration values will be in effect.
If the default values are not satisfactory, configuration data will have to
be re-entered with the CHGDDMTCPA command. Before removing the entry, you
might want to record the values specified in the CHGDDMTCPA command so that
they can be restored after the *LOCAL entry is deleted and added with the
correct local RDB name.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal1workwith.htm" title="Use these instructions to work with the relational database directory.">Work with the relational database directory</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../cl/chgddmtcpa.htm">Change DDM TCP/IP Attributes (CHGDDMTCPA) command</a></div>
</div>
</div>
</body>
</html>