Caché ObjectScript Reference - InterSystems Documentation

System and Other Functions$ZUTIL(39)Specifies a search path for percent (%) routines.$ZUTIL(39,sys1,sys2,sys3)$ZU(39,sys1,sys2,sys3)Parameterssys1sys2sys3Specify a namespace name to use as the search path for percent (%) routines.Optional — Specify a namespace name to use as the second search path forpercent (%) routines.Optional — Specify a namespace name to use as the third search path forpercent (%) routines.Description$ZUTIL(39) specifies one or more namespaces to use as a search path for percent (%) routines,and thereby establishes an alternate system manager's namespace. After issuing $ZUTIL(39),when you call percent routines, Caché search for these routines in the namespace(s) specifiedby $ZUTIL(39), rather than the default system manager's namespace.A percent routine is a routine whose name begins with a percent sign character. This namingconvention is commonly used for system routines found in the system manager's namespaceand available to all users. The default system manager's namespace is %SYS.After issuing $ZUTIL(39), Caché uses up to the maximum of three path specifications tofind percent routines when they are called. If Caché cannot locate a percent routine in theCaché database in sys1, it then searches sys2 (if you specified this parameter.) If the percentroutine is not in the Caché database insys2, Caché then searches sys3 (if you specified thisparameter.)You can use a null string as a search specification to indicate the default system manager'snamespace. After resetting the search path to the default system manager's namespace, subsequentcalls to $ZUTIL(39) returns ^^c:\cachesys\mgr\.A call to $ZUTIL(39) with no parameters returns the current namespace to search for percentroutines. A call to $ZUTIL(39) with any number of parameters returns the namespace namefor percent routine searches that existed prior to that $ZUTIL(39) call. $ZUTIL(39) onlyreturns one namespace name (sys1), even if you have established sys2 and sys3.582 Caché ObjectScript Reference