The variables described in this section are PATROL for Microsoft Exchange Servers agent configuration variables that are set in the PATROL Agent. To view these variables, use the wpconfig utility or the PATROL Configuration Manager.
Warning
Changing any of these variables can prevent some functions from working properly and can affect your entire installation. Before you change a variable, make a record of the original setting.
The following tables list all of the agent configuration variables in PATROL for Microsoft Exchange Servers. They are separated according to variables that can be modified and variables that should not be modified.
The following table lists the agent configuration variables that you can easily modify in PATROL for Microsoft Exchange Servers.
Note
All configuration variables are located in the \MSEXCHSetup directory.
Modifiable configuration variables
Variable and description | Values | Default |
---|---|---|
annotation expert advice saved as an annotation to the parameter value |
| 1 |
cluster_port_range range of port numbers of a cluster; used by MSEXCHE2E.exe | N/A | 10 |
debug variables
|
| 0 |
displayAllErrorsSinceStart error messages posted to the MSEXCH_Server\ServerColl parameter |
| 0 |
E2EServerName Roundtrip originating server name (this server) | N/A | N/A |
E2EUsrDom Roundtrip account's domain name | N/A | N/A |
E2EUsrName Roundtrip account name | N/A | N/A |
E2EUsrPass Roundtrip account password (encrypted) | N/A | N/A |
enable_NT_event_monitoring flag to enable monitoring of Windows NT events |
| 1 |
enable_NT_process_ monitoring flag to enable monitoring of Windows NT processes |
| 1 |
ExchProductVersion Exchange version 2000, 2003, 2007, 2010, or 2013 |
| N/A |
IETEMaxAlarmAfter default maximum alarm value displayed in Internet E2E dialog box thumbwheel | N/A | 7200 |
IETEMaxAttaSize default maximum attachment size value displayed in Internet E2E dialog box thumbwheel | N/A | 20 |
IE2EMaxDbgLvl default maximum debug level displayed in Internet E2E dialog box thumbwheel | N/A | 1 |
IETEMaxSendInt default maximum interval value displayed in Internet E2E dialog box thumbwheel | N/A | 7200 |
IETEMaxWarnAfter default maximum warning value displayed in Internet E2E dialog box thumbwheel | N/A | 7200 |
IETEMinAlarmAfter default minimum alarm value displayed in Internet E2E dialog box thumbwheel | N/A | 1 |
IETEMinAttaSize default minimum attachment size value displayed in Internet E2E dialog box thumbwheel | N/A | 0 |
IETEMinSendInt default minimum interval value displayed in Internet E2E dialog box thumbwheel | N/A | 1 |
IETEMinWarnAfter default minimum warn value displayed in Internet E2E dialog box thumbwheel | N/A | 1 |
increasingTimeAlarm controls the alarm behavior of the MSEXCH_Queues\IncreasingTime parameter | N/A | 30 |
increasingTimeWarn controls the warn behavior of the MSEXCH_Queues\IncreasingTime parameter | N/A | 25 |
lastNMsgGlobalValue number of Roundtrip times used to calculate average | N/A | 10 |
maxAlarmAfter default maximum alarm value displayed in Server to Server E2E dialog box thumbwheel | N/A | 7200 |
maxAttaSize default maximum attachment size value displayed in Server to Server E2E dialog box thumbwheel | N/A | 20 |
maxCacheAge number of hours before flushing the userdata cache file in %PATROL_HOME%\msexch\userdata.dat | N/A | 24 |
maxCfgTopN default maximum value for number of messages used to calculate LastNMsgTime parameter in Roundtrip Configure dialog box slidebar | N/A | 50 |
maxConfigTop default maximum value for Top monitoring functionality | N/A | 50 |
maxETESendInt default maximum interval value displayed in Roundtrip dialog box slidebar | N/A | 7200 |
maxWarnAfter default maximum alarm value displayed in Roundtrip dialog box slidebar | N/A | 7200 |
minAlarmAfter default minimum alarm value displayed in Roundtrip dialog box slidebar | N/A | 1 |
minAttaSize default minimum attachment size value displayed in Roundtrip dialog box slidebar | N/A | 0 |
minCfgTopN default minimum value for number of messages used to calculate LastNMsgTime parameter in Roundtrip dialog box slidebar | N/A | 1 |
minConfigTop default minimum value for Top monitoring functionality | N/A | 0 |
minETESendInt default minimum interval value displayed in Roundtrip dialog box slidebar | N/A | 1 |
minWarnAfter default minimum warning value displayed in Roundtrip dialog box slidebar | N/A | 1 |
/MSEXCHSetup/OutlookPath disable auto outlook open, outlook.exe path include \OUTLOOK.EXE at the end of the path | -1 | N/A |
restartServiceConfig flag to enable or disable restarting non-Exchange services |
| 0 |
restartServiceList list of Exchange services to restart | N/A | N/A |
server.defaultAccount name of the account that will own all KM processes | N/A | N/A |
serverList dynamic list of servers that send mail to this server | N/A | N/A |
topPriv number of private folders (mailboxes) to include in the top list | N/A | 5 |
topPrivSort top private folders sort flag |
| .SORT_MSGSIZE |
topPub number of public folders to include in the top list | N/A | 5 |
topPubSort top public folders sort flag |
| .SORT_MSGSIZE |
topRecv number of receivers to include in the top list | N/A | 10 |
topRecvMin default timeslice to search for messages in message tracking log | N/A | 15 |
topRecvSort top receivers sort flag |
| .SORT_MSGSIZE |
topSend number of senders to include in the top list | N/A | 10 |
topSendMin default timeslice to search for messages in message tracking log | N/A | 15 |
topSendSort top senders sort flag |
| .SORT_MSGSIZE |
usesPatrolAccount flag that indicates whether the KM should use the PATROL Agent default account to own all spawned processes |
| 0 |
vdMailbox name of the mailbox used for virus detection | N/A | N/A |
workingSetSize_MTAQueueGrowth sliding window of MTA queue objects used to calculate queue growth | N/A | 5 |
workingSetSize_SMTP_X400QueueGrowth sliding window of SMTP or X-400 queue objects used to calculate queue growth | N/A | 5 |
The following table lists the agent configuration variables you should not modify. Doing so might render PATROL for Microsoft Exchange Servers inoperable.
Unmodifiable agent configuration variables
Variable | Values | Default |
---|---|---|
AD_Publish_Exclude_List not used | N/A |
|
ADSettingsLoc Active Directory location for KM settings | N/A | x |
applParent parent application for PATROL for Microsoft Exchange Servers | N/A | MSEXCH_Server |
ClientClass name of the client Roundtrip session application class | N/A | MSEXCH_Roundtrip_Client |
clientRoundtripList list of clients for Roundtrip monitoring | N/A | N/A |
clusterContainer name of the parent container for MSEXCH_Cluster application class | N/A | MSEXCH_Cluster_Container |
confPerfParent not used | N/A | N/A |
connPerfParent name of the parent container for all connector application classes | N/A | MSEXCH_Connector_Performance |
E2EChannel PSL channel name used for communication from the PATROL Agent to the PATROL for Microsoft Exchange Servers binaries | N/A | E2Echannel |
E2EClass name of the parent Roundtrip application class | N/A | MSEXCH_Roundtrip_Container |
E2ELock PSL lock name for reading from or writing to the PATROL for Microsoft Exchange Servers binaries | N/A | E2ELock |
E2EServerID dynamic ID that is incremented with each additional server added to serverRountripList | N/A | N/A |
enableLocalE2E for testing purposes only |
| 0 |
exchChan PSL channel used to communicate between the PATROL Agent and the PATROL for Microsoft Exchange Servers binaries | N/A | ExchangeKM |
inetE2E_use_MAPI_only type of Exchange server (MAPI or CDO) |
| 0 |
inetE2E_use_PEM_only type of mode of communication between the COM server and the PATROL Agent |
| 0 |
inetE2EChannel PSL channel name used for communication from the PATROL Agent to the PATROL for Microsoft Exchange Servers binaries for Internet Roundtrip | N/A | inetE2EChannel |
inetE2EClass name of the Internet Server Roundtrip session application class | N/A | MSEXCH_Roundtrip_InetServer |
inetE2EComObjRegistered flag used to determine whether COM objects have been registered |
| 0 |
inetE2EEvSinkRegistered flag used to determine whether Event Sinks have been registered |
| 0 |
inetE2ERoundtripList list of foreign servers for Roundtrip monitoring | N/A | N/A |
inetE2ESecurityInitialised flag indicating if security settings have been initialized on the Internet Roundtrip COM object |
| N/A |
isAccountConfigured flag indicating that the KM account has been configured |
| 0 |
lastMTAUp the time that the KM checked to see whether MSExchangeMTA service is running | N/A | N/A |
lastUpdateTime timestamp of the last time configuration variables were updated | N/A | N/A |
logWarnDone one-time warning flag regarding the use of circular logging |
| 0 |
oldExchKMVersion used to determine whether the KM has been upgraded to a newer version | N/A | N/A |
overRideMailbox legacy variable from a previous version | N/A | N/A |
perfParent name of the KM that is the parent of all performance monitoring KM applications | N/A | MSEXCH_Performance |
RecvrActionLock PSL lock name for reading from or writing to the PATROL for Microsoft Exchange Servers binaries | N/A | RecvrActionLock |
rpingchan not used | N/A | N/A |
RTDebug Roundtrip debug flag for internal use only |
| 0 |
RTDown Roundtrip process running flag |
| 0 |
rtripProcess name of the Roundtrip executable | N/A | MSEXCHRoundtrip.exe |
RunDeployer run Roundtrip in debug mode flag |
| 1 |
runFirstTime not used | N/A | N/A |
sentMailContainers name of the Sent Mail parent container application class | N/A | MSEXCH_Sent_Mail_Containers |
ServerClass name of the server Roundtrip session application class | N/A | MSEXCH_Roundtrip_Server |
serverRountripList list of servers for Roundtrip monitoring | N/A | N/A |
topFoldersContainer name of the top folders parent container application class | N/A | MSEXCH_Top_Folders_Container |
topMailboxesContainer name of the Top MailBoxes parent container application class | N/A | MSEXCH_Top_Mailboxes_Container |
topReceiversContainer name of the Top Mail Receivers parent container application class | N/A | MSEXCH_Top_Receivers_Container |
topSendersContainer name of the Top Mail Senders parent container application class | N/A | MSEXCH_Top_Senders_Container |
verifyConfigLog subdirectory and file name for the MSEXCH_Server\CheckConfiguration parameter log file | N/A | msexch\\log |
WatchedUserList list of mailbox users to monitor | N/A | N/A |
watchedUsersContainer name of the Watched Users parent container class | N/A | MSEXCH_Watched_Users_Container |
BMC recommends that you set agent configuration variables by using a console to configure PATROL for Microsoft Exchange Servers KM files. Use the PATROL Configuration Manager or the wpconfig utility only to view variable settings or deploy them to other computers.