Agent and Extension Preferences


Agent Preferences

The following table lists the agent preferences:

Preference

Description

ConnectionInitiation

Secure tunnel initiation mode. Specify 0=OFF, 1=Agent initiates, 2=Services initiate.

Description

This value will be displayed on the network host view and is usable in Policy expressions. Default is an empty string, which is supported at agent version 8.0.00.000 and above.

AvoidDNSLookups

Determines whether QPEA does optional DNS lookups.  Specify ON or OFF.  Default is OFF. Supported at agent version 8.0.00.000 and above.

ProtectEaaXmlFile

Determines whether qpea should override the default user permissions on the eaa.xml file. The default is Enabled. Supported at agent version 9.0.00.000 and above.

RTServer_Connect_Frequency

How many seconds to wait to connect to the Topic Service, once QPEA realizes that it is not connected.  Specify between 5 and 180 seconds.  Default is 60 seconds.

RTServer_Ping_Frequency

How often to send ping from QPEA to the Topic Service.  Specify 10-18000 seconds.  Default is 20 seconds.

Max_Checkpoint_MB

Maximum size for the agent checkpoint file.  Specify 1MB or larger.  Default if not specified is 0.

Apply_Suppression_To_WebSphereMQMonitor

If Suppress_Duplicate_Updates is enabled, it determines if duplicate update filtering should be applied to QPMON.
Default value is 0 (disabled). Modify value to 1 to enable the agent preference.

Suppress_Duplicate_Updates

Determines whether QPEA should examine updates to eliminate any duplicate values.  Specify 0(Disabled) or 1(Enabled).  Default is 0(Disabled).

Adjust_Timestamp_Attributes_By_Skew

Adjusts timestamps by skew between Topic Service and agent. Specify ON or OFF.  Default is ON.

ProcessStatInterval

How often (in seconds) to display process statistics in log. Specify 60-86400 seconds. Default is 300 seconds. Process Stats enabled with procstat=100 log category or logLevel=6.  Supported at agent version 9.0.00.000 and above.

LeafNodeStatInterval

How often (in seconds) to display leaf node statistics in log. Specify 60-86400 seconds. Default is 300 seconds. Leaf Node Stats enabled with rtsp_stat=50 log category or logLevel=6. Supported at agent version 9.0.00.000 and above.

NetworkFailureRetryCount

The number of times the agent will attempt to resolve the local hostname at startup before failing. The default is zero. -1 to retry forever. Supported at agent version 8.1.00.000 and above.

Local_HostName

The string that will be put into the navigation tree in the Monitor Console, all objects will show up under this node.  Specify any valid IPv4 Address or hostname. Default is blank string.

RTServer_Hostname

Hostname or IP address to use to connect to the Topic Service.  Default is an empty string.

EAA_Version

Agent interface version (read only).

SocketTimeout

The maximum time allowed for a socket to wait for data after the initial receive. Use 0 for the default. -1 for infinite. Recommend 60 or larger. Supported at agent version 8.1.00.000 and above.

LastSuccessfulConnectionName

Secure tunnel connection name (read only). Supported at agent version 8.0.00.000 and above.

Dom_Dump_Frequency

The minimum time QPEA will allow between logging the dom tree (if such logging is enabled via QPLog.ini settings).  Specify greater than or equal to 60 seconds.  Default is 1800 seconds (30 min).

IOBAlternateStorageMode

Valid on z/OS only, where it causes the memory associated with large IO buffers to be stored in hyperspace.  Specify True or False. Default is False.

RTServer_Port

Port to use to connect to the Topic Service. Default is 15001.

NetworkFailureRetrySeconds

The time between attempts to resolve the local hostname. The default is 30. Supported at agent version 8.1.00.000 and above.

Extension Preferences

The following table lists the extension preferences:

Extension Name

Preference

Description

WebSphere MQ Monitor

MQLibrary

MQ API library to load, *CLIENT* for client bindings, *SERVER* for server bindings (default), Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ResetTotalsTime

Clock time when to reset calculated totals. Specify HH:MM where HH=0-24, MM=0-59, or disabled. Default is 00:00.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

Prefix

Queue Manager cpf - WebSphere MQ subsystem name. Only QMGR of specified prefix will be discovered. z/OS only. Used in conjunction with psid preference. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

