180 lines
12 KiB
HTML
180 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="Connection string keywords - other properties" />
|
||
<meta name="abstract" content="Use these iSeries Access ODBC driver connection string keywords to change other properties of the ODBC connection." />
|
||
<meta name="description" content="Use these iSeries Access ODBC driver connection string keywords to change other properties of the ODBC connection." />
|
||
<meta name="DC.Relation" scheme="URI" content="connectkeywords.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="rzaikconnectkeywords" />
|
||
<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>Connection string keywords - other properties</title>
|
||
</head>
|
||
<body id="rzaikconnectkeywords"><a name="rzaikconnectkeywords"><!-- --></a>
|
||
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">Connection string keywords - other properties</h1>
|
||
<div><p>Use these iSeries™ Access ODBC driver connection string keywords
|
||
to change other properties of the ODBC connection.</p>
|
||
<div class="section"><p>The following table lists other connection string keywords that
|
||
are recognized by the iSeries Access ODBC driver:</p>
|
||
</div>
|
||
<div class="section">
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 1. iSeries Access ODBC connection string keywords for
|
||
other properties</caption><thead align="left"><tr valign="bottom"><th align="center" valign="bottom" width="24.409448818897637%" id="d0e35">Keyword</th>
|
||
<th align="center" valign="bottom" width="33.07086614173229%" id="d0e37">Description</th>
|
||
<th align="center" valign="bottom" width="33.46456692913386%" id="d0e39">Choices</th>
|
||
<th align="center" valign="bottom" width="9.05511811023622%" id="d0e41">Default</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">ALLOWPROCCALLS</td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specifies whether stored procedures can be called when
|
||
the connection attribute, SQL_ATTR_ACCESS_MODE, is set to SQL_MODE_READ_ONLY.</td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">0 = Do not allow stored procedures to be called <p>1
|
||
= Allow stored procedures to be called</p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 ">0</td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">DB2SQLSTATES</td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specifies whether or not to return ODBC-defined SQL
|
||
States or DB2<sup>®</sup> SQL
|
||
States. Refer to the DB2 UDB SQL Reference for more details on the DB2 SQL States.
|
||
This option should be used only if you have the ability to change the ODBC
|
||
application's source code. If not, you should leave this option set to 0
|
||
as most applications are coded only to handle the ODBC-defined SQL States.</td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">0 = Return ODBC-defined SQLStates <p>1 = Return DB2 SQL
|
||
States</p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 ">0 </td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 "><img src="./delta.gif" alt="Start of change" />DATETIMETOCHAR or ConvertDateTimeToChar<img src="./deltaend.gif" alt="End of change" /></td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 "><img src="./delta.gif" alt="Start of change" /> Specifies one or more options on how date, time, and
|
||
timestamp data types are reported to an application. To specify multiple options
|
||
add together the values for the options. This option supports cases in which
|
||
date values such as 24:00:00 are used. <img src="./deltaend.gif" alt="End of change" /></td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 "><img src="./delta.gif" alt="Start of change" />To determine the value for this keyword, add the values
|
||
below that are associated with each option that you want. <p> 0 = Continue
|
||
to map the DATE, TIME, and TIMESTAMP data types as SQL_TYPE_DATE, SQL_TYPE_TIME,
|
||
and SQL_TYPE_TIMESTAMP </p>
|
||
<p>1 = Return DATE data type as SQL_CHAR </p>
|
||
<p>2
|
||
= Return TIME data type as SQL_CHAR </p>
|
||
<p>4 = Return TIMESTAMP data type
|
||
as SQL_CHAR</p>
|
||
<img src="./deltaend.gif" alt="End of change" /></td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 "><img src="./delta.gif" alt="Start of change" />0<img src="./deltaend.gif" alt="End of change" /></td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">DBCSNoTruncError</td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specifies whether or not to report a DBCS string conversion
|
||
overflow error as an ODBC trunctation error.</td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">0 = Report DBCS string conversion overflow error as
|
||
ODBC truncation error <p>1 = Ignore truncation error</p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 ">0</td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">DEBUG </td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specifies one or more debug options. To specify multiple
|
||
debug options add together the values for the options that you want. In most
|
||
cases you will not need to set this option. </td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">To determine the value for this keyword, add the
|
||
values below that are associated with each option that you want. <p>2 = Return
|
||
SQL_IC_MIXED for the SQL_IDENTIFIER_CASE option of SQLGetInfo </p>
|
||
<p>4 =
|
||
Store all SELECT statements in the package</p>
|
||
<p>8 = Return zero for the SQL_MAX_QUALIFIER_NAME_LEN
|
||
option of option of SQLGetInfo</p>
|
||
<p>16 = Add positioned UPDATEs / DELETEs
|
||
into packages</p>
|
||
<p>32 = Convert static cursors to dynamic cursors</p>
|
||
<p>64
|
||
= Send the entire column size worth of data for variable length fields (VARCHAR,
|
||
VARGRAPHIC, BLOB, etc.) Note, set this option with caution as this can have
|
||
an adverse impact on performance.</p>
|
||
<p>128 = Subtract one from the SQLBindParameter
|
||
sourcelength if the last character in the buffer is a null-terminator character.</p>
|
||
<p>256
|
||
= Ignore data decimal errors</p>
|
||
<p>512 = Ignore case warnings (SQL0402) for
|
||
scrollable cursors</p>
|
||
<p>1024 = Disable variable length compression</p>
|
||
<p>2048
|
||
= Return no support for SQL_CVT_DATE when calling the SQLGetInfo's SQL_CONVERT_TIMESTAMP
|
||
option. </p>
|
||
<p>32768 = If the result of a query results in a column being
|
||
divided by 0, return a NULL value instead of an error.</p>
|
||
<p></p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 "> 0 </td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">TRUEAUTOCOMMIT</td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specifies how to handle autocommit support. In past
|
||
ODBC drivers, turning autocommit on resulted in the server running under the
|
||
*NONE isolation level. Now autocommit can run under any isolation level.
|
||
Applications that require strict conformance to the SQL specification should
|
||
use setting 1. Note that this setting requires that all files be journaled.
|
||
Setting 0 offers better performance for most applications. See the SQL reference
|
||
for further information on Transaction Isolation levels.</td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">0 = run autocommit under the *NONE isolation level <p><img src="./delta.gif" alt="Start of change" />1 = run autocommit under the isolation level that is set for the
|
||
connection. The connection's isolation level is set using the SQLSetConnectAttr
|
||
API and the SQL_ATTR_TXN_ISOLATION option. <img src="./deltaend.gif" alt="End of change" /></p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 ">0</td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 "><img src="./delta.gif" alt="Start of change" />NEWPWD<img src="./deltaend.gif" alt="End of change" /></td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 "><img src="./delta.gif" alt="Start of change" />Specifies a new password used to override the current
|
||
user's iSeries password.
|
||
This option is only honored if set by an application. When using this option,
|
||
the UID and PWD keywords should also be specified. <img src="./deltaend.gif" alt="End of change" /></td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 "><img src="./delta.gif" alt="Start of change" />New password to use<img src="./deltaend.gif" alt="End of change" /></td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 "><img src="./delta.gif" alt="Start of change" />none<img src="./deltaend.gif" alt="End of change" /></td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">XALCS or XALooselyCoupledSupport </td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specifies whether locks are shared between loosely coupled
|
||
distributed transaction branches.</td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">0 = Locks are not shared <p>1 = Locks are shared </p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 "> 1 (for Windows<sup>®</sup>)<p>0 (for Linux<sup>®</sup>)</p>
|
||
</td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">XALOCKTIMEOUT</td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specifies the maximum amount of time (in seconds) that
|
||
a distributed transaction waits on a lock request before timing out. </td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">0 = Use the default system setting <p>0 – 999999999
|
||
= the number of seconds to wait</p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 ">0</td>
|
||
</tr>
|
||
<tr><td valign="top" width="24.409448818897637%" headers="d0e35 ">XATXNTIMEOUT or XATransactionTimeout</td>
|
||
<td valign="top" width="33.07086614173229%" headers="d0e37 ">Specfies the amount of time (in seconds) that a distributed
|
||
transaction waits before timing out.</td>
|
||
<td valign="top" width="33.46456692913386%" headers="d0e39 ">0 = Wait indefinitely for the transaction to finish <p>0
|
||
– 999999999 = the number of seconds to wait</p>
|
||
</td>
|
||
<td valign="top" width="9.05511811023622%" headers="d0e41 ">0</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="connectkeywords.htm" title="The iSeries Access ODBC driver has many connection string keywords that can be used to change the behavior of the ODBC connection.">Connection string keywords</a></div>
|
||
</div>
|
||
</div>
|
||
</body>
|
||
</html> |