Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# Monitoring the WIS Processes

You can use the `SWDIR``\util`\`plist -w` command to monitor the operation of the `WIS` processes. TIBCO recommends you do this regularly, particularly in the following circumstances:

| • | On the initial configuration of your system. The default values can be used but when cases, users, or groups are added, you will need to monitor and perhaps configure the system.

| • | After several new queues have been added.

| • | After a significant increase in the number of cases in the system. If there are only a small number of queues, for example, less than 10, monitor the system after you add more users or group queues so you can monitor the load balancing of the `WIS` processes.

The format of the `SWDIR``\util`\`plist -w` command is:

    plist -w[V][v] [WIS]

where:

| • | `V` can be used to display additional information (the `LastCacheTime` and `CDQPVer` columns)

| • | `v` can be used to display additional information (the `Version`, `NewVers`, `DelVers`, `ExpVers`, `UrgVers`, and `QParamV` columns)

| • | `WIS` is the number of a specific `WIS` process and can be used to display details only for that `WIS` process. If this parameter is omitted, the command displays details for all the `WIS` processes.

Use the `plist -w` command to view detailed information about the `WIS` processes such as the number of items in the queue, whether the queue is disabled, and the number of new items in each `WIS` process.

Use the `plist -wVv` command to view all the additional information that is returned by the `plist -wV` and the `plist -wv` commands.

For example (using `plist -wV`):

WIS | QueueName | Flags | #Items | #Newp | #Dead | #Urgent | LastCacheTime(ms) | CDQPVer
1 | sblanch | -----NM | 3000 | 3000 | 0 | 0 | 766 | -1
1 | steveb | ------- | 0 | 0 | 0 | 0 | 11 | -1
1 | swadmin | -----NM | 2 | 2 | 0 | 0 | 29 | -1
1 | swgrp0000 | --G---- | 0 | 0 | 0 | 0 | 12 | -1
1 | swgrp0001 | --G---- | 0 | 0 | 0 | 0 | 11 | -1
1 | swgrp0002 | --G---- | 0 | 0 | 0 | 0 | 11 | -1
1 | swgrp0003 | --G---- | 0 | 0 | 0 | 0 | -1 | -1

The `plist -w[V][v] [WIS]` command displays the following information:

Information Returned by the plist -w[V][v] [WIS] Command

Column | Description
WIS | The number of this `WIS` process instance.
QueueName | The name of the work queue allocated to this WIS instance.
Flags | Any combination of the following, in order. A "-" in place of the indicated letter means that the corresponding flag is not set:
| • | `D` = The queue is disabled (this would normally be when the system has just been started and the queues have not yet been allocated to a WIS.
| • | `U` = There are urgent items in this queue.
| • | `G` = This is a group queue.
| • | `T` = This is a test queue.
| • | `D` = There are items in this queue with deadlines set.
| • | `N` = There is new mail in this queue.
| • | `M` = There is mail in this queue (i.e. it is not empty).
#Items | The total number of work items in this work queue.
#NewP | The total number of new (unread) work items in this work queue.
#Dead | The total number of work items in this work queue that have deadlines.
#Urgent | The total number of urgent work items in this work queue.
LastCacheTime | Displayed if the `-V` option is used. The number of milliseconds that the `WIS` process took to cache this work queue. Note that:
| • | The time shown is the time taken when the queue was last cached (which could be either when the `WIS` process was started or when the queue was first accessed). The number of items in the queue at that time may have been different from the number of items currently in the queue as shown in the `#Items` column.
| • | A value of `-1` indicates that the queue has not been cached yet.
CDQPVer | Displayed if the `-V` option is used. The current CDQP definition version for this work queue. (This should match the version number of the `cdqp` row in the `version` database table.)
#New | Displayed if the `-v` option is used. The total number of new (unread) work items in the work queue.
Version | Displayed if the `-v` option is used. The total number of work items in the work queue that are processed from the time when the queue was last cached.
NewVers | Displayed if the `-v` option is used. The total number of new (unread) work items in the work queue from the time when the queue was last cached.
DelVers | Displayed if the `-v` option is used. The total number of work items in the work queue that are deleted from the time when the queue was last cached.
ExpVers | Displayed if the `-v` option is used. The total number of work items in the work queue that are expired from the time when the queue was last cached.
UrgVers | Displayed if the `-v` option is used. The total number of urgent work items in the work queue from the time when the queue was last cached.
QParamV | Displayed if the `-v` option is used. The current QParam definition version for the work queue.
| Displayed only if the -v option is used.
NewVers | Displayed only if the -v option is used.
DelVers | Displayed only if the -v option is used.
ExpVers | Displayed only if the -v option is used.
UrgVers | Displayed only if the -v option is used.
QParamV | Displayed only if the -v option is used.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.