sesam_connect

(PHP 3 CVS only)

sesam_connect -- Open SESAM database connection

Descrição

bool sesam_connect ( string catalog, string schema, string user )

Establishes a connection to a SESAM database handler task. The connection is always "persistent" in the sense that only the very first invocation will actually load the driver from the configured SESAM OML PLAM library. Subsequent calls will reuse the driver and will immediately use the given catalog, schema, and user.

Parâmetros

catalog

When creating a database, the "catalog" name is specified in the SESAM configuration directive //ADD-SQL-DATABASE-CATALOG-LIST ENTRY-1 = *CATALOG(CATALOG-NAME = catalogname,...)

schema

The schema references the desired database schema (see SESAM handbook).

user

The "user" argument references one of the users which are allowed to access this "catalog" / "schema" combination. Note that "user" is completely independent from both the system's user id's and from HTTP user/password protection. It appears in the SESAM configuration only.

Valores de retornado

Retorna TRUE em caso de sucesso ou FALSE em falhas.

Exemplos

Exemplo 1. Connect to a SESAM database

<?php
if (!sesam_connect ("mycatalog", "myschema", "otto")) {
    die(
"Unable to connect to SESAM");
}
?>

Veja também

sesam_disconnect()