GetDatabase

Description

Returns the database object with the specified name.

The databaseName parameter corresponds to the logical database name, that is, the string in the Name field of the Database object.

Syntax

VBScript

adminSession.GetDatabase(databaseName) 

Perl

$adminSession->GetDatabase(databaseName); 

Identifier

Description

adminSession

The AdminSession object representing the current schema repository access session.

databaseName

A String containing the name of the database object you want.

Return value

The Database Object with the specified name, or null if no such database exists.

Examples

VBScript

set adminSession = CreateObject("Rational ClearQuest.AdminSession"))
adminSession.Logon "admin", "admin", ""

set dbObj = adminSession.GetDatabase ("NEWDB") 

Perl

use CQPerlExt;

#Create a Rational
                    ClearQuest admin session
$adminSession= CQAdminSession::Build();

#Logon as admin
$adminSession->Logon( "admin", "admin", "" );

#Get the database "NEWDB" object
$dbObj = $adminSession->GetDatabase( "NEWDB" );

#...

CQAdminSession::Unbuild($adminSession);