db2_get_option

(PECL ibm_db2 >= 1.6.0)

db2_get_optionRetrieves an option value for a statement resource or a connection resource

Beschreibung

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

Retrieves the value of a specified option value for a statement resource or a connection resource.

Parameter-Liste

resource

A valid statement resource as returned from db2_prepare() or a valid connection resource as returned from db2_connect() or db2_pconnect().

option

A valid statement or connection options. The following new options are available as of ibm_db2 version 1.6.0. They provide useful tracking information that can be set during execution with db2_get_option().

Hinweis:

Prior versions of ibm_db2 do not support these new options.

When the value in each option is being set, some servers might not handle the entire length provided and might truncate the value.

To ensure that the data specified in each option is converted correctly when transmitted to a host system, use only the characters A through Z, 0 through 9, and the underscore (_) or period (.).

userid

SQL_ATTR_INFO_USERID - A pointer to a null-terminated character string used to identify the client user ID sent to the host database server when using DB2 Connect.

Hinweis:

DB2 for z/OS and OS/390 servers support up to a length of 16 characters. This user-id is not to be confused with the authentication user-id, it is for identification purposes only and is not used for any authorization.

acctstr

SQL_ATTR_INFO_ACCTSTR - A pointer to a null-terminated character string used to identify the client accounting string sent to the host database server when using DB2 Connect.

Hinweis:

DB2 for z/OS and OS/390 servers support up to a length of 200 characters.

applname

SQL_ATTR_INFO_APPLNAME - A pointer to a null-terminated character string used to identify the client application name sent to the host database server when using DB2 Connect.

Hinweis:

DB2 for z/OS and OS/390 servers support up to a length of 32 characters.

wrkstnname

SQL_ATTR_INFO_WRKSTNNAME - A pointer to a null-terminated character string used to identify the client workstation name sent to the host database server when using DB2 Connect.

Hinweis:

DB2 for z/OS and OS/390 servers support up to a length of 18 characters.

The following table specifies which options are compatible with the available resource types:

Resource-Parameter Matrix
Key Value Resource Type
  Connection Statement Result Set
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 -

Rückgabewerte

Returns the current setting of the connection attribute provided on success Bei einem Fehler wird false zurückgegeben..

Beispiele

Beispiel #1 Setting and retrieving parameters through a connection resource

<?php
/* Database Connection Parameters */
$database 'SAMPLE';
$user     'db2inst1';
$password 'ibmdb2';

/* Obtain Connection Resource */
$conn db2_connect($database$user$password);

echo 
"Client attributes passed through connection string:\n";

/* Create the associative options array with valid key-value pairs */
/* Assign the attributes through connection string */
/* Access the options specified */
$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 
"Client attributes passed post-connection:\n";

/* Create the associative options array with valid key-value pairs */
/* Assign the attributes after a connection is made */
/* Access the options specified */
$options5 = array('userid' => 'db2inst1');
$conn5 db2_connect($database$user$password);
$rc db2_set_option($conn5$options51);
$val db2_get_option($conn5'userid');
echo 
$val "\n";

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

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

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Client attributes passed through connection string:
db2inst1
account
myapp
workstation
Client attributes passed post-connection:
db2inst1
account
myapp
workstation

Siehe auch

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

PHP cURL-Tutorial: Verwendung von cURL zum Durchführen von HTTP-Anfragen

cURL ist eine leistungsstarke PHP-Erweiterung, die es Ihnen ermöglicht, mit verschiedenen Servern über verschiedene Protokolle wie HTTP, HTTPS, FTP und mehr zu kommunizieren. ...

TheMax

Autor : TheMax
Kategorie: PHP-Tutorials

Midjourney Tutorial - Anleitung für Anfänger

Über Midjourney, dem Tool zur Erstellung digitaler Bilder mithilfe von künstlicher Intelligenz, gibt es ein informatives Video mit dem Titel "Midjourney Tutorial auf Deutsch - Anleitung für Anfänger" ...

Mike94

Autor : Mike94
Kategorie: KI Tutorials

Grundlagen von Views in MySQL

Views in einer MySQL-Datenbank bieten die Möglichkeit, eine virtuelle Tabelle basierend auf dem Ergebnis einer SQL-Abfrage zu erstellen. ...

admin

Autor : admin
Kategorie: mySQL-Tutorials

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Schwarzes Brett/ News Script

Thanks for the best post with these amazing ideas, and it is good for us to find more updates that bring us the right results. You can click here ...

Geschrieben von Yagil am 02.11.2024 19:12:36
Forum: PHP Developer Forum
Spielgeschenk für Freund zu finden

Ist es ein Geschenk, das in 4 Jahren sicher gefunden wird, oder brauchen wir Hilfe? )))))))) Ich habe übrigens einmal ein originelles Geschenk be ...

Geschrieben von benisfroms am 31.10.2024 20:21:11
Forum: Off-Topic Diskussionen
Mongo Datenbank und Tabellendaten in sehr großer Menge...Wer kennt sich aus?

Es hört sich so an, als stünden Sie vor einer großen Herausforderung beim Importieren und Verarbeiten einer großen Anzahl von JSON-Dateien in ...

Geschrieben von ColeHarry am 29.10.2024 04:17:30
Forum: PHP Developer Forum
Kalenderwoche auf Sonntag anfangen lassen

Um die neue Woche bereits am Sonntag starten zu lassen, können wir den Code so anpassen, dass er prüft, ob heute Sonntag ist. Falls ja, zählt d ...

Geschrieben von magentaviking am 28.10.2024 10:04:54
Forum: PHP Developer Forum