DiscoverRemoteQueues

Disable/Enable discovery of MQ Remote queues. Specify OFF|ON.  Default is OFF. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

OCSPResponderURL

OCSP Responder URL. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ExcludePermanentDynamicQueues

Controls whether permanent dynamic queues will be discovered. Specify OFF|ON. Default is OFF. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

MQChannelEventQueue

Specifies an alternate event queue for channel MQ events. Specify queue name to use. Default is SYSTEM.ADMIN.CHANNEL.EVENT. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ExcludeAPISubscriptions

Controls whether subscriptions with a sub type of API will be discovered. Specify OFF|ON. Default is ON. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ChannelEventMsgId_

Channel event msg id for queue manager.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

AgentReconnectInterval

Time to wait in seconds between attempts to (re)connect to QPEA. Default is 15 seconds. Note that this currently only works if specified at the default level, which means there can only be one setting for an instance of QPMON. Supported at agent version 8.0.00.000 and above.

WebSphere MQ Monitor

SecurityExitName

Security Exit Name. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ConsoleInterface

Disable/Enable console interface. Specify Enabled|True|Disabled|False. Default is False.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

DiscoverAliasQueues

Disable/Enable discovery of MQ Alias queues. Specify OFF|ON.  Default is OFF. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

MaintainValuesOverRestart

Determines whether to keep values over restart of queue manager. Specify ON|OFF. Default is ON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

LocalQMgrDiscoveryInterval

The number of seconds between attempts to discover local queue managers. It has no effect unless DiscoverQueueManagers is enabled. Specify value range 60-86400 seconds. Default is 300 seconds. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

RemoteMonitor

Disable/Enable remote monitor. Specify True|False. Default is False.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

QmgrAuthType

Determines authentication mode for qmgr connection. Specify none|userpw. Default is none. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

SvrconnChannelStatusInstanceMonitoring

Sets the svrconn channel status instance monitoring mode. Specify Default|reduced_attributes|minimum_attributes|ON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-ConnectionName

MQ connection specification, e.g. 127.0.0.1(1414).

WebSphere MQ Monitor

MQLoggerEventQueue

Specifies an alternate event queue for logger MQ events. Specify queue name to use. Default is SYSTEM.ADMIN.LOGGER.EVENT. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

PCFQueue

The remote queue name on the local queue manager that will get to the target queue manager's command server when using proxy based remote monitoring mode.  Specify remote queue name.  Default is not set.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-KeyRepository

Key Repository

WebSphere MQ Monitor

CCDTURL

Client Channel Definition Table URL. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-ChannelName

Target SVRCONN Channel Name

WebSphere MQ Monitor

LEParm

LEParm name.

WebSphere MQ Monitor

DefaultMQInstallationPath

Default path to MQSeries installation. Specify valid path to WebSphere MQSeries installation.  Not set by default.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

Remote Monitor-queue manager-PCFQueue

PCF queue for remote queue manager, use --set-dynamic

WebSphere MQ Monitor

UseQMgrsFromPrefs

Determines whether only QMGRs specified by psid and prefix are to be discovered. z/OS only. Specify True/False. Default is False. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-RemoteQueueManagerName

Remote Queue Manager Name

WebSphere MQ Monitor

DiscoverObjects

Disable/Enable object discovery. Specify OFF|ON.  Default is OFF for z/OS, ON for all other platforms. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ReadSystemTopics

Reads monitoring data from queue manager system topics. Specify ON|OFF. Default is ON. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ChannelName

Target SVRCONN Channel Name. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

QueueBatchModeMonitoring

Determines queue batch monitoring mode. Specify ON|OFF. Default is ON. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

MQConfigEventQueue

Specifies an alternate event queue for configuration MQ events. Specify queue name to use. Default is SYSTEM.ADMIN.CONFIG.EVENT. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

RemoteQueueManagerName

Remote Queue Manager Name. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ChannelEventMode

The channel event mode. The mode for reading messages from the channel event queue. Specify Browse|Read. Default is Read.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

SampleInterval

Time to wait in seconds from end of a monitoring cycle until starting the next one. Specify value range 10-3600 seconds.  Default is 60 seconds.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

MQTTMonitoring

Disable/Enable MQTT queries against Queue Manager. Specify OFF|ON. Default is ON. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

