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

150 lines
12 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="reference" />
<meta name="DC.Title" content="Control DDM conversations" />
<meta name="abstract" content="The term connection in this topic collection refers to the concept of an SQL connection. An SQL connection lasts from the time an explicit or implicit SQL CONNECT is done until the logical SQL connection is terminated by such means as an SQL DISCONNECT, or a RELEASE followed by a COMMIT." />
<meta name="description" content="The term connection in this topic collection refers to the concept of an SQL connection. An SQL connection lasts from the time an explicit or implicit SQL CONNECT is done until the logical SQL connection is terminated by such means as an SQL DISCONNECT, or a RELEASE followed by a COMMIT." />
<meta name="DC.subject" content="connection, SQL versus network, conversations, SNA versus TCP/IP, communications, DDM conversations, distributed data management (DDM), keeping conversations, dropping conversations, DDM (distributed data management), keeping conversations, dropping conversations, keeping conversations active, DDM (distributed data management), SQL statement, DISCONNECT, RELEASE, distributed data management (DDM), unused conversations, dropped conversations, unused conversations, dropped conversations, DDMCNV job attribute, DDMCNV (DDM conversations) job attribute, keeping conversations active, keeping conversations active, command, RCLRSC (Reclaim Resources), Reclaim Resources (RCLRSC), command, CL, Reclaim Resources (RCLRSC), resources, reclaiming, RCLDDMCNV (Reclaim Distributed Data Management Conversations), Reclaim Distributed Data Management Conversations (RCLDDMCNV), RCLDDMCNV (Reclaim Distributed Data Management Conversations), Reclaim Distributed Data Management Conversations (RCLDDMCNV), distributed data management conversations, CHGJOB, CHGJOB (Change Job), Change Job (CHGJOB), CHGJOB (Change Job), Change Job (CHGJOB), job, changing" />
<meta name="keywords" content="connection, SQL versus network, conversations, SNA versus TCP/IP, communications, DDM conversations, distributed data management (DDM), keeping conversations, dropping conversations, DDM (distributed data management), keeping conversations, dropping conversations, keeping conversations active, DDM (distributed data management), SQL statement, DISCONNECT, RELEASE, distributed data management (DDM), unused conversations, dropped conversations, unused conversations, dropped conversations, DDMCNV job attribute, DDMCNV (DDM conversations) job attribute, keeping conversations active, keeping conversations active, command, RCLRSC (Reclaim Resources), Reclaim Resources (RCLRSC), command, CL, Reclaim Resources (RCLRSC), resources, reclaiming, RCLDDMCNV (Reclaim Distributed Data Management Conversations), Reclaim Distributed Data Management Conversations (RCLDDMCNV), RCLDDMCNV (Reclaim Distributed Data Management Conversations), Reclaim Distributed Data Management Conversations (RCLDDMCNV), distributed data management conversations, CHGJOB, CHGJOB (Change Job), Change Job (CHGJOB), CHGJOB (Change Job), Change Job (CHGJOB), job, changing" />
<meta name="DC.Relation" scheme="URI" content="rbal1admin.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal1reclaim.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgjob.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/dspjob.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal1excon.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal1reclaim.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/rclrsc.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/rrtjob.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/rtvjoba.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="rbal1ddmcnv" />
<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>Control DDM conversations</title>
</head>
<body id="rbal1ddmcnv"><a name="rbal1ddmcnv"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Control DDM conversations</h1>
<div><p>The term <em>connection</em> in this topic collection refers to the
concept of an SQL connection. An SQL connection lasts from the time an explicit
or implicit SQL CONNECT is done until the logical SQL connection is terminated
by such means as an SQL DISCONNECT, or a RELEASE followed by a COMMIT.</p>
<div class="section"> <p>Multiple SQL connections can occur serially over a single network
connection or conversation. In other words, when a connection is ended, the
conversation that carried it is not necessarily ended.</p>
<div class="note"><span class="notetitle">Note:</span> The term <em>conversation</em> has
a specific, technical meaning in SNA APPC terminology. It does not extend
to TCP/IP terminology in a formal sense. However, there is a similar concept
in TCP/IP (a 'network connection' in other topics on the subject). In this
topic collection, the word is used with the understanding that it applies
to TCP/IP network connections as well. In other topics of this topic collection,
the term retains its specific APPC meaning, but it is expected that the reader
can discern that meaning from the context. </div>
</div>
<div class="section"><p>When an application requester (AR) uses DRDA<sup>®</sup> to connect to an application server
(AS), it uses a DDM conversation. The conversation is established with the
SQL CONNECT statement from the AR, but only if: </p>
<ul><li>A conversation using the same remote location values does not already
exist for the AR job.</li>
<li>A conversation uses the same activation group.</li>
<li>If started from DDM, a conversation has the file scoped to the activation
group.</li>
<li>A conversation has the same conversation type (protected or unprotected).</li>
</ul>
<p>DDM conversations can be in one of three states: active, unused,
or dropped. A DDM conversation used by the distributed relational database
is active while the AR is connected to the AS.</p>
</div>
<div class="section"><p>The SQL DISCONNECT and RELEASE statements are used to end connections.
Connections can also be ended implicitly by the server. In addition, when
running with RUW connection management, previous connections are ended when
a CONNECT is performed. </p>
<p>After a connection ends, the DDM conversations
then either become unused or are dropped. If a DDM conversation is unused,
the conversation to the remote database management system is maintained by
the DDM communications manager and marked as unused. If a DDM conversation
is dropped, the DDM communications manager ends the conversation. The DDMCNV
job attribute determines whether DDM conversations for connections that are
no longer active become unused or dropped. If the job attribute value is *KEEP
and the connection is to another <span class="keyword">iSeries™ server</span>,
the conversation becomes unused. If the job attribute value is *DROP or the
connection is not to another <span class="keyword">iSeries server</span>,
the conversation is dropped.</p>
</div>
<div class="section"><p>Using a DDMCNV job attribute of *KEEP is desirable when connections
to remote relational databases are frequently changed.</p>
</div>
<div class="section"><p>A value of *DROP is desirable in the following situations:</p>
<ul><li>When the cost of maintaining the conversation is high and the conversation
will not be used relatively soon.</li>
<li>When running with a mixture of programs compiled with RUW connection management
and programs compiled with DUW connection management. Attempts to run programs
compiled with RUW connection management to remote locations will fail when
protected conversations exist.</li>
<li>When running with protected conversations either with DDM or DRDA. Additional
overhead is incurred on commits and rollbacks for unused protected conversations.</li>
</ul>
</div>
<div class="section"><p>If a DDM conversation is also being used to operate on remote
files through DDM, the conversation will remain active until the following
conditions are met:</p>
<ul><li>All the files used in the conversation are closed and unlocked</li>
<li>No other DDM-related functions are being performed</li>
<li>No DDM-related function has been interrupted (by a break program, for
example)</li>
<li>For protected conversations, a commit or rollback was performed after
ending all SQL programs and after all DDM-related functions were completed</li>
<li>An AR job is no longer connected to the AS</li>
</ul>
</div>
<div class="section"><p>Regardless of the value of the DDMCNV job attribute, conversations
are dropped at the end of a job routing step, at the end of the job, or when
the job initiates a <span class="cmdname">Reroute Job (RRTJOB)</span> command. Unused
conversations within an active job can also be dropped by the <span class="cmdname">Reclaim
DDM Conversations (RCLDDMCNV)</span> or <span class="cmdname">Reclaim Resources (RCLRSC)</span> command.
Errors, such as communications line failures, can also cause conversations
to drop. </p>
</div>
<div class="section"><p>The DDMCNV parameter is changed by the <span class="cmdname">Change Job (CHGJOB)</span> command
and is displayed by <span class="cmdname">Display Job (DSPJOB)</span> command with OPTION(*DFNA).
Also, you can use the <span class="cmdname">Retrieve Job Attributes (RTVJOBA)</span> command
to get the value of this parameter and use it within a CL program.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rbal1reclaim.htm">Reclaim DDM resources</a></strong><br />
The <span class="cmdname">Reclaim Distributed Data Management Conversations
(RCLDDMCNV)</span> command reclaims all application conversations that
are not currently being used by a source job, even if the DDMCNV attribute
value for the job is *KEEP.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal1admin.htm" title="As an administrator for a distributed relational database, you are responsible for work being done on several servers.">Administration</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../cl/chgjob.htm">Change Job (CHGJOB) command</a></div>
<div><a href="../cl/dspjob.htm">Display Job (DSPJOB) command</a></div>
<div><a href="rbal1excon.htm" title="The CONNECT statement is used to explicitly connect an application requester (AR) to an identified application server (AS). This SQL statement can be embedded within an application program or you can issue it using Interactive SQL.">Explicit connection management</a></div>
<div><a href="rbal1reclaim.htm" title="The Reclaim Distributed Data Management Conversations (RCLDDMCNV) command reclaims all application conversations that are not currently being used by a source job, even if the DDMCNV attribute value for the job is *KEEP.">Reclaim DDM resources</a></div>
<div><a href="../cl/rclrsc.htm">Reclaim Resources (RCLRSC) command</a></div>
<div><a href="../cl/rrtjob.htm">Reroute Job (RRTJOB) command</a></div>
<div><a href="../cl/rtvjoba.htm">Retrieve Job Attributes (RTVJOBA) command</a></div>
</div>
</div>
</body>
</html>