Filtering the Server Log by Category
When logging information to the server log, you can filter the information according to categories, which results in only a few categories of information to be logged and others to be disregarded. The available categories are:
|
Category |
Value |
SWSrvLogCategoryType |
|
All Categories |
0x7FFFFFFF |
swAllSrvLogCategories |
|
Main Server Thread |
0x00000001 |
swCatMainThd |
|
UDP Broadcast (UDP Thread) |
0x00000002 |
swCatUDPThd |
|
TCP Connection (TCP Thread) |
0x00000004 |
swCatTCPThd |
|
Auto Forward Thread |
0x00000008 |
swCatAutoFwdThd |
|
Auxiliary Thread |
0x00000010 |
swCatAuxThd |
|
Client I/O (Message Processing Threads) |
0x00000020 |
swCatMsgThd |
|
Logins/Logouts |
0x00000040 |
swCatLogin |
|
Password Changes |
0x00000080 |
swCatPassword |
|
User Operations (add, remove, change, list users) |
0x00000100 |
swCatUser |
|
Attribute Operations (add, remove, change, list attributes) |
0x00000200 |
swCatAttribute |
|
Role Operations (add, remove, list roles) |
0x00000400 |
swCatRole |
|
Group Operations (add/remove group, add/remove user from/to group) |
0x00000800 |
swCatGroup |
|
Procedure Operations (list/query) |
0x00001000 |
swCatProc |
|
Procedure Queries |
0x00002000 |
swCatProcQuery |
|
Procedure Definitions |
0x00004000 |
swCatProcDef |
|
Work Queue Operations (add, remove, list) |
0x00008000 |
swCatQueueAccess |
|
Work Item Lists (queue query, get queue item, destroy view) |
0x00010000 |
swCatQueueQuery |
|
Case Operations (close, purge) |
0x00020000 |
swCatCase |
|
Node Operations (list) |
0x00040000 |
swCatNode |
|
Event Operations (trigger) |
0x00080000 |
swCatEvent |
|
Work Item Operations (get, keep, release, forward) |
0x00100000 |
swCatWorkItem |
|
Work Item Forwarding (forward item, add/remove/list auto-forward list) |
0x00200000 |
swCatForwarding |
|
Server Instrumentation |
0x00400000 |
swCatInstrumentation |
|
Lists and Tables |
0x01000000 |
swCatSWListTable |
|
Log Operations (set level/categories) |
0x02000000 |
swCatLog |
|
SAL SDK Timing |
0x04000000 |
swCatSALTiming |
|
TIBCO iProcess Objects Director Operations |
0x08000000 |
swCatDirector |
The default Server Log category is all categories.
You can specify which categories of information to write to the server log using the following:
| • | Object Model - Only the on-disk log categories can be set via the object model. The following methods can be used to set log categories: |
| — | TIBCO iProcess Objects - SetLogCategories method |
| — | TIBCO iProcess Server Objects - SetSrvLogOptions method (using the aCategories parameter) |
These methods use the SWSrvLogCategoryType enumeration type to specify the categories to log. These enumerations are shown in the table above.
Besides using the enumerations, you can specify the categories using the hex values. This allows you to combine the values to specify any combination of categories you want.
| • | TIBCO iProcess Objects Server Configuration Utility: |
| — | For on-disk logging, check the appropriate category check boxes in the Categories included in log section on the Disk Log tab. |
| — | For in-memory logging, check the appropriate category check boxes in the Categories included in log section on the Memory Log tab. |
| • | TIBCO iProcess® Objects Server Configuration File: |
| — | For on-disk logging, locate the LOG_CATEGORIES entry in the swentobjsv.cfg file and set it to the appropriate hex value for the categories you want to log (see the table above for the hex values). You can combine the hex values to specify any combination of categories to log. For more information, see LOG_CATEGORIES. |
| — | For in-memory logging, locate the MEMLOG_CATEGORIES entry in the swentobjsv.cfg file and set it to the appropriate hex value for the categories you want to log (see the table above for the hex values). You can combine the hex values to specify any combination of categories to log. For more information, see MEMLOG_CATEGORIES. |