GET_CONNECTION

Script-Funktion: Liest Informationen aus einem DB-artigen Verbindungsobjekt.

Syntax

GET_CONNECTION (Object name, Attribute)

Syntax

Beschreibung/Format

Object name

Der Name eines DB-artigen Verbindungsobjekts (Verbindung (CONN)).
Format: AE-Name, Script-Literal oder Script-Variable

Attribute

Wert, der aus dem Objekt gelesen werden soll.
Format: AE-Name, Script-Literal oder Script-Variable

Erlaubte Werte:

  • db.type = Datenbank-Typ
    Mögliche zurückgelieferte Werte:
    • „MSSQL“ - MS SQL Server
    • „DB2“ - IBM DB2
    • „ORACLE“ - Oracle
    • „SYBASE“ - Sybase
    • „MYSQL“ - MyQL
    • „INFORMIX“ - Informix
    • „ORACLE_OCI“ - Oracle OCI
  • db.server = Name des DB-Servers
  • db.port = Portnummer des DB-Servers
  • db.name = Name der Datenbank
  • DbUserid = Datenbank-Benutzer
  • DbPassword = Password des DB-Benutzers
  • Login = Name des Alternativ-Login-Objektes

Bei Datenbanken, in denen die Groß- und Kleinschreibung eine Rolle spielt, müssen Sie den Wert DbUserid in der hier gezeigten Schreibweise verwenden.

Rückgabewerte

Gewünschter Wert des CONN-Objektes

Die Script-Funktion liest einen bestimmten Wert aus einem Verbindungs-Objekt vom Typ DB und liefert diesen als Rückgabewert zurück.

Wurde das angegebene Objekt nicht gefunden, entspricht das Verbindungs-Objekt nicht dem Typ DB oder ist das spezifizierte Attribut ungültig, so kommt es zu einem Laufzeitfehler.

Beispiele

Folgendes Beispiel ermiitelt den Datenbank-Typ des Verbindungs-Objektes CONN.DB und schreibt diesen in den Aktivierungsreport.

:SET &VAR# = GET_CONNECTION(CONN.DB, db.type)
:P &VAR#

So erscheint die zugehörige Zeile im Aktivierungsreport:

2013-01-30 12:45:21 - U0020408 MSSQL

Siehe auch: