Caché ObjectScript Reference - InterSystems Documentation

Legacy Commands and Functions$ZUTIL(133,1)tnum=$ZUTIL(133,1,table,ccount,tabbrev,tdesc)$ZUTIL(133,1) creates a metric counter table and returns tnum, a numeric identifier for thattable. Calling $ZUTIL(133,1) with only the table parameter performs a lookup that determinesif a table with that name has been created. Calling $ZUTIL(133,1) with all four parameterscreates a working metric counter table. A maximum of 255 metric counter tables may becreated. You can call $ZUTIL(133,1) for an existing metric counter table to change the tdesc(table description).tnumtableccounttabbrevtdescReturns a positive numeric identifier for the counter table. Table numbersare assigned sequentially, beginning with 1. A value of 0 on a lookupmeans that the table has not been created. A negative value is an errorcode, indicating why the counter table cannot be created.The name of the metric counter table, specified as a quoted text string.The maximum length of the name is 20 characters.Optional — The number of counters to establish for the table. There isno explicit maximum value; however, there is a limit of 1024 total countersacross all counter tables.Optional — An abbreviation used to uniquely identify the metric countertable, specified as a quoted text string. This abbreviated name is usedwhen specifying a single counter in $ZUTIL(133,2). The maximum stringlength is 3 characters.Optional — The description of the table, specified as a quoted text string.A description can include variables.This example shows how to define a table.; Create counter tableSET BillingTable=$ZUTIL(133,1,"Billing",100,"BCT","My Billing Counters")If the last three parameters (ccount, tabbrev, tdesc) are not specified, only a lookup is performed.When a table is created, it is disabled. Therefore, you must use $ZUTIL(133,3) to explicitlyenable the table before its counters are available to ViewPoint.Each table has a version number that is an indicator of changes made to the table and counters.The value is incremented whenever a table is created, description changed, or enabled/disabled,790 Caché ObjectScript Reference