Caché ObjectScript Reference - InterSystems Documentation

$ZUTIL(20)file specification preceded by two caret characters: either "^^dir" (on the current system),or "^system^dir".To understand $ZUTIL(20), you need to keep the following in mind. When a job starts, ituses routines in the current namespace. After you issue $ZUTIL(20,new), all subsequentroutines come from new.To determine the current namespace, use the $ZNSPACE special variable or $ZUTIL(5). Tochange the current namespace, use the ZNSPACE command or $ZUTIL(5).If you issue $ZUTIL(20,new,second,third), all subsequent routines located in new also comefrom new. If Caché does not find a routine in new, Caché looks for the routine in second. IfCaché does not find the routine in second, Caché looks for the routine in third, and so on.Note:Using routines in second is VERY slow! You should use second as an aid to programdevelopment, not as a normal running procedure.To use second as a development aid, make new your development area and second as a storagearea of routines that work. When you issue ZSAVE, the routine you save always goes intonew, even if you loaded it from second. As you edit and file routines, they appear in newwithout affecting the library in second, and subsequent calls for the routines get the newversion from new.For % routines, refer to $ZUTIL(39).ParametersnewSpecify the primary namespace that contains the routine dataset. If used alone, this is thenamespace that will be searched for all routines. If used in conjunction with second and third,new will be the first namespace searched for routines.Enclose the namespace in double quotes. The namespace you specify can be either an explicitnamespace or an implied namespace (a directory path or OpenVMS file specification precededby two circumflex characters).secondSpecify the second namespace to search for routines. If Caché doesn't find a routine in new,it will search for it in second. Specify the same as new.Caché ObjectScript Reference 579