CipherSpecName

Cipher Spec Name. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

qmgr_statistics_interval

The interval between each set of logged statistics. Specify value range 60-86400 seconds. Default is 3600 seconds. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-MQLibrary

MQ API library to load, *CLIENT* for client bindings, *SERVER* for server bindings (default)

WebSphere MQ Monitor

SMFMonitoring

Disable/Enable SMF monitoring Z/OS only. Specify Enabled|True|Disabled|False. Default is True.  Note that this currently only works if specified at the default level, which means there can only be one setting for an instance of QPMON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

MQStatQueue

Specifies an alternate statistics queue name for MQ statistic messages. Specify queue name to use. Default is SYSTEM.ADMIN.STATISTICS.QUEUE. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ProcessLoggerMQEvents

Determines if mq events on the logger event queue will be processed. Specify True/False. Default is False. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ServicePort

Extension's Port. Specify value range 1-65535. Default is 6001. Note that this currently only works if specified at the default level, which means there can only be one setting for an instance of QPMON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-MaintainValuesOverRestart

OFF|ON, keep values over restart of queue manager, use --set-dynamic

WebSphere MQ Monitor

queue manager-ChannelEventQueue

Channel event queue for queue manager, use --set-dynamic

WebSphere MQ Monitor

LocalQM

Local queue manager name when using proxy based remote monitoring mode. Specify local queue manager name.  Default is not set.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

KeyRepository

Key Repository. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ChannelStatusInstanceMonitoring

Disable/Enable channel status instance monitoring. Specify OFF|ON.  Default is ON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-ChannelEventMsgId_

Channel event msg id for queue manager, use --set-dynamic

WebSphere MQ Monitor

ExcludeTemporaryDynamicQueues

Controls whether temporary dynamic queues will be discovered. Specify OFF|ON. Default is ON. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

UseReadAheadOnReplyQueue

Disable/Enable read ahead mode for the command server reply queue. Specify OFF|ON. Default is ON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

MQQMgrEventQueue

Specifies an alternate event queue for qmgr MQ events. Specify queue name to use. Default is SYSTEM.ADMIN.QMGR.EVENT. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-OCSPResponderURL

OCSP Responder URL

WebSphere MQ Monitor

ConnectionName

MQ connection specification, e.g. 127.0.0.1(1414). Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ChannelBatchModeMonitoring

Disable/Enable batch PCF mode for channel monitoring.  Specify OFF|ON.  Default is ON. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

DiscoverProductQueues

Disable/Enable discovery of the product's reply queues. Specify OFF|ON.  Default is OFF. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

QmgrAuthUserName

Specifies user name for qmgr connection. Used when QmgrAuthType is userpw. Default is ''. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

MQAcctQueue

Specifies an alternate accounting queue name for MQ accounting messages. Specify queue name to use. Default is SYSTEM.ADMIN.ACCOUNTING.QUEUE. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

DiscoverQueueManagers

Disable/Enable queue manager discovery. Specify OFF|ON.  Default is OFF for z/OS, on for all other platforms., Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ProcessMQStatMessages

Determines if MQ statistic messages on the statistics queue will be processed. Specify True/False. Default is False. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

IOBAlternateStorageMode

Disable/Enable IOB alternate storage mode, affects Z/OS only. Specify Enabled|True|Disabled|False. Default is false.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

Remote Monitor-queue manager-LocalQM

Local queue manager for remote queue manager, use --set-dynamic

WebSphere MQ Monitor

ListenerAndServiceMonitoring

Disable/Enable listener and service. monitoring. Specify OFF|ON. Default is ON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

QueueStatusMonitoring

Disable/Enable queue status monitoring. Specify OFF|status_only|handles_only|ON. Default is ON.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ChannelEventQueue

The channel event queue name. Specify channel Event Queue Name.  No default values.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ProcessMQAcctMessages

Determines if MQ accounting messages on the accounting queue will be processed. Specify True/False. Default is False. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ProcessChannelMQEvents

Determines if mq events on the channel event queue will be processed. Specify True/False. Default is False. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-SecurityUserData

Security User Data

WebSphere MQ Monitor

QSGMonitoringMode

Determines QSG monitoring mode. z/OS only.  Specify QSGDISP_DYNAMIC | QSGDISP_Always_PRIVATE | QSGDISP_Always_SHARED | QSGDISP_Dont_Specify.  Default not set.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

