Caché ObjectScript Reference - InterSystems Documentation

Legacy Commands and FunctionsDescriptionThis page describes the legacy function $ZUTIL(67,5), which has been superseded by theSYS.Process class methods. (Refer to the Caché Class Reference for further details.)$ZUTIL(67,5) is described here for compatibility with legacy applications.$ZUTIL(67,5,pid) returns a string containing the routine name of the specified process. Themaximum string length is 32 characters, for either 8-bit characters or Unicode characters. Ifthere is no routine name for the process, $ZUTIL(67,5) returns a null string.The routine names of all currently running processes are listed in the Processes option of theSystem Management Portal. The routine name of the current process is stored in the $ZNAMEspecial variable.To determine which client application is running, call $ZUTIL(67,13) to return the name ofthe executable file.Both $ZUTIL(67,5) and the $ZNAME special variable return a null string for a Caché Terminalprocess. On the Processes option of the System Management Portal a Caché Terminalprocess is listed with the routine name shell.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,5) returns a valueof zero.SYS.Process MethodsYou can get the same process information using methods of the SYS.Process class, as shownin the following example:ZNSPACE "%SYS"WRITE ##CLASS(SYS.Process).%OpenId($JOB).RoutineGet()See Also• $JOB special variable• $ZNAME special variable772 Caché ObjectScript Reference