Caché ObjectScript Reference - InterSystems Documentation

System and Other FunctionsDatabase Header Information$ZUTIL(49), $ZUTIL(49,dir) and $ZUTIL(49,dir,0) all return the database header information,returned as a comma-separated list of values. The following table lists the values thatthese forms of $ZUTIL(49) can return for each part of this comma-separated list:ListedItem123456DescriptionThis part contains either the file name status flag (if file header info cannotbe obtained) or the system file number:-3: This flag indicates that dir specified a file name that is too long or hasinvalid file name syntax. No other information is returned.-2: This flag indicates that dir specified a file that does not exist or cannotbe read. No other information is returned.-1: This flag indicates that dir specified a file that exists, but is currentlydismounted. No other information is returned.255 or 15999:These numbers are too large to be actual system file numbers.They indicate that the specified directory is not mounted. No other informationis returned. 15999 is returned by Caché version 5.0 and subsequent versions;255 is returned by Caché versions prior to 5.0.Other numbers: The system file number (index into gfiletab) of the file. Ifzero (0), this indicates the System Manager's directory. These values arefollowed by a comma-separated list of header information items, as shownbelow.Caché block size, in bytes. Either 2048 or 8192.User Identification Code (UIC), the decimal value of the two bytes of theprotection code assigned to the Caché database file. For example, A UICof [1,4] is represented by the decimal number 260 (256 + 4). 0 if noprotection. (The OpenVMS operating system assigns a UIC; At Cachéversion 5.1 (and subsequent), Caché security no longer sets or uses a UICvalue.)Current size of the Caché database file in megabytes. (1MB = 1024 * 1024bytes)Number of blocks by which Caché expands the database when it runs outof room.Maximum total number of blocks that can be allocated for this database. 0= limited only by GMaxBlks.586 Caché ObjectScript Reference