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:

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