Process running table

The process running table (psRunningTable) lists all the processes running on a host. Each row in the table represents one process. You cannot configure table rows themselves because they contain information about the processes running; however, you can control the process by setting its psRunningState row object.

Table 1 lists the objects in psRunningTable.

Table 1. Process running table (psRunningTable)
Row object	Description
`CommandLine`	The exact command including parameters used to start this process.
`ContextSwitches`	The total number of context switches this process has undergone.
`CWD`	The full path of the process's current working directory, if known. This value is useful in diagnosing problems with removing directories that are busy.
`Device`	The name of the user interface device associated with this process.
`FilePath`	The full path of the program file associated with this process.
`Handles`	The total number of operating system handles, or file descriptors on UNIX systems, that this process currently has open.
`HardPageFaults`	The total number of hard page faults that this process has generated since starting. Hard page faults are those that require I/O (virtual memory access) to complete.
`KernelTime`	The total amount of CPU time consumed in kernel calls for this process. On multi-CPU machines this value can represent an amount of time greater than the amount of time over which the process has been running.
`Name`	The short process name, which is typically the executable file's name without a path or arguments.
`PageFaults`	The total number of page faults, both hard/major and soft/minor, that this process has generated since starting.
`PercentCPU`	An approximation of the percentage of CPU time currently consumed by this process. This value is calculated by dividing this process's kernel and user time by the total time available to all CPUs. A value of `100` indicates that this process is occupying all CPUs on the entire machine.
`PercentRSS`	The percentage of physical memory occupied by the process's resident set of pages. The value of this object is highly volatile and is in no way an indicator of memory requirements. The value can easily vary from 0 to 100 without the process allocating or freeing any memory. The `psRunningPercentSize` provides a more stable indication of memory use.
`PercentSize`	The relative percentage of physical memory, not all of which is necessarily resident, allocated to a process. Values greater than 100 are possible and such values indicate that a process is using more physical RAM than is available.
`PGID`	The process group ID of this process, which is the PID of the process that started the logical group of processes to which this process belongs. belongs. On Windows, this value is the WindowsTerminal Services session ID if the process has one otherwise it value will be zero. On other platforms that do not support process groups, this value is simply the PID of the process.
`PID`	The unique process identifier (PID) of this process.
`PPID`	The PID of the process's parent.
`Priority`	The UNIX-style static priority value of the process. On non-UNIX systems, this value is a modified base priority value that follows the nice-value convention: The value is between `-20` and `20` Lower values represent higher priorities Negative values are reserved for the system and administrator
`RSS`	The amount of memory (in KB) resident in physical or main memory that is allocated to this process.
`Size`	The total amount of memory (in KB) allocated to this process.
`StartTime`	The time and date when this process started.
`State`	The current state of this process: `kill(0)` - This is not a real state, but setting the object to this value kills the process. First a polite kill is attempted (for example, using SIGTERM on UNIX systems). If the process does not die within 20 seconds, the subagent issues a forceful kill (for example, using SIGKILL on UNIX systems). `starting(1)` - The process is being created or initialized and is not yet a candidate for any of the other states. `suspended(2)` - The process has been temporarily prevented from executing. Setting the object to this value suspends a process. `sleeping(3)` - The process is idle, awaiting an event. `running(4)` - The process is in the run queue or currently running. Setting the object to this value if the process's current state is `suspended(4)` causes it to resume execution. `zombie(5)` - The process has exited, but has not yet been freed. Only the values `kill(0)`, `suspended(2)` and `running(4)` may be written to this object.
`Threads`	The total number of threads that this process currently has.
`UserName`	The name of the user who owns this process.
`UserTime`	The total amount of CPU time consumed in user code (non-kernel code) for this process. On multi-CPU machines this value can represent an amount of time greater than the amount of time over which the process has been running.
`ZoneName`	(Solaris 10 or later) Displays the Name of the zone in which the processes are running. (Read-only)