8.3.4 Monitor Windows event (event monitor item)
- Organization of this subsection
(1) Overview of function
This item monitors Windows events.
(2) List of settings
|
Name |
Required |
Format |
Can specify inherited information? |
|---|---|---|---|
|
Monitor event |
Yes |
Combo box (Log on, Log off, Screen lock, or Screen lock release) |
No |
|
Windows User Name |
No |
String (0 to 276 bytes) You can use alphanumeric characters and the following symbols: _ - \ . |
No |
|
Timeout period(min.) |
No |
Numeric (0 to 1440) |
No |
(3) Settings
- Monitor event
-
Specify the types of Windows events to be monitored.
You can select from the following options: Log on, Log off, Screen lock, and Screen lock release.
- Windows User Name
-
Specify the Window user name to be monitored. If you do not specify this setting, all events are detected, regardless of who is triggering those events.
If a user belonging to a domain is to be monitored, specify NetBIOS-domain-name\user-name. If you omit the NetBIOS domain name, the item assumes that the local host name is set as the domain name.
If a Windows event is triggered by a user other than the specified user, monitoring continues without the event being detected.
The monitor does not distinguish between upper and lower case letters in the specified Windows user names.
- Timeout period(min.)
-
Specify the timeout period for the Windows event monitor. If omitted or set to 0, the Windows event monitor is not terminated.
When the timeout period is reached, the monitor ends abnormally (ENDE).
(4) Return values
|
Value |
Description |
|---|---|
|
-1 |
Forced termination. |
|
0 |
The event being monitored was detected, and the Windows event monitor ended, or the monitor timed out because timeout was reached. |
|
2 |
Insufficient resources or high processing load.
|
|
3 |
System call failed.
|
|
21 |
The event ended abnormally due to one of the following reasons:
|
|
22 |
An attempt to execute the Windows event monitor failed.
|
(5) Example 1
Continue monitoring until a user logs on to Windows.
|
Monitor event |
Log on |
|
Windows User Name |
-- |
- Legend:
-
-- : Not specified
(6) Example 2
Continue monitoring until the designated user (UserA) unlocks the Windows screen.
|
Monitor event |
Screen lock release |
|
Windows User Name |
UserA |
(7) Notes
You can only use this item while the COM+ Event System service, the COM+ System Application service, and System Event Notification Service service are up and running. For details, see 2.3.5 Using the Windows event monitor function.
Note that, if you stop the above services while this item is being executed, events can no longer be detected, although event monitoring continues. In this state, events cannot be detected even when the services are restarted. You have to re-execute the item.