Caché ObjectScript Reference - InterSystems Documentation

Legacy Commands and FunctionsLegacy commands and functions are obsolete. In most cases, they have been replaced bynewer implementations with different syntax. These commands and functions should not beused in new programming. They are documented here for compatibility with existing programcode. Note that legacy commands and functions are not compatible with their replacements;though they may appear in the same program, they should never be combined. For example,you should not use a block-oriented IF with the legacy line-oriented ELSE, or attempt tomanipulate a bitstring created with a $BIT function using a $ZBIT function, or vice versa.CommandsThe following legacy commands have been replaced by new command syntax:• FOR• IF• ELSE• DO (without an argument)• ZQUITThe legacy IF, ELSE, and FOR commands do not use curly brace block structure syntax.Instead, they execute commands that appear on the same program line. They are thus muchmore restricted as to line formatting than the newer block-oriented versions of these commands.In addition, the legacy IF command cannot use the ELSEIF clause, and uses the $TESTspecial variable.The legacy argumentless DO uses a period prefix syntax to indicate block structure. Thissyntax has been superseded and is not compatible with curly brace syntax. The argumentlessform of DO should not be used for future coding.The ZQUIT command has been replaced by ZTRAP $ZERROR. Refer to the ZTRAPcommand for further details.Functions• The following legacy functions have been replaced by the new $BIT functions:$ZBITAND, $ZBITCOUNT, $ZBITFIND, $ZBITGET, $ZBITLEN, $ZBITNOT,$ZBITOR, $ZBITSET, $ZBITSTR, $ZBITXOR.Caché ObjectScript Reference 739