Caché ObjectScript Reference - InterSystems Documentation

$ZUTIL(67,4) (legacy function)• $JOB special variable$ZUTIL(67,4) (legacy function)Returns the process state.$ZUTIL(67,4,pid)$ZU(67,4,pid)ParameterspidThe process ID number.DescriptionThis page describes the legacy function $ZUTIL(67,4), which has been superseded by theSYS.Process class methods. (Refer to the Caché Class Reference for further details.)$ZUTIL(67,4) is described here for compatibility with legacy applications.$ZUTIL(67,4,pid) returns process state information in the form x^y^z, three numeric codesseparated by caret symbols. x = pstate, an integer indicating which part of the code is executing.y = pstatebits, a bitmap which provide additional process state information. z = gstatebits, abitmap which provide information on global requests and other shared resources requestedby the process. One use of the gstatebits bitmap is to give state information on cluster locking.Process state information can also be obtained from the Processes option of the SystemManagement Portal, which lists the State for all currently running processes. The pstate,pstatebits, and gstatebits information can be obtained from the command line by running theCSTAT utility with the appropriate operand. For example, to obtain gstatebits informationcall CSTAT -p64.pstate can return the following values:pstate12345AbbreviationLOCKOPENCLOSUSEREADDefinitionThis job is in the lock code.This job is opening a device.This job is closing a device.This job is in the USE command.This job is reading from a device.Caché ObjectScript Reference 769