4.33. Automatic Monitoring Options

The Monitoring Options below apply to a given UMS context. You can override the default values of these options and apply monitoring option values to all UMS contexts (transports and event queues) with the following environment variables.

These variables will not override any Monitoring Options you specifically set. The environment variables only override Monitoring Options default values.

If you do not specify any monitoring options either in an UMS configuration file or via lbm_context_attr_setopt() calls, no monitoring will occur. However, if you then set the LBM_MONITOR_INTERVAL environment variable to 5, you will turn on automatic monitoring for every UMS context your application creates at 5 second intervals. If you then set monitor_interval to 10 for a particular context, all transport sessions in that context will be monitored every 10 seconds.

See also Automatic Monitoring for more information about this feature.

4.33.1. monitor_appid (context)

An application ID string used by automatic monitoring to identify the application generating the statistics.

Scope: context
Type: string
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.

4.33.2. monitor_appid (event_queue)

An application ID string used by automatic monitoring to identify the application generating the statistics.

Scope: event_queue
Type: string
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.

4.33.3. monitor_interval (context)

Interval at which automatic monitoring retrieves the statistics for all transport sessions on a context. Setting this option to zero (the default) disables the automatic monitoring of a context's transport sessions.

Scope: context
Type: lbm_ulong_t
Units: seconds
Default value: 0
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.

4.33.4. monitor_interval (event_queue)

Interval at which automatic monitoring retrieves the statistics for an event queue. Setting this option to zero (the default) disables the automatic monitoring of an event queue. When monitoring Event Queue statistics you must enable the Event Queue UM Configuration Options, queue_age_enabled, queue_count_enabled and queue_service_time_enabled . UM disables these options by default, which produces no event queue statistics.

Scope: event_queue
Type: lbm_ulong_t
Units: seconds
Default value: 0
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.

4.33.5. monitor_transport (context)

The LBMMON transport module to be used for automatic monitoring.

Scope: context
Type: string
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.
String value Integer value Description
lbm LBM_CTX_ATTR_MON_TRANSPORT_LBM Use the LBMMON lbm transport module. Default for all.
lbmsnmp LBM_CTX_ATTR_MON_TRANSPORT_LBMSNMP Use the LBMMON lbmsnmp transport module. This value is required if you use the Ultra Messaging® SNMP Agent.

4.33.6. monitor_transport (event_queue)

The LBMMON transport module to be used for automatic monitoring.

Scope: event_queue
Type: string
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.
String value Integer value Description
lbm LBM_CTX_ATTR_MON_TRANSPORT_LBM Use the LBMMON lbm transport module. Default for all.
lbmsnmp LBM_CTX_ATTR_MON_TRANSPORT_LBMSNMP Use the LBMMON lbmsnmp transport module. This value is required if you use the Ultra Messaging SNMP Agent.

4.33.7. monitor_transport_opts (context)

An option string to be passed to the LBMMON transport module for automatic monitoring. See The UM Transport Module for more information about Transport Options. (Options for the lbm transport module and the lbmsnmp transport module are identical.)

Scope: context
Type: string
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.

4.33.8. monitor_transport_opts (event_queue)

An option string to be passed to the LBMMON transport module for automatic monitoring. See The UM Transport Module for more information about Transport Options. (Options for the lbm transport module and the lbmsnmp transport module are identical.)

Scope: event_queue
Type: string
When to Set: Can only be set during object initialization.
Version: This option was implemented in LBM 3.4/UME 2.1.

Copyright (c) 2004 - 2014 Informatica Corporation. All rights reserved.