CASING Statement
Selects data case sensitivity or insensitivity.
Syntax
CASING [ON || OFF]
CASING expression
Syntax elements
ON Selects data case sensitivity.
OFF Selects data case insensitivity.
expression An expression that evaluates to true (select data case sensitivity) or false (select data case insensitivity).
Comments
Selecting data insensitivity is only possible if both the DataCaseControl database configuration option and the DATA.CC environment option are set. If either of these options is not selected, CASING generates a warning message.
Unless changed with the CASING statement, DataBasic inherits the current state of TCL case sensitivity, set with the CASE TCL command.
The CASING statement only changes case sensitivity within the current DataBasic program, though it affects the current program, any called subroutines and, if used in a subroutine, the calling programs. It does not change case sensitivity at TCL and therefore does not affect any commands run with the PERFORM statement. To change case sensitivity for these, perform the CASE TCL command; the effect of this is limited to commands performed from the current DataBasic program.
To find out the current state of data case sensitivity call the SYSTEM(101) function.
Note
To find out whether data case insensitivity is permitted, call CASING OFF, and then use SYSTEM(101) to find out whether this was effective:
* Try to select insensitivity.
CASING OFF
* Did it work?
IF SYSTEM(101)<3> THEN
ERROR "Cannot set case insensitivity"
ABORT
END
* Continue.
...