Caché ObjectScript Reference - InterSystems Documentation

System and Other FunctionsCluster Lock InformationIf you specify a flag value of 1, $ZUTIL(49,dir,1) returns the cluster lock information fordir for the database. The returned string consists of four comma-separated parts:sfn,cfn,locktype,lockidListed ItemsfncfnlocktypelockidDescriptionThe system file number (index into gfiletab) of the file. If zero (0), thisindicates the System Manager's directory. Negative numbers indicatethat the specified directory does not exist, is not mounted, or can't beread (see the first item in the Database Header Information table).Cluster File Number (CFN) if the directory is a cluster-mounteddatabase. Otherwise (non-USECLUSTER systems) returns zero (0).The locktype status if the directory is cluster-mounted: S=shared,X=exclusive, N=null, U=unknown. Otherwise returns zero (0).Lock ID of the distributed lock manager if the directory iscluster-mounted. Otherwise returns zero (0).An examples of database cluster lock information is as follows:ZNSPACE "%SYS"SET dir=$ZUTIL(168) ; determine Caché directorySET dbdir=dir_"cachelib"WRITE $ZUTIL(49,dbdir,1)which returns the following string of 4 comma-separated values, corresponding to the rowsof the table above:1,0,0,0,Note:Do not specify a system file number (sfn) for dir for $ZUTIL(49,dir,1).For Tru64 UNIX, the lockid is of the form: “seqn:hndl”.588 Caché ObjectScript Reference