FrymasterVB/DWPRMON.CLS.md

DWPRMON.CLS - Process Monitor Class Documentation

Overview

DWPRMON.CLS provides process monitoring capabilities for DataWindow applications. It allows tracking and managing DataWindow processes during runtime.

Class Properties

• ProcessID - Current process identifier
• ProcessName - Name of the monitored process
• StartTime - Process start timestamp
• Status - Current process status (Active/Inactive)
• MemoryUsage - Current memory consumption
• CPUUsage - CPU utilization percentage

Methods

Constructor

Constructor( as_processname )

Initializes a new process monitor instance

• Parameters:
  • as_processname: String - Name of process to monitor

StartMonitoring()

StartMonitoring()

Begins monitoring the specified process

• Returns: Boolean - True if monitoring started successfully

StopMonitoring()

StopMonitoring()

Stops monitoring the current process

• Returns: Boolean - True if monitoring stopped successfully

GetProcessMetrics()

GetProcessMetrics()

Retrieves current process performance metrics

• Returns: Structure containing:
  • CPU usage
  • Memory usage
  • Thread count
  • Handle count

IsProcessActive()

IsProcessActive()

Checks if monitored process is still running

• Returns: Boolean - True if process is active

Events

• ProcessStarted - Fired when monitoring begins
• ProcessStopped - Fired when monitoring ends
• MetricsUpdated - Fired when new metrics are collected
• ThresholdExceeded - Fired when resource usage exceeds defined limits

Usage Example

// Create monitor instance DWPRMON lw_monitor lw_monitor = CREATE DWPRMON("myprocess")

// Start monitoring lw_monitor.StartMonitoring()

// Check process status IF lw_monitor.IsProcessActive() THEN // Process metrics lst_metrics = lw_monitor.GetProcessMetrics() END IF

// Stop monitoring lw_monitor.StopMonitoring()

Notes

• Requires appropriate system permissions to monitor processes
• Recommended to properly dispose monitor instances when no longer needed
• Can be used to monitor multiple processes simultaneously using separate instances