SecurityUserData

Security User Data. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

DiscoverModelQueues

Disable/Enable discovery of MQ Model queues. Specify OFF|ON.  Default is OFF. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

Psid

Queue Manager Dataset name pointed to by DD name CSQINP1. Only QMGR of specified psid will be discovered. z/OS only. Used in conjunction with prefix preference. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

ProcessQMgrMQEvents

Determines if mq events on the qmgr event queue will be processed. Specify true/false. Default is false. Supported at agent version 8.0.00.000 and above.

WebSphere MQ Monitor

QmgrAuthPassword

Specifies password for qmgr connection. Used when QmgrAuthType is userpw. Default is ''. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

DefaultModelQueue

Model queue name for temporary reply queue. Specify model queue name for temporary reply queue. Default is SYSTEM.COMMAND.REPLY.MODEL on z/OS, SYSTEM.MQSC.REPLY.QUEUE elsewhere.

WebSphere MQ Monitor

ProcessConfigMQEvents

Determines if mq events on the config event queue will be processed. Specify True/False. Default is False. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

queue manager-SecurityExitName

Security Exit Name

WebSphere MQ Monitor

queue manager-CipherSpecName

Cipher Spec Name

WebSphere MQ Monitor

qmgr_get_wait_time

The maximum time to wait for response for PCF query. Specify value range 10-360 seconds. Default is 0 seconds, wait is based on sample interval. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

TopicBatchModeMonitoring

Disable/Enable topic batch mode monitoring. Specify ON|OFF. Default is ON. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

EaapiPollInterval

Controls how often QPMON checks for EAAPI events such as monitoring selection or preference changes. Specify value range 10-120 seconds. Default is 15 seconds. Supported at agent version 8.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere MQ Monitor

qmgr_pcf_response_pad_size

Byte count to be added to returned size from MQGET for PCF response messages, workaround for 2190 error, IBM PMR 32258,756,000. Specify value range 0-10240 bytes. Default is 2048 bytes. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

WebSphere Liberty Monitor

URL

URL for HTTPS endpoint enabled for JMX monitoring. 
Required.

WebSphere Liberty Monitor

JMXUser

User ID used for JMX monitoring.
Required unless certificate authentication is being used.

WebSphere Liberty Monitor

JMXPassoword

Password used for JMX monitoring. May be obfuscated or plaintext.
Required unless certificate authentication is being

WebSphere Liberty Monitor

JMXRole

Requires administrator to monitor Messaging Engine state. Default is reader

WebSphere Liberty Monitor

DisableURLHostnameVerification

(Optional) The default value is false.

Disables hostname verification for HTTPS URLs. Optional.

WebSphere Liberty Monitor

UseCertificateAuthentication

(Optional) The default value is false.

Enables client certification-based authentication.
If the value is set to true, JMXUser and JMXPassword are not required or used.
Defaults to false.

WebSphere Liberty Monitor

MaxServerWaitTime

(Optional) The default value is 30000.

Milliseconds to wait for server timeouts.

WebSphere Liberty Monitor

ReadTimeout

(Optional) The default value is 60000.

Milliseconds to wait for server read timeouts.

WebSphere Liberty Monitor

ServerStatusPollingInterval

(Optional) The default is 4000.

Milliseconds between polls for server status.

WebSphere Liberty Monitor

WLMEndPoints

(Optional) Comma separated list of workload management endpoints to monitor.
Endpoint format is hostname:portnumber.

WebSphere Liberty Monitor

TLSProtocol

(Optional) The default value is TLSv1.3.

TLS protocol version for HTTPS connections to the Liberty servers.

WebSphere Liberty Monitor

TrustStore

Filename of Java trust store used to verify HTTPS certificates.
Required for HTTPS monitoring.

WebSphere Liberty Monitor

TrustStorePassword

Password of Java trust store used to verify HTTPS certificates.
Required for HTTPS monitoring.
This can be obfuscated or used as plain text.

WebSphere Liberty Monitor

TrustStoreType

(Optional) The default is managed by the JRE used for monitoring.

Type of trust store used to verify HTTPS certificates.

WebSphere Liberty Monitor

KeyStore

