GET_CONNECTION

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

Syntax

GET_CONNECTION (Objektname, Attribut)

Syntax

Beschreibung/Format

Objektname

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

Attribut

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" - MySQL
    • "INFORMIX" - Informix
    • "ORACLE_OCI" - Oracle OCI
  • db.server = Name des DB-Servers
  • db.port = Portnummer des DB-Servers.
  • db.name = Name der Datenbank
  • DbUserid = Der Datenbank-Benutzer.
  • DbPassword = Password des DB-Benutzers
  • Login = Name des alternativen Login-Objekts.

Achtung! 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 ermittelt den Datenbank-Typ des Verbindungs-Objekts 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: