Caché ObjectScript Reference - InterSystems Documentation

Routine, Debugging, and Other CommandsNotesZINSERT and ZREMOVEYou can use the ZREMOVE command to remove one or more lines of code from the currentlyexecuting routine. Thus by using ZREMOVE and ZINSERT, you can substitute a new codeline for an existing code line. These operations only affect the copy of the routine currentlybeing run by your process.ZINSERT, XECUTE, and $TEXTYou use the XECUTE command to define and insert a single line of executable code fromwithin a routine. You use the ZINSERT command to define and insert by line position asingle line of executable code from outside a routine.An XECUTE command cannot be used to define a new label. Therefore, XECUTE doesnot require an initial blank space before the first command in its code line. ZINSERT canbe used to define a new label. Therefore ZINSERT does require an initial blank space (orthe name of a new label) before the first command in its command line.The $TEXT function permits you to extract a line of code by line position from within aroutine. $TEXT simply copies the specified line of code as a text string; it does not affectthe execution of that line or change the current line location (edit pointer) when extractingfrom the current routine. (Using $TEXT to extract code from a routine other than the currentroutine does change the current line location.) $TEXT can supply a line of code to theXECUTE command. $TEXT can also supply a line of code to a WRITE command, andthus supply a code line to the programmer prompt.See Also• XECUTE command• ZLOAD command• ZPRINT command• ZREMOVE command• ZSAVE command• $TEXT function392 Caché ObjectScript Reference