Filename of Java key store used for client certificate authentication.

WebSphere Liberty Monitor

KeyStorePassword

Password of Java key store used for client certificate authentication.

WebSphere Liberty Monitor

KeyStoreType

(Optional) The default value is managed by the JRE used for monitoring.

Type of keystore used for client certificate authentication.

com.bmc.mmpa.wmb.monitor

CMPAPIUseSSL

Use SSL for CMP API remote monitoring (requires a username and password). Default is True if using a username and password. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

com.bmc.mmpa.wmb.monitor

PolicyTypeMonitoringFilter

Filter for ACE policy type monitoring. MONITOR_ALL, MONITOR_NONE, or a comma-separated list of policy types to monitor. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

com.bmc.mmpa.wmb.monitor

TerminalMonitoring

Enables (True) or Disables (False) terminal monitoring. Optional. Requires message flow statistics to be set to 2 (advanced) on the broker. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

com.bmc.mmpa.wmb.monitor

trustStorePassword

Password to use to access the trust store used for TLS connections. Supported at agent version 9.0.00.000 and above.

com.bmc.mmpa.wmb.monitor

Password

Password to use to connect to the WebSphereMQ queue manager. Use --set-dynamic.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

com.bmc.mmpa.wmb.monitor

AddSampleInterval

Publish sampleInterval attribute for all monitored objects. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

ConfigurableServiceMonitoringFilter

Filter configuration services. Use MONITOR_ALL, MONITOR_NONE, or list by service name to provide a specific filter. Default is MONITOR_ALL. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

ResourceManagerMonitoringFilter

Filter resource types. Use MONITOR_ALL, MONITOR_NONE, or list by resource name to provide a specific filter. Default is MONITOR_ALL. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

AdminPassword

Password for ACE REST Administration. Required if monitoring ACE with security authorization enabled. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

StatisticsAccountingRecordType

Record type for statistics accounting. Use Archive or SnapShot. SnapShot is the default, with a fixed 20 second publication interval. Archive statistics are published on a configurable interval of at least 1 minute. Intervals are configured in the Integration Node. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

NameReplaceCharacter

Replace '!' character if found in object names (Applications, Libraries or Message Flow Nodes). Default is '|'. Use NONE to disable (objects with invalid names will not be monitored if NONE is used). Supported at agent version 8.1.0.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

CMPAPIPassword

Password for the Web Administration user name. Required if Web Administration authentication is enabled. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

AdminURI

URI for ACE REST Administration. Required if monitoring ACE. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

CMPAPIReconnect

Reconnect interval for cmp-api broker connection. Default is 0 (always stay connected). Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQPassword

Password to use if WMQAuthType is userpw. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

BrokerName

The name of the Broker (or Integration Node). Optional. If not provided the broker preference level name is used. Supported at agent version 8.1.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQSSLCipherSuite

SSL cipher suite name. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQSubscriberReplyTimeout

Time to wait for a response to a subscription request. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

CMPAPITracefile

File name for configuration manager trace (WMB v6 only). Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

trustStore

File path of trust store used for TLS connections to Integration Server, queue manager or MQTT broker, e.g. 'truststore.jks'. Supported at agent version 9.0.00.000 and above.

com.bmc.mmpa.wmb.monitor

CMPAPISetStatisticsInterval

Interval, in seconds, for setting message flow or resource statistics collection. 0 to disable. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

SampleInterval

Sample interval

com.bmc.mmpa.wmb.monitor

WMQUserName

User name to use if WMQAuthType is userpw. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQSSLPeerName

SSL peer name. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

IntegrationServer

Set to true to monitor an ACE Integration Server, false to monitor an ACE Integration Node. Default is False. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MessageFlowStatistics

Sets message flow statistics. 0 to disable, 1 to enable basic, 2 to enable advanced. If not set, message flow statistics publication is as set on the broker. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQChannelName

Name of the SVRCONN channel on the IBM MQ queue manager. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQQMgrName

Name of the IBM MQ queue manager to which IIB is publishing statistic messages (required for IBM MQ subscriptions). Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQHostName

Hostname or IP address of the IBM MQ queue manager to which IIB is publishing statistic messages. Supported at agent version 8.0.01.000 and above.

com.bmc.mmpa.wmb.monitor

ResourceStatistics

