<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/pdo.drivers.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-ibm.php',
    1 => 'Controlador PDO IBM',
    2 => 'Funciones del controlador PDO IBM (PDO_IBM)',
  ),
  'up' => 
  array (
    0 => 'pdo.drivers.php',
    1 => 'Controladores PDO',
  ),
  'prev' => 
  array (
    0 => 'pdo-firebird.getapiversion.php',
    1 => 'Pdo\\Firebird::getApiVersion',
  ),
  'next' => 
  array (
    0 => 'ref.pdo-ibm.connection.php',
    1 => 'PDO_IBM DSN',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/pdo_ibm/reference.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/ref.pdo-ibm.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-ibm" class="reference">
 
 <h1 class="title">Funciones del controlador PDO IBM (PDO_IBM)</h1>
 
 <div class="partintro">

  <div class="section" id="pdo-ibm.intro">
   <h2 class="title">Introducción</h2>
   <p class="para">
    PDO_IBM es un driver que implementa la interfaz <a href="book.pdo.php#intro.pdo" class="link">PHP Data
    Objects (PDO)</a> para habilitar el acceso
    desde PHP a las bases de datos IBM.
   </p>
  </div>

  
  




<div class="section" id="ref.pdo-ibm.installation">
 <h2 class="title">Instalación</h2>
 <p class="para">
  Para compilar la extensión PDO_IBM, el cliente DB2 v9.1 o superior debe ser
  instalado en el mismo sistema que PHP. El cliente DB2 puede ser descargado
  desde el sitio de IBM de <a href="http://www.ibm.com/software/data/db2/ad" class="link external">&raquo;&nbsp;desarrollo
   de aplicaciones</a>.
 </p>
 <blockquote class="note"><p><strong class="note">Nota</strong>: 
  <strong>Nota</strong><br />
   <p class="para">
    El cliente DB2 v9.1 o superior soporta los accesos directos a DB2
    para los sistemas Linux, UNIX y los servidores Windows v8 y v9.1.
   </p>
   <p class="para">
    El cliente DB2 v9.1 soporta asimismo los accesos a DB2 UDB para i5
    y DB2 UDB para los servidores z/OS utilizando el
    <a href="http://www.ibm.com/software/data/db2/db2connect" class="link external">&raquo;&nbsp;producto de conexión DB2</a> de pago.
   </p>
 </p></blockquote>
 <p class="para">
  PDO_IBM es una extensión <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a>;
  por lo tanto, las instrucciones de <a href="install.pecl.php" class="xref">Instalaci&oacute;n de extensiones PECL</a>
  deben ser seguidas para instalar la extensión PDO_IBM. Ejecute el comando
  <strong class="command">configure</strong> para que apunte hacia el directorio
  que contiene los ficheros de encabezado y las bibliotecas del
  cliente DB2 de la siguiente manera:
  <div class="example-contents screen">
<div class="cdata"><pre>
 bash$ ./configure --with-pdo-ibm=/path/to/sqllib[,shared]
</pre></div>
  </div>
  El comando <strong class="command">configure</strong> utiliza por omisión
  el valor de la variable de entorno <var class="envar">DB2DIR</var>.
 </p>
</div>



  
  


<div class="section" id="pdo-ibm.configuration">
 <h2 class="title">Configuración en tiempo de ejecución</h2>
 <p class="simpara">El comportamiento de estas funciones es
afectado por la configuración en el archivo <var class="filename">php.ini</var>.</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Opciones de configuración PDO_IBM</strong></caption>
   
    <thead>
     <tr>
      <th>Nombre</th>
      <th>Por defecto</th>
      <th>Cambiable</th>
      <th>Historial de cambios</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="ref.pdo-ibm.php#ini.pdo-ibm.i5-dbcs-alloc" class="link">pdo_ibm.i5_dbcs_alloc</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td>Añadido en PDO_IBM 1.5.0</td>
     </tr>

     <tr>
      <td><a href="ref.pdo-ibm.php#ini.pdo-ibm.i5-override-ccsid" class="link">pdo_ibm.i5_override_ccsid</a></td>
      <td>&quot;0&quot;</td>
      <td><strong><code><a href="info.constants.php#constant.ini-system">INI_SYSTEM</a></code></strong></td>
      <td>Añadido en PDO_IBM 1.5.0</td>
     </tr>

    </tbody>
   
  </table>

  Para más detalles sobre los modos INI_*,
        refiérase a <a href="configuration.changes.modes.php" class="xref">D&oacute;nde una directiva de configuraci&oacute;n puede ser modificada</a>.
</p>

<p class="para">Aquí hay una aclaración sobre
el uso de las directivas de configuración.</p>

 <p class="para">
  <dl>
   
    <dt id="ini.pdo-ibm.i5-dbcs-alloc">
     <code class="parameter">pdo_ibm.i5_dbcs_alloc</code>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
    </dt>
    <dd>
     <p class="para">
      Esta opción afecta a la estrategia de asignación de memoria interna en IBM i.
      Por omisión, esta opción es 0. Cuando esta opción está definida, se asignan
      búferes con un tamaño mucho mayor, por si la base de datos engañara sobre el
      tamaño de los caracteres durante la conversión entre codificaciones. Esta opción
      utiliza seis veces más memoria para los búferes (para tener en cuenta las secuencias
      UTF-8 más largas), pero puede ser necesaria si se devuelven datos truncados.
      <ul class="itemizedlist">
       <li class="listitem">
        <p class="para">
         0 - Se asigna el tamaño mínimo de los búferes.
        </p>
       </li>
       <li class="listitem">
        <p class="para">
         1 - Se asigna un tamaño mayor de los búferes.
        </p>
       </li>
      </ul>
     </p>
    </dd>
   
   
    <dt id="ini.pdo-ibm.i5-override-ccsid">
     <code class="parameter">pdo_ibm.i5_override_ccsid</code>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
    </dt>
    <dd>
     <p class="para">
      El CCSID ASCII a utilizar para la conversión de EBCDIC en IBM i. Al definirlo
      como 1208, se utilizará UTF-8. Por omisión es 0, lo que seleccionará el CCSID
      ASCII de trabajo predeterminado.
     </p>
     <p class="para">
      Para obtener más información sobre los CCSID en IBM i, consulte la
      <a href="https://www.ibm.com/docs/en/i/7.5?topic=information-ccsid-reference" class="link external">&raquo;&nbsp;documentación de IBM</a>.
     </p>
    </dd>
   
  </dl>
 </p>
</div>




 </div>

 
<h2>Tabla de contenidos</h2><ul class="chunklist chunklist_reference"><li><a href="ref.pdo-ibm.connection.php">PDO_IBM DSN</a> — Conexi&oacute;n a las bases de datos IBM</li></ul>
</div>
<?php manual_footer($setup); ?>