Caché ObjectScript Reference - InterSystems Documentation

System and Other Functions$ZUTIL(69)Sets system-wide configuration defaults.$ZUTIL(69,subfunc,n)$ZU(69,subfunc,n)ParameterssubfuncnAn integer specifying which $ZUTIL(69) subfunction to invoke.Optional — The value used to set the invoked function, usually a boolean(0 or 1), occasionally a numeric code. If this parameter is omitted, the$ZUTIL(69) subfunction returns its current value.DescriptionUse the $ZUTIL(69) subfunctions to set or clear system-wide configuration settings.Although each of the $ZUTIL(69,subfunc,n) functions control a different aspect of systemoperation, all of them have the following operating characteristics in common:• You must have the %Admin_Manage:Use privilege to execute any of the $ZUTIL(69)functions. These functions can also be invoked by % routines located in the manager'sdirectory. For further details, refer to the Privileges and Permissions chapter of the CachéSecurity Administration Guide.• Whenever you issue a call to $ZUTIL(69,subfunc) without specifying the third, nparameter, $ZUTIL(69,subfunc) returns the current setting of the switch specified bysubfunc.• Whenever you make a call to $ZUTIL(69,subfunc,n), the function first sets the switchto the new value specified by n, and then returns the previous switch value.• Whenever you change a system setting through the use of $ZUTIL(69,subfunc,n), onlyprocesses that log in subsequent to the change are affected. Processes that logged inbefore the change still operate under the old switch value.In a most cases, the $ZUTIL(69) function provides a system-wide override for a system-widedefault value. Setting one of these $ZUTIL(69) functions overrides the system configurationdefault; it does not change the default setting. The value set by $ZUTIL(69) applies to allsubsequent processes running on the current instance of Caché; stopping and restarting Cachécauses these configuration values to revert to their defaults.630 Caché ObjectScript Reference