True to enable or false to disable resource statistics. If not set, resource statistics publication is as set on the broker. Supported at agent version 8.0.01.000 and above.

com.bmc.mmpa.wmb.monitor

CMPAPISampleInterval

Interval, in seconds, to sample the IIB Configuration Manager. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MQTTHostName

Hostname or IP address of MQTT server to which IIB is publishing statistic messages. Local loopback address will be used if not set. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

StatisticsAccountingInterval

Interval at which the broker publishes message flow statistics accounting messages.  AddSampleInterval must also be set to true for this to take effect. Optional. Default is 20 seconds. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

AdminUser

User for ACE REST Administration. Required if monitoring ACE with security authorization enabled. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQModelQueue

Name of the model queue used to subscribe for statistics messages. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

CMPAPIUserName

Web Administration user name. User must have, at least, permissions to read objects. Write permission is required to set broker properties (e.g. to set ResourceStatistics). Required if Web Administration authentication is enabled. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

RenameUndeployedSOAPInputResources

If True, remove the [Undeployed]. prefix from SOAP Input resource instance names. Optional. Default is False. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

authType

Authorziation type (none or userpw) to use to connect to the IBM MQ queue manager. Use --set-dynamic.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

com.bmc.mmpa.wmb.monitor

WMQPort

Port number on which the IBM MQ queue manager is accepting connections. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MQTTPassword

Password for authenticating to the MQTT server. No authentication used if not set. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

keyStorePassword

Password to use to access key store used for TLS connections. Supported at agent version 9.0.00.000 and above.

com.bmc.mmpa.wmb.monitor

CMPAPIHostName

Hostname or IP address of the Integration Server Web Administraction server. Required for remote IIB monitoring. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

username

User name to use to connect to the IBM MQ queue manager. Use --set-dynamic.

Allowed level type names: ComMQSoftwareWebSphereMQQueueManager

com.bmc.mmpa.wmb.monitor

WMQAuthType

Authorization type (none or userpw) for connections to the IBM MQ queue manager. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

WMQSubscriberReplyToQueue

Name of the reply queue used for subscription request. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MQTTQOS

Quality of service for MQTT subscription. Allows 0,1 or 2. Default is 0. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MQTTUseSSL

Use SSL for the connection to the MQTT server. Default is False. Ensure the extensions SSL environment (trust stores etc) are configured if set to True. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MQTTUserName

User name for authenticating to the MQTT server. No authentication used if not set. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MQTTPort

Port number on which the MQTT server is accepting connections (required for MQTT subscriptions). Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

MQTTKeepAliveInterval

Interval at which to send keep alive messages (if a data message has not been sent in the same interval). Default is 60 seconds. Use 0 to disable.  Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

keyStore

File path of key store used for TLS connections to Integration Server, queue manager or MQTT broker, e.g. 'keystore.jks'. Supported at agent version 9.0.00.000 and above.

com.bmc.mmpa.wmb.monitor

CMPAPITimeout

Maximum time to wait for a response from the IIB configuration manager. Supported at agent version 8.0.01.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

CMPAPIPort

Port number of the Integration Server Web Administration server. Required for remote IIB monitoring. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

com.bmc.mmpa.wmb.monitor

IntegrationServerFilter

A regular expression that matches against Integration Server names to include matching objects in monitoring. Optional. All are monitored if not defined. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComMQSoftwareWebSphereMBBroker

DataPowerMonitoringExtension

hostNameVerifier

Method used to verify connection to the DataPower device, e.g. 'all'. Choices are 'Strict', 'All', or 'Browser'. Default is 'Strict'. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

keyStorePassword

Password to use to access the keystore used to connect to the DataPower device. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

ignoreCertificates

Ignore certificate checks if SSL is not configured. The default is False. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

httpSoTimeout

Time to wait for socket activity from the DataPower device in seconds. The default is 30 seconds. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

deviceVersion

Discovers the Datapower device version in runtime and then uses the proper XML files, which are responsible for monitoring types or classes. Using the deviceVersion preference forces the extension to use the XML files of the given version. The version format is VERSION_TEXT.RELEASE.MAJOR.MINOR.PATCH. For example, IDG.7.5.1.0.

In case the DataPower version discovery or selecting the proper XML files goes wrong, you can use this as a workaround.

