Caché ObjectScript Reference - InterSystems Documentation

Routine, Debugging, and Other CommandsDescriptionZINSERT "code" inserts a specified line of Caché ObjectScript code in the current routineat the current line location (edit pointer), as established by the ZPRINT or ZREMOVEcommand, by a previous ZINSERT command, or by some forms of the $TEXT function.ZINSERT "code":location inserts the specified line of code in the current routine after thespecified line location. Line location can be specified as number of lines offset from thebeginning of the routine, or number of lines offset from a specified label.After ZINSERT inserts a line of code, it resets the edit pointer to the end of this new line ofcode. This means the next ZINSERT places its line of code directly after the last new line,unless it explicitly specifies a location.ZINSERT effects only the local copy of the routine. It does not change the routine as storedon disk. To store inserted lines, you must use the ZSAVE command to save the routine.ZINSERT incrementally compiles each line.The ZINSERT command is usually executed from the programmer prompt. It should not becoded into the body of a routine, because its operation would effect the execution of thatroutine. To call ZINSERT from a routine, use the XECUTE command.CAUTION:ZINSERT and other commands move the edit pointer.ArgumentspcAn optional postconditional expression. Caché executes the command if the postconditionalexpression is true (evaluates to a non-zero numeric value). Caché does not execute the commandif the postconditional expression is false (evaluates to zero). For further details, referto Command Postconditional Expressions in Using Caché ObjectScript.codeA line of Caché ObjectScript code, specified as a string literal (in quotes), or a variable thatcontains a string literal. This line of code can contain one or more Caché ObjectScript commands,a new label name, or both a label and one or more commands. Because the code isinserted into a routine, it must follow Caché ObjectScript formatting. Therefore, the firstcharacter of the code string literal must either be a blank space (standard Caché ObjectScriptindentation) or a label. The enclosing quotation marks are required. Since quotation marksenclose the line of code you are inserting, quotes within the code itself must be doubled.390 Caché ObjectScript Reference