ibm-information-center/dist/eclipse/plugins/i5OS.ic.cli_5.4.0.1/rzadphdovv.htm

87 lines
5.7 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="Write a DB2 UDB CLI application" />
<meta name="abstract" content="Find out how you code your applications to use the DB2 CLI functions." />
<meta name="description" content="Find out how you code your applications to use the DB2 CLI functions." />
<meta name="DC.subject" content="writing, CLI, writing a DB2 UDB CLI application" />
<meta name="keywords" content="writing, CLI, writing a DB2 UDB CLI application" />
<meta name="DC.Relation" scheme="URI" content="rzadpkickoff.htm" />
<meta name="DC.Relation" scheme="URI" content="rzadphditerm.htm" />
<meta name="DC.Relation" scheme="URI" content="rzadphdptran.htm" />
<meta name="DC.Relation" scheme="URI" content="rzadphddiag.htm" />
<meta name="DC.Relation" scheme="URI" content="rzadphddtdcn.htm" />
<meta name="DC.Relation" scheme="URI" content="rzadpstringarguments.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="rzadphdovv" />
<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>Write a DB2 UDB
CLI application</title>
</head>
<body id="rzadphdovv"><a name="rzadphdovv"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Write a DB2 UDB
CLI application</h1>
<div><p>Find out how you code your applications to use the DB2<sup>®</sup> CLI functions.</p>
<p>A DB2 UDB
CLI application consists of a set of tasks, each comprised of a set of discrete
steps. Other tasks might occur throughout the application as it runs. The
application calls one or more DB2 UDB CLI functions to carry out each
of these tasks.</p>
<p>Every DB2 UDB CLI application
contains the three main tasks that are shown in the following figure. If the
functions are not called in the sequence that is shown in the figure, an error
results.</p>
<div class="fignone" id="rzadphdovv__fgovva"><a name="rzadphdovv__fgovva"><!-- --></a><span class="figcap">Figure 1. Conceptual view of a DB2 UDB CLI application</span><br /><img src="rv3w321.gif" alt="Conceptual View of a DB2&#xA;UDB CLI Application" /><br /></div>
<p>The <em>initialization</em> task allocates and initializes resources in preparation
for the main <em>Transaction Processing</em> task.</p>
<p>The <em>transaction processing</em> task, the main task of the application,
passes queries and modifications to the SQL to DB2 UDB CLI.</p>
<p>The <em>termination</em> task frees allocated resources. The resources generally
consist of data areas that are identified by unique handles. After freeing
the resources, other tasks can use these handles.</p>
<p>In addition to the three central tasks that control a DB2 UDB CLI application,
there are numerous <em>general</em> tasks, such as diagnostic message
handlers, throughout an application.</p>
<p>See <a href="rzadpclilist.htm#rzadpclilist">Categories of DB2 UDB CLIs</a> for an overview
of how the CLI functions fit into these key task areas.</p>
<p>This topic provides examples to illustrate how these functions are used
in a DB2 UDB
CLI application.</p>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rzadphditerm.htm">Initialization and termination tasks in a DB2 UDB CLI application</a></strong><br />
The initialization task allocates and initializes environment handles and connection handles.</li>
<li class="ulchildlink"><strong><a href="rzadphdptran.htm">Transaction processing task in a DB2 UDB CLI application</a></strong><br />
This topic shows a typical order of function calls in a DB2 UDB CLI application.</li>
<li class="ulchildlink"><strong><a href="rzadphddiag.htm">Diagnostics in a DB2 UDB CLI application</a></strong><br />
This topic deals with warning or error conditions generated within an application.</li>
<li class="ulchildlink"><strong><a href="rzadphddtdcn.htm">Data types and data conversion in DB2 UDB CLI functions</a></strong><br />
This topics shows all of the supported SQL types and their corresponding symbolic names.</li>
<li class="ulchildlink"><strong><a href="rzadpstringarguments.htm">Work with string arguments in DB2 UDB CLI functions</a></strong><br />
These topics discuss some conventions when dealing with the various
aspects of working with string arguments in DB2 UDB CLI functions.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzadpkickoff.htm" title="DB2 UDB call level interface (CLI) is a callable Structured Query Language (SQL) programming interface that is supported in all DB2 environments except for DB2 Universal Database for z/OS and DB2 Server for VSE and VM.">SQL call level interface</a></div>
</div>
</div>
</body>
</html>