11.07.2015 Views

Caché ObjectScript Reference - InterSystems Documentation

Caché ObjectScript Reference - InterSystems Documentation

Caché ObjectScript Reference - InterSystems Documentation

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

or a counter's name or description is changed. Version numbers are returned by$ZUTIL(133,8).$ZUTIL(133,2)rval=$ZUTIL(133,2,tnum,cnum,cabbrev,cdesc)$ZUTIL(133) (legacy function)This function adds a metric counter to a table. If the counter exists, the function can be usedto change the name and/or description of the counter. Note that if the name or description ischanged, the version number of the table is incremented.rvaltnumcnumcabbrevcdescReturns a positive index number if the counter add/change wassuccessful. A negative value is an error message, indicating what kindof error occurred.The relative number of the metric counter table, specified as a positiveinteger, the count beginning with 1. The tnum of a table is returned bycalling $ZUTIL(133,1).The relative index number of the counter within the table, specified asan integer, the count beginning with 1.The name of the metric counter, specified as a quoted string. To specifya cabbrev name, concatenate the abbreviated name of the metric countertable (tabbrev in $ZUTIL(133,1)) with a unique counter name. If thecounter (specified by tnum and cnum) already exists, this new namereplaces the old name. Use the null string ("") to hide this counter.The description of the counter, specified as a quoted text string. Adescription can include variables.$ZUTIL(133,3)rval=$ZUTIL(133,3,tnum,n)This function is used to show (enable) or hide (disable) a metric counter table. All tables areinitially created as hidden. Hidden counter tables are disabled; the values in the counter tablewhile still incremented appropriately are unavailable to ViewPoint or a retrieve function call.You can determine the status (show or hide) of a table by calling $ZUTIL(133,3) withoutthe n parameter.<strong>Caché</strong> <strong>ObjectScript</strong> <strong>Reference</strong> 791

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!