Description
Returns
the database ID (DbId) translated from string ID. The DbId is a unique
number assigned to every record by IBM® Rational® ClearQuest®.
For stateful
records, the string ID is the display name (for example, SAMPL00001234).
Note: This method does not support stateless
record types.
Note: This method became available in version
2002.05.00. In version 7.0 the limit on the number of records that
can be stored increased so the range of DBIDs also increased. However,
Rational ClearQuest clients
earlier than version 7.0 cannot display records with database identifiers
(DBIDs) higher than the former limit. For more information on DBIDs,
see
Working with records
Syntax
VBScript
session.StringIdToDbId string_id
Perl
$session->StringIdToDbId(string_id);
- Identifier
- Description
- session
- The Session object that represents the current
database-access session.
- string_id
- A String containing a record string ID (display
name)
- Return value
- Returns a Long containing the record database ID.
Examples
VBScript
dbid = session.StringIdToDbId "RAMBU00001234"
Perl
$dbid = $session->StringIdToDbId ("RAMBU00001234");