array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.db2-get-option.php', 1 => 'db2_get_option', 2 => 'Recupera el valor de una opción para una consulta o conexión', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Funciones de IBM DB2', ), 'prev' => array ( 0 => 'function.db2-free-stmt.php', 1 => 'db2_free_stmt', ), 'next' => array ( 0 => 'function.db2-last-insert-id.php', 1 => 'db2_last_insert_id', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/ibm_db2/functions/db2-get-option.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

db2_get_option

(PECL ibm_db2 >= 1.6.0)

db2_get_option — Recupera el valor de una opción para una consulta o conexión

Descripción

db2_get_option(resource $resource, string $option): string|false

Recupera el valor de una opción especificada para un recurso de consulta o un recurso de conexión.

Parámetros

resource
Un recurso de consulta válido devuelto por db2_prepare() o un recurso de conexión válido devuelto por db2_connect() o db2_pconnect().
option

Opciones de consulta o conexión válidas. Las siguientes opciones nuevas están disponibles desde la versión 1.6.0 de ibm_db2. Proporcionan información de seguimiento útil que puede ser establecida durante la ejecución con db2_get_option().

Nota: Las versiones anteriores de ibm_db no soportan estas nuevas opciones. Cuando un valor en cada opción es establecido, algunos servidores pueden no soportar el valor total proporcionado y pueden truncar este valor. Para asegurar que los datos especificados en cada opción sean convertidos correctamente durante la transmisión hacia una base de datos, utilice solo los caracteres de A a Z, 0 a 9 y los caracteres de subrayado (_) o punto (.).

userid

SQL_ATTR_INFO_USERID : un puntero hacia un string utilizado para identificar el identificador de usuario (ID) enviado hacia el servidor de base de datos durante la conexión a DB2.

Nota: DB2 para servidores z/OS y OS/390 soportan hasta 16 caracteres. El user-id no debe ser confundido con la identificación user-id; se trata solamente de un propósito de identificación y no debe ser autorizado para permisos.

acctstr

SQL_ATTR_INFO_ACCTSTR : un puntero hacia un string utilizado para identificar la cuenta del cliente enviada hacia el servidor de base de datos durante la conexión a DB2.

Nota: DB2 para servidores z/OS y OS/390 soportan hasta 200 caracteres.

applname

SQL_ATTR_INFO_APPLNAME : un puntero hacia un string utilizado para identificar el nombre de la aplicación del cliente enviada hacia el servidor de base de datos durante la conexión a DB2.

Nota: DB2 para servidores z/OS y OS/390 soportan hasta 32 caracteres.

wrkstnname

SQL_ATTR_INFO_WRKSTNNAME : un puntero hacia un string utilizado para identificar el nombre de la máquina del cliente enviada hacia el servidor de base de datos durante la conexión a DB2.

Nota: DB2 para servidores z/OS y OS/390 soportan hasta 18 caracteres.

La siguiente tabla especifica qué opciones son compatibles con el tipo de recurso disponible:
Matriz recurso parámetro
Clave Valor Tipo de recurso
  Conexión Consulta Conjunto de resultados
userid SQL_ATTR_INFO_USERID X X -
acctstr SQL_ATTR_INFO_ACCTSTR X X -
applname SQL_ATTR_INFO_APPLNAME X X -
wrkstnname SQL_ATTR_INFO_WRKSTNNAME X X -

Valores devueltos

Devuelve la configuración actual de la conexión proporcionada en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Establece y recupera los parámetros de un recurso de conexión

<?php
/* Parámetros de Conexión */
$database = 'SAMPLE';
$user = 'db2inst1';
$password = 'ibmdb2';

/* Recuperación del Recurso de Conexión */
$conn = db2_connect($database, $user, $password);

echo "Atributos de conexión pasados con la cadena de caracteres de conexión :\n";

/* Crea un array asociativo de opciones con los pares clave/valor válidos */
/* Asigna los atributos a partir de la cadena de caracteres de conexión */
/* Accede a las opciones especificadas */
$options1 = array('userid' => 'db2inst1');
$conn1 = db2_connect($database, $user, $password, $options1);
$val = db2_get_option($conn1, 'userid');
echo $val . "\n";

$options2 = array('acctstr' => 'account');
$conn2 = db2_connect($database, $user, $password, $options2);
$val = db2_get_option($conn2, 'acctstr');
echo $val . "\n";

$options3 = array('applname' => 'myapp');
$conn3 = db2_connect($database, $user, $password, $options3);
$val = db2_get_option($conn3, 'applname');
echo $val . "\n";

$options4 = array('wrkstnname' => 'workstation');
$conn4 = db2_connect($database, $user, $password, $options4);
$val = db2_get_option($conn4, 'wrkstnname');
echo $val . "\n";

echo "Atributos después de la conexión :\n";

/* Crea un array asociativo de opciones con los pares clave/valor válidos */
/* Asigna los atributos después de que la conexión sea realizada */
/* Accede a las opciones especificadas */
$options5 = array('userid' => 'db2inst1');
$conn5 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn5, $options5, 1);
$val = db2_get_option($conn5, 'userid');
echo $val . "\n";

$options6 = array('acctstr' => 'account');
$conn6 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn6, $options6, 1);
$val = db2_get_option($conn6, 'acctstr');
echo $val . "\n";

$options7 = array('applname' => 'myapp');
$conn7 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn7, $options7, 1);
$val = db2_get_option($conn7, 'applname');
echo $val . "\n";

$options8 = array('wrkstnname' => 'workstation');
$conn8 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn8, $options8, 1);
$val = db2_get_option($conn8, 'wrkstnname');
echo $val . "\n";
?>

El ejemplo anterior mostrará:

Atributos de conexión pasados con la cadena de caracteres de conexión :
db2inst1
account
myapp
workstation
Atributos después de la conexión :
db2inst1
account
myapp
workstation

Ver también