Skip to main content

Processes (Jobs) (Tools/APIs)

Get information about and manipulate CPU processes (also known as jobs).

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.

Note:

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().

FeedbackOpens in a new tab