Caché ObjectScript Reference - InterSystems Documentation

System and Other FunctionsYou can use the wildcard options of the $ZSEARCH function to locate an existing directoryand return its full path name. You can use $ZUTIL(140) to create a new directory, or toreturn information about an existing file or directory.Directory PathnamesThe following rules govern the expansion of directory pathnames:• $ZUTIL(12) (with no arguments) returns the current system manager's directory pathname.For example: c:\cachesys\mgr\.• $ZUTIL(12,"") or $ZUTIL(12,"c:") returns the current namespace pathname. Forexample: c:\cachesys\mgr\user\.• $ZUTIL(12,"fred") returns the current namespace pathname for the specified directory.For example: c:\cachesys\mgr\user\fred\.• $ZUTIL(12,"\fred") returns the specified directory as a top-level directory. For example:c:\fred\.• Pathnames can use a single dot (.) to indicate the current directory, or a double dot (..)to indicate its parent directory. Thus $ZUTIL(12,".") returns the current namespacedirectory: c:\cachesys\mgr\user\, and $ZUTIL(12,"..") returns the parent directory ofthe current namespace directory: c:\cachesys\mgr\.Device NamesDevice names are handled much like directory names:• $ZUTIL(12,$PRINCIPAL) returns the current namespace pathname for the specifieddevice. For example: c:\cachesys\mgr\user\|trm|:|1876\.• $ZUTIL(12,"\"_$PRINCIPAL) returns the specified device as a top-level directory.For example: c:\|trm|:|1876\.The canon Flag$ZUTIL(12,name,canon) determines the action to be performed based on the value of canon.Valid values are:572 Caché ObjectScript Reference