Processes (Jobs) (Tools/APIs)
Background Information
A CPU process is an instance of an InterSystems IRIS® data platform virtual machine running on an InterSystems IRIS server. Every active process has a unique job number. You typically use the Management Portal to view the process list and, if necessary, suspend, resume, or terminate them; see Controlling InterSystems IRIS Processes.
Within productions, a CPU process is called a job, to avoid confusion with the term business processes, which are frequently referred to simply as processes.
Available Tools
This structured system variable returns information about processes.
Availability: All namespaces.
Allows manipulation and display of the current process. This class provides class methods like the following:
-
BatchFlag()
-
CallingRoutine()
-
ExceptionLog()
-
GetCPUTime()
-
NodeNameInPid()
-
PrivateGlobalLocation()
-
TruncateOverflow()
-
And others
Some of the class methods have restrictions on where they may be called.
Availability: All namespaces.
Provides the following class methods:
-
ProcessID()
-
MaxLocalLength()
Availability: All namespaces.
Provides the following class methods:
-
JobPrio()
-
GetPrio()
-
SetPrio()
Availability: All namespaces.
Enables you to display and manipulate InterSystems IRIS processes. This class provides properties that you can set to modify a process, as well as read-only properties that provide information about its current state. Properties of this class include:
-
ClientExecutableName
-
CurrentDevice
-
JobType
-
LastGlobalReference
-
Priority
-
Routine
-
UserName
-
And others
It also provides the following class methods:
-
GetCPUTime()
-
KillAllPrivateGlobals()
-
NextProcess()
-
And others
It also provides queries, which include:
-
AllFields()
-
CONTROLPANEL()
-
JOBEXAM()
-
And others
Availability: All namespaces.
Provides instance methods which operate on a process instance as well as class methods for use by managers. This class provides the following methods:
-
ProcessTableSize()
-
ReleaseAllLocks()
-
Resume()
-
Suspend()
-
Terminate()
This class extends %SYS.ProcessQueryOpens in a new tab and thus also includes the properties, methods, and queries of that class.
Availability: %SYS namespace.
Note
The special variable $SYSTEM is bound to the %SYSTEM package. This means that instead of ##class(%SYSTEM.class).method(), you can use $SYSTEM.class.method().