Caché ObjectScript Reference - InterSystems Documentation

Legacy Commands and Functions$ZUTIL(67,1) (legacy function)Returns the activity state of a specified process, and resets.$ZUTIL(67,1,pid)$ZU(67,1,pid)ParameterspidThe process ID number.DescriptionThis page describes the legacy function $ZUTIL(67,1), which has been superseded by theSYS.Process class methods. (Refer to the Caché Class Reference for further details.)$ZUTIL(67,1) is described here for compatibility with legacy applications.$ZUTIL(67,1,pid) returns 2 if the process is active, 1 if the process is dead but the pid is stillin the pidtable, 0 if thepid is not in the pidtable. If 1 is returned, $ZUTIL(67,1,pid) removesthe pid from the pidtable.The $ZUTIL(67,0,pid) function is identical, except when a value of 1 is returned:$ZUTIL(67,0,pid) leaves a dead process in the pidtable; $ZUTIL(67,1,pid) removes a deadprocess from the pidtable.ParameterspidA process ID number. The process ID of the current process is returned by the $JOB specialvariable. The System Management Portal provides a Processes option, which list the pids ofall running processes. If you specify a non-existent process, $ZUTIL(67,1) returns a valueof zero.ExampleThe following example tests the current process. It should (of course) return 2 (process isactive):WRITE $ZUTIL(67,1,$JOB)See Also• $ZUTIL(67,0) Return the Activity State of a Specified Process legacy function768 Caché ObjectScript Reference