Caché ObjectScript Reference - InterSystems Documentation

$ZUTIL(49) with no parameters returns the header information for the manager's directory.$ZUTIL(49,dir,flag) returns the type of information specified by flag from the dir directory.This information is returned as a string of comma-separated items. The first item of thisreturned string is either the system file number (sfn) or a negative number indicating that thespecified directory does not exist, is not mounted, or can't be read.You can use the wildcard options of the $ZSEARCH function to determine the pathnamesof .DAT files on your system.ParametersdirThe fully-qualified pathname of the directory which contains the Caché .DAT database file.Specify dir as a quoted string. The dir parameter must be present to specify a flag parameter.If you omit the dir parameter, $ZUTIL(49) (with no arguments) returns the header informationfor the system manager's directory (for example: c:\cachesys\mgr\). You can specify dir as anull string ("") to return information on the current directory (for example:c:\cachesys\mgr\user\).On Windows and UNIX systems you can also use the following standard pathname symbols:a single dot (.) to specify the current directory, or a double dot (..) to specify its parent directory.Alternately, you can specify the system file number (sfn), which is an index to gfiletab, asthe dir parameter value for most flag values. This system file number can be obtained froma prior call to $ZUTIL(49) which specified the directory name as the dir parameter.flagA flag that specifies what type of database information to return.$ZUTIL(49)Value0123DescriptionReturn the database header information as a comma-separated string. Thisis the default if no flag parameter is specified.Return cluster lock information as a comma-separated string. Do not use thisflag value when specifying a system file number for dir.Return the most recent database file expansion time (in $HOROLOG format).This value is returned as the second item in a comma-separated string.Returns the directory location as the string sys^dir, where sys is the remotesystem number (0 if local), and dir is the directory name. This flag value canonly be used when specifying a system file number (sfn) for dir.Caché ObjectScript Reference 585