Returns, as a character string, the name of
a connected database's code page.
Syntax
DBCODEPAGE ( {integer-expression|logical-name|alias} )
|
-
integer-expression
- The sequence number of a database the ABL session is connected to. For example,
DBCODEPAGE(1) returns information on the first database the ABL session is connected to,
DCODEPAGE(2) returns information on the second database the ABL session is connected to,
etc. If you specify a sequence number that does not correspond to a database the ABL
session is connected to, the DBCODEPAGE function returns the Unknown value
(?).
-
logical-name
- A character expression that specifies the database by its logical
name or alias.
A code page maps each character
in a character set to a numeric value. For an OpenEdge database,
DBCODEPAGE returns the code page of the database represented by
the integer expression, logical name, or alias. For a non-OpenEdge database,
DBCODEPAGE returns the value originally inserted when the schema
was created.
There are three possible types of non-OpenEdge code
pages:
- Physical data source for the database
- Code page of a non-OpenEdge vendor library linked in with
an OpenEdge dataserver executable (either dynamically or at compile time)
- Code page that is in the schema holder that is part of the create activity
If any parameter is invalid, it returns the Unknown value (?).
Example
This
procedure displays the logical name and code page of all connected databases:
r-dbcp.p
DEFINE VARIABLE ix AS INTEGER NO-UNDO.
REPEAT ix = 1 TO NUM-DBS:
DISPLAY LDBNAME(ix) DBCODEPAGE(ix) FORMAT "x(19)".
END.
|
Notes
A database
must be connected in order for the DBCODEPAGE function to work as
described.
See also
ALIAS function, CONNECT statement, CONNECTED function, CREATE ALIAS statement, CREATE CALL statement, DATASERVERS function, DBCOLLATION function, DBRESTRICTIONS function, DBTYPE function, DBVERSION function, DELETE ALIAS statement, DISCONNECT statement, FRAME-DB function, LDBNAME function, PDBNAME function, SDBNAME function