DataPowerMonitoringExtension

trustStorePassword

Password to access the trust store that connects to the DataPower device. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

Hostname

Hostname or IP address of the DataPower device. Must match device url. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

Password

Password to use to connect to the DataPower device. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

port

Port number on which the DataPower device accepts connections. Must match device url. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

keyStore

File path of key store used to connect to the DataPower device, e.g. 'keystore.jks'. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

httpClientResponseTimeout

Time to wait for non-connection responses from the DataPower device in seconds. Default is 60 seconds. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

trustStore

File path of trust store used to connect to the DataPower device, e.g. 'truststore.jks'. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

sslProtocol

SSL protocol used when communicating with the DataPower device, for example, TLS.

Default is TLSv1.3. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

httpClientConnectionTimeout

Time to wait for connection response from the DataPower device in seconds. Default is 30 seconds. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

SampleInterval

Sample interval. Default is 60 seconds. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

DataPowerMonitoringExtension

Username

User name to use to connect to the DataPower device. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcDataPowerDevice

BTMConfig Ext

ChangeDistributionDirectoryTo

Directory where agent distributions are placed. If not set defaults to $MQS_HOME/AgentDistribution.

BTMConfig Ext

ASHost

AS host when auto-deploy used, if not defined agent preference RTS_Server_Hostname is used.

BTMConfig Ext

MSRetries

Number of retry attempts made when accessing media.

BTMConfig Ext

MSPassword

Password to access media when auto-deploy used

BTMConfig Ext

MSUser

User to access media when auto-deploy used.

BTMConfig Ext

DisableAgentDistribution

Disables agent distribution.  Specify True|False.

BTMConfig Ext

ASPort

AS port when auto-deploy used

BTMConfig Ext

NativeEncoding

Override the default native encoding of a BTM extension. Supported values are CCSIDs from QPTTAB.DAT.

BTMConfig Ext

ASSecure

True (use HTTPS) or False (use HTTP) when auto-deploy used.

BTMConfig Ext

ASTrustStore

Truststore file used when secure (HTTPS) auto-deploy is used. File can be in MQS_HOME directory or extension configuration/services directory. Supported at agent version 9.0.00.000 and above.

BTMConfig Ext

ASTrustStorePassword

Truststore password used when secure (HTTPS) auto-deploy is used. Supported at agent version 9.0.00.000 and above.

BTMConfig Ext

MSRetryInterval

Interval between retry attempts.

BTMConfig Ext

ASTrustStoreType

Truststore type used when secure (HTTPS) auto-deploy is used. Supported at agent version 9.0.00.000 and above.

BMTM Tunnel Service

TSProxyPort

Topic Service Proxy Port

BMTM Tunnel Service

ASProxyPort

Application Service Proxy Port

WebSphere MQ Configuration

ServicePort

Extension's Port

WebSphere MQ Configuration

DefaultModelQueue

Default model queue

WebSphere MQ Configuration

HeartbeatInterval

0 (OFF) or 60-180

WebSphere MQ Configuration

Secured

True/False

WebSphere MQ Configuration

MQPATH

Specifies the path where qpcfg should look for the mqs.ini file.

WebSphere MQ Configuration

PollQMInterval

0-300, default 10

WebSphere MQ Configuration

Encryption

True/False

WebSphere MQ Configuration

AllowMultipleConnections

True/False

WebSphere MQ Configuration

UseDefaultDomainName

Send domain name with user name to validate user, True/False, default to False.

WebSphere MQ Configuration

PCFMsgExpiry

Must be more than 5, over 60 client may appear to freeze.

WebSphere MQ Configuration

ValidateToken

Validate token passed to qpcfg connect, True/False, default to False

ActiveMQ Monitor

JMXUser

User name to use to connect to the ActiveMQ JMX server. Optional. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcActiveMQJMXConnection

ActiveMQ Monitor

SampleInterval

Sample interval. Default is 60 seconds. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcActiveMQJMXConnection

ActiveMQ Monitor

JMXPassword

Password to use to connect to the ActiveMQ JMX server. Optional. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcActiveMQJMXConnection

ActiveMQ Monitor

URL

JMX server URL, for example, service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi. Supported at agent version 9.0.00.000 and above.

Allowed level type names: ComBmcActiveMQJMXConnection



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*