Caché ObjectScript Reference - InterSystems Documentation

System and Other FunctionsReturn Values$ZUTIL(4) returns the following values:Value10-1-2-3-4MeaningSuccess. $ZUTIL(4) successfully caused the process to exit.Failure. The process is a system daemon process, such as Write Daemon.Neither $ZUTIL(4) nor the RESJOB utility (which uses it) can terminate asystem daemon, unless you specify $ZUTIL(4,pid,-65).Failure. The process is non-responsive.Failure. The process is inactive, a ghost or "dead" process.Failure. The process is not a Caché process. It is not on the Caché job table.Failure. The process has an open transaction that is currently in a halt orrollback state and cannot be terminated unless you specify $ZUTIL(4,pid,-65).ExamplesThe following example causes process number 1584 to exit:SET procid=1584SET x=$ZUTIL(4,procid)IF x=1 { WRITE "Success: ",procid," terminated" }ELSEIF x=0 {WRITE "Failure: ",procid," is a daemon",!WRITE "Use the $ZUTIL(4,pid,-65) syntax" }ELSEIF x=-3 { WRITE "Process ",procid," not recognized" }ELSEIF x=-4 { WRITE "Process ",procid," in halt or rollback" }ELSE { WRITE "Failure: $ZUTIL(4) returned ",x," for ",procid }NotesTo determine the process IDs of all currently running processes, go to the System ManagementPortal, and select the Processes option.OpenVMS: $ZUTIL(4,pid) is the internal function called by the RESJOB utility.See Also• HALT command• JOB command566 Caché ObjectScript Reference