Caché ObjectScript Reference - InterSystems Documentation

$ZUTIL(12)0123Canonize name as a file name without checking for a valid name. Thus:c:\cachesys\mgr\user\fred.Windows: Canonize name as a directory name without checking for a valid name.Thus: c:\cachesys\mgr\user\fred\. This is the default.OpenVMS: Returns null if it is an invalid name (existing or not).UNIX: Returns null if it is not a file or special device such as a raw partition.If name refers to an existing directory, canonize name and return the full pathname.Otherwise, return null.If name refers to an existing directory or a special device that can contain a Cachédatabase, canonize name and return the full pathname. Otherwise, return null.The case FlagOn Windows systems, the default canonical form returned is entirely in lowercase letters,regardless of the case of name. Because Windows and Caché ObjectScript are case-insensitive,this is usually irrelevant. However, this may affect some Windows applications (such as Java)which are case-sensitive.To preserve uppercase letters on Windows systems, specify a case flag with a value of 1.This has the following effects:• The drive letter is always converted to uppercase.• If the directory does not exist on your system, $ZUTIL(12) follows the capitalizationyou specified. Letters specified as uppercase remain in uppercase.• If the directory exists on your system, $ZUTIL(12) follows the capitalization conventionsof the directory itself, rather than the capitalization in the string you specified.For example, if you specify:SET x=$ZUTIL(12,"\cAcHeSys\mGr\vIsiToR\fReD",0,1)WRITE xIt will return: C:\CacheSys\Mgr\vIsiToR\fReD\, deriving the case of the existing directories inthis pathname (C:\CacheSys\Mgr) from the file system, and deriving the case of the nonexistentdirectories (vIsiToR\fReD\) from the input string.The case flag is accepted on non-Windows systems, but performs no operation.Caché ObjectScript Reference 573