IBM Tivoli Composite Application Manager for Microsoft

Applications: Microsoft Host Integration Server Agent

vNext

User's Guide - Beta 1 Draft



6
IBM Tivoli Composite Application Manager for Microsoft
Applications: Microsoft Host Integration Server Agent
vNext

User's Guide - Beta 1 Draft



6
 Note
Before using this information and the product it supports, read the information in “Notices” on page 403.

This edition applies to versionvNext of IBM Tivoli Composite Application Manager for Microsoft Applications:
Microsoft Host Integration Server Agent (product number 5724-U17) and to all subsequent releases and
modifications until otherwise indicated in new editions.
© Copyright IBM Corporation 2010, 2013.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures . . . . . . . . . . . . . . . v Link Service IPDLC attribute group . . . . . 60
Link Service SDLC attribute group . . . . . 69
Tables . . . . . . . . . . . . . . . vii Managed Application Integration attribute group 70
MQBridge attribute group . . . . . . . . 73
MQBridge Channel attribute group . . . . . 75
Chapter 1. Overview of the agent . . . . 1 MQBridge Connected Network attribute group 77
IBM Tivoli Monitoring . . . . . . . . . . . 1 MQBridge Message Pipe attribute group . . . 79
Functions of the monitoring agent . . . . . . . 1 MQBridge MQS to MSMQ attribute group . . . 82
New in this release . . . . . . . . . . . . 3 MQBridge MQS to MSMQ Tx attribute group . . 86
Components of the IBM Tivoli Monitoring MQBridge MSMQ to MQS attribute group . . . 91
environment . . . . . . . . . . . . . . 3 MQBridge MSMQ to MQS Tx attribute group . . 95
Agent Management Services . . . . . . . . . 5 MQBridge Service attribute group . . . . . . 99
User interface options . . . . . . . . . . . 5 MSFT DB2 Access Library attribute group . . . 101
Data sources . . . . . . . . . . . . . . 6 Performance Object Status attribute group . . . 110
Session Integrator Server attribute group . . . 115
Chapter 2. Agent installation and Session Integrator Server PLUs attribute group 118
configuration . . . . . . . . . . . . 7 SNA 3270 Response Times attribute group. . . 121
Requirements . . . . . . . . . . . . . . 7 SNA APPC Mode attribute group . . . . . 123
Language pack installation . . . . . . . . . 7 SNA Configured Users attribute group . . . . 128
Installing language packs on Windows systems . . 7 SNA Connection Configuration attribute group 130
Installing language packs on UNIX or Linux SNA Connections attribute group. . . . . . 136
systems . . . . . . . . . . . . . . . 8 SNA Domain attribute group . . . . . . . 138
Silent installation of language packs on Windows, SNA Domain Topology attribute group . . . . 146
UNIX, or Linux systems . . . . . . . . . 8 SNA Logical Unit Sessions attribute group . . 147
Agent-specific installation and configuration . . . 10 SNA LU AppcLocal attribute group . . . . . 149
Configuration values . . . . . . . . . . 10 SNA LU AppcRemote attribute group . . . . 152
Remote installation and configuration . . . . 10 SNA LU Display attribute group . . . . . . 155
SNA LU LUA attribute group . . . . . . . 158
Chapter 3. Workspaces reference . . . 13 SNA LU Print attribute group . . . . . . . 160
SNA LU3270 attribute group . . . . . . . 162
Predefined workspaces . . . . . . . . . . 13
SNA Pool attribute group . . . . . . . . 165
Workspace descriptions . . . . . . . . . . 15
SNA Pool Display attribute group . . . . . 166
Microsoft Host Integration Server Navigator item 15
SNA Print Session attribute group . . . . . 167
Application Integration Navigator item . . . . 15
SNA Server attribute group. . . . . . . . 177
Availability Navigator item . . . . . . . . 17
SNA Service attribute group . . . . . . . 178
Data Integration Navigator item . . . . . . 18
SNA Service Print attribute group . . . . . 180
Databases Navigator item . . . . . . . . 19
SNA Service TN3270 attribute group . . . . 185
Event Log Navigator item . . . . . . . . 19
SNA Service TN5250 attribute group . . . . 191
HIS Tracing Navigator item . . . . . . . . 19
Status APPC Local LU attribute group . . . . 193
Message Integration Navigator item . . . . . 19
Status APPC Session attribute group . . . . 194
SNA Server Navigator item . . . . . . . . 20
Status Client Connection attribute group . . . 195
Status and Configuration Navigator item . . . 21
Status LU3270 attribute group . . . . . . . 197
TN3270 Server Navigator item . . . . . . . 23
Status Print Session attribute group . . . . . 199
Status Service Print attribute group . . . . . 201
Chapter 4. Attributes reference . . . . 25 Status Service SNA attribute group . . . . . 203
Attribute groups for the monitoring agent . . . . 25 Status Service TN3270 attribute group . . . . 205
Attributes in each attribute group . . . . . . . 30 Status Service TN5250 attribute group . . . . 206
Application Integration HIP attribute group . . 30 Status SNA Connection attribute group. . . . 208
Application Integration WIP attribute group . . 38 Status TN3270 Session attribute group . . . . 210
Availability attribute group . . . . . . . . 47 Status TN5250 Session attribute group . . . . 211
Event Log attribute group . . . . . . . . 51 TN3270 Server attribute group . . . . . . 213
HIS Databases attribute group . . . . . . . 53 Trace SNA Application attribute group . . . . 221
HIS Information attribute group . . . . . . 54 Trace SNA Base attribute group . . . . . . 224
HIS Tracing attribute group . . . . . . . . 55 Trace SNA Manage Client attribute group . . . 226
Link Service attribute group . . . . . . . . 57 Trace SNA Mng Agent attribute group . . . . 227
Link Service Distributed attribute group . . . . 59 Trace SNA NetView attribute group . . . . . 228

© Copyright IBM Corp. 2010, 2013 iii

 Trace SNA Print attribute group . . . . . . 230 Stop Link Service action . . . . . . . . . 302
Trace SNA Server attribute group. . . . . . 233 Stop Microsoft MSMQ-MQSeries Bridge Service
Trace SNA Server Manager attribute group . . 236 action . . . . . . . . . . . . . . . 303
Trace TN3270 attribute group . . . . . . . 239 Stop Session Integrator Server Service action 304
Trace TN5250 attribute group . . . . . . . 242 Stop SNA DDM Service action . . . . . . 305
Disk capacity planning for historical data . . . . 245 Stop SNA MngAgent Service action . . . . . 306
Stop SNA RPC Service action . . . . . . . 307
Chapter 5. Situations reference. . . . 249 Stop SnaBase Service action . . . . . . . 307
Predefined situations . . . . . . . . . . . 249 Stop SnaNetMn Service action . . . . . . . 308
Situation descriptions. . . . . . . . . . . 251 Stop SnaPrint Service action . . . . . . . 309
Microsoft Host Integration Server Navigator Stop SnaServer Service action . . . . . . . 310
item . . . . . . . . . . . . . . . 251 Stop SnaSrv02 Service action . . . . . . . 311
Application Integration Navigator item. . . . 252 Stop SnaSrv03 Service action . . . . . . . 311
Availability Navigator item . . . . . . . . 252 Stop SnaSrv04 Service action . . . . . . . 312
Data Integration Navigator item . . . . . . 260 Stop TN3270 Service action . . . . . . . . 313
Databases Navigator item . . . . . . . . 260 Stop TN5250 Service action . . . . . . . . 314
Event Log Navigator item . . . . . . . . 260
HIS Tracing Navigator item . . . . . . . 269 Chapter 7. Policies reference. . . . . 317
Message Integration Navigator item . . . . . 269 Predefined policies . . . . . . . . . . . 317
SNA Server Navigator item. . . . . . . . 269
Status and Configuration Navigator item . . . 269 Chapter 8. Troubleshooting . . . . . 319
TN3270 Server Navigator item . . . . . . 271 Trace logging . . . . . . . . . . . . . 320
Overview of log file management . . . . . 320
Chapter 6. Take Action commands Principal trace log files . . . . . . . . . 321
reference . . . . . . . . . . . . . 273 Examples: Using trace logs . . . . . . . . 323
Predefined Take Action commands . . . . . . 273 RAS trace parameters . . . . . . . . . 324
Take Action command descriptions . . . . . . 274 Dynamic modification of trace settings . . . . 326
Disable SI Monitoring action . . . . . . . 274 Setting trace parameters for the Tivoli Enterprise
Disable SNA Monitoring action . . . . . . 275 Console server . . . . . . . . . . . . 329
Disable TN3270 Monitoring action . . . . . 276 Problems and workarounds . . . . . . . . 330
Enable SI Monitoring action . . . . . . . 277 Installation and configuration troubleshooting 330
Enable SNA Monitoring action . . . . . . 278 Remote deployment troubleshooting . . . . 334
Enable TN3270 Monitoring action . . . . . 279 Agent troubleshooting . . . . . . . . . 335
Reset DI UpdateCounters action . . . . . . 280 Workspace troubleshooting . . . . . . . . 338
Set DI UpdateCounters action . . . . . . . 280 Situation troubleshooting . . . . . . . . 342
Start Enterprise Single Sign On Service action 281 Take Action commands troubleshooting . . . 345
Start HIS LU62 Resync Service action . . . . 282 Discovery Library Adapter for the agent
Start HIS TCP/IP Resync Service action . . . 283 troubleshooting. . . . . . . . . . . . 345
Start Link Service action . . . . . . . . . 284 Tivoli Common Reporting troubleshooting . . 346
Start Microsoft MSMQ-MQSeries Bridge Service Support information . . . . . . . . . . . 346
action . . . . . . . . . . . . . . . 286 Informational, warning, and error messages
Start Session Integrator Server Service action 287 overview . . . . . . . . . . . . . . . 346
Start SNA DDM Service action . . . . . . 288 Message format . . . . . . . . . . . 347
Start SNA MngAgent Service action . . . . . 289 Agent messages . . . . . . . . . . . 347
Start SNA RPC Service action . . . . . . . 290
Start SnaBase Service action . . . . . . . 291 Appendix A. Event mapping . . . . . 365
Start SnaNetMn Service action. . . . . . . 292
Start SnaPrint Service action . . . . . . . 293 Appendix B. Documentation library 399
Start SnaServer Service action . . . . . . . 294 Prerequisite publications. . . . . . . . . . 399
Start SnaSrv02 Service action . . . . . . . 295 Related publications . . . . . . . . . . . 400
Start SnaSrv03 Service action . . . . . . . 296 Other sources of documentation . . . . . . . 400
Start SnaSrv04 Service action . . . . . . . 297
Start TN3270 Service action. . . . . . . . 298
Start TN5250 Service action. . . . . . . . 299
Notices . . . . . . . . . . . . . . 403
Stop Enterprise Single Sign On Service action 300 Trademarks . . . . . . . . . . . . . . 405
Stop HIS LU62 Resync Service action . . . . 300
Stop HIS TCP/IP Resync Service action . . . 301 Index . . . . . . . . . . . . . . . 407

iv IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Figures

© Copyright IBM Corp. 2010, 2013 v

vi IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Tables
1. Capacity planning for historical data logged 7. Agent problems and solutions . . . . . . 335
by the . . . . . . . . . . . . . . 247 8. Workspace problems and solutions . . . . 339
2. Information to gather before contacting IBM 9. Situation problems and solutions . . . . . 342
Software Support . . . . . . . . . . 319 10. Take Action commands problems and
3. Trace log files for troubleshooting agents 321 solutions . . . . . . . . . . . . . 345
4. Problems and solutions for installation and 11. Discovery Library Adapter for problems and
configuration . . . . . . . . . . . 330 solutions . . . . . . . . . . . . . 346
5. General problems and solutions for 12. Tivoli Common Reporting for problems and
uninstallation . . . . . . . . . . . 333 solutions . . . . . . . . . . . . . 346
6. Remote deployment problems and solutions 335

© Copyright IBM Corp. 2010, 2013 vii

viii IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Chapter 1. Overview of the agent
The IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration
Server Agent (product code QH) provides you with the capability to monitor Microsoft Host Integration
Server. You can also use the agent to take basic actions with the Microsoft Host Integration Server.

IBM® Tivoli® Monitoring is the base software for the . The monitors

IBM Tivoli Monitoring

IBM Tivoli Monitoring provides a way to monitor the availability and performance of all the systems in
your enterprise from one or several designated workstations. It also provides useful historical data that
you can use to track trends and to troubleshoot system problems.

You can use IBM Tivoli Monitoring to achieve the following tasks:
v Monitor for alerts on the systems that you are managing by using predefined situations or custom
situations.
v Establish your own performance thresholds.
v Trace the causes leading to an alert.
v Gather comprehensive data about system conditions.
v Use policies to take actions, schedule work, and automate manual tasks.

The Tivoli Enterprise Portal is the interface for IBM Tivoli Monitoring products. You can use the
consolidated view of your environment as seen in the Tivoli Enterprise Portal to monitor and resolve
performance issues throughout the enterprise.

See the IBM Tivoli Monitoring publications listed in “Prerequisite publications” on page 399 for complete
information about IBM Tivoli Monitoring and the Tivoli Enterprise Portal.

Functions of the monitoring agent

Availability and resource monitoring
Monitor the following core processes, and indicate when they are down:
v SNA Base process
v SNA RPC process
v SNA DDM process
v SNA Server process
v SNA Management Agent
Monitors processor and memory consumption for the following optional processes, if present:
v SNA Host Account Synch process
v SNA Print process
v TN3270 process
v TN5250 process
v SNA LU6.2 Resynchronization process
v Shared Folders Gateway process
Performance monitoring
Collect performance attributes and provide appropriate situations for the following services:

© Copyright IBM Corp. 2010, 2013 1

 v SNA Service activity
v APPC Local LU activity
v COMTI activity
v SNA Connection activity
v SNA LU Session activity
v TN3270 Server activity
v SDLC and IPDLC Link Service activity
Error and event log monitoring
Monitor key errors and events that affect availability or performance, Monitor warning and error
events in the Windows Event Log for Applications, for events related to COMTI, SNA and other
elements of Host Integration Server.
Actions
Provide the following actions:
v Start SnaBase Service
v Stop SnaBase Service
v Start SNA MngAgent Service
v Stop SNA MngAgent Service
v Start SNA DDM Service
v Stop SNA DDM Service
v Start SNA RPC Service
v Stop SNA RPC Service
v Start SnaServer Service
v Stop SnaServer Service
v Start SnaSrv02 Service
v Stop SnaSrv02 Service
v Start SnaSrv03 Service
v Stop SnaSrv03 Service
v Start SnaSrv04 Service
v Stop SnaSrv04 Service
v Start SnaPrint Service
v Stop SnaPrint Service
v Start TN3270 Service
v Stop TN3270 Service
v Start TN5250 Service
v Stop TN5250 Service
v Start Enterprise Single Sign On Service
v Stop Enterprise Single Sign On Service
v Start HIS LU62 Resync Service
v Stop HIS LU62 Resync Service
v Start HIS TCP/IP Resync Service
v Stop HIS TCP/IP Resync Service
v Start Session Integrator Server Service
v Stop Session Integrator Server Service
v Start Microsoft MSMQ-MQSeries Bridge Service
v Stop Microsoft MSMQ-MQSeries Bridge Service

2 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 v Start SnaNetMn Service
v Stop SnaNetMn Service
v Set DI UpdateCounters
v Reset DI UpdateCounters
v Disable SNA Monitoring
v Enable SNA Monitoring
v Disable SI Monitoring
v Enable SI Monitoring
v Disable TN3270 Monitoring
v Enable TN3270 Monitoring
v Start Link Service
v Stop Link Service
Historical data
Provides a history enablement file that provides the ability to generate reports for all metrics
collected.

New in this release

For version vNext of the , the following enhancements were made since version 6.3, including the Fix
Packs:
v Changes related to system requirements. See the information about system requirements in Software
product compatibility reports (http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/
index.html).
v New attribute groups
– SNA LU AppcLocal
– SNA LU AppcRemote
– Link Service Distributed
– SNA Configured Users
v New or changed workspaces
– Status and Configuration
– Link Service Statistics
– SNA LU APPC Local and Remote
v New or changed situations
– KQH_SNA_Server_Unreachable
v Updated kqh.baroc file to support IBM Tivoli Enterprise Console® event mapping changes
v Added support for the IBM Prerequisite Scanner, which is a stand-alone prerequisite checking tool that
analyzes system environments before the installation or upgrade of a Tivoli product or IBM solution.

Components of the IBM Tivoli Monitoring environment

After you install and set up the , you have an environment that contains the client, server, and
monitoring agent implementation for Tivoli Monitoring.

This Tivoli Monitoring environment contains the following components:

Tivoli Enterprise Portal client
The portal has a user interface based on Java™ for viewing and monitoring your enterprise.
Tivoli Enterprise Portal Server
The portal server is placed between the client and the Tivoli Enterprise Monitoring Server and

Chapter 1. Overview of the agent 3

 enables retrieval, manipulation, and analysis of data from the monitoring agents. The Tivoli
Enterprise Portal Server is the central repository for all user data.
Tivoli Enterprise Monitoring Server
The monitoring server acts as a collection and control point for alerts received from the
monitoring agents, and collects their performance and availability data. The Tivoli Enterprise
Monitoring Server is also a repository for historical data.
Tivoli Enterprise Monitoring Agent,
This monitoring agent collects data and distributes the data to the Tivoli Enterprise Monitoring
Server, Tivoli Enterprise Portal Server, Tivoli Enterprise Portal, Tivoli Data Warehouse, and Tivoli
Integrated Portal.
IBM Tivoli Netcool/OMNIbus
Tivoli Netcool/OMNIbus is an optional component and the recommended event management
component. The Netcool/OMNIbus software is a service level management (SLM) system that
delivers real-time, centralized monitoring of complex networks and IT domain events. Event
information is tracked in a high-performance, in-memory database and presented to specific users
through individually configurable filters and views. The software includes automation functions
that you can use to perform intelligent processing on managed events. You can use this software
to forward events for Tivoli Monitoring situations to Tivoli Netcool/OMNIbus.
IBM Tivoli Enterprise Console
The Tivoli Enterprise Console is an optional component that acts as a central collection point for
events from various sources, including events from other Tivoli software applications, Tivoli
partner applications, custom applications, network management platforms, and relational
database systems. You can view these events through the Tivoli Enterprise Portal (by using the
event viewer), and you can forward events from Tivoli Monitoring situations to the Tivoli
Enterprise Console component. If you do not already use Tivoli Enterprise Console and need an
event management component, you can choose to use IBM Tivoli Netcool/OMNIbus.
IBM Tivoli Common Reporting
Tivoli Common Reporting is a separately installable feature available to users of Tivoli software
that provides a consistent approach to generating and customizing reports. Some individual
products provide reports that are designed for use with Tivoli Common Reporting and have a
consistent look and feel.
IBM Tivoli Application Dependency Discovery Manager (TADDM)
TADDM delivers automated discovery and configuration tracking capabilities to build application
maps that provide real-time visibility into application complexity.
IBM Tivoli Business Service Manager
The Tivoli Business Service Manager component delivers real-time information to help you
respond to alerts effectively based on business requirements. Optionally, you can use this
component to meet service-level agreements (SLAs). Use the Tivoli Business Service Manager
tools to help build a service model that you can integrate with Tivoli Netcool/OMNIbus alerts or
optionally integrate with data from an SQL data source. Optional components provide access to
data from other IBM Tivoli applications such as Tivoli Monitoring and TADDM.
IBM Dashboard Application Services Hub
The Dashboard Application Services Hub has a core set of components that provide such
administrative essentials as network security and database management. This component replaces
the Tivoli Integrated Portal component after version 2.2.
Tivoli Integrated Portal
Tivoli Integrated Portal helps the interaction and secure passing of data between Tivoli products
through a common portal. You can launch from one application to another and within the same
dashboard view research different aspects of your managed enterprise. This component is
installed automatically with the first Tivoli product that uses the Tivoli Integrated Portal

4 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 framework. Subsequent products can install updated versions of Tivoli Integrated Portal. After
version 2.2, this component is replaced by the Dashboard Application Services Hub.

Agent Management Services

You can use IBM Tivoli Monitoring Agent Management Services to manage the .

Agent Management Services is available for the following IBM Tivoli Monitoring OS agents: Windows,
Linux, and UNIX. The services are designed to keep the available, and to provide information about the
status of the product to the Tivoli Enterprise Portal. IBM Tivoli Monitoring V6.2.2, Fix Pack 2 or later
provides support for Agent Management Services. For more information about Agent Management
Services, see Agent Management Services in the IBM Tivoli Monitoring Administrator's Guide.

User interface options

Installation of the base IBM Tivoli Monitoring software and other integrated applications provides
various interfaces that you can use to work with your resources and data.

The following interfaces are available:

Tivoli Enterprise Portal user interface
You can run the Tivoli Enterprise Portal as a desktop application or a browser application. The
client interface is a graphical user interface (GUI) based on Java on a Windows or Linux
workstation. The browser application is automatically installed with the Tivoli Enterprise Portal
Server. The desktop application is installed by using the Tivoli Monitoring installation media or
with a Java Web Start application. To start the Tivoli Enterprise Portal browser client in your
Internet browser, enter the URL for a specific Tivoli Enterprise Portal browser client installed on
your Web server.
Command-line interface
You can use Tivoli Monitoring commands to manage the Tivoli Monitoring components and their
configuration. You can also run commands at the Tivoli Enterprise Console event server or the
Tivoli Netcool/OMNIbus ObjectServer to configure event synchronization for enterprise
situations.
Manage Tivoli Enterprise Monitoring Services window
You can use the window for the Manage Tivoli Enterprise Monitoring Services utility to configure
the agent and start Tivoli services not designated to start automatically.
IBM Tivoli Netcool/OMNIbus event list
You can use the Netcool/OMNIbus event list to monitor and manage events. An event is created
when the Netcool/OMNIbus ObjectServer receives an event, alert, message, or data item. Each
event is made up of columns (or fields) of information that are displayed in a row in the
ObjectServer alerts.status table. The Tivoli Netcool/OMNIbus web GUI is also a web-based
application that processes network events from one or more data sources and presents the event
data in various graphical formats.
IBM Tivoli Enterprise Console
You can use the Tivoli Enterprise Console to help ensure the optimal availability of an IT service
for an organization. The Tivoli Enterprise Console is an event management application that
integrates system, network, database, and application management. If you do not already use
Tivoli Enterprise Console and need an event management component, you can choose to use
Tivoli Netcool/OMNIbus.
IBM Tivoli Common Reporting
Use the Tivoli Common Reporting web user interface for specifying report parameters and other
report properties, generating formatted reports, scheduling reports, and viewing reports. This
user interface is based on the Dashboard Application Services Hub for Tivoli Common Reporting
3.1 and on Tivoli Integrated Portal for earlier versions.

Chapter 1. Overview of the agent 5

IBM Tivoli Application Dependency Discovery Manager
The Discovery Management Console is the TADDM client user interface for managing
discoveries.
IBM Tivoli Business Service Manager
The Tivoli Business Service Manager console provides a graphical user interface that you can use
to logically link services and business requirements within the service model. The service model
provides an operator with a second-by-second view of how an enterprise is performing at any
moment in time or how the enterprise performed over a time period.
IBM Dashboard Application Services Hub
The Dashboard Application Services Hub provides an administrative console for applications that
use this framework. It is a web-based console that provides common task navigation for
products, aggregation of data from multiple products into a single view, and the passing of
messages between views from different products. This interface replaces the Tivoli Integrated
Portal component after version 2.2.
Tivoli Integrated Portal
Web-based products that are built on the Tivoli Integrated Portal framework share a common
user interface where you can launch applications and share information. After version 2.2, this
interface is replaced by the Dashboard Application Services Hub.

Data sources
Monitoring agents collect data from specific data sources.

The collects data from the following sources:

WMI By using WMI (Windows Management Instrumentation), you can monitor and control managed
resources throughout the network. Resources include hard drives, file systems, operating system
settings, processes, services, shares, registry settings, networking components, event logs, users,
and groups. WMI is built into clients with Windows 2000 or later, and can be installed on any
32-bit Windows client.
Perfmon
Use the Windows Performance Monitor, or Perfmon, to view various system and application
performance metrics for collection and use by management applications. You typically view
system metrics on a Windows system through the 'perfmon' application.
Availability
Use the agent to monitor availability of the application and related components in the following
ways:
v Monitor the Windows services used by the application.
Scripts
The agent uses application-specific commands and interfaces to gather metrics.
Windows Event Log
The agent collects Windows Event Log entries related to the monitored resource and forwards
them to IBM Tivoli Monitoring.

6 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Chapter 2. Agent installation and configuration
Agent installation and configuration requires the use of the IBM Tivoli Monitoring Installation and Setup
Guide and agent-specific installation and configuration information.

To install and configure the , use the Installing monitoring agents procedures in the IBM Tivoli Monitoring
Installation and Setup Guide.

If you are installing silently by using a response file, see Performing a silent installation of IBM Tivoli
Monitoring in the IBM Tivoli Monitoring Installation and Setup Guide.

With the self-describing agent capability, new or updated IBM Tivoli Monitoring agents using IBM Tivoli
Monitoring V6.2.3 or later can become operational after installation without having to perform additional
product support installation steps. To take advantage of this capability, see “Enabling self-describing
agent capability at the hub monitoring server” in the IBM Tivoli Monitoring Installation and Setup Guide.
Also, see “Self-describing monitoring agents” in the IBM Tivoli Monitoring Administrator's Guide.

Requirements
Before installing and configuring the agent, make sure your environment meets the requirements for the
IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server
Agent.

For information about system requirements, see the Software product compatibility reports
(http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html). Search for the ITCAM for
Microsoft Applications product.

Language pack installation

The steps for installing language packs depend on which operating system and mode of installation you
are using.

To install a language pack for the agent support files on the Tivoli Enterprise Monitoring Server, the
Tivoli Enterprise Monitoring Agent, and the Tivoli Enterprise Portal Server, make sure that you installed
the product in the English language. Then use the steps for the operating system or mode of installation
you are using:
v “Installing language packs on Windows systems”
v “Installing language packs on UNIX or Linux systems” on page 8
v “Silent installation of language packs on Windows, UNIX, or Linux systems” on page 8

Installing language packs on Windows systems

You can install the language packs on a Windows system.

Before you begin

First, make sure that you installed the product in the English language.

Procedure
1. On the language pack CD, double-click the lpinstaller.bat file to start the installation program.
2. Select the language of the installer and click OK.
3. In the Introduction panel, click Next

© Copyright IBM Corp. 2010, 2013 7

 4. Click Add/Update and click Next.
5. Select the folder where the National Language Support package (NLSPackage) files are located.
Typically, the NLSPackage files are located in the nlspackage folder where the installer executable
file is located.
6. Select the language support for the agent of your choice and click Next. To make multiple selections,
press Ctrl and select the language that you want.
7. Select the languages that you want to install and click Next.
8. Examine the installation summary page and click Next to begin installation.
9. After installation completes, click Finish to exit the installer.
10. Restart the Tivoli Enterprise Portal, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of
these components are installed.

Installing language packs on UNIX or Linux systems

You can install the language packs on a UNIX or Linux system.

Before you begin

First, make sure that you installed the product in the English language.

Procedure
1. Enter the mkdir command to create a temporary directory on the computer, for example, mkdir
dir_name. Make sure that the full path of the directory does not contain any spaces.
2. Mount the language pack CD to the temporary directory that you created.
3. Enter the following command to start the installation program: cd dir_name lpinstaller.sh -c
install_dir where install_dir is where you installed IBM Tivoli Monitoring. Typically, the directory
name is /opt/IBM/ITM for UNIX and Linux systems.
4. Select the language of the installer and click OK.
5. In the Introduction panel, click Next.
6. Click Add/Update and click Next.
7. Select the folder where the National Language Support package (NLSPackage) files are located.
Typically, the NLSPackage files are located in the nlspackage folder where the installer executable file
is located.
8. Select the language support for the agent of your choice and click Next. To make multiple selections,
press Ctrl and select the language that you want.
9. Select the languages that you want to install and click Next.
10. Examine the installation summary page and click Next to begin installation.
11. After installation completes, click Finish to exit the installer.
12. Restart the Tivoli Enterprise Portal, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of
these components are installed.

Silent installation of language packs on Windows, UNIX, or Linux

systems
You can use the silent-mode installation method to install the language packs. In silent mode, the
installation process obtains the installation settings from a predefined response file. It does not prompt
you for any information.

Before you begin

First, make sure that you installed the product in the English language.

8 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Procedure
1. Copy and paste the ITM_Agent_LP_silent.rsp response file template as shown in “Response file
example.”
2. Change the following parameter settings:
NLS_PACKAGE_FOLDER
Folder where the National Language Support package (NLSPackage) files are located.
Typically, the NLSPackage files are located in the nlspackage folder, for example:
NLS_PACKAGE_FOLDER = //tmp//LP//nlspackage.
PROD_SELECTION_PKG
Name of the language pack to install. Several product components can be included in one
language package. You might want to install only some of the available components in a
language pack.
BASE_AGENT_FOUND_PKG_LIST
Agent for which you are installing language support. This value is usually the same as
PROD_SELECTION_PKG.
LANG_SELECTION_LIST
Language you want to install.
3. Enter the command to install the language pack with a response file (silent installation):
v For Windows systems:
lpinstaller.bat -f path_to_response_file
v For UNIX or Linux systems:
lpinstaller.sh -c candle_home -f path_to_response_file

where candle_home is the IBM Tivoli Monitoring base directory.

Response file example

# IBM Tivoli Monitoring Agent Language Pack Silent Installation Operation
#
#This is a sample response file for silent installation mode for the IBM Tivoli
#Monitoring Common Language Pack Installer.
#.
#This file uses the IBM Tivoli Monitoring Common Agent Language Pack with the
#install package as an example.
#Note:
#This response file is for the INSTALLATION of language packs only.
#This file does not support UNINSTALLATION of language packs in silent mode.
#-------------------------------------------------------------------------------
#-------------------------------------------------------------------------------
#To successfully complete a silent installation of the the example of Common Agent
#localization pack, complete the following steps:
#
#1.Copy ITM_Agent_LP_silent.rsp to the directory where lpinstaller.bat or
#lpinstaller.sh is located (IBM Tivoli Monitoring Agent Language Pack build
#location).
#
#2.Modify the response file so that it is customized correctly and completely for
#your site.
# Complete all of the following steps in the response file.
#
#3.After customizing the response file, invoke the silent installation using the
#following command:
#For Windows:
# lpinstaller.bat -f <path_to_response_file>
#For UNIX and Linux:
# lpinstaller.sh -c <candle_home> -f <path_to_response_file>
#Note:<candle_home> is the IBM Tivoli Monitoring base directory.
#--------------------------------------------------------------------------------

Chapter 2. Agent installation and configuration 9

#--------------------------------------------------------------------------------
#Force silent install mode.
#--------------------------------------------------------------------------------
INSTALLER_UI=silent
#---------------------------------------------------------------------------------
#Run add and update actions.
#---------------------------------------------------------------------------------
CHOSEN_INSTALL_SET=ADDUPD_SET
#---------------------------------------------------------------------------------
#NLS Package Folder, where the NLS Packages exist.
#For Windows:
# Use the backslash-backslash(\\) as a file separator (for example,
#C:\\zosgmv\\LCD7-3583-01\\nlspackage).
#For UNIX and Linux:
# Use the slash-slash (//) as a file separator (for example,
#//installtivoli//lpsilenttest//nlspackage).
#---------------------------------------------------------------------------------
#NLS_PACKAGE_FOLDER=C:\\zosgmv\\LCD7-3583-01\\nlspackage
NLS_PACKAGE_FOLDER=//tmp//LP//nlspackage
#---------------------------------------------------------------------------------
#List the packages to process; both variables are required.
#Each variable requires that full paths are specified.
#Separate multiple entries with a semicolon (;).
#For Windows:
# Use the backslash-backslash(\\) as a file separator.
#For Unix and Linux:
# Use the slash-slash (//) as a file separator.
#---------------------------------------------------------------------------------
#PROD_SELECTION_PKG=C:\\zosgmv\\LCD7-3583-01\\nlspackage\\KIP_NLS.nlspkg
#BASE_AGENT_FOUND_PKG_LIST=C:\\zosgmv\\LCD7-3583-01\\nlspackage\\KIP_NLS.nlspkg
PROD_SELECTION_PKG=//tmp//LP//nlspackage//kex_nls.nlspkg;//tmp//LP//nlspackage//
koq_nls.nlspkg
BASE_AGENT_FOUND_PKG_LIST=//tmp//LP//nlspackage//kex_nls.nlspkg;//
tmp//LP//nlspackage//koq_nls.nlspkg
#--------------------------------------------------------------------------------
#List the languages to process.
#Separate multiple entries with semicolons.
#--------------------------------------------------------------------------------
LANG_SELECTION_LIST=pt_BR;fr;de;it;ja;ko;zh_CN;es;zh_TW

Agent-specific installation and configuration

In addition to the installation and configuration information in the IBM Tivoli Monitoring Installation and
Setup Guide, use this agent-specific installation and configuration information to install the .

Configuration values
For both local and remote configuration, you provide the configuration values for the agent to operate.

When you are configuring an agent, a panel is displayed so you can enter each value. When a default
value exists, this value is pre-entered into the field. If a field represents a password, two entry fields are
displayed. You must enter the same value in each field. The values that you type are not displayed to
help maintain the security of these values.

The configuration for this agent is organized into the following groups:

Remote installation and configuration

You can install the monitoring agent remotely from the Tivoli Enterprise Portal or from the command
line.

When installing the agent remotely, you must provide the configuration values for the agent to operate.
See “Configuration values.”

10 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
To install from the portal, see the IBM Tivoli Monitoring Installation and Setup Guide.

To remotely install or configure an agent through the Tivoli Enterprise Portal, you must have installed the
application support for that agent (Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Server,
and Tivoli Enterprise Portal). You must also have installed the agent bundle into the Remote Deploy
Depot.

For information about displaying the configuration options that are available to use with the
configureSystem or addSystem commands see “tacmd describeSystemType” in the IBM Tivoli Monitoring
Command Reference.

If you are using the command line, the following command is an example of remote installation and
configuration for Windows operating systems:
tacmd addSystem -t QH -n Primary:sample.node.name:NT
-p

Chapter 2. Agent installation and configuration 11

12 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Chapter 3. Workspaces reference
A workspace is the working area of the Tivoli Enterprise Portal application window. The Navigator tree
contains a list of the workspaces provided by the agent.

About workspaces

Use the Navigator tree to select the workspace you want to see. As part of the application window, the
status bar shows the Tivoli Enterprise Portal Server name and port number to which the displayed
information applies and the ID of the current user.

When you select an item in the Navigator tree, a default workspace is displayed. When you right-click a
Navigator item, a menu that includes a Workspace item is displayed. The Workspace item contains a list
of workspaces for that Navigator item. Each workspace has at least one view. Some views have links to
other workspaces. You can also use the Workspace Gallery tool as described in the Tivoli Enterprise Portal
User's Guide to open workspaces.

The workspaces in the Navigator are displayed in a Physical view that shows your enterprise as a
physical mapping or a dynamically populated logical view that is agent-specific. You can also create a
Logical view. The Physical view is the default view.

This monitoring agent provides predefined workspaces. You cannot modify or delete the predefined
workspaces, but you can create new workspaces by editing them and saving the changes with a different
name.

Workspace views can be any combination of query-based views, event views, and special purpose views.

Additional information about workspaces

For more information about creating, customizing, and working with workspaces, see "Using workspaces"
in the Tivoli Enterprise Portal User's Guide.

For a list of the predefined workspaces for this monitoring agent and a description of each workspace,
see Predefined workspaces and the information about each individual workspace.

Some attribute groups for this monitoring agent might not be represented in the predefined workspaces
or views for this agent. For a full list of the attribute groups, see “Attribute groups for the monitoring
agent” on page 25.

Predefined workspaces
The provides predefined workspaces, which are organized by Navigator item.
v Microsoft Host Integration Server Navigator item
– Microsoft Host Integration Server workspace
– SNA Domain Topology workspace
v Application Integration Navigator item
– Application Integration workspace
– HIP Byte Transfer Statistics workspace
– HIP Host Request Statistics workspace
– HIP Method Execution Statistics workspace

© Copyright IBM Corp. 2010, 2013 13

 – HIP Work Flow Process Statistics workspace
– Managed WIP Calls Request Response Stats workspace
– Session Integrator PLUs Statistics workspace
– Session Integrator Server Statistics workspace
– WIP Byte Transfer Statistics workspace
– WIP Host Response Statistics workspace
– WIP Method Call Statistics workspace
v Availability Navigator item
– Availability workspace
– Performance Object Status workspace
v Data Integration Navigator item
– Data Integration workspace
– Data Transfer Statistics workspace
– ODBC Exec Prepare and Fetch Statistics workspace
– OLEDB Exec Prepare and Fetch Statistics workspace
v Databases Navigator item
– Databases workspace
v Event Log Navigator item
– Event Log workspace
v HIS Tracing Navigator item
– HIS Tracing workspace
v Message Integration Navigator item
– Channel and Message Pipe Configuration workspace
– Message Integration workspace
– MQS TO MSMQ Status workspace
– MSMQ TO MQS Status workspace
v SNA Server Navigator item
– Data on Connection and LU Statistics workspace
– Link Service Statistics workspace
– Response Failure Statistics workspace
– SNA Server workspace
v Status and Configuration Navigator item
– APPC Configuration workspace
– Pool and LU Configuration workspace
– Print Session Statistics workspace
– Print Status and LU Statistics workspace
– SNA LU APPC Local and Remote workspace
– SNA Server and Connection Configuration workspace
– SNA Service and Domain Configuration workspace
– Status and Configuration workspace
– TN3270 Status and Session workspace
– TN5250 Status and Session workspace
v TN3270 Server Navigator item
– RU Transfer Statistics workspace
– TCP Data Transfer Statistics workspace

14 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 – TN3270 Server workspace

Workspace descriptions
Each workspace description provides information about the workspace such as the purpose and a list of
views in the workspace.

Workspaces are listed under Navigator items.

Microsoft Host Integration Server Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Microsoft Host Integration Server workspace
This workspace displays an overview of the important components of Microsoft Host Integration
Server (HIS).
This workspace contains the following views:
Host Integration Server Information
Displays the name and version of Microsoft HIS.
WIP Total of Total Calls and Errors
Displays the rate at which total calls are made and the errors that occur for
Windows-initiated processing (WIP).
DI Open Connections and Statements - Top 5 Open Connection
Displays the top 5 instances with open connections and statments for data integration.
HIP Request Processing Statistics - Top 5 Call Executing
Displays the request processing statistics for the top 5 instances in Host Initiated
Processing (HIP).
SNA Domain Topology workspace
This workspace displays the SNA domain topology.
This workspace contains the following views:
Topology Details
This view displays information about the SNA domain topology.
SNA Domain Topology
This view displays the number of SNA Servers that are configured under the SNA
domain of the monitored system.

Application Integration Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Application Integration workspace
This workspace represents the application level integration between applications running on
Windows environment and Mainframe system.
This workspace contains the following views:
HIP Total Method Execution Rate
Displays total method execution rate of common instance.
HIP Request Processing
Displays the request processing for top 5 instances.
WIP Total of Total Calls and Errors
Displays the total calls and error rate.
Managed WIP Total of Total Calls and Errors
Displays the total calls and error rate for managed WIP.
HIP Byte Transfer Statistics workspace
This workspace displays the details about the HIP Byte Transfer Statistics and data transfer rate
on SNA and TCP/IP.
This workspace contains the following views:

Chapter 3. Workspaces reference 15

 Byte Transfer Stats on SNA and TCP/IP
Displays the Byte transfer statistics on SNA and TCP/IP for the Top 100 rows using HIP.
Total Byte Transfer Rate on SNA
Displays the byte transfer rate on SNA for HIP.
Total Byte Transfer Rate on TCP/IP
Displays the byte transfer rate on TCP/IP for HIP.
HIP Host Request Statistics workspace
This workspace displays the details of the HIP Host Request Statistics.
This workspace contains the following views:
Total Host Request Rate
Displays the total host request rate.
Host Request Stats
Displays the host request statistics.
HIP Method Execution Statistics workspace
This workspace displays the details about HIP Method Execution, Request and Process Stats.
This workspace contains the following views:
Method Execution Stats
Displays the Method Execution Statistics.
Total Dot Net Method Execution Rate
Displays the total .NET Method Execution Rate.
Total COM Method Execution Rate
Displays the total COM Method Execution Rate.
HIP Work Flow Process Statistics workspace
This workspace displays the details for the HIP work flow process statistics and work flow
process rate.
This workspace contains the following views:
Total Work Flow Process Rate
Displays the work flow process rate.
Work Flow Process Stats
Displays the Work Flow Process Statistics.
Managed WIP Calls Request Response Stats workspace
This workspace displays the details for Managed WIP HIS Calls request response statistics.
This workspace contains the following views:
Calls, Request And Response Stats
Displays call, request and response statistics for Managed WIP applications Top 100 rows.
Total of Total Calls and Errors Rate
Displays the total calls and errors rate for managed WIP.
Request And Response Call Time (seconds)
Displays the request and response call time in seconds for top 5 instances for managed
WIP.
Session Integrator PLUs Statistics workspace
This workspace displays the Session integrator server PLUs statistics.
This workspace contains the following views:
SI Server PLUs Stats
Displays the session integrator server Primary Logical Units (PLUs) statistics for Top 100
rows.
Total Chains Transfer Rate
Displays the total chain transfer rate for session integrator server LUs.
Total Data Transfer Rate
Displays the total data transfer rate for session integrator server LUs.
Sessions Count Top 6 Sessions Connected
Displays the session counts for session integrator server PLUs for top 6 instances.

16 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Session Integrator Server Statistics workspace
This workspace displays the Session integrator server details.
This workspace contains the following views:
SI Server Stats
Displays the session integrator server statistics for Top 100 rows.
Sessions Count
Displays the session counts for session integrator server.
Total Chains Transfer Rate
Displays the total chain transfer rate for session integrator server.
Total Data Transfer Rate
Displays the total data transfer rate for session integrator server.
WIP Byte Transfer Statistics workspace
This workspace displays the details for the WIP Byte Transfer rate and statistics on SNA and
TCP/IP.
This workspace contains the following views:
Byte Transfer Stats on SNA and TCP/IP
Displays the byte transfer statistics on SNA and TCP/IP for WIP Top 100 rows.
Total Byte Transfer Rate on SNA
Displays the byte transfer rate on SNA for WIP.
Total Byte Transfer Rate on TCP/IP
Displays the byte transfer rate on TCP/IP for WIP.
WIP Host Response Statistics workspace
This workspace displays the details for the WIP Host Response Statistics.
This workspace contains the following views:
Total Host Response Stats
Displays the host response time.
Host Response Stats
Displays the host response statistics Top 100 rows.
WIP Method Call Statistics workspace
This workspace displays the details of WIP Method Call Statistics.
This workspace contains the following views:
Total of Total Calls and Errors Rate
Displays the total calls and error rate.
Method Call Stats
Displays the total calls and error statistics for instance specific Top 100 rows.

Availability Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Availability workspace
The Availability workspace displays the overall health of the application.
This workspace contains the following views:
Availability
Displays the state of each component in the application. Each service is displayed using a
descriptive name, the short name of the service, and the state of the service (UP, DOWN,
or UNKNOWN). The state is UP if the service is running, DOWN if the service exists but
is not running. UNKNOWN indicates that the service is not installed, so these elements
are filtered from the view. When the state of the component is DOWN (for a process, or
service) it is highlighted with a red background.
Processor
Displays the amount of CPU used by each process that is a component of the application.
This displays the 2 main components of CPU usage, privileged time which is time spent
in the kernel on behalf of the process and user mode time, which is the time spent
running the process code.

Chapter 3. Workspaces reference 17

 Threads
Displays the number of threads used by each process that is a component of the
application.
Memory
Displays the amount of memory being consumed by each process that is a component of
the application. This total (virtual) size of the process and the size of the process in
memory (working set) are displayed.
Performance Object Status workspace
This workspace displays the overall health of the application.
This workspace contains the following view:
Performance Object Status
Displays the status of the data collection from the application, usually this will display
NO ERROR indicating that the agent is collecting application data correctly, if some of
the agent's other views are empty, then this view will help isolate the cause of the failure,
PerfMon objects will display the object class name.

Data Integration Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Data Integration workspace
This workspace displays the details of integration with various data storage system on
Mainframe machine e.g.DB2.
This workspace contains the following views:
Total Host Processing Time (millisecond)
Displays the total host processing time in milliseconds.
Total Transaction Rate
Displays the total transaction rate.
Processing, Transactions and Connections Stats
Displays the processing, transactions and connections statistics for the Top 100 rows.
Open Connections and Statements Top 6 Open Connection
Displays the open connections and statements for the Top 6 open connections.
Data Transfer Statistics workspace
This workspace displays the data transfer statistics.
This workspace contains the following views:
Total Data Received Rate
Displays the total data received rate.
Total Data Sent Rate
Displays the total data sent rate.
Total Packets Sent and Received Rate
Displays the total packets sent and received rate.
Data and Packets Sent and Received Stats
Displays the data and packets sent and received statistics for the Top 100 rows.
ODBC Exec Prepare and Fetch Statistics workspace
This workspace displays the details for ODBC Exec Prepare and Fetch statistics.
This workspace contains the following views:
ODBC Execute, Prepare and Fetch Statistics
Displays the ODBC Execute, Prepare and Fetch statistics for the top 100 rows.
Total ODBC Row Fetched Rate
Displays the total ODBC Row Fetched Rate.
Total ODBC Execute, Prepare and Fetch Rate
Displays the total ODBC Execute, Prepare and Fetch rate.
Total ODBC Execute, Prepare and Fetch Time (millisecond)
Displays the Total ODBC Execute, Prepare and Fetch time in milliseconds.

18 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
OLEDB Exec Prepare and Fetch Statistics workspace
This workspace displays the details for OLEDB Exec Prepare and Fetch statistics.
This workspace contains the following views:
OLE DB Execute, Prepare and Fetch Statistics
Displays the OLE DB Execute, Prepare and Fetch statistics for the Top 100 rows.
Total OLE DB Row Fetched and Get Data Rate
Displays the total OLE DB Row Fetched and Get Data rate.
Total OLE DB Execute, Prepare and Fetch Rate
Displays the total OLE DB Execute, Prepare and Fetch rate.
Total OLE DB Execute, Prepare and Fetch Time (millisecond)
Displays the total OLE DB Execute, Prepare and Fetch time in milliseconds.

Databases Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Databases workspace
This workspace displays details about the database created by Microsoft HIS and ESSO.
This workspace contains the following view:
Databases
Displays the databases used by Microsoft HIS and ESSO.

Event Log Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Event Log workspace
The Event Log workspace shows the details for the recent events logged by the application to the
Windows Event Log. By default, the agent only displays events that occur after the agent is
started. Events are removed from the Event Log view 1 hour after they occur.
This workspace contains the following view:
Event Log
Shows the recent Event Log entries for Microsoft Host Integration Server.

HIS Tracing Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
HIS Tracing workspace
Workspace under HIS Tracing navigation item represents tracing setting for various components
of Microsoft HIS product
This workspace contains the following view:
HIS Tracing Stats
HIS Tracing - This view represents tracing setting for various components of Microsoft
HIS product.

Message Integration Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Channel and Message Pipe Configuration workspace
This workspace displays the channel and message pipe configuration details for message
integration.
This workspace contains the following views:
Channel Configuration Stats
Displays an overview of channel configuration settings.
Message Pipe Configuration Stats
Displays an overview of message pipe configuration settings.

Chapter 3. Workspaces reference 19

Message Integration workspace
This workspace displays the message level integration statistics between MSMQ on Windows
system and MQSeries on Mainframe system
This workspace contains the following views:
MQBridge Stats
Displays the MQBridge message integration statistics.
Service Configuration Stats
Displays an overview of service configuration message integration statistics.
Network Configuration Stats
Displays an overview of network configuration message integration statistics.
MQS TO MSMQ Status workspace
This workspace displays the details of message integration statistics for for MQS TO MSMQ.
This workspace contains the following views:
MQS to MSMQ Stats
Displays an overview of MQS to MSMQ message integration statistics.
MQS to MSMQ TX Stats
Displays an overview of MQS to MSMQ TX message integration statistics.
MSMQ TO MQS Status workspace
This workspace displays the message integration statistics for MSMQ to MQS.
This workspace contains the following views:
MSMQ to MQS Stats
Displays an overview of MSMQ to MQS message integration statistics.
MSMQ to MQS TX Stats
Displays an overview of MSMQ to MQS TX message integration statistics.

SNA Server Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Data on Connection and LU Statistics workspace
This workspace displays the counter details for data on connection and LU.
This workspace contains the following views:
Total Data on SNA Connections Rate
Displays the statistics for total data on SNA connections.
Total Data on LU Sessions Rate
Displays the statistics for total data on LU sessions.
Data on SNA Connections Stats
Displays the details of data on SNA connections.
Data on LU Sessions Stats
Displays the details of data on LU sessions.
Link Service Statistics workspace
This workspace displays the details about the link service.
This workspace contains the following views:
Link Service Statistics
Displays the details about the link service configuration.
Link Service SDLC Statistics
Displays the details about the link service SDLC configuration.
Link Service Distributed Statistics
Displays the configuration details of the distributed link services.
Link Service IPDLC Stats 1
Displays the details about the link service IPDLC configuration of part 1.
Link Service IPDLC Stats 2
Displays the details about the link service IPDLC configuration of part 2.
Response Failure Statistics workspace
This workspace displays the details about response failure statistics.

20 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 This workspace contains the following views:
Response Failure Count (Top 5 on Response Threshold 1)
Displays a graphical representation of the percentage of response failure.
Response Failure Statistics
Displays the details of the percentage of response failure.
SNA Server workspace
This workspace displays an overview of the network integration using SNA protocol.
This workspace contains the following views:
Response Failure Count (Top 5 on Response Threshold 1)
Displays the top 5 response failure count.
SNA Connection Stats
Displays the SNA connection details.
SNA Service Stats
Displays the SNA service details.

Status and Configuration Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
APPC Configuration workspace
This workspace displays the details for APPC configuration.
This workspace contains the following views:
APPC Session Stats
Displays the APPC session status statistics.
APPC Local LU Stats
Displays the APPC local LU status statistics.
APPC Mode Stats
Displays the SNA APPC Mode statistics.
Pool and LU Configuration workspace
This workspace displays the details for Pool and LU configuration.
This workspace contains the following views:
LU LUA Statistics
Displays the LU LUA statistics.
LU Display Statistics
Displays the LU Display statistics.
Pool Display Statistics
Displays the Pool Display statistics.
Print Session Statistics workspace
This workspace displays the details for print session statistics.
This workspace contains the following views:
Print File Statistics
Displays the details about the print file status.
Print Margin and Code Statistics
Displays the print margin and code statistics.
Print Override and Scaling Statistics
Displays the print override and scaling statistics.
Print Status and LU Statistics workspace
This workspace provides details of Print Status and LU.
This workspace contains the following views:
Print Service Status
Displays the print service status details.
Print Service Stats
Displays the print service configuration details.
Print Session Status
Displays the print Session status details.

Chapter 3. Workspaces reference 21

 LU Print Stats
Displays the LU print configuration details.
SNA LU APPC Local and Remote workspace
This workspace displays the information about local and remote APPC LUs.
This workspace contains the following views:
SNA LU APPC Local
Displays information about the local APPC LU.
SNA LU APPC Remote
Displays infromation about the remote APPC LU.
SNA Server and Connection Configuration workspace
This workspace provides details for SNA server and connection configuration.
This workspace contains the following views:
SNA Server Stats
Displays the SNA server statistics.
SNA Connection Stats
Displays the SNA connection statistics.
SNA Local and Remote Connection Stats
Displays the SNA local and remote connection statistics.
SNA Service and Domain Configuration workspace
This workspace represents details for SNA service and domain configuration.
This workspace contains the following views:
SNA Service Stats
Displays the SNA service statistics.
Domain Configuration Stats
Displays the domain configuration statistics.
RTM Threshold and LU Security Stats
Displays the RTM threshold and LU security statistics.
Status and Configuration workspace
This workspace displays the configuration details of the various components of Microsoft HIS
product.
This workspace contains the following views:
SNA Connection Status
Displays the SNA connection status details.
SNA Service Status
Displays the SNA service status details.
SNA Configured Users
Displays the details of the users that are configured on the SNA Server.
Client Connection Status
Displays the client connection status details.
TN3270 Status and Session workspace
This workspace displays the details for TN3270 status and session.
This workspace contains the following views:
TN3270 Service Status
Displays the TN3270 service status details.
TN3270 Session Status
Displays the TN3270 session status details.
LU3270 Status
Displays the LU3270 status details.
LU3270 Stats
Displays the LU3270 statistics.
TN3270 Service Stats
Displays the TN3270 service statistics.

22 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
TN5250 Status and Session workspace
This workspace displays the details for the TN5250 status and session.
This workspace contains the following views:
TN5250 Service Status
Displays the TN5250 service status statistics.
TN5250 Session Stats
Displays the TN5250 session status statistics.
TN5250 Service Stats
Displays the TN5250 service statistics.

TN3270 Server Navigator item

The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
RU Transfer Statistics workspace
This workspace displays the details about RU transfer.
This workspace contains the following views:
RU Transfer Stats
Displays the RU transfer statistics.
RU Transfer Count
Displays the RU transfer count details.
RU Transfer Rate
Displays the RU transfer rate.
TCP Data Transfer Statistics workspace
This workspace displays the details about TCP data transfer.
This workspace contains the following views:
TCP Data Transfer Stats
Displays the TCP data transfer statistics.
TCP Data Transfer Count
Displays the TCP data transfer count details.
TCP Data Transfer Rate
Displays the TCP data transfer rate details.
TN3270 Server workspace
This workspace displays the TN3270 server performance details.
This workspace contains the following views:
Connections and Sessions Count
Displays the connections and sessions count details.
Session Count Stats
Displays the session count statistics details.
Connections and Sessions Stats
Displays the connections and sessions statistics.
TN3270 Service Status
Displays the TN3270 service status details.

Chapter 3. Workspaces reference 23

24 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Chapter 4. Attributes reference
Attributes are the application properties that are being measured and reported by the IBM Tivoli
Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent.

About attributes

Attributes are organized into attribute groups. Attributes in an attribute group relate to a single object
such as an application, or to a single kind of data such as status information.

Attributes in a group can be used in queries, query-based views, situations, policy workflows, take action
definitions, and launch application definitions. Chart or table views and situations are two examples of
how attributes in a group can be used:
v Chart or table views
Attributes are displayed in chart and table views. The chart and table views use queries to specify
which attribute values to request from a monitoring agent. You use the Properties editor to apply filters
and set styles to define the content and appearance of a view based on an existing query.
v Situations
You use attributes to create situations that monitor the state of your operating system, database, or
application. A situation describes a condition you want to test. When you start a situation, the values
you assign to the situation attributes are compared with the values collected by the and registers an
event if the condition is met. You are alerted to events by indicator icons that are displayed in the
Navigator.

Additional information about attributes

For more information about using attributes and attribute groups, see the Tivoli Enterprise Portal User's
Guide.

For a list of the attribute groups, a list of the attributes in each attribute group, and descriptions of the
attributes for this monitoring agent, see “Attribute groups for the monitoring agent” and “Attributes in
each attribute group” on page 30.

Attribute groups for the monitoring agent

The contains the following attribute groups. The table name depends on the maximum table name limits
of the target database being used for the Tivoli Data Warehouse. If the maximum name is 30 characters,
any warehouse table name longer than 30 characters is shortened to 30 characters.
v Attribute group name: Application Integration HIP
– Table name: KQHAPPINTE
– Warehouse table name: KQH_APPLICATION_INTEGRATION_HIP or KQHAPPINTE
v Attribute group name: Application Integration WIP
– Table name: KQHAPPINT1
– Warehouse table name: KQH_APPLICATION_INTEGRATION_WIP or KQHAPPINT1
v Attribute group name: Availability
– Table name: KQHAVAIL
– Warehouse table name: KQH_AVAILABILITY or KQHAVAIL
v Attribute group name: Event Log
– Table name: KQHEVTLOG

© Copyright IBM Corp. 2010, 2013 25

 – Warehouse table name: KQH_EVENT_LOG or KQHEVTLOG
v Attribute group name: HIS Databases
– Table name: KQHHISDATA
– Warehouse table name: KQH_HIS_DATABASES or KQHHISDATA
v Attribute group name: HIS Information
– Table name: KQHHISINFO
– Warehouse table name: KQH_HIS_INFORMATION or KQHHISINFO
v Attribute group name: HIS Tracing
– Table name: KQHMSHIS01
– Warehouse table name: KQH_HIS_TRACING or KQHMSHIS01
v Attribute group name: Link Service
– Table name: KQHMSSNALI
– Warehouse table name: KQH_LINK_SERVICE or KQHMSSNALI
v Attribute group name: Link Service Distributed
– Table name: KQHDISTLS
– Warehouse table name: KQH_LINK_SERVICE_DISTRIBUTED or KQHDISTLS
v Attribute group name: Link Service IPDLC
– Table name: KQHMSSNAL1
– Warehouse table name: KQH_LINK_SERVICE_IPDLC or KQHMSSNAL1
v Attribute group name: Link Service SDLC
– Table name: KQHSDLCLS
– Warehouse table name: KQH_LINK_SERVICE_SDLC or KQHSDLCLS
v Attribute group name: Managed Application Integration
– Table name: KQHMANAGE0
– Warehouse table name: KQH_MANAGED_APPLICATION_INTEGRATION or KQHMANAGE0
v Attribute group name: MQBridge
– Table name: KQHMQBRID1
– Warehouse table name: KQH_MQBRIDGE or KQHMQBRID1
v Attribute group name: MQBridge Channel
– Table name: KQHMSHISMQ
– Warehouse table name: KQH_MQBRIDGE_CHANNEL or KQHMSHISMQ
v Attribute group name: MQBridge Connected Network
– Table name: KQHMSHISM2
– Warehouse table name: KQH_MQBRIDGE_CONNECTED_NETWORK or KQHMSHISM2
v Attribute group name: MQBridge Message Pipe
– Table name: KQHMSHISM3
– Warehouse table name: KQH_MQBRIDGE_MESSAGE_PIPE or KQHMSHISM3
v Attribute group name: MQBridge MQS to MSMQ
– Table name: KQHMQBRID2
– Warehouse table name: KQH_MQBRIDGE_MQS_TO_MSMQ or KQHMQBRID2
v Attribute group name: MQBridge MQS to MSMQ Tx
– Table name: KQHMQBRID3
– Warehouse table name: KQH_MQBRIDGE_MQS_TO_MSMQ_TX or KQHMQBRID3
v Attribute group name: MQBridge MSMQ to MQS
– Table name: KQHMQBRID4

26 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 – Warehouse table name: KQH_MQBRIDGE_MSMQ_TO_MQS or KQHMQBRID4
v Attribute group name: MQBridge MSMQ to MQS Tx
– Table name: KQHMQBRID5
– Warehouse table name: KQH_MQBRIDGE_MSMQ_TO_MQS_TX or KQHMQBRID5
v Attribute group name: MQBridge Service
– Table name: KQHMSHISM1
– Warehouse table name: KQH_MQBRIDGE_SERVICE or KQHMSHISM1
v Attribute group name: MSFT DB2 Access Library
– Table name: KQHMSFTDB2
– Warehouse table name: KQH_MSFT_DB2_ACCESS_LIBRARY or KQHMSFTDB2
v Attribute group name: Performance Object Status
– Table name: KQHPOBJST
– Warehouse table name: KQH_PERFORMANCE_OBJECT_STATUS or KQHPOBJST
v Attribute group name: Session Integrator Server
– Table name: KQHSESSIO1
– Warehouse table name: KQH_SESSION_INTEGRATOR_SERVER or KQHSESSIO1
v Attribute group name: Session Integrator Server PLUs
– Table name: KQHSESSIO2
– Warehouse table name: KQH_SESSION_INTEGRATOR_SERVER_PLUS or KQHSESSIO2
v Attribute group name: SNA 3270 Response Times
– Table name: KQHSNA3270
– Warehouse table name: KQH_SNA_3270_RESPONSE_TIMES or KQHSNA3270
v Attribute group name: SNA APPC Mode
– Table name: KQHMSSNAA0
– Warehouse table name: KQH_SNA_APPC_MODE or KQHMSSNAA0
v Attribute group name: SNA Configured Users
– Table name: KQHMSSNACO
– Warehouse table name: KQH_SNA_CONFIGURED_USERS or KQHMSSNACO
v Attribute group name: SNA Connection Configuration
– Table name: KQHMSSNAC0
– Warehouse table name: KQH_SNA_CONNECTION_CONFIGURATION or KQHMSSNAC0
v Attribute group name: SNA Connections
– Table name: KQHSNACON0
– Warehouse table name: KQH_SNA_CONNECTIONS or KQHSNACON0
v Attribute group name: SNA Domain
– Table name: KQHMSSNAD0
– Warehouse table name: KQH_SNA_DOMAIN or KQHMSSNAD0
v Attribute group name: SNA Domain Topology
– Table name: KQHSNATOPO
– Warehouse table name: KQH_SNA_DOMAIN_TOPOLOGY or KQHSNATOPO
v Attribute group name: SNA Logical Unit Sessions
– Table name: KQHSNALOG0
– Warehouse table name: KQH_SNA_LOGICAL_UNIT_SESSIONS or KQHSNALOG0
v Attribute group name: SNA LU AppcLocal
– Table name: KQHMSSNAAL

Chapter 4. Attributes reference 27

 – Warehouse table name: KQH_SNA_LU_APPCLOCAL or KQHMSSNAAL
v Attribute group name: SNA LU AppcRemote
– Table name: KQHMSSNAAR
– Warehouse table name: KQH_SNA_LU_APPCREMOTE or KQHMSSNAAR
v Attribute group name: SNA LU Display
– Table name: KQHMSSNAL3
– Warehouse table name: KQH_SNA_LU_DISPLAY or KQHMSSNAL3
v Attribute group name: SNA LU LUA
– Table name: KQHMSSNAL2
– Warehouse table name: KQH_SNA_LU_LUA or KQHMSSNAL2
v Attribute group name: SNA LU Print
– Table name: KQHMSSNAL4
– Warehouse table name: KQH_SNA_LU_PRINT or KQHMSSNAL4
v Attribute group name: SNA LU3270
– Table name: KQHMSSNAL0
– Warehouse table name: KQH_SNA_LU3270 or KQHMSSNAL0
v Attribute group name: SNA Pool
– Table name: KQHMSSNAPO
– Warehouse table name: KQH_SNA_POOL or KQHMSSNAPO
v Attribute group name: SNA Pool Display
– Table name: KQHMSSNAP0
– Warehouse table name: KQH_SNA_POOL_DISPLAY or KQHMSSNAP0
v Attribute group name: SNA Print Session
– Table name: KQHMSSNAPR
– Warehouse table name: KQH_SNA_PRINT_SESSION or KQHMSSNAPR
v Attribute group name: SNA Server
– Table name: KQHMSSNAS0
– Warehouse table name: KQH_SNA_SERVER or KQHMSSNAS0
v Attribute group name: SNA Service
– Table name: KQHMSSNA13
– Warehouse table name: KQH_SNA_SERVICE or KQHMSSNA13
v Attribute group name: SNA Service Print
– Table name: KQHMSSNA12
– Warehouse table name: KQH_SNA_SERVICE_PRINT or KQHMSSNA12
v Attribute group name: SNA Service TN3270
– Table name: KQHMSSNA14
– Warehouse table name: KQH_SNA_SERVICE_TN3270 or KQHMSSNA14
v Attribute group name: SNA Service TN5250
– Table name: KQHMSSNA15
– Warehouse table name: KQH_SNA_SERVICE_TN5250 or KQHMSSNA15
v Attribute group name: Status APPC Local LU
– Table name: KQHMSSNAST
– Warehouse table name: KQH_STATUS_APPC_LOCAL_LU or KQHMSSNAST
v Attribute group name: Status APPC Session
– Table name: KQHMSSNAS5

28 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 – Warehouse table name: KQH_STATUS_APPC_SESSION or KQHMSSNAS5
v Attribute group name: Status Client Connection
– Table name: KQHMSSNAS8
– Warehouse table name: KQH_STATUS_CLIENT_CONNECTION or KQHMSSNAS8
v Attribute group name: Status LU3270
– Table name: KQHMSSNAS1
– Warehouse table name: KQH_STATUS_LU3270 or KQHMSSNAS1
v Attribute group name: Status Print Session
– Table name: KQHMSSNAS3
– Warehouse table name: KQH_STATUS_PRINT_SESSION or KQHMSSNAS3
v Attribute group name: Status Service Print
– Table name: KQHMSSNA11
– Warehouse table name: KQH_STATUS_SERVICE_PRINT or KQHMSSNA11
v Attribute group name: Status Service SNA
– Table name: KQHMSSNA10
– Warehouse table name: KQH_STATUS_SERVICE_SNA or KQHMSSNA10
v Attribute group name: Status Service TN3270
– Table name: KQHMSSNAS9
– Warehouse table name: KQH_STATUS_SERVICE_TN3270 or KQHMSSNAS9
v Attribute group name: Status Service TN5250
– Table name: KQHMSSNAS6
– Warehouse table name: KQH_STATUS_SERVICE_TN5250 or KQHMSSNAS6
v Attribute group name: Status SNA Connection
– Table name: KQHMSSNAS4
– Warehouse table name: KQH_STATUS_SNA_CONNECTION or KQHMSSNAS4
v Attribute group name: Status TN3270 Session
– Table name: KQHMSSNAS7
– Warehouse table name: KQH_STATUS_TN3270_SESSION or KQHMSSNAS7
v Attribute group name: Status TN5250 Session
– Table name: KQHMSSNAS2
– Warehouse table name: KQH_STATUS_TN5250_SESSION or KQHMSSNAS2
v Attribute group name: TN3270 Server
– Table name: KQHTN3270S
– Warehouse table name: KQH_TN3270_SERVER or KQHTN3270S
v Attribute group name: Trace SNA Application
– Table name: KQHMSHIST7
– Warehouse table name: KQH_TRACE_SNA_APPLICATION or KQHMSHIST7
v Attribute group name: Trace SNA Base
– Table name: KQHMSHIST1
– Warehouse table name: KQH_TRACE_SNA_BASE or KQHMSHIST1
v Attribute group name: Trace SNA Manage Client
– Table name: KQHMSHISTR
– Warehouse table name: KQH_TRACE_SNA_MANAGE_CLIENT or KQHMSHISTR
v Attribute group name: Trace SNA Mng Agent
– Table name: KQHMSHIST3

Chapter 4. Attributes reference 29

 – Warehouse table name: KQH_TRACE_SNA_MNG_AGENT or KQHMSHIST3
v Attribute group name: Trace SNA NetView
– Table name: KQHMSHIST5
– Warehouse table name: KQH_TRACE_SNA_NETVIEW or KQHMSHIST5
v Attribute group name: Trace SNA Print
– Table name: KQHMSHIST2
– Warehouse table name: KQH_TRACE_SNA_PRINT or KQHMSHIST2
v Attribute group name: Trace SNA Server
– Table name: KQHMSHIST4
– Warehouse table name: KQH_TRACE_SNA_SERVER or KQHMSHIST4
v Attribute group name: Trace SNA Server Manager
– Table name: KQHMSHIST8
– Warehouse table name: KQH_TRACE_SNA_SERVER_MANAGER or KQHMSHIST8
v Attribute group name: Trace TN3270
– Table name: KQHMSHIST9
– Warehouse table name: KQH_TRACE_TN3270 or KQHMSHIST9
v Attribute group name: Trace TN5250
– Table name: KQHMSHIST6
– Warehouse table name: KQH_TRACE_TN5250 or KQHMSHIST6

Attributes in each attribute group

Attributes in each attribute group collect data that the agent uses for monitoring.

The descriptions of the attribute groups contain the following information:

Historical group
Whether the attribute group is a historical type that you can roll off to a data warehouse.
Attribute descriptions
Information such as description, type, source, and warehouse name, as applicable, for each
attribute in the attribute group.
Some attributes are designated as key attributes. A key attribute is an attribute that is used in
warehouse aggregation to identify rows of data that represent the same object.
The Source information sometimes uses C programming code syntax for if-then-else clauses to
describe how an attribute is derived, for example:
(CPU_Pct < 0 ) || (Memory_Pct < 0 )? 0 : 1

This example means that if the CPU_Pct attribute is less than 0 or if the Memory_Pct attribute is
less than 0, then the attribute is set to 0. Otherwise, the attribute is set to 1.

Application Integration HIP attribute group

The Application Integration HIP attributes help you to determine how well the HIS processes requests
from the host system.You can also use these attributes to display details about requests that come from
the host system and HIS processing performance.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Application Integration HIP
attribute group:
Node attribute: This attribute is a key attribute.

30 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Dot Net Methods Executed Per Sec attribute
Description
This attribute displays the number of .NET Server methods that the HIP currently
processes per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\.Net methods
executed / sec.
Warehouse name
NET_METHODS_EXECUTED_SEC or NET_METHOD
Average Dot Net Server Time attribute
Description
This attribute displays the average time that the .NET Server currently takes to
process a request.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Avg .Net Server
time.
Warehouse name
AVG_NET_SERVER_TIME or AVG_NET_SE
Average COM Server Time attribute

Chapter 4. Attributes reference 31

 Description
This attribute displays the average time that the COM Server currently takes to
process a request.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Avg COM
Server time.
Warehouse name
AVG_COM_SERVER_TIME or AVG_COM_SE
Average Unit of Work Time attribute
Description
This attribute displays the average time that the HIP currently takes to process
the host request.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Avg
unit-of-work time.
Warehouse name
AVG_UNIT_OF_WORK_TIME or AVG_UNIT_O
Calls Executing attribute
Description
This attribute displays the number of requests that the HIP is currently
processing.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Calls executing.
Warehouse name
CALLS_EXECUTING or CALLS_EXEC
Count of Errors Per Second attribute
Description
This attribute displays the number of requests that currently failed.

32 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Cnt of errors /
sec.
Warehouse name
CNT_OF_ERRORS_SEC or CNT_OF_ERR
COM Methods Executed Per Second attribute
Description
This attribute displays the number of COM Server methods that the HIP
currently processes per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\COM methods
executed / sec.
Warehouse name
COM_METHODS_EXECUTED_SEC or COM_METHOD
Host Requests Processed Per Second attribute
Description
This attribute displays the total number of host requests that the HIP currently
processes per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Host requests
Processed / sec.
Warehouse name
HOST_REQUESTS_PROCESSED_SEC or HOST_REQUE
Host Requests Queued attribute
Description
This attribute displays the number of host requests that are currently in the
processing queue.

Chapter 4. Attributes reference 33

 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Host requests
queued.
Warehouse name
HOST_REQUESTS_QUEUED or HOST_REQU0
Host Requests Rejected Per Second attribute
Description
This attribute displays the number of host requests that are currently rejected by
the work flow per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Host requests
rejected / sec.
Warehouse name
HOST_REQUESTS_REJECTED_SEC or HOST_REQU1
Total Requests Accepted attribute
Description
This attribute displays the number of requests that the HIP accepts to process
using the work flow since the start of the HIS.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Total requests
accepted.
Warehouse name
TOTAL_REQUESTS_ACCEPTED or TOTAL_REQU
Total Requests Received attribute
Description
This attribute displays the number of requests that the HIP receives since the start
of the HIS.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the

34 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Total requests
received.
Warehouse name
TOTAL_REQUESTS_RECEIVED or TOTAL_REQ0
Work Flow Determinant Starts Per Second attribute
Description
This attribute displays the number of determinant resolved work flow processes
that currently start per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Work Flow
Determinant Starts / sec.
Warehouse name
WORK_FLOW_DETERMINANT_STARTS_SEC or WORK_FLOW_
Work Flow Endpoint Starts Per Second attribute
Description
This attribute displays the number of endpoint resolved work flow processes that
currently start per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Work Flow
Endpoint Starts / sec.
Warehouse name
WORK_FLOW_ENDPOINT_STARTS_SEC or WORK_FLOW0
Work Flow Envelope Starts Per Second attribute
Description
This attribute displays the number of envelope resolved work flow processes that
currently start per second.
Type
Real number (32-bit gauge) with three decimal places of precision with

Chapter 4. Attributes reference 35

 enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Work Flow
Envelope Starts / sec.
Warehouse name
WORK_FLOW_ENVELOPE_STARTS_SEC or WORK_FLOW1
Work Flow Starts Per Second attribute
Description
This attribute displays the number of work flow processes that currently start per
second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Work Flow
Starts / sec.
Warehouse name
WORK_FLOW_STARTS_SEC or WORK_FLOW2
Work Flow TRM Starts Per Second attribute
Description
This attribute displays the number of TRM resolved work flow processes that
currently start per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration HIP\*\Work Flow TRM
Starts / sec.
Warehouse name
WORK_FLOW_TRM_STARTS_SEC or WORK_FLOW3
Kilobytes Received from an SNA Host Per Second attribute
Description
This attribute displays the data in KB that the HIP currently receives from the
mainframe using SNA per second.
Type
Real number (32-bit gauge) with three decimal places of precision with

36 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_recv_d_from_an_SNA_host_sec /
1024.
Warehouse name
KILOBYTES_RECV_D_FROM_AN_SNA_HOST_SEC or KILOBYTES_
Kilobytes Sent to an SNA Host Per Second attribute
Description
This attribute displays the data in KB that the HIP currently sends to the
mainframe using SNA per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_sent_to_an_SNA_host_sec / 1024.
Warehouse name
KILOBYTES_SENT_TO_AN_SNA_HOST_SEC or KILOBYTES0
Kilobytes Received from a TCP/IP Host Per Second attribute
Description
This attribute displays the data in KB that the HIP currently receives from the
mainframe using TCP/IP per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_recv_d_from_a_TCP_IP_host_sec /
1024.
Warehouse name
KILOBYTES_RECV_D_FROM_A_TCP_IP_HOST_SEC or KILOBYTES1
Kilobytes Sent to a TCP/IP Host Per Second attribute
Description
This attribute displays the data in KB that the HIP currently sends to the
mainframe using TCP/IP per second.
Type
Real number (32-bit gauge) with three decimal places of precision with

Chapter 4. Attributes reference 37

 enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_sent_to_a_TCP_IP_host_sec / 1024.
Warehouse name
KILOBYTES_SENT_TO_A_TCP_IP_HOST_SEC or KILOBYTES2
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

Application Integration WIP attribute group

The Application Integration WIP attributes help you to determine how well the HIS processes a request
from the Windows system, attributes will demonstrate details about requests that come from Host system
and processing performance by HIS.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Application Integration WIP
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.

38 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Warehouse name
TIMESTAMP
Average Method Call Time attribute
Description
This attribute measures the average time that Transaction Integrator (TI) WIP
currently takes to process method calls that the client application makes.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Average
method call time.
Warehouse name
AVERAGE_METHOD_CALL_TIME or AVERAGE_ME
Calls Currently Executing attribute
Description
This attribute indicates the number of method calls that are processed since the
start of the server.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Calls currently
executing.
Warehouse name
CALLS_CURRENTLY_EXECUTING or CALLS_CURR
Cumulative Calls attribute
Description
This attribute indicates the total number of method calls that occur after the start
of the COM+ Application (MTS Package).
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Cumulative
calls.
Warehouse name
CUMULATIVE_CALLS or CUMULATIVE

Chapter 4. Attributes reference 39

 Host Response Time CICS Link attribute
Description
This attribute measures the average time that the host currently spends on
processing the transaction program's unit of work, while using the CICS Link
model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Host resp time
CICS Link.
Warehouse name
HOST_RESP_TIME_CICS_LINK or HOST_RESP_
Host Response Time CICS Non Link or IMS attribute
Description
This attribute measures the average time that the host currently spends on
processing the transaction program's unit of work, while using either the CICS
Non-link or IMS models.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Host resp time
CICS Non-link or IMS.
Warehouse name
HOST_RESP_TIME_CICS_NON_LINK_OR_IMS or HOST_RESP0
Host Response Time TCP Concurrent Server attribute
Description
This attribute measures the average time the that host currently spends on
processing the transaction program's unit of work, while using the TCP/IP CICS
Concurrent Server model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

40 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Source
The source for this attribute is Perfmon - App Integration WIP\*\Host resp time
TCP Concurrent Server.
Warehouse name
HOST_RESP_TIME_TCP_CONCURRENT_SERVER or HOST_RESP1
Host Response Time TCP Explicit attribute
Description
This attribute measures the average time that the host currently spends on
processing the transaction program's unit of work, while using the TCP/IP IMS
Explicit model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Host resp time
TCP Explicit.
Warehouse name
HOST_RESP_TIME_TCP_EXPLICIT or HOST_RESP2
Host Response Time TCP Implicit attribute
Description
This attribute measures the average time that the host currently spends on
processing the transaction program's unit of work, while using the TCP/IP IMS
Implicit model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Host resp time
TCP Implicit.
Warehouse name
HOST_RESP_TIME_TCP_IMPLICIT or HOST_RESP3
Host Response Time TCP IMS Connect or OTMA attribute
Description
This attribute measures the average time that the host currently spends on
processing the transaction program's unit of work, while using the TCP/IP IMS
Explicit model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 41

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Host resp time
TCP IMS Connect or OTMA.
Warehouse name
HOST_RESP_TIME_TCP_IMS_CONNECT_OR_OTMA or HOST_RESP4
Host Response Time TCP MSLink attribute
Description
This attribute measures the average time that the host currently spends on
processing the transaction program's unit of work, while using the TCP/IP CICS
MSLink model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Host resp time
TCP MSLink.
Warehouse name
HOST_RESP_TIME_TCP_MSLINK or HOST_RESP5
Link Calls Per Second attribute
Description
This attribute measures the number of method calls that currently use the CICS
Link programming model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Link calls / sec.
Warehouse name
LINK_CALLS_SEC or LINK_CALLS
Non Link Calls Per Second attribute
Description
This attribute measures the number of method calls that currently use the CICS
Non-link or IMS programming model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

42 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Non-link calls /
sec.
Warehouse name
NON_LINK_CALLS_SEC or NON_LINK_C
TCP Concurrent Server Calls Per Second attribute
Description
This attribute measures the number of method calls that currently use the TCP/IP
CICS Concurrent Server programming model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\TCP Concurrent
Server calls / sec.
Warehouse name
TCP_CONCURRENT_SERVER_CALLS_SEC or TCP_CONCUR
TCP Explicit Calls Per Second attribute
Description
This attribute measures the number of method calls per second that currently use
the TCP/IP IMS Explicit programming model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\TCP Explicit
calls / sec.
Warehouse name
TCP_EXPLICIT_CALLS_SEC or TCP_EXPLIC
TCP Implicit Calls Per Second attribute
Description
This attribute measures the number of method calls per second that currently use
the TCP/IP IMS Implicit programming model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 43

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\TCP Implicit
calls / sec.
Warehouse name
TCP_IMPLICIT_CALLS_SEC or TCP_IMPLIC
TCP IMS Connect or OTMA calls sec attribute
Description
This attribute measures the number of method calls per second that currently use
the TCP/IP IMS Connect or OTMA programming model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\TCP IMS
Connect or OTMA calls / sec.
Warehouse name
TCP_IMS_CONNECT_OR_OTMA_CALLS_SEC or TCP_IMS_CO
TCP MSLink Calls Per Second attribute
Description
This attribute measures the number of method calls per second that currently use
the TCP/IP CICS MSLink programming model.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\TCP MSLink
calls / sec.
Warehouse name
TCP_MSLINK_CALLS_SEC or TCP_MSLINK
Total Calls Per Second attribute
Description
This attribute indicates the total number of method calls that TI WIP currently
processes per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

44 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Total calls / sec.
Warehouse name
TOTAL_CALLS_SEC or TOTAL_CALL
Total Errors Per Second attribute
Description
This attribute indicates the total number of method calls that currently return a
non-zero HRESULT indication to the client application per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - App Integration WIP\*\Total errors /
sec.
Warehouse name
TOTAL_ERRORS_SEC or TOTAL_ERRO
Kilobytes Received from an SNA Host Per Second attribute
Description
This attribute indicates the rate at which the TI WIP currently receives data in KB
from the mainframe using SNA.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_recv_d_from_an_SNA_host_sec /
1024.
Warehouse name
KILOBYTES_RECV_D_FROM_AN_SNA_HOST_SEC or KILOBYTES_
Kilobytes Sent to an SNA Host Per Second attribute
Description
This attribute indicates the rate at which the TI WIP currently sends data in KB to
the mainframe using SNA.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 45

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_sent_to_an_SNA_host_sec / 1024.
Warehouse name
KILOBYTES_SENT_TO_AN_SNA_HOST_SEC or KILOBYTES0
Kilobytes Received from a TCP Host Per Second attribute
Description
This attribute indicates the rate at which the TI WIP currently receives data in KB
from the mainframe using TCP/IP.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_recv_d_from_a_TCP_host_sec /
1024.
Warehouse name
KILOBYTES_RECV_D_FROM_A_TCP_HOST_SEC or KILOBYTES1
Kilobytes Sent to a TCP Host Per Second attribute
Description
This attribute indicates the rate at which the TI WIP currently sends data in KB to
the mainframe using TCP/IP.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_sent_to_a_TCP_host_sec / 1024.
Warehouse name
KILOBYTES_SENT_TO_A_TCP_HOST_SEC or KILOBYTES2
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String

46 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Source
The source for this attribute is PerfMon.
Warehouse name
NAME

Availability attribute group

The Availability attribute group contains the availability data for all processes and services that make up
this application.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Availability attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Application Component attribute: This attribute is a key attribute.
Description
The descriptive name of a part of the application.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
APPLICATION_COMPONENT or COMPONENT
Name attribute
Description
The name of the process, service, or functionality test. This name matches the
executable name of the process, the service short name or the name of the process
used to test the application.
Type
String with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v N/A (N/A)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is the agent.
Warehouse name
NAME

Chapter 4. Attributes reference 47

 Status attribute
Description
The status of the application component.
v For processes 'UP', 'DOWN', 'WARNING', or
'PROCESS_DATA_NOT_AVAILABLE': 'PROCESS_DATA_NOT_AVAILABLE' is
displayed for a process when the matching process is running but the resource
use information cannot be collected for that process.
v For services 'UP', 'DOWN', or 'UNKNOWN': 'UNKNOWN' is displayed when
the service is not installed.
v For functionality tests: 'PASSED' or 'FAILED' is displayed.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v DOWN (0)
v UP (1)
v WARNING (2)
v UNKNOWN (3)
v PASSED (4)
v FAILED (5)
v PROCESS DATA NOT AVAILABLE (6)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is the agent.
Warehouse name
STATUS
Full Name attribute
Description
The full name of the process including the path.
Type
String with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v N/A (N/A)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is collected from the operating system. The data is
gathered from the Windows process. The data is limited to 256 bytes.
Warehouse name
FULL_NAME or FULLNAME
Type attribute
Description
The type of the application component. Components are processes, services, or
functionality tests.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v PROCESS (0)
v SERVICE (1)
v FUNCTIONALITY TEST (2)

48 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is the agent.
Warehouse name
TYPE
Virtual Size attribute
Description
The virtual size (in MB) of the process.
Type
Integer (32-bit gauge)
Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - Private Bytes. .
Warehouse name
VIRTUAL_SIZE or VIRTSIZE
Page Faults per Sec attribute
Description
The rate of page faults for the process measured in faults per second. This
attribute only contains valid data for processes.
Type
Integer (32-bit gauge)
Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - Page Faults/sec. .
Warehouse name
PAGE_FAULTS_PER_SEC or PAGEFAULTS
Working Set Size attribute
Description
The working set size of the process in MB. This attribute only contains valid data
for processes.
Type
Integer (32-bit gauge)
Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - Working Set. .
Warehouse name
WORKING_SET_SIZE or WORKSET
Thread Count attribute
Description
The number of threads currently allocated by this process. This attribute only
contains valid data for processes.
Type
Integer (32-bit gauge)
Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - Thread Count. .
Warehouse name
THREAD_COUNT or THREADS
PID attribute
Description
The process ID associated with the process. This attribute only contains valid data
for processes.
Type
Integer (32-bit gauge)

Chapter 4. Attributes reference 49

 Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - ID Process. .
Warehouse name
PID
Percent Privileged Time attribute
Description
The percentage of the available CPU time that is being used by this process for
privileged operation.
Type
Integer (32-bit gauge)
Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - % Privileged Time. .
Warehouse name
PERCENT_PRIVILEGED_TIME or PERCPRIV
Percent User Mode Time attribute
Description
The percentage of the available CPU time that is being used by this process for
user mode operation.
Type
Integer (32-bit gauge)
Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - % User Time. .
Warehouse name
PERCENT_USER_MODE_TIME or PERCUSER
Percent Processor Time attribute
Description
The percentage of the elapsed time that this process used the processor to execute
instructions.
Type
Integer (32-bit gauge)
Source
The source for this attribute is Collected from the operating system. It is gathered
from the Perfmon counter Process - % Processor Time. .
Warehouse name
PERCENT_PROCESSOR_TIME or PERCPROC
Command Line attribute
Description
The program name and any arguments specified on the command line when the
process was started. This has the value N/A if this is a Service, or Functionality
test.
Type
String with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v N/A (N/A)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Collected from the operating system. It is gathered
from the process. .
Warehouse name
COMMAND_LINE or CMDLINE

50 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Functionality Test Status attribute
Description
The return code of the functionality test. When the monitored application is
running correctly, 'SUCCESS' is displayed. 'NOT_RUNNING' is displayed when it
is not running correctly. 'N/A' is displayed when the row does not represent a
functionality test.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v SUCCESS (0)
v N/A (1)
v GENERAL ERROR (2)
v WARNING (3)
v NOT RUNNING (4)
v DEPENDENT NOT RUNNING (5)
v ALREADY RUNNING (6)
v PREREQ NOT RUNNING (7)
v TIMED OUT (8)
v DOESNT EXIST (9)
v UNKNOWN (10)
v DEPENDENT STILL RUNNING (11)
v INSUFFICIENT USER AUTHORITY (12)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is the agent.
Warehouse name
FUNCTIONALITY_TEST_STATUS or FUNCSTATUS
Functionality Test Message attribute
Description
The text message that corresponds to the Functionality Test Status. This is only
valid for functionality tests.
Type
String with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v N/A (N/A)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is the agent.
Warehouse name
FUNCTIONALITY_TEST_MESSAGE or FUNCMSG

Event Log attribute group

The Event Log attribute group contains any event log entries that pertain to this application.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Event Log attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.

Chapter 4. Attributes reference 51

 Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Log Name attribute
Description
The name of the event log - Application, System, Security or an
application-specific log
Type
String
Warehouse name
LOG_NAME or LOGNAME
Event Source attribute
Description
The event source defined by the application
Type
String
Warehouse name
EVENT_SOURCE or EVTSOURCE
Event Type attribute
Description
Event Type - Error(0), Warning(1), Informational(2), Audit_Success(3),
Audit_Failure(4), Unknown(5)
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Error (0)
v Warning (1)
v Informational (2)
v Audit Success (3)
v Audit Failure (4)
v Unknown (5)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
EVENT_TYPE or EVTTYPE
Event ID attribute
Description
The ID of the event
Type
Integer (32-bit counter)
Warehouse name
EVENT_ID or EVTID
Event Category attribute
Description
The Category of the event
Type
String with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v None (None)

52 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
EVENT_CATEGORY or EVTCATEG
Message attribute
Description
The event message
Type
String
Warehouse name
MESSAGE
Time Generated attribute
Description
The time the event was generated
Type
Timestamp
Warehouse name
TIME_GENERATED or TIMESTAMP

HIS Databases attribute group

This attribute group displays information about the HIP, Data Integration, and ENTSSO for Microsoft HIS
databases.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the HIS Databases attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Database Name attribute
Description
This attribute displays the name of the database.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
DATABASENAME or DATABASENM
Server attribute

Chapter 4. Attributes reference 53

 Description
This attribute displays the name of the server that contains the database.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
SERVER or SERVER01
Database Type attribute: This attribute is a key attribute.
Description
This attribute displays the types of database; the possible values are SSO, HIP, or
DI.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
DATABASETYPE or DATABASETY
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

HIS Information attribute group

This attribute group displays about HIS information
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the HIS Information attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Product Name attribute: This attribute is a key attribute.

54 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Description
The name of HIS.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
PRO_NAME
Product Version attribute
Description
The version of HIS.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
PRO_VER
Role attribute
Description
This attribute indicates whether the HIS is a client or a server.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
ROLE
Is Configured attribute
Description
This attribute indicates whether the HIS is configured.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
ISCONFIGURED or ISCON

HIS Tracing attribute group

The MSHIS Tracing attribute group displays the tracing information about HIS components.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the HIS Tracing attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.

Chapter 4. Attributes reference 55

 Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Class Name attribute: This attribute is a key attribute.
Description
This attribute displays the WMI class name for a particular component.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
CLASSNAME
Internal Message Trace attribute
Description
This attribute shows that, is internal message trace is enabled or not.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Enabled (1)
v Disabled (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Script data.
Warehouse name
INTERNALMESSAGETRACE or INTERNALMS
Fatal Trace attribute
Description
This attribute checks whether the fatal error trace mask is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Enabled (1)
v Disabled (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Script data.
Warehouse name
FATALTRACE or FATALERROR
Traces attribute
Description
This attribute checks whether the traces is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Enabled (1)
v Disabled (0)

56 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Script data.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Link Service attribute group

This attribute group displays information about Link Service configuration.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Link Service attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
DllName attribute
Description
This attribute represents the name of the Dynamic Link Library (DLL) that
implements the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkServiceDllName.
Warehouse name
DLLNAME
Domain attribute
Description
This attribute represents the domain of the link service.

Chapter 4. Attributes reference 57

 Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkServiceDomain.
Warehouse name
DOMAIN
DriverName attribute
Description
This attribute represents the device driver that is associated with the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkServiceDriverName.
Warehouse name
DRIVERNAME
IsRemotable attribute
Description
This attribute checks whether the link service is used from a remote node.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkServiceIsRemotable.
Warehouse name
ISREMOTABLE or ISREMOTABL
Name attribute: This attribute is a key attribute.
Description
This attribute displays the link server name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkServiceName.
Warehouse name
NAME
Title attribute
Description
This attribute displays the title of the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_LinkServiceTitle.
Warehouse name
TITLE
Type attribute
Description
This attribute displays the type of the link service.

58 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v SDLC (3)
v X25 (4)
v DFT (10)
v DLC8022 (11)
v TWINAX (31)
v CHANNEL (32)
v IPDLC (35)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkServiceType.
Warehouse name
TYPE
User attribute
Description
This represents the user who can authenticate the addition of a link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_LinkServiceUser.
Warehouse name
USER

Link Service Distributed attribute group

This attribute group provides the configuration details for the Distributed Link Services.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Link Service Distributed
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Service Name attribute: This attribute is a key attribute.

Chapter 4. Attributes reference 59

 Description
This attribute displays the name of the service.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
SERVICE_NAME or SLSNAME
Service Title attribute
Description
This attribute displays the title of the link service.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
SERVICE_TITLE or TITLE
DLL Name attribute
Description
This attribute displays the name of the Dynamic Link Library (DLL) that
implements the link service.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
DLL_NAME or DLLNAME
Description attribute
Description
This attribute displays information about the link service.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
DESCRIPTION or DESCRIP
System Name attribute
Description
This attribute displays the name of the system on which the link service is
installed.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Link Service IPDLC attribute group

This attribute group displays information about Link Service IPDLC configuration.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Link Service IPDLC attribute
group:
Node attribute: This attribute is a key attribute.

60 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Activation Delay Timer attribute
Description
This attribute displays the current value of the activation delay timer.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcActivationDelayTimer.
Warehouse name
ACTIVATIONDELAYTIMER or ACTIVATION
Address Type attribute
Description
This attribute displays the type of the local address, the types are ADAPTER or
STATICIP.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v ADAPTER (1)
v STATICIP (2)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcAddressType.
Warehouse name
ADDRESSTYPE or ADDRESSTYP
Backup NNS attribute
Description
This attribute displays a list of backup Network Node Servers (NNS) that ia
separated by semicolons.

Chapter 4. Attributes reference 61

 Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcBackupNNS.
Warehouse name
BACKUPNNS
CMD Maximum Retry attribute
Description
This attribute displays the maximum number of attempts currently used while
connecting to the server.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcCMDMaxRetry.
Warehouse name
CMDMAXRETRY or CMDMAXRETR
CPName attribute
Description
This attribute displays the Control Point name of the Branch Network Node.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcCPName.
Warehouse name
CPNAME
DllName attribute
Description
This attribute displays the device driver that is associated with the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcDllName.
Warehouse name
DLLNAME
Domain attribute
Description
This attribute displays the domain of the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcDomain.
Warehouse name
DOMAIN
DriverName attribute

62 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Description
This attribute represents the device driver that is associated with the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcDriverName.
Warehouse name
DRIVERNAME
IsRemotable attribute
Description
This attribute checks whether the link service on the server is used from a remote
node.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcIsRemotable.
Warehouse name
ISREMOTABLE or ISREMOTABL
LENNode attribute
Description
This attribute displays the name of the associated Low Entry Network (LEN)
node.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcLENNode.
Warehouse name
LENNODE
Livetime Timeout attribute
Description
This attribute displays the livetime timeout of the link service.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcLivetimeTimeout.
Warehouse name
LIVETIMETIMEOUT or LIVETIMETI
Local Address attribute

Chapter 4. Attributes reference 63

 Description
This attribute displays the local network adapter or address.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcLocalAddress.
Warehouse name
LOCALADDRESS or LOCALADDRE
Maximum Activation Attempts attribute
Description
This attribute displays the number of maximum activation attempts.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcMaxActivationAttempts.
Warehouse name
MAXACTIVATIONATTEMPTS or MAXACTIVAT
Maximum BTU Receive attribute
Description
This attribute displays the value of MaxBTUReceive (max basic Transmission
Unit) that the client currently receives.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcMaxBTUReceive.
Warehouse name
MAXBTURECEIVE or MAXBTURECE
Maximum BTU Send attribute
Description
This attribute displays the value of MaxBTUSend (max basic Transmission Unit)
that the client currently sends.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

64 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcMaxBTUSend.
Warehouse name
MAXBTUSEND
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the link service that is assigned automatically.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcName.
Warehouse name
NAME
NetworkName attribute
Description
This attribute displays the network name of the Branch Network Node that is
implemented by the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcNetworkName.
Warehouse name
NETWORKNAME or NETWORKNAM
NodeID attribute
Description
This attribute displays the identity of the branch Network Node.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcNodeID.
Warehouse name
NODEID
No Preferred NNS attribute
Description
This attribute checks whether the use of first available network node server is
enabled.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcNoPreferredNNS.
Warehouse name
NOPREFERREDNNS or NOPREFERRE
PrimaryNNS attribute

Chapter 4. Attributes reference 65

 Description
This attribute displays the name of the primary NNS server.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcPrimaryNNS.
Warehouse name
PRIMARYNNS
Receive Acknowledge Timeout attribute
Description
This attribute displays the current timeout value for receipt acknowledgement.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcReceiveAckTimeout.
Warehouse name
RECEIVEACKTIMEOUT or RECEIVEACK
ResolvedIP attribute
Description
This attribute displays the resolved IP address or the local address of the network
adapter.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcResolvedIP.
Warehouse name
RESOLVEDIP
Title attribute
Description
This attribute displays the title of the link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcTitle.
Warehouse name
TITLE
Type attribute
Description
This attribute displays the type of the link service.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v SDLC (3)
v X25 (4)

66 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 v DFT (10)
v DLC8022 (11)
v TWINAX (31)
v CHANNEL (32)
v IPDLC (35)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcType.
Warehouse name
TYPE
Use Dynamic PU Definition attribute
Description
This attribute checks whether the dynamic PU (Physical Unit) is used by the
server.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcUseDynamicPuDefinition.
Warehouse name
USEDYNAMICPUDEFINITION or USEDYNAMIC
User attribute
Description
This attribute displays the user that authenticates the addition of a link service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcUser.
Warehouse name
USER
Delayed Path Switch Timer attribute
Description
This attribute indicates the delay that currently occurs (in seconds) on a High
Performance Routing (HPR) path switch if an outage has been detected on the
HPR link.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 67

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcDelayedPathSwitchTimer.
Warehouse name
DELAYED_PATH_SWITCH_TIMER or DELAYSWTIM
Disable Progressive ARB attribute
Description
This attribute indicates that the link service must use the Responsive Mode
Adaptive Rate-Based (ARB) flow control alogorithm instead of the Progressive
Mode ARB flow control algorithm to communicate with the host.
Type
Integer (32-bit numeric property) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and queries return the
values that are shown in parentheses. The following values are defined:
v TRUE (1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcDisableProgressiveARB.
Warehouse name
DISABLE_PROGRESSIVE_ARB or DISABLEARB
Use IPv6 attribute
Description
This attribute indicates that the link service must use the IPv6 protocol to
communicate with the host.
Type
Integer (32-bit numeric property) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and queries return the
values that are shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcUseIPv6.
Warehouse name
USE_IPV6 or USEIPV6
VRN Not Limited Resource attribute
Description
This attribute indicates that the links that use the Virtual Routing Node (VRN)
are not a limited resource, and therefore the links are not automatically
deactivated if no traffic occurs for a specific duration.
Type
Integer (32-bit numeric property) with enumerated values. The strings are
displayed in the Tivoli Enterprise Portal. The warehouse and queries return the
values that are shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

68 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LinkService_IpDlcVRNNotLimitedResource.
Warehouse name
VRN_NOT_LIMITED_RESOURCE or VRNNOTLTDR

Link Service SDLC attribute group

This attribute group provides the configuration details for the Link Service SDLC.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Link Service SDLC attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Service Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the service.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
SERVICE_NAME or SLSNAME
Service Title attribute
Description
This attribute displays the title of the link service.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
SERVICE_TITLE or TITLE
DLL Name attribute
Description
This attribute displays the name of the Dynamic Link Library (DLL) that
implements the link service.
Type
String

Chapter 4. Attributes reference 69

 Source
The source for this attribute is Script data.
Warehouse name
DLL_NAME or DLLNAME
Description attribute
Description
This attribute displays information about the link service.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
DESCRIPTION or DESCRIP
System Name attribute
Description
This attribute displays the name of the system on which the link service is
installed.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Managed Application Integration attribute group

This attribute group displays the average time that TI WIP takes to process method calls that are made
by the client application.The time begins when TI receives the request from the client and ends when TI
returns control to the client.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Managed Application
Integration attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Average Host Response Time attribute
Description
This attribute displays the average host response time.

70 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Managed Application Integration
WIP\*\Average host response time.
Warehouse name
AVERAGE_HOST_RESPONSE_TIME or AVERAGE_HO
Average Method Call Time attribute
Description
This attribute displays the average time in milliseconds that the TI WIP currently
takes to process method calls that are made by the client application.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Managed Application Integration
WIP\*\Average method call time.
Warehouse name
AVERAGE_METHOD_CALL_TIME or AVERAGE_ME
Calls Currently Executing attribute
Description
This attribute displays the number of method calls that are currently running.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Managed Application Integration
WIP\*\Calls currently executing.
Warehouse name
CALLS_CURRENTLY_EXECUTING or CALLS_CURR
Cumulative Calls attribute
Description
This attribute displays the total number of calls that occur after the TI Application
starts.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the

Chapter 4. Attributes reference 71

 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Managed Application Integration
WIP\*\Cumulative calls.
Warehouse name
CUMULATIVE_CALLS or CUMULATIVE
Total Calls Per Second attribute
Description
This attribute displays the total number of method calls that TI WIP currently
processes per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Managed Application Integration
WIP\*\Total calls / sec.
Warehouse name
TOTAL_CALLS_SEC or TOTAL_CALL
Total Errors Per Second attribute
Description
This attribute displays the total number of method calls that currently return a
non-zero HRESULT indication to the client application per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Managed Application Integration
WIP\*\Total errors / sec.
Warehouse name
TOTAL_ERRORS_SEC or TOTAL_ERRO
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").

72 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

MQBridge attribute group

This attribute group displays details about the transactional and the non-transactional threads.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Gateway Starting Time in millisec attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the gateway in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge\*\Gateway Starting Time.
Warehouse name
GATEWAY_STARTING_TIME or GATEWAY_ST
MQS to MSMQ Threads attribute

Chapter 4. Attributes reference 73

 Description
This attribute displays the number of MQSeries to MSMQ Non-Tx channel
threads that are currently active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge\*\MQS to MSMQ Threads.
Warehouse name
MQS_TO_MSMQ_THREADS or MQS_TO_MSM
MQS to MSMQ Transacted Threads attribute
Description
This attribute displays the number of MQSeries to MSMQ Tx channel threads that
are currently active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge\*\MQS to MSMQ Tx
Threads.
Warehouse name
MQS_TO_MSMQ_TX_THREADS or MQS_TO_MS0
MSMQ to MQS Threads attribute
Description
This attribute displays the number of MSMQ to MQSeries Non-Tx channel
threads that are currently active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge\*\MSMQ to MQS Threads.
Warehouse name
MSMQ_TO_MQS_THREADS or MSMQ_TO_MQ
MSMQ to MQS Transacted Threads attribute
Description
This attribute displays the number of MSMQ to MQSeries Tx channel threads that
are currently active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the

74 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge\*\MSMQ to MQS Tx
Threads.
Warehouse name
MSMQ_TO_MQS_TX_THREADS or MSMQ_TO_M0
Gateway Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the gateway in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Gateway_Starting_Time / 1000.
Warehouse name
GATEWAY_STARTING_TIME_IN_SECONDS or GATEWAY_S0
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

MQBridge Channel attribute group

This attribute group displays details about the MQBridge Channel configuration.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge Channel attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute

Chapter 4. Attributes reference 75

 Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
LU62 Side Info Record attribute
Description
This attribute displays the CPI-C symbolic name that is defined with HIS that
uses the SNA LU 6.2 transport.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ChannelLU62SideInfoRecord.
Warehouse name
LU62SIDEINFORECORD or LU62SIDEIN
MCA User attribute
Description
This attribute displays the existing or new MQSeries user name that is used to
run the server side of the MQI channel.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ChannelMcaUser.
Warehouse name
MCAUSER
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the computer.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ChannelName.
Warehouse name
NAME
Queue Manager Name attribute
Description
This attribute displays the name of MQSeries Queue Manager that connects with
the channel.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ChannelQueueManagerName.
Warehouse name
QUEUEMANAGERNAME or QUEUEMANAG
TCP Address attribute
Description
This attribute displays the TCP/IP address that is used with the TCP/IP transport
of the MQSeries listener.

76 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ChannelTCPAddress.
Warehouse name
TCPADDRESS
TCP Port attribute
Description
This attribute displays the TCP/IP port that is used with the TCP/IP transport of
the MQSeries listener.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ChannelTCPPort.
Warehouse name
TCPPORT
Transport Type attribute
Description
This attribute displays the type of the currently used transport and the possible
values are LU 6.2 or TCP/IP.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TCP/IP (2)
v LU6.2 (1)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ChannelTransportType.
Warehouse name
TRANSPORTTYPE or TRANSPORTT

MQBridge Connected Network attribute group

This attribute group displays the details about the MQBridge Connected Network configuration.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge Connected Network
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.

Chapter 4. Attributes reference 77

 Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
MQSeries QMNGR attribute
Description
This attribute displays the CN connected MQSeries Queue manager.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ConnectedNetworkMQSeriesQMNGR.
Warehouse name
MQSERIESQMNGR or MQSERIESQM
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the computer.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ConnectedNetworkName.
Warehouse name
NAME
Reply to Queue Manager attribute
Description
This attribute displays the default MSMQ QM to which the MQSeries returns the
report or acknowledgement.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ConnectedNetworkReplyToQMNGR.
Warehouse name
REPLYTOQMNGR or REPLYTOQMN
Startup attribute
Description
This attribute checks whether the MSMQ MQSeries is enabled at the start.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ConnectedNetworkStartup.
Warehouse name
STARTUP

78 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
MQBridge Message Pipe attribute group
This attribute group displays details about the MQBridge MessagePipe configuration.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge Message Pipe
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Cache Refresh attribute
Description
This attribute displays the maximum time currently required to group messages
in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeCacheReresh.
Warehouse name
CACHERERESH or CACHERERES
Long Retry Count attribute
Description
This attribute displays the maximum number of attempts that are currently used
for the long retry cycle.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 79

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeLongRetryCount.
Warehouse name
LONGRETRYCOUNT or LONGRETRYC
Long Retry Delay attribute
Description
This attribute displays the interval between the attempts that are currently used
for the long retry cycle.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeLongRetryDelay.
Warehouse name
LONGRETRYDELAY or LONGRETRYD
Maximum Message Count attribute
Description
This attribute displays the maximum number of messages that are currently in a
batch.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeMaxMessageCount.
Warehouse name
MAXMESSAGECOUNT or MAXMESSAGE
Maximum Message Size attribute
Description
This attribute displays the maximum size of the current batch in bytes.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeMaxMessageSize.

80 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Warehouse name
MAXMESSAGESIZE or MAXMESSAG0
Maximum Time attribute
Description
This attribute displays the time interval that the message pipes currently use to
check for Cache Timeout in minutes.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeMaxTime.
Warehouse name
MAXTIME
Short Retry Count attribute
Description
This attribute displays the maximum number of attempts that are currently used
for the short retry cycle.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeShortRetryCount.
Warehouse name
SHORTRETRYCOUNT or SHORTRETRY
Short Retry Delay attribute
Description
This attribute displays the interval between the attempts that are currently used
for the short retry cycle.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeShortRetryDelay.
Warehouse name
SHORTRETRYDELAY or SHORTRETR0
Startup attribute

Chapter 4. Attributes reference 81

 Description
This attribute checks whether the MSMQ-MQ Bridge startup is enabled.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeStartup.
Warehouse name
STARTUP
Transmit Queue attribute
Description
This attribute displays the unique MQSeries transmission queue name for the
pipe.The Default name is CN name and XMITQ for the transactional message
pipe and CN name and XMITQ HIGH for the non-transactional message pipe.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_MessagePipeTransmitQueue.
Warehouse name
TRANSMITQUEUE or TRANSMITQU
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

MQBridge MQS to MSMQ attribute group

This attribute group displays the details about the data that is moved over a channel, the status, and the
queue depth for non-transactional messaging from IBM MQSeries to MS MQ.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge MQS to MSMQ
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute

82 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
MQS Queue Depth attribute
Description
This attribute displays the number of messages that are currently in the MQSeries
transmission queue.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ\*\MQS
Queue Depth.
Warehouse name
MQS_QUEUE_DEPTH or MQS_QUEUE_
Message Count attribute
Description
This attribute displays the total messages that moved on the channel since the
start of HIS.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ\*\Msg
Count.
Warehouse name
MSG_COUNT
Starting Retry Count attribute
Description
This attribute displays the number of attempts that are currently used to start a
message pipe.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 83

 Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ\*\Starting
Retry Count.
Warehouse name
STARTING_RETRY_COUNT or STARTING_R
Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ\*\Starting
Time.
Warehouse name
STARTING_TIME or STARTING_T
Status attribute
Description
This attribute displays the current status of the channel.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ\*\Status.
Warehouse name
STATUS
Suspension Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ\*\
Suspension Starting Time.
Warehouse name
SUSPENSION_STARTING_TIME or SUSPENSION

84 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
Suspension Time attribute
Description
This attribute displays the current suspension time of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ\*\
Suspension Time.
Warehouse name
SUSPENSION_TIME or SUSPENSIO0
Kilobyte Count attribute
Description
This attribute displays the data in KB that has moved on the channel since the
start of the HIS.
Type
Real number (64-bit counter) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return the values that
are shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Byte_Count / 1024.
Warehouse name
KILO_BYTE_COUNT or KILO_BYTE_
Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Starting_Time / 1000.
Warehouse name
STARTING_TIME_IN_SECONDS or STARTING_0
Suspension Time in seconds attribute
Description
This attribute displays the current suspension time of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the

Chapter 4. Attributes reference 85

 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Time / 1000.
Warehouse name
SUSPENSION_TIME_IN_SECONDS or SUSPENSIO1
Suspension Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Starting_Time / 1000.
Warehouse name
SUSPENSION_STARTING_TIME_IN_SECONDS or SUSPENSIO2
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

MQBridge MQS to MSMQ Tx attribute group

This attribute group displays the details for the data that moves on the channel, the status, and the queue
depth for transactional messaging from IBM MQSeries to MSMQ.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge MQS to MSMQ Tx
attribute group:
Node attribute: This attribute is a key attribute.

86 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
MQS Queue Depth attribute
Description
This attribute displays the number of messages that are currently in the MQSeries
transmission queue.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ Tx\*\MQS
Queue Depth.
Warehouse name
MQS_QUEUE_DEPTH or MQS_QUEUE_
Message Count attribute
Description
This attribute displays the total messages that has moved on the channel since the
start of the HIS.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ Tx\*\Msg
Count.
Warehouse name
MSG_COUNT
Starting Retry Count attribute
Description
This attribute displays the number of attempts that are currently used to start the
message pipe.

Chapter 4. Attributes reference 87

 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ
Tx\*\Starting Retry Count.
Warehouse name
STARTING_RETRY_COUNT or STARTING_R
Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ
Tx\*\Starting Time.
Warehouse name
STARTING_TIME or STARTING_T
Status attribute
Description
This attribute displays the current status of the channel.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ Tx\*\Status.
Warehouse name
STATUS
Suspension Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)

88 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ
Tx\*\Suspension Starting Time.
Warehouse name
SUSPENSION_STARTING_TIME or SUSPENSION
Suspension Time attribute
Description
This attribute displays the current suspension time of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MQS to MSMQ
Tx\*\Suspension Time.
Warehouse name
SUSPENSION_TIME or SUSPENSIO0
Kilobyte Count attribute
Description
This attribute displays the total data in KB that has moved on the channel since
the start of the HIS.
Type
Real number (64-bit counter) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return the values that
are shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Byte_Count / 1024.
Warehouse name
KILO_BYTE_COUNT or KILO_BYTE_
Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Starting_Time / 1000.

Chapter 4. Attributes reference 89

 Warehouse name
STARTING_TIME_IN_SECONDS or STARTING_0
Suspension Time in seconds attribute
Description
This attribute displays the current suspension time of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Time / 1000.
Warehouse name
SUSPENSION_TIME_IN_SECONDS or SUSPENSIO1
Suspension Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Starting_Time / 1000.
Warehouse name
SUSPENSION_STARTING_TIME_IN_SECONDS or SUSPENSIO2
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

90 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
MQBridge MSMQ to MQS attribute group
This attribute group displays the details for the data that moves on the channel, the status and the queue
depth for non-transactional messaging from MS MQ to IBM MQSeries.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge MSMQ to MQS
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
MQS Queue Depth attribute
Description
This attribute displays the number of messages that are currently in the MQSeries
transmission queue.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS\*\MQS
Queue Depth.
Warehouse name
MQS_QUEUE_DEPTH or MQS_QUEUE_
Message Count attribute
Description
This attribute displays the total messages that move on the channel since the start
of the HIS.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)

Chapter 4. Attributes reference 91

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS\*\Msg
Count.
Warehouse name
MSG_COUNT
Starting Retry Count attribute
Description
This attribute displays the number of attempts that are currently used to start the
message pipe.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS\*\Starting
Retry Count.
Warehouse name
STARTING_RETRY_COUNT or STARTING_R
Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS\*\Starting
Time.
Warehouse name
STARTING_TIME or STARTING_T
Status attribute
Description
This attribute displays the current status of the channel.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS\*\Status.

92 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Warehouse name
STATUS
Suspension Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to
MQS\*\Suspension Starting Time.
Warehouse name
SUSPENSION_STARTING_TIME or SUSPENSION
Suspension Time attribute
Description
This attribute displays the current suspension time of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to
MQS\*\Suspension Time.
Warehouse name
SUSPENSION_TIME or SUSPENSIO0
Kilobyte Count attribute
Description
This attribute displays the total data in KB that has moved on the channel since
the start of the HIS.
Type
Real number (64-bit counter) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return the values that
are shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Byte_Count / 1024.
Warehouse name
KILO_BYTE_COUNT or KILO_BYTE1
Starting Time in seconds attribute

Chapter 4. Attributes reference 93

 Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Starting_Time / 1000.
Warehouse name
STARTING_TIME_IN_SECONDS or STARTING_1
Suspension Time in seconds attribute
Description
This attribute displays the current suspension time of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Time / 1000.
Warehouse name
SUSPENSION_TIME_IN_SECONDS or SUSPENSIO2
Suspension Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Starting_Time / 1000.
Warehouse name
SUSPENSION_STARTING_TIME_IN_SECONDS or SUSPENSIO3
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").

94 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

MQBridge MSMQ to MQS Tx attribute group

This attribute group displays the details for the data that moves over the channel, the status, and the
queue depth for transactional messaging from MS MQ to IBM MQSeries.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge MSMQ to MQS Tx
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
MQS Queue Depth attribute
Description
This attribute displays the number of messages that are currently in the MQSeries
transmission queue.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS Tx\*\MQS
Queue Depth.
Warehouse name
MQS_QUEUE_DEPTH or MQS_QUEUE_

Chapter 4. Attributes reference 95

 Message Count attribute
Description
This attribute displays the total number of messages that move on the channel
since the start of the HIS.
Type
Integer (64-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)
v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS Tx\*\Msg
Count.
Warehouse name
MSG_COUNT
Starting Retry Count attribute
Description
This attribute displays the number of attempts that are currently used to start the
message pipe.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS
Tx\*\Starting Retry Count.
Warehouse name
STARTING_RETRY_COUNT or STARTING_R
Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS
Tx\*\Starting Time.
Warehouse name
STARTING_TIME or STARTING_T
Status attribute
Description
This attribute displays the current status of the channel.

96 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS Tx\*\Status.
Warehouse name
STATUS
Suspension Starting Time attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS
Tx\*\Suspension Starting Time.
Warehouse name
SUSPENSION_STARTING_TIME or SUSPENSION
Suspension Time attribute
Description
This attribute displays the current suspension time of the channel in milliseconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MQBridge:MSMQ to MQS
Tx\*\Suspension Time.
Warehouse name
SUSPENSION_TIME or SUSPENSIO0
Kilobyte Count attribute
Description
This attribute displays the total data in KB that move on the channel since the
start of the HIS.
Type
Real number (64-bit counter) with enumerated values. The strings are displayed
in the Tivoli Enterprise Portal. The warehouse and queries return the values that
are shown in parentheses. The following values are defined:
v Value Exceeds Maximum (9223372036854775807)

Chapter 4. Attributes reference 97

 v Value Exceeds Minimum (-9223372036854775808)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Byte_Count / 1024.
Warehouse name
KILO_BYTE_COUNT or KILO_BYTE2
Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the start of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Starting_Time / 1000.
Warehouse name
STARTING_TIME_IN_SECONDS or STARTING_3
Suspension Time in seconds attribute
Description
This attribute displays the current suspension time of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Time / 1000.
Warehouse name
SUSPENSION_TIME_IN_SECONDS or SUSPENSIO4
Suspension Starting Time in seconds attribute
Description
This attribute displays the High Frequency performance counter value currently
at the suspension of the channel in seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Suspension_Starting_Time / 1000.
Warehouse name
SUSPENSION_STARTING_TIME_IN_SECONDS or SUSPENSIO5

98 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's Guide
 System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

MQBridge Service attribute group

This attribute group displays details about the MQBridge Service configuration.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the MQBridge Service attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Cache Refresh attribute
Description
This attribute displays the time interval that the message pipes currently used to
check for Cache Timeout in minutes.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 99

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ServiceCacheReresh.
Warehouse name
CACHERERESH or CACHERERES
F2QR Maximum Threads attribute
Description
This attribute displays the maximum number of threads that are currently used
for the MSMQ to MQSeries High service message pipe.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ServiceF2QR_MaxThreads.
Warehouse name
F2QR_MAXTHREADS or F2QR_MAXTH
F2QT Maximum Threads attribute
Description
This attribute displays the maximum number of threads that are currently used
for the MSMQ to MQSeries Normal service message pipe.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ServiceF2QT_MaxThreads.
Warehouse name
F2QT_MAXTHREADS or F2QT_MAXTH
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the computer.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ServiceName.
Warehouse name
NAME
Q2FD Maximum Threads attribute
Description
This attribute displays the maximum number of threads that are currently used
for the MQSeries to MSMQ High service message pipe.

100 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ServiceQ2FD_MaxThreads.
Warehouse name
Q2FD_MAXTHREADS or Q2FD_MAXTH
Q2FO Maximum Threads attribute
Description
This attribute displays the maximum number of threads that are currently used
for the MQSeries to MSMQ Normal service message pipe.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ServiceQ2FO_MaxThreads.
Warehouse name
Q2FO_MAXTHREADS or Q2FO_MAXTH
Encryption attribute
Description
This attribute checks whether the Encryption feature from MSMQ to
MSMQ-MQSeries Bridge is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisMQBridge_ServiceEncryption.
Warehouse name
ENCRYPTION

MSFT DB2 Access Library attribute group

This attribute group helps you to determine how well the HIS processes the requests from the Windows
system, the attributes demonstrate details about requests coming from Host system and processing
performance by HIS.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.

Chapter 4. Attributes reference 101

Attribute descriptions
The following list contains information about each attribute in the MSFT DB2 Access Library
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Commits Per Second attribute
Description
This attribute indicates the number of commit calls that the client currently sends
to a DB2 database per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\Commits /
Second.
Warehouse name
COMMITS_SECOND or COMMITS_SE
ODBC Executes Per Second attribute
Description
This attribute indicates the number of queries that are currently processed in
ODBC (SQLExecute or SQLExecDirect) per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\ODBC
Executes / Second.

102 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
ODBC_EXECUTES_SECOND or ODBC_EXECU
ODBC Prepares Per Second attribute
Description
This attribute indicates the number of rows currently prepared in ODBC
(SQLPrepare) per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\ODBC
Prepares / Second.
Warehouse name
ODBC_PREPARES_SECOND or ODBC_PREPA
ODBC Rows Fetched Per Second attribute
Description
This attribute indicates the number of rows currently fetched in ODBC (SQLFetch
or SQLFetchScroll) per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\ODBC
Rows Fetched / Second.
Warehouse name
ODBC_ROWS_FETCHED_SECOND or ODBC_ROWS_
OLE DB Average Data Access Time attribute
Description
This attribute measures the total time currently taken to complete calls in OLE
DB.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\OLE DB
Avg. Data Access Time.

Chapter 4. Attributes reference 103

 Warehouse name
OLE_DB_AVG_DATA_ACCESS_TIME or OLE_DB_AVG
OLE DB Executes Per Second attribute
Description
This attribute indicates the number of Executes currently done in OLE DB per
second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\OLE DB
Executes / Second.
Warehouse name
OLE_DB_EXECUTES_SECOND or OLE_DB_EXE
OLE DB GetData Calls Per Second attribute
Description
This attribute indicates the number of GetData calls currently done in OLE DB
per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\OLE DB
GetData() calls / Second.
Warehouse name
OLE_DB_GETDATA_CALLS_SECOND or OLE_DB_GET
OLE DB Prepares Per Second attribute
Description
This attribute indicates the number of Prepares currently done in OLE DB per
second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\OLE DB
Prepares / Second.

104 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
OLE_DB_PREPARES_SECOND or OLE_DB_PRE
OLE DB Rows Fetched Per Second attribute
Description
This attribute indicates the number of row fetches currently done in OLE DB per
second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\OLE DB
Rows Fetched / Second.
Warehouse name
OLE_DB_ROWS_FETCHED_SECOND or OLE_DB_ROW
Open Connections attribute
Description
This attribute indicates the total number of connections that are open to DB2
since the start of the server.
Type
Integer (32-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\Open
Connections.
Warehouse name
OPEN_CONNECTIONS or OPEN_CONNE
Open Statements attribute
Description
This attribute indicates the total number of active statements created by data
providers for DB2 since the start of the server.
Type
Integer (32-bit counter) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\Open
Statements.
Warehouse name
OPEN_STATEMENTS or OPEN_STATE

Chapter 4. Attributes reference 105

 Packets Received Per Second attribute
Description
This attribute indicates the number of packets that the client currently receives
from a DB2 database.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\Packets
Received / Second.
Warehouse name
PACKETS_RECEIVED_SECOND or PACKETS_RE
Packets Sent Per Second attribute
Description
This attribute indicates the number of packets that the client currently sends to a
DB2 database per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\Packets
Sent / Second.
Warehouse name
PACKETS_SENT_SECOND or PACKETS_SE
Rollbacks Per Second attribute
Description
This attribute indicates the number of rollback calls that a client currently sends
to a DB2 database per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\Rollbacks
/ Second.
Warehouse name
ROLLBACKS_SECOND or ROLLBACKS_

106 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Transactions Per Second attribute
Description
This attribute indicates the number of transactions that currently take place per
second in a DB2 database.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - MSFT DB2 Access Library\*\
Transactions / Second.
Warehouse name
TRANSACTIONS_SECOND or TRANSACTIO
Kilobytes Received Per Second attribute
Description
This attribute displays the rate at which the DB2 database currently receives the
data in KB from the client per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_Received_Second / 1024.
Warehouse name
KILOBYTES_RECEIVED_SECOND or KILOBYTES_
Kilobytes Sent Per Second attribute
Description
This attribute displays the rate at which the DB2 database currently sends the
data in KB to the client per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Bytes_Sent_Second / 1024.
Warehouse name
KILOBYTES_SENT_SECOND or KILOBYTES0
Average Host Processing Time in millisec attribute

Chapter 4. Attributes reference 107

 Description
This attribute measures the average time in milliseconds that the host currently
takes to respond to a request.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Avg_Host_Processing_Time * 1000.
Warehouse name
AVG_HOST_PROCESSING_TIME_IN_MILLISEC or AVG_HOSTP0
ODBC Average Execution Time in millisec attribute
Description
This attribute measures the average ODBC processing time in milliseconds.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: ODBC_Avg_Execution_Time * 1000.
Warehouse name
ODBC_AVG_EXECUTION_TIME_IN_MILLISEC or ODBCAVGEXE
ODBC Average Fetch Time in millisec attribute
Description
This attribute measures the average ODBC fetch time.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: ODBC_Avg_Fetch_Time * 1000.
Warehouse name
ODBC_AVG_FETCH_TIME_IN_MILLISEC or ODBCAVGFET
ODBC Average Prepare Time in millisec attribute
Description
This attribute measures the average ODBC prepare time in milliseconds.
Type
Real number (32-bit gauge) with three decimal places of precision with

108 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: ODBC_Avg_Prepare_Time * 1000.
Warehouse name
ODBC_AVG_PREPARE_TIME_IN_MILLISEC or ODBCAVGPRE
OLE DB Average Execution Time in millisec attribute
Description
This attribute measures the average OLE DB processing time in milliseconds.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: OLE_DB_Avg_Execution_Time * 1000.
Warehouse name
OLE_DB_AVG_EXECUTION_TIME_IN_MILLISEC or OLEDBAVEXE
OLE DB Average Fetch Time in millisec attribute
Description
This attribute measures the average OLE DB fetch time in milliseconds.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: OLE_DB_Avg_Fetch_Time * 1000.
Warehouse name
OLE_DB_AVG_FETCH_TIME_IN_MILLISEC or OLEDBAVFET
OLE DB Average Prepare Time in millisec attribute
Description
This attribute measures the average OLE DB prepare time in milliseconds.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 109

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: OLE_DB_Avg_Prepare_Time * 1000.
Warehouse name
OLE_DB_AVG_PREPARE_TIME_IN_MILLISEC or OLEDBAVPRE
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

Performance Object Status attribute group

The Performance Object Status attribute group contains information that reflects the status of other
attribute groups so you can see the status of all of the performance objects that make up this application
all at once. Each of these other performance attribute groups is represented by a row in this table (or
other type of view). The status for an attribute group reflects the result of the last attempt to collect data
for that attribute group, which allows you to see whether the agent is performing correctly. Unlike other
attribute groups, the Performance Object Status attribute group does not reflect the state of the monitored
application. This attribute group is most often used to determine why data is not available for one of the
performance attribute groups.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Performance Object Status
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.

110 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
TIMESTAMP
Query Name attribute: This attribute is a key attribute.
Description
The name of the attribute group.
Type
String
Warehouse name
QUERY_NAME or ATTRGRP
Object Name attribute
Description
The name of the performance object.
Type
String
Warehouse name
OBJECT_NAME or OBJNAME
Object Type attribute
Description
The type of the performance object.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v WMI (0)
v PERFMON (1)
v WMI ASSOCIATION GROUP (2)
v JMX (3)
v SNMP (4)
v SHELL COMMAND (5)
v JOINED GROUPS (6)
v CIMOM (7)
v CUSTOM (8)
v ROLLUP DATA (9)
v WMI REMOTE DATA (10)
v LOG FILE (11)
v JDBC (12)
v CONFIG DISCOVERY (13)
v NT EVENT LOG (14)
v FILTER (15)
v SNMP EVENT (16)
v PING (17)
v DIRECTOR DATA (18)
v DIRECTOR EVENT (19)
v SSH REMOTE SHELL COMMAND (20)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
OBJECT_TYPE or OBJTYPE
Object Status attribute
Description
The status of the performance object.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:

Chapter 4. Attributes reference 111

 v ACTIVE (0)
v INACTIVE (1)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
OBJECT_STATUS or OBJSTTS
Error Code attribute
Description
The error code that is associated with the query.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v NO ERROR (0)
v GENERAL ERROR (1)
v OBJECT NOT FOUND (2)
v COUNTER NOT FOUND (3)
v NAMESPACE ERROR (4)
v OBJECT CURRENTLY UNAVAILABLE (5)
v COM LIBRARY INIT FAILURE (6)
v SECURITY INIT FAILURE (7)
v PROXY SECURITY FAILURE (9)
v NO INSTANCES RETURNED (10)
v ASSOCIATOR QUERY FAILED (11)
v REFERENCE QUERY FAILED (12)
v NO RESPONSE RECEIVED (13)
v CANNOT FIND JOINED QUERY (14)
v CANNOT FIND JOIN ATTRIBUTE IN QUERY 1 RESULTS (15)
v CANNOT FIND JOIN ATTRIBUTE IN QUERY 2 RESULTS (16)
v QUERY 1 NOT A SINGLETON (17)
v QUERY 2 NOT A SINGLETON (18)
v NO INSTANCES RETURNED IN QUERY 1 (19)
v NO INSTANCES RETURNED IN QUERY 2 (20)
v CANNOT FIND ROLLUP QUERY (21)
v CANNOT FIND ROLLUP ATTRIBUTE (22)
v FILE OFFLINE (23)
v NO HOSTNAME (24)
v MISSING LIBRARY (25)
v ATTRIBUTE COUNT MISMATCH (26)
v ATTRIBUTE NAME MISMATCH (27)
v COMMON DATA PROVIDER NOT STARTED (28)
v CALLBACK REGISTRATION ERROR (29)
v MDL LOAD ERROR (30)
v AUTHENTICATION FAILED (31)
v CANNOT RESOLVE HOST NAME (32)
v SUBNODE UNAVAILABLE (33)
v SUBNODE NOT FOUND IN CONFIG (34)
v ATTRIBUTE ERROR (35)
v CLASSPATH ERROR (36)
v CONNECTION FAILURE (37)
v FILTER SYNTAX ERROR (38)
v FILE NAME MISSING (39)
v SQL QUERY ERROR (40)
v SQL FILTER QUERY ERROR (41)
v SQL DB QUERY ERROR (42)

112 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v SQL DB FILTER QUERY ERROR (43)
v PORT OPEN FAILED (44)
v ACCESS DENIED (45)
v TIMEOUT (46)
v NOT IMPLEMENTED (47)
v REQUESTED A BAD VALUE (48)
v RESPONSE TOO BIG (49)
v GENERAL RESPONSE ERROR (50)
v SCRIPT NONZERO RETURN (51)
v SCRIPT NOT FOUND (52)
v SCRIPT LAUNCH ERROR (53)
v CONF FILE DOES NOT EXIST (54)
v CONF FILE ACCESS DENIED (55)
v INVALID CONF FILE (56)
v EIF INITIALIZATION FAILED (57)
v CANNOT OPEN FORMAT FILE (58)
v FORMAT FILE SYNTAX ERROR (59)
v REMOTE HOST UNAVAILABLE (60)
v EVENT LOG DOES NOT EXIST (61)
v PING FILE DOES NOT EXIST (62)
v NO PING DEVICE FILES (63)
v PING DEVICE LIST FILE MISSING (64)
v SNMP MISSING PASSWORD (65)
v DISABLED (66)
v URLS FILE NOT FOUND (67)
v XML PARSE ERROR (68)
v NOT INITIALIZED (69)
v ICMP SOCKETS FAILED (70)
v DUPLICATE CONF FILE (71)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
ERROR_CODE or ERRCODE
Last Collection Start attribute
Description
The most recent time a data collection of this group started.
Type
Timestamp with enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v NOT COLLECTED (0691231190000000)
v NOT COLLECTED (0000000000000001)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
LAST_COLLECTION_START or COLSTRT
Last Collection Finished attribute
Description
The most recent time a data collection of this group finished.
Type
Timestamp with enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v NOT COLLECTED (0691231190000000)
v NOT COLLECTED (0000000000000001)

Chapter 4. Attributes reference 113

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
LAST_COLLECTION_FINISHED or COLFINI
Last Collection Duration attribute
Description
The duration of the most recently completed data collection of this group in
seconds.
Type
Real number (32-bit counter) with two decimal places of precision
Warehouse name
LAST_COLLECTION_DURATION or COLDURA
Average Collection Duration attribute
Description
The average duration of all data collections of this group in seconds.
Type
Real number (32-bit counter) with two decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v NO DATA (-100)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Warehouse name
AVERAGE_COLLECTION_DURATION or COLAVGD
Refresh Interval attribute
Description
The interval at which this group is refreshed in seconds.
Type
Integer (32-bit counter)
Warehouse name
REFRESH_INTERVAL or REFRINT
Number of Collections attribute
Description
The number of times this group has been collected since agent start.
Type
Integer (32-bit counter)
Warehouse name
NUMBER_OF_COLLECTIONS or NUMCOLL
Cache Hits attribute
Description
The number of times an external data request for this group was satisfied from
the cache.
Type
Integer (32-bit counter)
Warehouse name
CACHE_HITS or CACHEHT
Cache Misses attribute
Description
The number of times an external data request for this group was not available in
the cache.
Type
Integer (32-bit counter)
Warehouse name
CACHE_MISSES or CACHEMS

114 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Cache Hit Percent attribute
Description
The percentage of external data requests for this group that were satisfied from
the cache.
Type
Real number (32-bit counter) with two decimal places of precision
Warehouse name
CACHE_HIT_PERCENT or CACHPCT
Intervals Skipped attribute
Description
The number of times a background data collection for this group was skipped
because the previous collection was still running when the next one was due to
start.
Type
Integer (32-bit counter)
Warehouse name
INTERVALS_SKIPPED or INTSKIP

Session Integrator Server attribute group

The Session Integrator Server attribute group helps you to determine how well the HIS application
receives and transmits data by using the Session Integrator Server.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Session Integrator Server
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Chains Received Per Second attribute
Description
This attribute displays the number of SNA chains that the client receives per
second, a chain is a collection of SNA Request Units (RU).
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 115

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server\*\Chains
Received/Sec.
Warehouse name
CHAINS_RECEIVED_PER_SEC or CHAINS_REC
Chains Transmitted Per Second attribute
Description
This attribute displays the number of SNA chains that the client currently
transmits per second, a chain is a collection of SNA RUs.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server\*\Chains
Transmitted/Sec.
Warehouse name
CHAINS_TRANSMITTED_PER_SEC or CHAINS_TRA
Sessions attribute
Description
This attribute displays the number of existing sessions.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server\*\Sessions.
Warehouse name
SESSIONS
Sessions Connected attribute
Description
This attribute displays the number of sessions that are currently connected to the
clients.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

116 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is Perfmon - Session Integrator Server\*\Sessions
connected.
Warehouse name
SESSIONS_CONNECTED or SESSIONS_C
Sessions Online attribute
Description
This attribute displays the number of sessions that are currently online (in
session).
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server\*\Sessions
online.
Warehouse name
SESSIONS_ONLINE or SESSIONS_O
Transactions Per Second attribute
Description
This attribute displays the number of transactions per second, a transaction
consists of an SNA bracket.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server\*\
Transactions/sec.
Warehouse name
TRANSACTIONS_PER_SEC or TRANSACTIO
Data Kilobytes Received Per Second attribute
Description
This attribute displays the data in KB that the client currently receives per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Data_Bytes_Received_per_Sec / 1024.

Chapter 4. Attributes reference 117

 Warehouse name
DATA_KILO_BYTES_RECEIVED_SEC or DATA_KILO_
Data Kilobytes Transmitted Per Second attribute
Description
This attribute displays the data in KB that the client currently transmits per
second
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Data_Bytes_Transmitted_per_Sec / 1024.
Warehouse name
DATA_KILO_BYTES_TRANSMITTED_SEC or DATA_KILO0
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Session Integrator Server PLUs attribute group

The Session Integrator Server PLUs attribute group includes attributes that you can use to determine how
well the HIS application receives and transmits data by using the Session Integrator Server PLUs.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Session Integrator Server PLUs
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP

118 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Chains Received Per Second attribute
Description
This attribute displays the number of SNA chains that the client currently receives
per second, a chain is a collection of SNA RUs.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server
PLUs\*\Chains Received/Sec.
Warehouse name
CHAINS_RECEIVED_PER_SEC or CHAINS_REC
Chains Transmitted Per Second attribute
Description
This attribute displays the number of SNA chains that the client currently
transmits per second, a chain is a collection of SNA RUs.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server
PLUs\*\Chains Transmitted/Sec.
Warehouse name
CHAINS_TRANSMITTED_PER_SEC or CHAINS_TRA
Sessions attribute
Description
This attribute displays the number of sessions that currently exist.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server
PLUs\*\Sessions.
Warehouse name
SESSIONS
Sessions Connected attribute

Chapter 4. Attributes reference 119

 Description
This attribute displays the number of sessions that are currently connected to
clients.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server
PLUs\*\Sessions connected.
Warehouse name
SESSIONS_CONNECTED or SESSIONS_C
Transactions Per Second attribute
Description
This attribute displays the number of transactions per second, a transaction
consists of an SNA bracket.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - Session Integrator Server
PLUs\*\Transactions/sec.
Warehouse name
TRANSACTIONS_PER_SEC or TRANSACTIO
Data Kilobytes Received Per Second attribute
Description
This attribute displays the data in KB that the client currently receives per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Data_Bytes_Received_per_Sec / 1024.
Warehouse name
DATA_KILO_BYTES_RECEIVED_SEC or DATA_KILO_
Data Kiloytes Transmitted Per Second attribute
Description
This attribute displays the data in KB that the client currently transmits per
second.

120 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Data_Bytes_Transmitted_per_Sec / 1024.
Warehouse name
DATA_KILO_BYTES_TRANSMITTED_SEC or DATA_KILO0
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

SNA 3270 Response Times attribute group

This attribute group displays SNA 3270 Response Times statistics.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA 3270 Response Times
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.

Chapter 4. Attributes reference 121

 Warehouse name
TIMESTAMP
Percent Response Threshold 1 attribute
Description
This attribute displays the percentage of responses that currently fall below the
first time threshold.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - SNA 3270 Response Times\*\%
Responses Threshold 1.
Warehouse name
PCT_RESPONSES_THRESHOLD_1 or PCT_RESPON
Percent Response Threshold 2 attribute
Description
This attribute displays the percentage of responses that currently fall between the
first and second time thresholds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - SNA 3270 Response Times\*\%
Responses Threshold 2.
Warehouse name
PCT_RESPONSES_THRESHOLD_2 or PCT_RESPO0
Percent Response Threshold 3 attribute
Description
This attribute displays the percentage of responses that currently fall between the
second and third time thresholds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - SNA 3270 Response Times\*\%
Responses Threshold 3.
Warehouse name
PCT_RESPONSES_THRESHOLD_3 or PCT_RESPO1
Percent Response Threshold 4 attribute

122 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute displays the percentage of responses that currently fall between the
third and fourth time thresholds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - SNA 3270 Response Times\*\%
Responses Threshold 4.
Warehouse name
PCT_RESPONSES_THRESHOLD_4 or PCT_RESPO2
Percent Response Threshold 5 attribute
Description
This attribute displays the percentage of responses that currently fall beyond the
fourth time threshold.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - SNA 3270 Response Times\*\%
Responses > Threshold 5.
Warehouse name
PCT_RESPONSES_THRESHOLD_5 or PCT_RESPO3
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

SNA APPC Mode attribute group

This attribute group displays information about SNA APPC Mode.

Chapter 4. Attributes reference 123

Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA APPC Mode attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Allow LZ and RLE attribute
Description
This attribute checks whether the data is compressed by using Run Length
Encoding (RLE) and then using Lempel-Ziv9 (LZ9).
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeAllowLZandRLE.
Warehouse name
ALLOWLZANDRLE or ALLOWLZAND
Auto Activate attribute
Description
This attribute represents the number of contention winner sessions that must be
currently activated for the local LU.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeAutoActivate.

124 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
AUTOACTIVATE or AUTOACTIVA
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeComment.
Warehouse name
COMMENT
Endpoint Only attribute
Description
This attribute checks whether intermediate nodes are allowed to enable
compression in the client.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeEndpointOnly.
Warehouse name
ENDPOINTONLY or ENDPOINTON
Maximum Receive Compression attribute
Description
This attribute represents the maximum compression that is currently allowed for
the received data.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v None (0)
v RLE (1)
v LZ9 (2)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeMaxRcvCompression.
Warehouse name
MAXRCVCOMPRESSION or MAXRCVCOMP
Maximum Send Compression attribute
Description
This attribute represents the maximum compression that is currently allowed for
the sent data.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:

Chapter 4. Attributes reference 125

 v None (0)
v RLE (1)
v LZ9 (2)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeMaxSendCompression.
Warehouse name
MAXSENDCOMPRESSION or MAXSENDCOM
Minimum Contention Winner attribute
Description
This attribute displays the limit for the minimum contention winner.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeMinContWin.
Warehouse name
MINCONTWIN
Name attribute: This attribute is a key attribute.
Description
This attribute represents the mode name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeName.
Warehouse name
NAME
Partner Minimum Contention Winner attribute
Description
This attribute displays the limit for the minimum contention winner for the
partner.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModePartMinContWin.
Warehouse name
PARTMINCONTWIN or PARTMINCON
Priority attribute

126 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute checks whether communication with a higher priority mode is
prefered over a lower priority mode.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModePriority.
Warehouse name
PRIORITY
Rx Pacing attribute
Description
This attribute represents the maximum number of frames that the local LU
currently receives without sending a SNA pacing response from the partner LU.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeRxPacing.
Warehouse name
RXPACING
RX RU attribute
Description
This attribute represents the RUs with maximum size that the Transaction
Programs (TP) currently sends to the remote system.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeRxRu.
Warehouse name
RXRU
Session Limit attribute
Description
This attribute displays the maximum number of parallel sessions that are
currently allowed simultaneously.

Chapter 4. Attributes reference 127

 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeSessionLimit.
Warehouse name
SESSIONLIMIT or SESSIONLIM
Tx Pacing attribute
Description
This attribute represents the maximum number of frames that the local LU
currently sends without receiving a SNA pacing response from the partner LU.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeTxPacing.
Warehouse name
TXPACING
TX RU attribute
Description
This attribute represents the RU's with maximum size that the TPs currently send
on the local system.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_AppcModeTxRu.
Warehouse name
TXRU

SNA Configured Users attribute group

This attribute group displays information about the configured users on the SNA Server.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.

128 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Attribute descriptions
The following list contains information about each attribute in the SNA Configured Users
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This attribute represents the user account that is configured on the SNA Server.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConfiguredUserName.
Warehouse name
NAME
DynRemote attribute
Description
The value of this attribute indicates whether the current user or group can use
dynamically created APPC LUs.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConfiguredUserDynRemote.
Warehouse name
DYNREMOTE
Encryption attribute
Description
The value of this attribute indicates whether encryption is currently enabled
between the client system and the Host Integration Server.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the

Chapter 4. Attributes reference 129

 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConfiguredUserEncryption.
Warehouse name
ENCRYPTION
User Type attribute
Description
This attribute represents the current account type.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v User (1)
v Group (2)
v Domain (3)
v Alias (4)
v WellKnownGroup (5)
v DeletedAccount (6)
v Invalid (7)
v Unknown (8)
v Computer (9)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConfiguredUserUserType.
Warehouse name
USERTYPE

SNA Connection Configuration attribute group

This attribute group displays information about SNA Connection.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Connection Configuration
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.

130 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Activation attribute
Description
This attribute displays the string for activation and is applicable to outgoing calls
that are currently included in allowed directions.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Initial (0)
v OnDemand (1)
v Administrator (2)
v Incoming (3)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionActivation.
Warehouse name
ACTIVATION
Adapter attribute
Description
This attribute represents the link service that corresponds to this connection.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionAdapter.
Warehouse name
ADAPTER
Affiliate Application attribute
Description
This attribute represents the name of the SSO affiliated application.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionAffiliateApplication.
Warehouse name
AFFILIATEAPPLICATION or AFFILIATEA
Allow Incoming attribute
Description
This attribute checks whether the incoming calls are allowed.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 131

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionAllowIncoming.
Warehouse name
ALLOWINCOMING or ALLOWINCOM
Block ID attribute
Description
This attribute represents the Block ID.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionBlockId.
Warehouse name
BLOCKID
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionComment.
Warehouse name
COMMENT
Compression Level attribute
Description
This attribute represents the compression type that the connection currently uses.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v None (0)
v RLE (1)
v LZ9 (2)
v LZ10 (3)
v LZ12 (4)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionCompressionLevel.
Warehouse name
COMPRESSIONLEVEL or COMPRESSIO
Dynamic Lu Definition attribute
Description
This attribute checks whether the APPC Remote LU's are automatically
configured after the user request.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)

132 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionDynamicLuDef.
Warehouse name
DYNAMICLUDEF or DYNAMICLUD
Local Control Point attribute
Description
This attribute displays a control point to identify a system and a LocalNetName.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionLocalControlPoint.
Warehouse name
LOCALCONTROLPOINT or LOCALCONTR
Local Network Name attribute
Description
This attribute displays the network name to identify the system and a
LocalControlPoint.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionLocalNetName.
Warehouse name
LOCALNETNAME or LOCALNETNA
Name attribute: This attribute is a key attribute.
Description
This attribute represents the name of the connection.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionName.
Warehouse name
NAME
Node ID attribute
Description
This attribute represents the Note ID, this attribute is valid only for a switched
Synchronous Data Link Control (SDLC) line (Standard telephone line) connection
to connect to the host system.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionNodeId.
Warehouse name
NODEID
Partner Connection Name attribute
Description
This attribute represents the name of the connecting partner and is valid only if
RemoteEnd is set to Passthrough.

Chapter 4. Attributes reference 133

 Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionPartnerConnectionName.
Warehouse name
PARTNERCONNECTIONNAME or PARTNERCON
Peer Role attribute
Description
This attribute represents the role of the peer.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Invalid (-1)
v Primary (0)
v Secondary (1)
v Negotiable (2)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionPeerRole.
Warehouse name
PEERROLE
Remote Block ID attribute
Description
This attribute represents the remote Block ID.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionRemoteBlockId.
Warehouse name
REMOTEBLOCKID or REMOTEBLOC
Remote Control Point attribute
Description
This attribute represents the control point of the remote system, it is applicable if
you are using the Format 3 Exchange Identification (XID).
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionRemoteControlPoint.
Warehouse name
REMOTECONTROLPOINT or REMOTECONT
Remote End attribute
Description
This attribute represents the remote end in numeric format.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Host (0)
v Peer (1)

134 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v Downstream (2)
v Passthrough (3)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionRemoteEnd.
Warehouse name
REMOTEEND
Remote Network Name attribute
Description
This attribute represents the network name of the remote system, it is applicable
while using the Format 3 XIDs.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionRemoteNetName.
Warehouse name
REMOTENETNAME or REMOTENETN
Remote Node ID attribute
Description
This attribute represents the remote node ID.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionRemoteNodeId.
Warehouse name
REMOTENODEID or REMOTENODE
Retry Delay attribute
Description
This attribute represents the time in seconds that the local system currently waits
for the response before trying again.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionRetryDelay.
Warehouse name
RETRYDELAY
Retry Limit attribute
Description
This attribute represents the number of times that the local system currently tries
to send data to the remote system if there is no response from the remote system.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:

Chapter 4. Attributes reference 135

 v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionRetryLimit.
Warehouse name
RETRYLIMIT
Service attribute
Description
This attribute represents the SNA service that corresponds to the connection.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionService.
Warehouse name
SERVICE
Status Text attribute
Description
This attribute represents the current status of the connection.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionStatusText.
Warehouse name
STATUSTEXT
XID Format attribute
Description
This attribute displays the XID format.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Format 0 (0)
v Format 3 (3)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ConnectionXIDFormat.
Warehouse name
XIDFORMAT

SNA Connections attribute group

This attribute group provides attribute details for data transfer rate and frame throughput rate for SNA
connection.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Connections attribute
group:

136 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Throughput Frames Per Second attribute
Description
This attribute displays the total number of data frames that currently flow
through the SNA server per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - SNA Connections\*\Throughput
Frames/Sec.
Warehouse name
THROUGHPUT_FRAMES_PER_SEC or THROUGHPUT
Data Kilobyte Received Per Second attribute
Description
This attribute displays the data in KB that the client currently receives per second
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Data_Bytes_Received_Sec / 1024.
Warehouse name
DATA_KILO_BYTES_RECEIVED_SEC or DATA_KILO_
Data Kilobyte Transmitted Per Second attribute

Chapter 4. Attributes reference 137

 Description
This attribute displays the data in KB that the client currently transmits per
second
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Data_Bytes_Transmitted_Sec / 1024.
Warehouse name
DATA_KILO_BYTES_TRANSMITTED_SEC or DATA_KILOL
Throughput KiloFrames Per Second attribute
Description
This attribute displays the total number of data frames that currently flow
through the SNA server per second in kiloframe.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Throughput_Frames_per_Sec / 1024.
Warehouse name
THROUGHPUT_FRAMES_KILOBYTES_PER_SEC or THRGHPUTKL
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

SNA Domain attribute group

This attribute group displays information about SNA Domain.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Domain attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String

138 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Audit Level attribute
Description
This attribute represents the default audit log level that contains the audited
events.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v General (0)
v Detailed (1)
v Significant (2)
v Disabled (3)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainAuditLevel.
Warehouse name
AUDITLEVEL
Broadcast Mean Time attribute
Description
This attribute represents the time interval in seconds currently taken to repeat the
server broadcast.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainBroadcastMeanTime.
Warehouse name
BROADCASTMEANTIME or BROADCASTM
Client Backup Domain Name attribute
Description
This attribute displays a list of SNA subdomains that are backup domains.
Type
String

Chapter 4. Attributes reference 139

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainClientBackupDomainName.
Warehouse name
CLIENTBACKUPDOMAINNAME or CLIENTBACK
Client Backup Sponsor Names attribute
Description
This attribute displays a list of all the SNA sponsor servers that are separated by
a semicolon.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainClientBackupSponsorNames.
Warehouse name
CLIENTBACKUPSPONSORNAMES or CLIENTBAC0
Client Domain Backup Type attribute
Description
This attribute displays the backup type of the client domain.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v None (0)
v Domain (1)
v Sponsors (2)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainClientDomainBackupType.
Warehouse name
CLIENTDOMAINBACKUPTYPE or CLIENTDOMA
Config Server attribute
Description
This attribute displays the primary configuration for the subdomain.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainConfigServer.
Warehouse name
CONFIGSERVER or CONFIGSERV
Date Time Saved attribute
Description
This attribute displays the date and time when the server saves the object.
Type
Timestamp
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainDateTimeSaved.
Warehouse name
DATETIMESAVED or DATETIMESA
Available Display Verb Connection attribute

140 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute displays the default verbs connection, random connection gets
selected if a null value is set.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainDispVerbConnection.
Warehouse name
DISPVERBCONNECTION or DISPVERBCO
Eventlog Server attribute
Description
This attribute represents the server name where the Windows Event logs for that
server installation are stored.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainEventlogServer.
Warehouse name
EVENTLOGSERVER or EVENTLOGSE
Ipx Spx attribute
Description
This attribute checks whether the server broadcast over IPX/SPX is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_DomainIpxSpx.
Warehouse name
IPXSPX
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the subdomain.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_DomainName.
Warehouse name
NAME
Named Pipes attribute
Description
This attribute checks whether the server is broadcast over Windows Networking.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 141

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainNamedPipes.
Warehouse name
NAMEDPIPES
Available Net View Connection attribute
Description
This attribute represents the connection where the NetView data is sent.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainNetViewConnection.
Warehouse name
NETVIEWCONNECTION or NETVIEWCON
Popup Server attribute
Description
This attribute represents the server name where the pop-up error messages are
routed.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainPopupServer.
Warehouse name
POPUPSERVER or POPUPSERVE
RTM End of Session attribute
Description
This attribute checks whether the Response Time Monitor (RTM) data is sent to
the host for every LU to LU session.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainRTMEndOfSession.
Warehouse name
RTMENDOFSESSION or RTMENDOFSE
RTM Overflow attribute
Description
This attribute checks whether the Response Time Monitor (RTM) sends data to
the host after the number of host responses overflow the size of the available
counter during a period of time.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)

142 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainRTMOverflow.
Warehouse name
RTMOVERFLOW or RTMOVERFLO
RTM Threshold 1 attribute
Description
This attribute displays the first threshold time in seconds currently taken after
which the RTM saves and then restarts the count.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainRTMThreshold1.
Warehouse name
RTMTHRESHOLD1 or RTMTHRESHO
RTM Threshold 2 attribute
Description
This attribute displays the second threshold time in seconds currently taken after
which the RTM saves and then restarts the count.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainRTMThreshold2.
Warehouse name
RTMTHRESHOLD2 or RTMTHRESH0
RTM Threshold 3 attribute
Description
This attribute displays the third threshold time in seconds currently taken after
which the RTM saves and then restarts the count.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 143

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainRTMThreshold3.
Warehouse name
RTMTHRESHOLD3 or RTMTHRESH1
RTM Threshold 4 attribute
Description
This attribute displays the fourth threshold time in seconds currently taken after
which the RTM saves and then restarts the count.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainRTMThreshold4.
Warehouse name
RTMTHRESHOLD4 or RTMTHRESH2
RTM Timer Until attribute
Description
This attribute displays a value when the Response Time Monitor (RTM) registers
after receiving a response from the host.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v FirstData (0)
v Unlock (1)
v AllowSent (2)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainRTMTimerUntil.
Warehouse name
RTMTIMERUNTIL or RTMTIMERUN
Security 3270 attribute
Description
If the value of this attribute is set to true then the access to 3270 LUs is restricted
to users that are assigned to the LU.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

144 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainSecurity3270.
Warehouse name
SECURITY3270 or SECURITY32
Security APPC attribute
Description
If the value of this attribute is set to true, then the access to APPC LU's is
restricted to users that are assigned to the LU.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainSecurityAPPC.
Warehouse name
SECURITYAPPC or SECURITYAP
Security LUA attribute
Description
If the value of this attribute is set to true, then the access to LUA LU's is
restricted to users that are assigned to the LU.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_DomainSecurityLUA.
Warehouse name
SECURITYLUA or SECURITYLU
Status attribute
Description
This attribute represents the current status of the subdomain.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_DomainStatus.
Warehouse name
STATUS

Chapter 4. Attributes reference 145

 TCP IP attribute
Description
This attribute checks whether the server is broadcast over TCP/IP.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_DomainTcpIp.
Warehouse name
TCPIP

SNA Domain Topology attribute group

This attribute group displays information about the SNA Servers that are configured under the SNA
domain of the monitored system.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Domain Topology
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Domain Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the SNA subdomain.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
DOMAINNAME or SNADOM
Server Name attribute
Description
This attribute displays the name of the SNA Server.

146 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
String
Source
The source for this attribute is Script data.
Warehouse name
SERVERNAME or SNASER
Role Name attribute
Description
This attribute indicates the role of the SNA Server.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
ROLENAME or SERROLE
Status Text attribute
Description
This attribute displays the status of the SNA Server.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
STATUSTEXT or STEXT
Transport String attribute
Description
This attribute specifies the transport string.
Type
String
Source
The source for this attribute is Script data.
Warehouse name
TRANSPORTSTRING or TSTRING

SNA Logical Unit Sessions attribute group

This attribute group provides attribute details for data transfer rate and frame throughput rate for Logical
Unit.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Logical Unit Sessions
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.

Chapter 4. Attributes reference 147

 Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Throughput Frames Per Second attribute
Description
This attribute represents the total number of data frames that currently flow
through the SNA server per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - SNA Logical Unit Sessions\*\
Throughput Frames/Sec.
Warehouse name
THROUGHPUT_FRAMES_PER_SEC or THROUGHPUT
Data Kilobyte Received Per Second attribute
Description
This attribute represents the data in KB that the client currently receives per
second
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Data_Bytes_Received_Sec / 1024.
Warehouse name
DATA_KILO_BYTES_RECEIVED_SEC or DATA_KILO_
Data Kilobyte Transmitted Per Second attribute
Description
This attribute represents the data in KB that the client currently transmits per
second
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

148 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is derived: Data_Bytes_Transmitted_Sec / 1024.
Warehouse name
DATA_KILO_BYTES_TRANSMITTED_SEC or DATA_KILO0
Throughput KiloFrames Per Second attribute
Description
This attribute represents the total number of data frames that currently flow
through the SNA server per second in kiloframe.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: Throughput_Frames_per_Sec / 1024.
Warehouse name
THROUGHPUT_FRAMES_KILOBYTE_PER_SEC or THRGHPTKLO
Name attribute: This attribute is a key attribute.
Description
The name of the instance.
Type
String
Source
The source for this attribute is PerfMon.
Warehouse name
NAME

SNA LU AppcLocal attribute group

This attribute group displays the information about SNA APPC Local LU.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA LU AppcLocal attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.

Chapter 4. Attributes reference 149

 Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the Logical Unit (LU).
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalLUName.
Warehouse name
NAME
Service Name attribute
Description
This attribute represents the name of the SNA service to which the LU belongs.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalService.
Warehouse name
SERVICE
Connection Name attribute
Description
This attribute indicates the connection on which the dependent LU is configured.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalConnection.
Warehouse name
CONNECTION
Network Name attribute
Description
This attribute displays the network name, which must match with the network
name that is configured on the remote computer.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalNetName.
Warehouse name
NETNAME
Number attribute
Description
This attribute represents the LU number for the dependent LUs.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

150 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalNumber.
Warehouse name
NUMBER
Pool Member attribute
Description
The value of this attribute indicates whether the LU is currently a member of the
default outgoing Local APPC LU pool.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalPoolMember.
Warehouse name
POOLMEMBER
Sync Point attribute
Description
The value of this attribute indicates whether the administrator has a specialized
Transaction Program (TP) that currently requires Resync Service.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalSyncPoint.
Warehouse name
SYNCPOINT
Sync Point Client attribute
Description
This attribute represents the IP address or the name of the client computer.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalSyncPointClient.
Warehouse name
SYNCPOINTCLIENT or SYNCPNTCLT
Incoming Lu attribute
Description
This attribute represents the implicit incoming remote LU.
Type
String

Chapter 4. Attributes reference 151

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalIncomingLu.
Warehouse name
INCOMINGLU
TP Timeout attribute
Description
This attribute represents the timeout value, in seconds.The default value is 60
seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcLocalTpTimeout.
Warehouse name
TPTIMEOUT

SNA LU AppcRemote attribute group

This attribute group displays information about SNA APPC Remote LU.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA LU AppcRemote attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the LU.
Type
String

152 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteLUName.
Warehouse name
NAME
Service Name attribute
Description
This attribute represents the name of the SNA service to which this LU belongs.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteService.
Warehouse name
SERVICE
Connection Name attribute
Description
This attribute indicates the connection on which dependent LU is configured.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteConnection.
Warehouse name
CONNECTION
Network Name attribute
Description
This attribute displays the network name, which must match with the network
name that is configured on the remote computer.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteNetName.
Warehouse name
NETNAME
Incoming Mode attribute
Description
This attribute represents the implicit incoming mode for the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteIncomingMode.
Warehouse name
INCOMINGMODE or INCOMMODE
Is Parallel attribute
Description
This attribute indicates whether parallel sessions are currently used.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 153

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteParallel.
Warehouse name
ISPARALLEL
Security attribute
Description
This attribute displays the type of session-level security currently used with the
LU.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v None (0)
v Characters (2)
v Hex (1)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteSecurity.
Warehouse name
SECURITY
Sync Point attribute
Description
The value of this attribute indicates whether Sync Point is currently enabled.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteSyncPoint.
Warehouse name
SYNCPOINT
Security Key/(Hex) attribute
Description
This attribute indicates the security key (in hexadecimal) when the value for
Security is set to 1.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteSecKeyHex.
Warehouse name
SECKEYHEX
Security Key/(Char) attribute

154 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute indicates the security key (in characters) when the value for
Security is set to 2.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuAppcRemoteSecKeyChar.
Warehouse name
SECKEYCHAR

SNA LU Display attribute group

This attribute group displays information about SNA LU Display.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA LU Display attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Associated LU attribute
Description
This attribute displays the printer LU that is associated with the current object.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayAssociatedLU.
Warehouse name
ASSOCIATEDLU or ASSOCIATED
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayComment.

Chapter 4. Attributes reference 155

 Warehouse name
COMMENT
Compression attribute
Description
This attribute checks whether the data stream from the 3270 LU is compressed.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayCompression.
Warehouse name
COMPRESSION or COMPRESSIO
Connection Name attribute
Description
This attribute displays the connection where the LU is defined.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayConnectionName.
Warehouse name
CONNECTIONNAME or CONNECTION
Model attribute
Description
This attribute displays the default model currently used for the terminal service.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Model12 (0)
v Model13 (1)
v Model14 (2)
v Model1215 (3)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayModel.
Warehouse name
MODEL
Model Override attribute
Description
This attribute checks whether the default model is overridden.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

156 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayModelOverride.
Warehouse name
MODELOVERRIDE or MODELOVERR
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayName.
Warehouse name
NAME
Number attribute
Description
This attribute displays the LU number (Number - Port Number * 16 + LT
Number) for LUs on 802.2 and X.25 for DFT connection, or SDLC.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayNumber.
Warehouse name
NUMBER
Pool Name attribute
Description
This attribute displays the pool name if it contains the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayPoolName.
Warehouse name
POOLNAME
User Workstation Secure attribute
Description
This attribute checks whether the LU acquires information from both the user and
workstation.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 157

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuDisplayUserWksSecure.
Warehouse name
USERWKSSECURE or USERWKSSEC

SNA LU LUA attribute group

This attribute group displays information about SNA LU LUA.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA LU LUA attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuLuaComment.
Warehouse name
COMMENT
Compression attribute
Description
This attribute checks whether the data stream from the 3270 LU is compressed.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

158 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuLuaCompression.
Warehouse name
COMPRESSION or COMPRESSIO
Connection Name attribute
Description
This attribute displays the connection where the LU is defined.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuLuaConnectionName.
Warehouse name
CONNECTIONNAME or CONNECTION
High Priority Mode attribute
Description
This attribute checks whether the priority of this LU is increased on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuLuaHighPriorityMode.
Warehouse name
HIGHPRIORITYMODE or HIGHPRIORI
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_LuLuaName.
Warehouse name
NAME
Number attribute
Description
This attribute displays the LU number (Number - Port Number * 16 + LT
Number) for LUs on 802.2 and X.25 for DFT connection, or SDLC.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_LuLuaNumber.

Chapter 4. Attributes reference 159

 Warehouse name
NUMBER
Pool Name attribute
Description
This attribute displays the pool name if the LU is assigned to a pool.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuLuaPoolName.
Warehouse name
POOLNAME
User Workstation Secure attribute
Description
This attribute checks whether the LU acquires information from both the user and
workstation.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuLuaUserWksSecure.
Warehouse name
USERWKSSECURE or USERWKSSEC

SNA LU Print attribute group

This attribute group displays information about SNA LU Print.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA LU Print attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Associated LU attribute

160 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute displays the associated Display LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuPrintAssociatedLU.
Warehouse name
ASSOCIATEDLU or ASSOCIATED
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuPrintComment.
Warehouse name
COMMENT
Compression attribute
Description
This attribute checks whether the data stream from the 3270 LU is compressed.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuPrintCompression.
Warehouse name
COMPRESSION or COMPRESSIO
Connection Name attribute
Description
This attribute displays the connection where the LU is defined.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuPrintConnectionName.
Warehouse name
CONNECTIONNAME or CONNECTION
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_LuPrintName.
Warehouse name
NAME
Number attribute

Chapter 4. Attributes reference 161

 Description
This attribute displays the LU number (Number - Port Number * 16 + LT
Number) for LUs on 802.2 and X.25 for DFT connection, or SDLC.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_LuPrintNumber.
Warehouse name
NUMBER
Pool Name attribute
Description
This attribute displays the pool name if it contains the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuPrintPoolName.
Warehouse name
POOLNAME
User Workstation Secure attribute
Description
This attribute checks whether the LU acquires information from both the user and
workstation.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_LuPrintUserWksSecure.
Warehouse name
USERWKSSECURE or USERWKSSEC

SNA LU3270 attribute group

This attribute group displays information about SNA LU3270.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA LU3270 attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String

162 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_Lu3270Comment.
Warehouse name
COMMENT
Compression attribute
Description
This attribute checks whether the data stream from the 3270 LU is compressed.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_Lu3270Compression.
Warehouse name
COMPRESSION or COMPRESSIO
Connection Name attribute
Description
This attribute displays the connection where the LU is defined.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_Lu3270ConnectionName.
Warehouse name
CONNECTIONNAME or CONNECTION
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the LU.
Type
String

Chapter 4. Attributes reference 163

 Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_Lu3270Name.
Warehouse name
NAME
Number attribute
Description
This attribute displays the LU number for LUs on 802.2 and X.25 for DFT
connection or SDLC.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_Lu3270Number.
Warehouse name
NUMBER
Pool Name attribute
Description
This attribute displays the pool name if it contains the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_Lu3270PoolName.
Warehouse name
POOLNAME
User Workstation Secure attribute
Description
This attribute checks whether the LU acquires information from both the user and
workstation.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_Lu3270UserWksSecure.
Warehouse name
USERWKSSECURE or USERWKSSEC
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").

164 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
SYSTEM_NAME or SYS_NAME

SNA Pool attribute group

This attribute group displays information about SNA Pool.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Pool attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PoolComment.
Warehouse name
COMMENT
Name attribute: This attribute is a key attribute.
Description
This attribute displays the pool name.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\MsSna_PoolName.
Warehouse name
NAME
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Chapter 4. Attributes reference 165

SNA Pool Display attribute group
This attribute group displays information about SNA Pool Display.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Pool Display attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
AssocPrint attribute
Description
This attribute checks whether the printer LU is associated with this display LU
pool on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PoolDisplayAssocPrint.
Warehouse name
ASSOCPRINT
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PoolDisplayComment.
Warehouse name
COMMENT
Model attribute

166 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
The attribute displays the default model that is currently used for terminal
emulation.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Model2 (0)
v Model3 (1)
v Model4 (2)
v Model5 (3)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PoolDisplayModel.
Warehouse name
MODEL
ModelOverride attribute
Description
This attribute checks whether the server overrides the default model.Some
emulators can emulate only few display models.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PoolDisplayModelOverride.
Warehouse name
MODELOVERRIDE or MODELOVERR
Name attribute: This attribute is a key attribute.
Description
This attribude displays the pool name.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PoolDisplayName.
Warehouse name
NAME

SNA Print Session attribute group

This attribute group displays information about SNA Print Session.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Print Session attribute
group:
Node attribute: This attribute is a key attribute.

Chapter 4. Attributes reference 167

 Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Activation attribute
Description
This attribute displays the activation status of the print session.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Manual (1)
v Automatic (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionActivation.
Warehouse name
ACTIVATION
Filter Flag attribute
Description
This attribute checks whether a DLL filter is used to filter the printer data stream
on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionbFilter.
Warehouse name
BFILTER
Bottom Margin attribute
Description
This attribute displays the measure of the bottom margin in inches.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the

168 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionBottomMargin.
Warehouse name
BOTTOMMARGIN or BOTTOMMARG
Chars Per Line attribute
Description
This attribute displays the number of characters to be printed per line.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionCharsPerLine.
Warehouse name
CHARSPERLINE or CHARSPERLI
Check PDT File attribute
Description
This attribute checks whether a PDT file is used to format the print job.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionCheckPDTFile.
Warehouse name
CHECKPDTFILE or CHECKPDTFI
Code Page attribute
Description
This attribute displays a value that indicates whether a standard language code
or a custom code page is currently used.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Language (0)
v Custom (1)

Chapter 4. Attributes reference 169

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionCodePage.
Warehouse name
CODEPAGE
Code Page Custom File attribute
Description
This attribute displays the file name if a custom code page is used.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionCodePageCustomFile.
Warehouse name
CODEPAGECUSTOMFILE or CODEPAGECU
Code Page Language attribute
Description
This attribute displays the name of the code page to use in the print session, see
the remarks section for more information about the possible CodePageLanguage
values.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionCodePageLanguage.
Warehouse name
CODEPAGELANGUAGE or CODEPAGELA
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionComment.
Warehouse name
COMMENT
Face Name attribute
Description
This attribute displays the name of the face.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionFaceName.
Warehouse name
FACENAME

170 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Face Name Override attribute
Description
This attribute checks whether the server overrides the host commands.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionFaceNameOverride.
Warehouse name
FACENAMEOVERRIDE or FACENAMEOV
Filter attribute
Description
This attribute displays the DLL filter that is used to filter the printer data stream.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionFilter.
Warehouse name
FILTER
Font Size attribute
Description
This attribute displays the font size to use while printing.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionFontSize.
Warehouse name
FONTSIZE
Font Size Override attribute
Description
This attribute checks whether the server overrides the host font size commands.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 171

 Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionFontSizeOverride.
Warehouse name
FONTSIZEOVERRIDE or FONTSIZEOV
Ignore Transparent Sections attribute
Description
This attribute checks whether the server ignores the sections of the print data
stream that are marked as transparent.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionIgnoreTransparentSections.
Warehouse name
IGNORETRANSPARENTSECTIONS or IGNORETRAN
Left Margin attribute
Description
This attribute displays the left margin in inches.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionLeftMargin.
Warehouse name
LEFTMARGIN
Lines Per Inch attribute
Description
This attribute displays the number of lines to print per inch.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionLinesPerInch.
Warehouse name
LINESPERINCH or LINESPERIN

172 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
LPI Override attribute
Description
This attribute checks whether the host commands are enabled to override the
lines printed per inch.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionLPIOverride.
Warehouse name
LPIOVERRIDE or LPIOVERRID
Margin Override attribute
Description
This attribute checks whether the server overrides the host margin commands.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionMarginOverride.
Warehouse name
MARGINOVERRIDE or MARGINOVER
Name attribute: This attribute is a key attribute.
Description
This attribute displays the session name that distinguishes different printers on
the network.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionName.
Warehouse name
NAME
No Horizontal Scaling attribute
Description
This attribute checks whether the horizontal scaling feature of the printer driver
is turned off.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 173

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionNoHorizontalScaling.
Warehouse name
NOHORIZONTALSCALING or NOHORIZONT
No Vertical Scaling attribute
Description
This attribute checks whether the vertical scaling feature of the printer driver is
turned off.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionNoVerticalScaling.
Warehouse name
NOVERTICALSCALING or NOVERTICAL
Page Setup Override attribute
Description
This attribute displays the information to override the page setup.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionPageSetupOverride.
Warehouse name
PAGESETUPOVERRIDE or PAGESETUPO
PDTFile attribute
Description
This attribute displays the name of the PDT file that is used to format the print
job.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionPDTFile.
Warehouse name
PDTFILE
Printer Device Name attribute
Description
This attribute displays the name of the destination printer.

174 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionPrinterDeviceName.
Warehouse name
PRINTERDEVICENAME or PRINTERDEV
Printer File attribute
Description
This attribute displays the name of the file, it is valid only when printing from a
file.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionPrinterFile.
Warehouse name
PRINTERFILE or PRINTERFIL
Printer To File attribute
Description
This attribute checks whether the print job is sent to a file.You must configure a
destination printer.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionPrintToFile.
Warehouse name
PRINTTOFILE or PRINTTOFIL
Right Margin attribute
Description
This attribute displays the value of the right margin in inches.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionRightMargin.
Warehouse name
RIGHTMARGIN or RIGHTMARGI
Service attribute
Description
This attribute displays the SNA service to which the print session belongs.

Chapter 4. Attributes reference 175

 Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionService.
Warehouse name
SERVICE
Session Type attribute
Description
This attribute displays a value that indicates whether this is an APPC or 3270
print session.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v 3270 (1)
v APPC (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionSessionType.
Warehouse name
SESSIONTYPE or SESSIONTYP
Status Text attribute
Description
This attribute displays the status of the print session.
Type
String
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionStatusText.
Warehouse name
STATUSTEXT
Top Margin attribute
Description
This attribute displays the value of the top margin in inches.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionTopMargin.
Warehouse name
TOPMARGIN
Unique Extension attribute
Description
This attribute checks whether the print service gives a unique extension to each
file while printing it.

176 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - ROOT\MicrosoftHIS\
MsSna_PrintSessionUniqueExtension.
Warehouse name
UNIQUEEXTENSION or UNIQUEEXTE

SNA Server attribute group

This attribute group displays information about SNA Server.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Server attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
IsOffline attribute
Description
This attribute checks if the server is offline, the attribute displays FALSE if the
server is online or if it is not configured or both, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE/NA (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_ServerIsOffline.
Warehouse name
ISOFFLINE

Chapter 4. Attributes reference 177

 Name attribute: This attribute is a key attribute.
Description
This attribute represents the name of the server.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\MsSna_ServerName.
Warehouse name
NAME
Role Name attribute
Description
This attribute represents the name of the role.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServerRoleName.
Warehouse name
ROLENAME
Status Text attribute
Description
This attribute displays the status of the SNA server, and the attribute does not
display any value if the server is available.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServerStatusText.
Warehouse name
STATUSTEXT
Transport String attribute
Description
This attribute represents the transport string.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServerTransportString.
Warehouse name
TRANSPORTSTRING or TRANSPORTS

SNA Service attribute group

This attribute group displays information about SNA Service.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Service attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.

178 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceSNAComment.
Warehouse name
COMMENT
Control Point attribute
Description
This attribute displays the control point for this SNA node.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceSNAControlPoint.
Warehouse name
CONTROLPOINT or CONTROLPOI
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceSNAName.
Warehouse name
NAME
Network Name attribute
Description
This attribute displays the name of the network for this SNA node.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceSNANetworkName.
Warehouse name
NETWORKNAME or NETWORKNAM
Status attribute
Description
This attribute displays the status code of the service that is currently used.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise

Chapter 4. Attributes reference 179

 Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Not Configured (0)
v Inactive (1)
v Inactive (2)
v Stopping (3)
v Active (4)
v Empty String (5)
v OutOfDate (6)
v Paused (7)
v Empty String (8)
v Empty String (9)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceSNAStatus.
Warehouse name
STATUS
Status Text attribute
Description
This attribute displays the status text of the service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceSNAStatusText.
Warehouse name
STATUSTEXT

SNA Service Print attribute group

This attribute group displays information about SNA Print Service.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Service Print attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP

180 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Activation Retry Interval attribute
Description
This attribute represents the current waiting time in seconds before sending a job
again for printing, the default waiting time is 10 seconds.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintActivationRetryInterval.
Warehouse name
ACTIVATIONRETRYINTERVAL or ACTIVATION
Activation Retry Limit attribute
Description
This attribute represents the number of times that the Host Print service currently
attempts to activate the APPC conversation after a terminated connection, the
default value is -1 (infinite).
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintActivationRetryLimit.
Warehouse name
ACTIVATIONRETRYLIMIT or ACTIVATIO0
Allow Do NL attribute
Description
This attribute checks whether a new line must be inserted when the Host Print
service determines that the Maximum Print Position is reached for a particular
line of data, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintAlwaysDoNL.
Warehouse name
ALWAYSDONL
Delay Print Start attribute

Chapter 4. Attributes reference 181

 Description
This attribute checks whether the start of the print job must be delayed until the
Host Print services receives the printable data, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintDelayPrintStart.
Warehouse name
DELAYPRINTSTART or DELAYPRINT
Do All FF attribute
Description
This attribute checks whether the printer driver is forced to process all the
form-feed command requests, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintDoAllFF.
Warehouse name
DOALLFF
Embedded Codes attribute
Description
This attribute checks if the codes are embedded, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintEmbeddedCodes.
Warehouse name
EMBEDDEDCODES or EMBEDDEDCO
Flush Final FF attribute
Description
This attribute checks whether the Host Print service is forced to explicitly form
feed the document after a print job, enable this option on the server.

182 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintFlushFinalFF.
Warehouse name
FLUSHFINALFF or FLUSHFINAL
Ignore Chars Under 3F attribute
Description
This attribute checks whether the Host Print service is forced to ignore
hexadecimal characters that are 3F and below, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintIgnoreCharsUnder3F.
Warehouse name
IGNORECHARSUNDER3F or IGNORECHAR
Name attribute: This attribute is a key attribute.
Description
This attribute represents the name of the Host Print service, this is same as the
system name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintName.
Warehouse name
NAME
No Event Log On Skipping Transparent Section attribute
Description
This attribute checks whether to prevent an entry in the Event Log every time a
print service skips a transparent section that is found while printing a host print
job, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 183

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintNoEventLogOnSkippingTransparentSection.
Warehouse name
NOEVENTLOGONSKIPPINGTRANSPARENTSECTION or NOEVENTLOG
No Space After FF attribute
Description
This attribute checks whether the print service is prevented from inserting a space
charachter after a form feed, enable this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintNoSpaceAfterFF.
Warehouse name
NOSPACEAFTERFF or NOSPACEAFT
Status Text attribute
Description
This attribute represents the current status of the Host Print service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintStatusText.
Warehouse name
STATUSTEXT
Use Fixed Tabs attribute
Description
This attribute checks whether the typical tab functionality such as aligning in
columns is disabled and each tab is interpreted as fixed number of spaces, enable
this option on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintUseFixedTabs.
Warehouse name
USEFIXEDTABS or USEFIXEDTA
Use Proportional Font Change attribute
Description
This attribute checks whether the Host Print service is prevented from printing
the overlapping charachters in documents that contain non-fixed type fonts,
enable this option on the server.

184 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServicePrintUseProportionalFontChange.
Warehouse name
USEPROPORTIONALFONTCHANGE or USEPROPORT

SNA Service TN3270 attribute group

This attribute group displays information about SNA TN3270 Service.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Service TN3270 attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Certificate CN attribute
Description
This attribute displays the certificate for the connection.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270CertCN.
Warehouse name
CERTCN
Close Delay attribute
Description
This attribute displays the time currently taken by the client computer to close a
socket after it receives a disconnect message.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the

Chapter 4. Attributes reference 185

 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270CloseDelay.
Warehouse name
CLOSEDELAY
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270Comment.
Warehouse name
COMMENT
Idle Timeout attribute
Description
This attribute displays the idle time currently taken for the session before the
TN3270 service disconnects the client system, if you specify 0, then there is no
time-out.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270IdleTimeout.
Warehouse name
IDLETIMEOUT or IDLETIMEOU
Inbound RU attribute
Description
This attribute represents the RU or SNA message size that is currently used by
the TN3270 service for receiving logon messages from the host.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270InboundRU.

186 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
INBOUNDRU
Log Normal attribute
Description
This attribute displays the value as true if the client connections and terminations
are successful and false if they are not successful.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270LogNormal.
Warehouse name
LOGNORMAL
Log SNA attribute
Description
This attribute checks whether all the TN3270 service event messages are logged in
the Event Log that is used by the Host Integration Server system or the Event
Log on the local computer.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270LogSna.
Warehouse name
LOGSNA
Name attribute: This attribute is a key attribute.
Description
This attribute displays the TN3270 service name, this is the same as the system
name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270Name.
Warehouse name
NAME
Outbound RU attribute
Description
This attribute represents the RU or SNA message size that is currently used by
the TN3270 service for sending the logon messages to the host.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the

Chapter 4. Attributes reference 187

 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270OutboundRU.
Warehouse name
OUTBOUNDRU
Port attribute
Description
This attribute represents the default port number of the TN3270 service, you can
override the port on a per-session basis, use 0 for the default TN3270 port.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270Port.
Warehouse name
PORT
Printer Flow Control attribute
Description
This attribute checks whether the TN3270 service sends all the messages to a
TN3270 printer client with criteria as RESPONSE-REQUIRED, and does not send
more messages until it receives a response for the previous message.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270PrinterFlowControl.
Warehouse name
PRINTERFLOWCONTROL or PRINTERFLO
Refresh Time attribute
Description
This attribute represents the delay between two successive status updates on the
display.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:

188 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270RefreshTime.
Warehouse name
REFRESHTIME or REFRESHTIM
Security High attribute
Description
This attribute represents the encryption key length that is currently used for high
security.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270SecurityHigh.
Warehouse name
SECURITYHIGH or SECURITYHI
Security Low attribute
Description
This attribute represents the encryption key length that is currently used for low
security.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270SecurityLow.
Warehouse name
SECURITYLOW or SECURITYLO
Security Medium attribute
Description
This attribute represents the encryption key length that is currently used for
medium security.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 189

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270SecurityMedium.
Warehouse name
SECURITYMEDIUM or SECURITYME
Socket Listen attribute
Description
This attribute checks whether the TN3270 service stops responding on the socket
after all of the defined LUs are in use.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270SocketListen.
Warehouse name
SOCKETLISTEN or SOCKETLIST
Status Delay attribute
Description
This attribute represents a delay between the time currently taken when the
TN3270 service connects to a host session and the time when the TN3270 service
starts updating the client screen.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270StatusDelay.
Warehouse name
STATUSDELAY or STATUSDELA
Status Text attribute
Description
This attribute represents the current status of the service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270StatusText.
Warehouse name
STATUSTEXT
TN Mode Only attribute

190 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute checks whether the TN3270 service is prevented from using the
TN3270E to the TN3270.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270TNModeOnly.
Warehouse name
TNMODEONLY
Use Name Resolution attribute
Description
This attribute checks whether the name of the computer is specified instead of the
IP address while running a domain name resolver.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN3270UseNameResolution.
Warehouse name
USENAMERESOLUTION or USENAMERES

SNA Service TN5250 attribute group

This attribute group displays information about SNA TN5250 Service.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the SNA Service TN5250 attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.

Chapter 4. Attributes reference 191

 Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Comment attribute
Description
This attribute displays the comment field, which is optional.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN5250Comment.
Warehouse name
COMMENT
Name attribute: This attribute is a key attribute.
Description
This attribute displays the TN5250 service name, this is same as the computer
name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN5250Name.
Warehouse name
NAME
Port attribute
Description
This attribute displays the default port number for the TN5250 service, you can
override this port on a per-session basis, use 0 for the default TN5250 port.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN5250Port.
Warehouse name
PORT
Status Text attribute
Description
This attribute displays the current status of the service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSna_ServiceTN5250StatusText.
Warehouse name
STATUSTEXT

192 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Status APPC Local LU attribute group
This attribute group displays information about APPC Local LU Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status APPC Local LU
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This attribute displays the alias of the local LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcLocalLuName.
Warehouse name
NAME
Service Name attribute
Description
This attribute displays the name of the SNA service where the Local LU is
defined.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcLocalLuServiceName.
Warehouse name
SERVICENAME or SERVICENAM
Session Count attribute
Description
This attribute displays the count of the current sessions.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

Chapter 4. Attributes reference 193

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcLocalLuSessionCount.
Warehouse name
SESSIONCOUNT or SESSIONCOU
Session Limit attribute
Description
This attribtute displays the current session limit for LU.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcLocalLuSessionLimit.
Warehouse name
SESSIONLIMIT or SESSIONLIM
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Status APPC Session attribute group

This attribute group displays information about APPC Session Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status APPC Session attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String

194 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
APPC LU attribute: This attribute is a key attribute.
Description
This attribute displays the local APPC LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcSessionAPPCLU.
Warehouse name
APPCLU
Mode attribute
Description
This attribute displays the mode for the session.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcSessionMode.
Warehouse name
MODE
Partner LU attribute
Description
This attribute displays the partner LU alias that is either a Remote LU or another
Local LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcSessionPartnerLU.
Warehouse name
PARTNERLU
Session ID attribute: This attribute is a key attribute.
Description
This attribute displays a unique ID for the session.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_AppcSessionSessionID.
Warehouse name
SESSIONID

Status Client Connection attribute group

This attribute group displays information about SNA Client Connection Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status Client Connection
attribute group:
Node attribute: This attribute is a key attribute.

Chapter 4. Attributes reference 195

 Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Client Application attribute
Description
This attribute displays the name of the client application.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ClientConnectionClientAppl.
Warehouse name
CLIENTAPPL
Client Machine attribute
Description
This attribute displays the name of the computer where the client application is
running.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ClientConnectionClientMachine.
Warehouse name
CLIENTMACHINE or CLIENTMACH
Client Connect Time attribute
Description
This attribute displays the start time of the connection between the client and the
server.
Type
Timestamp
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ClientConnectionClientConnectTime.
Warehouse name
CLIENTCONNECTTIME or CLIENTCONN
Domain attribute
Description
This attribute displays the domain on which the user is located.
Type
String

196 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ClientConnectionDomain.
Warehouse name
DOMAIN
User attribute
Description
This attribute displays the name of the user.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ClientConnectionUser.
Warehouse name
USER
User ID attribute: This attribute is a key attribute.
Description
This attribute displays the unique identifier key for the user.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ClientConnectionUserId.
Warehouse name
USERID
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Status LU3270 attribute group

This attribute group displays information about Lu3270 Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status LU3270 attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String

Chapter 4. Attributes reference 197

 Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Active State attribute
Description
This attribute displays additional details about active LUs, the possible values are
Available, InSession or SSCP.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v SSCP (2)
v InSession (1)
v Available (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_Lu3270ActiveState.
Warehouse name
ACTIVESTATE or ACTIVESTAT
Connection Name attribute
Description
This attribute displays the connection on which this LU is defined.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_Lu3270ConnectionName.
Warehouse name
CONNECTIONNAME or CONNECTION
Host Application attribute
Description
This attribute displays the short name of the host application.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_Lu3270HostAppl.
Warehouse name
HOSTAPPL
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_Lu3270Name.
Warehouse name
NAME
Status attribute

198 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute displays the current status of the connection that is either Inactive,
Pending, Stopping, or Active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Stopping (3)
v Pending (2)
v Inactive (1)
v Active (4)
v Empty String (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_Lu3270Status.
Warehouse name
STATUS
Status text attribute
Description
This attribute displays one of the status values.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_Lu3270StatusText.
Warehouse name
STATUSTEXT
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Status Print Session attribute group

This attribute group displays information about Print Session Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status Print Session attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE

Chapter 4. Attributes reference 199

 Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This attribute displays a unique ID for the session.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_PrintSessionName.
Warehouse name
NAME
Print State attribute
Description
This attribute indicates the status of the printer or any other printer errors.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Printer Error (4)
v Ready (8)
v Printer Idle (6)
v Printer Paused (5)
v InSession (7)
v Spooling (0)
v Unknown (10)
v Printer Offline (3)
v Paused (9)
v Printing (1)
v Paper Out (2)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_PrintSessionPrintState.
Warehouse name
PRINTSTATE
Status attribute
Description
This attribute displays the current status of the service that is either Inactive,
Pending, Stopping, or Active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Stopping (3)
v Pending (2)
v Inactive (1)

200 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v Active (4)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_PrintSessionStatus.
Warehouse name
STATUS
Status text attribute
Description
This attribute displays one of the status values.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_PrintSessionStatusText.
Warehouse name
STATUSTEXT
Type attribute
Description
This attribute displays the type of print session that is either 3270 or APPC.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v 3270 (0)
v APPC (1)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_PrintSessionType.
Warehouse name
TYPE
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Status Service Print attribute group

This attribute group displays information about Print Service Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status Service Print attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.

Chapter 4. Attributes reference 201

 Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This represents name of the Print Service, name will be the same as the computer
name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServicePrintName.
Warehouse name
NAME
Status attribute
Description
This attribute displays the current status of the service--inactive, pending,
stopping, or active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Stopping (3)
v Pending (2)
v Inactive (1)
v Active (4)
v Empty String (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServicePrintStatus.
Warehouse name
STATUS
Status Text attribute
Description
This attribute displays one of the Status values.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServicePrintStatusText.

202 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
STATUSTEXT

Status Service SNA attribute group

This attribute group displays information about SNA Service Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status Service SNA attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
APPC Sessions attribute
Description
This attribute displays the statistics of APPC sessions on the service.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceSnaAppcSessions.
Warehouse name
APPCSESSIONS or APPCSESSIO
Out of Date attribute
Description
This attribute checks whether change is made in the configuration and if the
service needs to be restarted.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 203

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceSnabOutOfDate.
Warehouse name
BOUTOFDATE
LU3270 Sessions attribute
Description
This attribtute displays the statistics of LU 3270 sessions currently on the service.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceSnaLU3270Sessions.
Warehouse name
LU3270SESSIONS or LU3270SESS
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the service.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceSnaName.
Warehouse name
NAME
Status attribute
Description
This attribute displays the current status of the service that is either Inactive,
Pending, Stopping, or Active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Stopping (3)
v Pending (2)
v Inactive (1)
v Active (4)
v Empty String (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceSnaStatus.
Warehouse name
STATUS
Status Text attribute

204 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute displays one of the status values.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceSnaStatusText.
Warehouse name
STATUSTEXT
Users attribute
Description
This attribute displays the statistics of the users currently on the service.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceSnaUsers.
Warehouse name
USERS

Status Service TN3270 attribute group

This attribute group displays information about TN3270 Service Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status Service TN3270 attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the service, this name is the same as the local
system name.

Chapter 4. Attributes reference 205

 Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceTN3270Name.
Warehouse name
NAME
Status attribute
Description
This attribute displays the current status of the service that is either Inactive,
Pending, Stopping, or Active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Stopping (3)
v Pending (2)
v Inactive (1)
v Active (4)
v Empty String (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceTN3270Status.
Warehouse name
STATUS
Status text attribute
Description
This attribute displays one of the status values.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceTN3270StatusText.
Warehouse name
STATUSTEXT
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Status Service TN5250 attribute group

This attribute group displays information about TN5250 Service Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status Service TN5250 attribute
group:
Node attribute: This attribute is a key attribute.

206 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the service, this name is same as the local
computer name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceTN5250Name.
Warehouse name
NAME
Status attribute
Description
This attribute displays the current status of the service that is either Inactive,
Pending, Stopping, or Active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Stopping (3)
v Pending (2)
v Inactive (1)
v Active (4)
v Empty String (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceTN5250Status.
Warehouse name
STATUS
Status Text attribute
Description
This attribute displays one of the status values.
Type
String

Chapter 4. Attributes reference 207

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ServiceTN5250StatusText.
Warehouse name
STATUSTEXT
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Status SNA Connection attribute group

This attribute group displays information about SNA Connection Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status SNA Connection
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Failcode attribute
Description
This attribute displays the current failure code, the code 0 indicates a non-failure.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ConnectionFailcode.

208 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
FAILCODE
Last Failed Time attribute
Description
This attribute displays the time when failure occurs and is valid only if the
Failcode is not 0; for fail code 0, the fail time displays the last failed time or the
default date and time that the system provides.
Type
Timestamp
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ConnectionFailTime.
Warehouse name
FAILTIME
Inactive State attribute
Description
This attribute displays the additional details for inactive connections.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Incoming (1)
v OnDemandIncoming (3)
v OnDemand (2)
v Inactive (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ConnectionInactiveState.
Warehouse name
INACTIVESTATE or INACTIVEST
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the connection.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ConnectionName.
Warehouse name
NAME
Service Name attribute
Description
This attribute displays the name of the SNA service to which this connection
belongs.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ConnectionServiceName.
Warehouse name
SERVICENAME or SERVICENAM
Status attribute

Chapter 4. Attributes reference 209

 Description
This attribute displays the current status of the SNA connection that is either
Inactive, Pending, Stopping, or Active.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Stopping (3)
v Pending (2)
v Inactive (1)
v Active (4)
v Empty String (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ConnectionStatus.
Warehouse name
STATUS
Status Text attribute
Description
This attribute displays the status of the SNA connection.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_ConnectionStatusText.
Warehouse name
STATUSTEXT

Status TN3270 Session attribute group

This attribute group displays information about TN3270 Session Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status TN3270 Session attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP

210 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Client attribute
Description
This attribute displays client computer name or IP address.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_TN3270SessionClient.
Warehouse name
CLIENT
Name attribute: This attribute is a key attribute.
Description
This attribute displays the name of the service, this name is the same as the
Logical Unit Application (LUA) LU or Pool name.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_TN3270SessionName.
Warehouse name
NAME
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Status TN5250 Session attribute group

This attribute group displays information about TN5250 Session Status.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Status TN5250 Session attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.

Chapter 4. Attributes reference 211

 Warehouse name
TIMESTAMP
APPC LU attribute
Description
This attribute displays the Advanced Program to Program Communications
(APPC) Local LU alias.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_TN5250SessionAPPCLU.
Warehouse name
APPCLU
Client attribute
Description
This attribute displays the name or the IP address of the client computer.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_TN5250SessionClient.
Warehouse name
CLIENT
Mode attribute
Description
This attribute displays the name of the mode for this session.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_TN5250SessionMode.
Warehouse name
MODE
Partner LU attribute
Description
This attribute displays the APPC Partner LU alias, the Partner LU is a Remote LU
or another Local LU.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_TN5250SessionPartnerLU.
Warehouse name
PARTNERLU
TN Session ID attribute: This attribute is a key attribute.
Description
This attribute displays an arbitrary unique ID that represents the session ID.
Type
String
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsSnaStatus_TN5250SessionTNSessionID.
Warehouse name
TNSESSIONID or TNSESSIONI
System Name attribute

212 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

TN3270 Server attribute group

This attribute group helps you to determine how well the HIS application receives and transmits the data
using the TN3270 server.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the TN3270 Server attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Connections Active attribute
Description
This attribute displays the number of TCP connections that are currently active on
the TN3270 Server.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Connections Active.
Warehouse name
CONNECTIONS_ACTIVE or CONNECTION
RUs Inbound attribute
Description
This attribute displays the total number of RUs that the TN3270 Server currently
sends to the IBM host.

Chapter 4. Attributes reference 213

 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\RUs Inbound.
Warehouse name
RUS_INBOUND or RUS_INBOUN
RUs Inbound Per Second attribute
Description
This attribute displays the rate at which TN3270 currently sends RUs the IBM
host.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\RUs Inbound/sec.
Warehouse name
RUS_INBOUND_PER_SEC or RUS_INBOU0
RUs Outbound attribute
Description
This attribute displays the total number of RUs that the IBM host currently
receives from the TN3270 Server.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\RUs Outbound.
Warehouse name
RUS_OUTBOUND or RUS_OUTBOU
RUs Outbound Per Second attribute
Description
This attribute displays the rate at which the TN3270 currently receives the RUs
from the IBM host.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:

214 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\RUs Outbound/Sec.
Warehouse name
RUS_OUTBOUND_PER_SEC or RUS_OUTBO0
RU Throughput attribute
Description
This attribute displays the total number of RUs that the TN3270 Server is
currently sending and receiving.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\RU Throughput.
Warehouse name
RU_THROUGHPUT or RU_THROUGH
RU Throughput Per Second attribute
Description
This attribute displays the rate at which the TN3270 Server currently sends and
receives the RUs.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\RU Throughput/sec.
Warehouse name
RU_THROUGHPUT_PER_SEC or RU_THROUG0
Sessions Active attribute
Description
This attribute displays the number of TN3270 clients that are currently using an
LU.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 215

 Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Active.
Warehouse name
SESSIONS_ACTIVE or SESSIONS_A
Sessions Configured attribute
Description
This attribute displays the number of sessions that are currently available on the
TN3270 Server.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Configured.
Warehouse name
SESSIONS_CONFIGURED or SESSIONS_C
Sessions Ended LULU attribute
Description
This attribute displays the number of TN3270 client sessions that are currently
closed during a session with an IBM host application.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Ended
LULU.
Warehouse name
SESSIONS_ENDED_LULU or SESSIONS_E
Sessions Ended Normal attribute
Description
This attribute displays the number of TN3270 client sessions that are currently
closed normally.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Ended
Normal.
Warehouse name
SESSIONS_ENDED_NORMAL or SESSIONS_0

216 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Sessions Failed attribute
Description
This attribute displays the number of TCP connections that the TN3270 Server are
currently closed.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Failed.
Warehouse name
SESSIONS_FAILED or SESSIONS_F
Sessions Failed Inactivity attribute
Description
This attribute displays the number of TCP connections that the TN3270 Server
currently closed due to inactivity.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Failed
Inactivity.
Warehouse name
SESSIONS_FAILED_INACTIVITY or SESSIONS_1
Sessions Failed No Resource attribute
Description
This attribute displays the number of TN3270 client sessions that were currently
rejected because the SNA resource was not obtained.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Failed No
Resource.
Warehouse name
SESSIONS_FAILED_NO_RESOURCE or SESSIONS_2
Sessions Succeeded attribute
Description
This attribute displays the current number of TN3270 client sessions that
successfully obtained an LU since the start of the TN3270 Server.

Chapter 4. Attributes reference 217

 Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Sessions Succeeded.
Warehouse name
SESSIONS_SUCCEEDED or SESSIONS_S
TCP Throughput attribute
Description
This attribute displays the total number of TCP bytes that the TN3270 Server is
currently sending and receiving.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\TCP Throughput.
Warehouse name
TCP_THROUGHPUT or TCP_THROUG
TCP Throughput Per Second attribute
Description
This attribute displays the rate at which the TN3270 Server currently sends and
receives the TCP bytes.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\TCP Throughput/Sec.
Warehouse name
TCP_THROUGHPUT_PER_SEC or TCP_THROU0
TN3270 Server attribute
Description
This attribute displays the TN3270 Server that is currently in use.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)

218 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\TN3270 Server.
Warehouse name
TN3270_SERVER or TN3270_SER
Users Active attribute
Description
This attribute displays the number of TCP/IP addresses that are currently active
on the TN3270 Server.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is Perfmon - TN3270 Server\*\Users Active.
Warehouse name
USERS_ACTIVE or USERS_ACTI
TCP Kilobytes Received attribute
Description
This attribute displays the total number of TCP data in KB that the TN3270
Server is currently receiving.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: TCP_Bytes_Received / 1024.
Warehouse name
TCP_KILO_BYTES_RECEIVED or TCP_KILO_B
TCP Kilobytes Received Per Second attribute
Description
This attribute displays the total number of TCP data in KB that the TN3270
Server is currently receiving per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: TCP_Bytes_Received_per_Sec / 1024.

Chapter 4. Attributes reference 219

 Warehouse name
TCP_KILO_BYTES_RECEIVED_SEC or TCP_KILO_0
TCP Kilobytes Sent attribute
Description
This attribute displays the total number of TCP data in KB kilobytes that the
TN3270 Server is currently sending.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: TCP_Bytes_Sent / 1024.
Warehouse name
TCP_KILO_BYTES_SENT or TCP_KILO_1
TCP Kilobytes Sent Per Second attribute
Description
This attribute displays the total number of TCP data in KB that the TN3270
Server is currently sending per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: TCP_Bytes_Sent_per_Sec / 1024.
Warehouse name
TCP_KILO_BYTES_SENT_SEC or TCP_KILO_2
TCP Throughput in Kilobytes attribute
Description
This attribute displays the total number of TCP bytes that the TN3270 Server is
currently sending and receiving.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: TCP_Throughput / 1024.
Warehouse name
TCP_KILO_THROUGHPUT or TCPKILOTHR
TCP Throughput in Kilobytes Per Second attribute

220 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
This attribute displays the total number of TCP bytes that the TN3270 Server
currently sends and receives per second.
Type
Real number (32-bit gauge) with three decimal places of precision with
enumerated values. The strings are displayed in the Tivoli Enterprise Portal. The
warehouse and queries return the values that are shown in parentheses. The
following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is derived: TCP_Throughput_per_Sec / 1024.
Warehouse name
TCP_KILO_THROUGHPUT_PER_SEC or TCPKLTHRPS
System Name attribute
Description
This attribute indicates the system name.
Type
String
Source
The source for this attribute is derived: getenv("computername").
Warehouse name
SYSTEM_NAME or SYS_NAME

Trace SNA Application attribute group

This attribute group displays information about SNA Application tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA Application
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
APPC Trace attribute
Description
This attribute checks whether APPC tracing is enabled.

Chapter 4. Attributes reference 221

 Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationAPPCTrace.
Warehouse name
APPCTRACE
CPIC Trace attribute
Description
This attribute checks whether CPI-C tracing is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationCPICTrace.
Warehouse name
CPICTRACE
CSV Trace attribute
Description
This attribute checks whether CSV tracing is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationCSVTrace.
Warehouse name
CSVTRACE
Enabled Traces attribute
Description
This attribute specifies the Internal Trace condition to record.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Fatal trace mask (1)
v Error trace mask (2)

222 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v Debug trace mask (4)
v State trace mask (8)
v Function trace mask (16)
v Message trace mask (32)
v Custom trace mask (64)
v Plan enter exit mask (128)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether the LU 6.2 tracing is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationLU62Trace.
Warehouse name
LU62TRACE
LUA Trace attribute
Description
This attribute checks whether the LUA tracing is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 223

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationLUATrace.
Warehouse name
LUATRACE
T3270 Trace attribute
Description
This attribute checks whether the 3270 tracing is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAApplicationT3270Trace.
Warehouse name
T3270TRACE

Trace SNA Base attribute group

This attribute group displays information about SNA Base tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA Base attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition that is currently recorded.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the

224 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNABaseEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNABaseInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether LU 6.2 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNABaseLU62Trace.
Warehouse name
LU62TRACE
T3270 Trace attribute
Description
This attribute checks whether 3270 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 225

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNABaseT3270Trace.
Warehouse name
T3270TRACE

Trace SNA Manage Client attribute group

This attribute group displays information about SNA Manage Client tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA Manage Client
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition that is currently recorded.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAManageClientEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:

226 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAManageClientInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME

Trace SNA Mng Agent attribute group

This attribute group displays information about SNA Server Management Agent tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA Mng Agent
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition that is currently recorded.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAMngAgentEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute

Chapter 4. Attributes reference 227

 Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAMngAgentInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME

Trace SNA NetView attribute group

This attribute group displays information about SNA NetView Management tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA NetView attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
DLC Trace attribute
Description
This attribute checks whether DLC tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

228 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNANetMnDLCTrace.
Warehouse name
DLCTRACE
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition to record.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Fatal trace mask (1)
v Error trace mask (2)
v Debug trace mask (4)
v State trace mask (8)
v Function trace mask (16)
v Message trace mask (32)
v Custom trace mask (64)
v Plan enter exit mask (128)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNANetMnEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNANetMnInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether LU 6.2 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 229

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNANetMnLU62Trace.
Warehouse name
LU62TRACE
Sna Trace attribute
Description
This attribute checks whether SNA tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNANetMnSnaTrace.
Warehouse name
SNATRACE
T3270 Trace attribute
Description
This attribute checks whether 3270 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNANetMnT3270Trace.
Warehouse name
T3270TRACE

Trace SNA Print attribute group

This attribute group displays information about SNA Print tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA Print attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.

230 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
APPC Trace attribute
Description
This attribute checks whether APPC tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintAPPCTrace.
Warehouse name
APPCTRACE
CPIC Trace attribute
Description
This attribute checks whether CPI-C tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintCPICTrace.
Warehouse name
CPICTRACE
CSV Trace attribute
Description
This attribute checks whether CSV tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 231

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintCSVTrace.
Warehouse name
CSVTRACE
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition to record.
Type
Integer (32-bit gauge) with enumerated values. The strings are displayed in the
Tivoli Enterprise Portal. The warehouse and queries return the values that are
shown in parentheses. The following values are defined:
v Value Exceeds Maximum (2147483647)
v Value Exceeds Minimum (-2147483648)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether the LU 6.2 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintLU62Trace.
Warehouse name
LU62TRACE

232 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 LUA Trace attribute
Description
This attribute checks whether the LUA tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintLUATrace.
Warehouse name
LUATRACE
T3270 Trace attribute
Description
This attribute checks whether the 3270 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAPrintT3270Trace.
Warehouse name
T3270TRACE

Trace SNA Server attribute group

This attribute group displays information about SNA Server tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA Server attribute
group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String

Chapter 4. Attributes reference 233

 Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
DLC Trace attribute
Description
This attribute checks whether DLC tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerDLCTrace.
Warehouse name
DLCTRACE
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition to record.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Fatal trace mask (1)
v Error trace mask (2)
v Debug trace mask (4)
v State trace mask (8)
v Function trace mask (16)
v Message trace mask (32)
v Custom trace mask (64)
v Plan enter exit mask (128)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

234 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether LU 6.2 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerLU62Trace.
Warehouse name
LU62TRACE
Sna Trace attribute
Description
This attribute checks whether SNA tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerSnaTrace.
Warehouse name
SNATRACE
T3270 Trace attribute
Description
This attribute checks whether 3270 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerT3270Trace.
Warehouse name
T3270TRACE

Chapter 4. Attributes reference 235

Trace SNA Server Manager attribute group
This attribute group displays information about SNA Server Manager tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace SNA Server Manager
attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
APPC Trace attribute
Description
This attribute checks whether APPC tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerAPPCTrace.
Warehouse name
APPCTRACE
CPIC Trace attribute
Description
This attribute checks whether CPI-C tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

236 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerCPICTrace.
Warehouse name
CPICTRACE
CSV Trace attribute
Description
This attribute checks whether CSV tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerCSVTrace.
Warehouse name
CSVTRACE
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition to record.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Fatal trace mask (1)
v Error trace mask (2)
v Debug trace mask (4)
v State trace mask (8)
v Function trace mask (16)
v Message trace mask (32)
v Custom trace mask (64)
v Plan enter exit mask (128)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerEnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

Chapter 4. Attributes reference 237

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerInternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether LU 6.2 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerLU62Trace.
Warehouse name
LU62TRACE
LUA Trace attribute
Description
This attribute checks whether LUA tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerLUATrace.
Warehouse name
LUATRACE
T3270 Trace attribute
Description
This attribute checks whether 3270 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_SNAServerManagerT3270Trace.

238 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
T3270TRACE

Trace TN3270 attribute group

This attribute group displays information about TN3270 tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace TN3270 attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
APPC Trace attribute
Description
This attribute checks whether APPC tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270APPCTrace.
Warehouse name
APPCTRACE
CPIC Trace attribute
Description
This attribute checks whether CPI-C tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.

Chapter 4. Attributes reference 239

 Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270CPICTrace.
Warehouse name
CPICTRACE
CSV Trace attribute
Description
This attribute checks whether CSV tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270CSVTrace.
Warehouse name
CSVTRACE
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition to record.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Fatal trace mask (1)
v Error trace mask (2)
v Debug trace mask (4)
v State trace mask (8)
v Function trace mask (16)
v Message trace mask (32)
v Custom trace mask (64)
v Plan enter exit mask (128)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270EnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

240 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270InternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether LU 6.2 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270LU62Trace.
Warehouse name
LU62TRACE
LUA Trace attribute
Description
This attribute checks whether LUA tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270LUATrace.
Warehouse name
LUATRACE
T3270 Trace attribute
Description
This attribute checks whether 3270 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270T3270Trace.

Chapter 4. Attributes reference 241

 Warehouse name
T3270TRACE
Trace State attribute
Description
This attribute checks whether the TN3270 internal tracing is enabled on the
server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE/NA (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN3270TraceState.
Warehouse name
TRACESTATE

Trace TN5250 attribute group

This attribute group displays information about TN5250 tracing.
Historical group
This attribute group is eligible for use with Tivoli Data Warehouse.
Attribute descriptions
The following list contains information about each attribute in the Trace TN5250 attribute group:
Node attribute: This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Source
The source for this attribute is the agent.
Warehouse name
TIMESTAMP
APPC Trace attribute
Description
This attribute checks whether APPC tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)

242 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250APPCTrace.
Warehouse name
APPCTRACE
CPIC Trace attribute
Description
This attribute checks whether CPI-C tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250CPICTrace.
Warehouse name
CPICTRACE
CSV Trace attribute
Description
This attribute checks whether CSV tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250CSVTrace.
Warehouse name
CSVTRACE
Enabled Traces attribute
Description
This attribute represents the Internal Trace condition to record.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v Fatal trace mask (1)
v Error trace mask (2)
v Debug trace mask (4)
v State trace mask (8)
v Function trace mask (16)
v Message trace mask (32)
v Custom trace mask (64)
v Plan enter exit mask (128)

Chapter 4. Attributes reference 243

 Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250EnabledTraces.
Warehouse name
ENABLEDTRACES or ENABLEDTRA
Internal Message Trace attribute
Description
This attribute checks whether the tracing of the internal message is enabled on
the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250InternalMessageTrace.
Warehouse name
INTERNALMESSAGETRACE or INTERNALME
LU62 Trace attribute
Description
This attribute checks whether LU 6.2 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250LU62Trace.
Warehouse name
LU62TRACE
LUA Trace attribute
Description
This attribute checks whether LUA tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250LUATrace.

244 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Warehouse name
LUATRACE
T3270 Trace attribute
Description
This attribute checks whether 3270 tracing is enabled on the server.
Type
Integer with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown in
parentheses. The following values are defined:
v TRUE (-1)
v FALSE (0)
Any other value is the value that is returned by the agent in the Tivoli Enterprise
Portal.
Source
The source for this attribute is WMI - root\MicrosoftHIS\
MsHisTrace_TN5250T3270Trace.
Warehouse name
T3270TRACE

Disk capacity planning for historical data

Disk capacity planning for a monitoring agent is a prediction of the amount of disk space to be
consumed by the historical data in each attribute group that is collecting historical data. Required disk
storage is an important factor when you are defining data collection rules and your strategy for historical
data collection.

The Capacity planning for historical data table provides the following information, which is required to
calculate disk space for this monitoring agent:
Table Table name as it is displayed in the warehouse database, if the attribute group is configured to be
written to the warehouse. The table name listed here corresponds to the table name in “Attribute
groups for the monitoring agent” on page 25.
Attribute group
Name of the attribute group that is used to create the table in the warehouse database if it is
short enough to fit in the table naming constraints of the database that is being used for the
warehouse. The attribute group name listed here corresponds to the Warehouse table name in
“Attribute groups for the monitoring agent” on page 25.
Bytes per row (agent)
Estimate of the record length for each row or instance that is written to the agent disk for
historical data collection. This estimate can be used for agent disk space planning purposes.
Database bytes per row (warehouse)
Estimate of the record length for detailed records that are written to the warehouse database, if
the attribute group is configured to be written to the warehouse. Detailed records are records that
have been uploaded from the agent for long-term historical data collection. This estimate can be
used for warehouse disk-space planning purposes.
Aggregate bytes per row (warehouse)
Estimate of the record length for aggregate records that are written to the warehouse database, if
the attribute group is configured to be written to the warehouse. Aggregate records are created by
the Summarization agent for attribute groups that have been configured for summarization. This
estimate can be used for warehouse disk-space planning purposes.

In addition to the information in the tables, you must know the number of rows of data that you plan to
collect. An attribute group can have single or multiple rows of data, depending on the application

Chapter 4. Attributes reference 245

environment that is being monitored. For example, if your attribute group monitors each processor in
your computer and you have a dual processor computer, the number of rows is two.

246 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 1. Capacity planning for historical data logged by the
Database Aggregate
Bytes per bytes per bytes per
row row row
Table Attribute group (agent) (warehouse) (warehouse)
KQHAPPINTE KQH_APPLICATION_INTEGRATION_HIP 332 555 1591
KQHAPPINT1 KQH_APPLICATION_INTEGRATION_WIP 340 613 1775
KQHAVAIL KQH_AVAILABILITY 3272 3296 3606
KQHEVTLOG KQH_EVENT_LOG 2240 2246 2283
KQHHISDATA KQH_HIS_DATABASES 332 332 369
KQHHISINFO KQH_HIS_INFORMATION 332 332 369
KQHMSHIS01 KQH_HIS_TRACING 216 217 254
KQHMSSNALI KQH_LINK_SERVICE 1129 1137 1252
KQHDISTLS KQH_LINK_SERVICE_DISTRIBUTED 524 525 562
KQHMSSNAL1 KQH_LINK_SERVICE_IPDLC 4947 4985 5529
KQHSDLCLS KQH_LINK_SERVICE_SDLC 524 525 562
KQHMANAGE0 KQH_MANAGED_APPLICATION_ 268 320 627
INTEGRATION
KQHMQBRID1 KQH_MQBRIDGE 164 167 438
KQHMSHISMQ KQH_MQBRIDGE_CHANNEL 464 467 543
KQHMSHISM2 KQH_MQBRIDGE_CONNECTED_NETWORK 272 272 348
KQHMSHISM3 KQH_MQBRIDGE_MESSAGE_PIPE 240 247 635
KQHMQBRID2 KQH_MQBRIDGE_MQS_TO_MSMQ 292 309 775
KQHMQBRID3 KQH_MQBRIDGE_MQS_TO_MSMQ_TX 292 309 775
KQHMQBRID4 KQH_MQBRIDGE_MSMQ_TO_MQS 292 309 775
KQHMQBRID5 KQH_MQBRIDGE_MSMQ_TO_MQS_TX 292 309 775
KQHMSHISM1 KQH_MQBRIDGE_SERVICE 164 167 399
KQHMSFTDB2 KQH_MSFT_DB2_ACCESS_LIBRARY 336 622 1811
KQHPOBJST KQH_PERFORMANCE_OBJECT_STATUS 352 399 664
KQHSESSIO1 KQH_SESSION_INTEGRATOR_SERVER 172 237 646
KQHSESSIO2 KQH_SESSION_INTEGRATOR_SERVER_ 268 333 703
PLUS
KQHSNA3270 KQH_SNA_3270_RESPONSE_TIMES 260 263 495
KQHMSSNAA0 KQH_SNA_APPC_MODE 227 238 587
KQHMSSNACO KQH_SNA_CONFIGURED_USERS 216 216 370
KQHSNACON0 KQH_SNA_CONNECTIONS 192 241 482
KQHMSSNAC0 KQH_SNA_CONNECTION_CONFIGURATION 1479 1503 1618
KQHMSSNAD0 KQH_SNA_DOMAIN 1200 1226 1497
KQHSNATOPO KQH_SNA_DOMAIN_TOPOLOGY 588 589 626
KQHSNALOG0 KQH_SNA_LOGICAL_UNIT_SESSIONS 192 241 482
KQHMSSNAL0 KQH_SNA_LU3270 299 303 379
KQHMSSNAAL KQH_SNA_LU_APPCLOCAL 476 482 675
KQHMSSNAAR KQH_SNA_LU_APPCREMOTE 536 542 696
KQHMSSNAL3 KQH_SNA_LU_DISPLAY 267 273 349

Chapter 4. Attributes reference 247

KQHMSSNAL2 KQH_SNA_LU_LUA 239 243 319
KQHMSSNAL4 KQH_SNA_LU_PRINT 259 263 339
KQHMSSNAPO KQH_SNA_POOL 239 238 275
KQHMSSNAP0 KQH_SNA_POOL_DISPLAY 187 188 225
KQHMSSNAPR KQH_SNA_PRINT_SESSION 4396 4445 4794
KQHMSSNAS0 KQH_SNA_SERVER 312 313 350
KQHMSSNA13 KQH_SNA_SERVICE 311 313 350
KQHMSSNA12 KQH_SNA_SERVICE_PRINT 220 230 345
KQHMSSNA14 KQH_SNA_SERVICE_TN3270 1100 1120 1547
KQHMSSNA15 KQH_SNA_SERVICE_TN5250 251 251 327
KQHMSSNAST KQH_STATUS_APPC_LOCAL_LU 276 277 392
KQHMSSNAS5 KQH_STATUS_APPC_SESSION 252 252 289
KQHMSSNAS8 KQH_STATUS_CLIENT_CONNECTION 1884 1895 1932
KQHMSSNAS1 KQH_STATUS_LU3270 1068 1075 1190
KQHMSSNAS3 KQH_STATUS_PRINT_SESSION 280 282 436
KQHMSSNA11 KQH_STATUS_SERVICE_PRINT 208 207 283
KQHMSSNA10 KQH_STATUS_SERVICE_SNA 224 227 420
KQHMSSNAS9 KQH_STATUS_SERVICE_TN3270 272 272 348
KQHMSSNAS6 KQH_STATUS_SERVICE_TN5250 272 272 348
KQHMSSNAS4 KQH_STATUS_SNA_CONNECTION 256 259 413
KQHMSSNAS7 KQH_STATUS_TN3270_SESSION 972 975 1012
KQHMSSNAS2 KQH_STATUS_TN5250_SESSION 460 462 499
KQHTN3270S KQH_TN3270_SERVER 240 382 1514
KQHMSHIST7 KQH_TRACE_SNA_APPLICATION 108 112 149
KQHMSHIST1 KQH_TRACE_SNA_BASE 92 92 168
KQHMSHISTR KQH_TRACE_SNA_MANAGE_CLIENT 84 82 158
KQHMSHIST3 KQH_TRACE_SNA_MNG_AGENT 84 82 158
KQHMSHIST5 KQH_TRACE_SNA_NETVIEW 100 102 139
KQHMSHIST2 KQH_TRACE_SNA_PRINT 108 112 188
KQHMSHIST4 KQH_TRACE_SNA_SERVER 100 102 139
KQHMSHIST8 KQH_TRACE_SNA_SERVER_MANAGER 108 112 149
KQHMSHIST9 KQH_TRACE_TN3270 112 117 154
KQHMSHIST6 KQH_TRACE_TN5250 108 112 149

For more information about historical data collection, see “Managing historical data” in the IBM Tivoli
Monitoring Administrator's Guide.

248 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Chapter 5. Situations reference
A situation is a logical expression involving one or more system conditions. Situations are used to
monitor the condition of systems in your network. You can manage situations from the Tivoli Enterprise
Portal by using the Situation Editor or from the command-line interface using the tacmd commands for
situations. You can manage private situations in the private configuration XML file.

About situations

The monitoring agents that you use to monitor your system environment include a set of predefined
situations that you can use as-is. You can also create new situations to meet your requirements.

Predefined situations contain attributes that check for system conditions common to many enterprises.
Using predefined situations can improve the speed with which you can begin using the IBM Tivoli
Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent. You
can change the conditions or values being monitored by a predefined situation to the conditions or values
best suited to your enterprise.

You can display predefined situations and create your own situations using the Situation editor. The
Situation editor initially lists the situations associated with the Navigator item that you selected. When
you click a situation name or create a situation, a panel opens with the following tabs:
Formula
Formula describing the condition being tested.
Distribution
List of managed systems (operating systems, subsystems, or applications) to which the situation
can be distributed. All the managed systems are assigned by default.
Expert advice
Comments and instructions to be read in the event workspace.
Action
Command to be sent to the system.
EIF Customize forwarding of the event to an Event Integration Facility receiver. (Available when the
Tivoli Enterprise Monitoring Server is configured to forward events.)
Until Options to close the event after a period of time, or when another situation becomes true.

Additional information about situations

The Tivoli Enterprise Portal User's Guide contains more information about predefined and custom
situations and how to use them to respond to alerts.

For a list of the predefined situations and information about each individual situation for this monitoring
agent, see “Predefined situations.”

Predefined situations
The monitoring agent contains predefined situations, which are organized by Navigator item.
v Microsoft Host Integration Server
– Not applicable
v Application Integration
– KQH_Many_Host_Req_Rejected

© Copyright IBM Corp. 2010, 2013 249

 – KQH_Many_Host_Req_Queued
v Availability
– KQH_ESSO_Server_Down_Warn
– KQH_LU_RESYNCSVC_Down_Crit
– KQH_TCP_RESYNC_Down_Crit
– KQH_SIS_Server_Down_Crit
– KQH_MQBridge_Down_Crit
– KQH_SNA_DDM_Down_Crit
– KQH_SNA_MNGAGENT_Down_Crit
– KQH_SNA_RPC_Down_Crit
– KQH_SNA_NetView_Down_Warn
– KQH_SNA_BASE_Down_Crit
– KQH_SNA_PRINT_Down_Warn
– KQH_SNA_Server_Down_Crit
– KQH_SNA_Server02_Down_Crit
– KQH_SNA_Server03_Down_Crit
– KQH_SNA_Server04_Down_Crit
– KQH_TN3270_Down_Crit
– KQH_TN5250_Down_Crit
– KQH_Link_Service_Down
v Data Integration
– Not applicable
v Databases
– Not applicable
v Event Log
– KQH_3270Session_Supp_Crit
– KQH_APPCSession_Failure_Crit
– KQH_Local_Param_Invalid_Warn
– KQH_TI_Exception_Warn
– KQH_IHVDLL_LoadingFailed_Warn
– KQH_LU62_Resync_Start_Warn
– KQH_Status_Failed_Warn
– KQH_DLUS_PU_Conn_Failed_Warn
– KQH_APPC_TP_Failed_One_Warn
– KQH_Unexpected_Logic_Err_Crit
– KQH_TN3270_Trace_Failed_Warn
– KQH_SNA_Mng_Conn_Failed_Warn
– KQH_SNABase_StartUp_Fail_Warn
– KQH_APPC_Session_Act_Fail_Warn
– KQH_Primary_HIS_Exist_Warn
– KQH_HIP_Listener_Event
– KQH_HIP_App_State_Event
– KQH_HIP_Auth_Error_Event
– KQH_WIP_COM_Event_Occured
– KQH_WIP_State_Machine_Event

250 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – KQH_TN3270_Service_Stopped
v HIS Tracing
– Not applicable
v Message Integration
– Not applicable
v SNA Server
– Not applicable
v Status and Configuration
– KQH_SNA_Server_Unreachable
– KQH_SNA_Connection_Inactive
– KQH_SNA_Connection_Failure
– KQH_SNA_Service_Inactive
– KQH_SNA_Service_OutOfDate
v TN3270 Server
– Not applicable

Situation descriptions
Each situation description provides information about the situation that you can use to monitor the
condition of systems in your network.

The situation descriptions provide the following information:

Description
Information about the conditions that the situation tests.
Formula
Syntax that contains one or more logical expressions that describe the conditions for the situation
to monitor.
Distribution
Whether the situation is automatically distributed to instances of the agent or is available for
manual distribution.
Run at startup
Whether the situation starts monitoring when the agent starts.
Sampling interval
Number of seconds that elapse between one sample of data that the monitoring agent collects for
the server and the next sample.
Situation persistence
Whether the conditions specified in the situation evaluate to "true" for the defined number of
occurrences in a row before the situation is raised. The default of one means that no
persistence-checking takes place.
Severity
Severity of the predefined events: Warning, Informational, or Critical.
Clearing conditions
Controls when a true situation closes: after a period, when another situation is true, or whichever
occurs first if both are selected.

Microsoft Host Integration Server Navigator item

No predefined situations are included for this Navigator item.

Chapter 5. Situations reference 251

Application Integration Navigator item
The situation descriptions are organized by the Navigator item to which the situations are relevant.
KQH_Many_Host_Req_Rejected situation
Description
Excessive host requests are rejected by the HIP application.
The situation is evaluated for each distinct value of the NAME attribute.
Formula
*IF *VALUE KQH_APPLICATION_INTEGRATION_HIP.Host_requests_rejected_sec *GE 180
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_Many_Host_Req_Queued situation
Description
Excessive host requests are queued in the HIP application.
The situation is evaluated for each distinct value of the NAME attribute.
Formula
*IF *VALUE KQH_APPLICATION_INTEGRATION_HIP.Host_requests_queued *GE 900
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.

Availability Navigator item

The situation descriptions are organized by the Navigator item to which the situations are relevant.
KQH_ESSO_Server_Down_Warn situation
Description
Enterprise Single Sign on service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.

252 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ ENTSSO *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_LU_RESYNCSVC_Down_Crit situation
Description
HIS LU62 Resync service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ UN2 *AND *VALUE KQH_AVAILABILITY.Status *EQ
DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_TCP_RESYNC_Down_Crit situation
Description
HIS TCP/IP Resync service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ DRDAResync *AND *VALUE
KQH_AVAILABILITY.Status *EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No

Chapter 5. Situations reference 253

 Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SIS_Server_Down_Crit situation
Description
Session integrator server service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF (*VALUE KQH_AVAILABILITY.Name *EQ siserver *OR *VALUE KQH_AVAILABILITY.Name
*EQ SIServer) *AND *VALUE KQH_AVAILABILITY.Status *EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_MQBridge_Down_Crit situation
Description
Microsoft MSMQ-MQSeries bridge service is down/has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ MQBridge *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_DDM_Down_Crit situation

254 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Description
SNA DDM service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaDdm *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_MNGAGENT_Down_Crit situation
Description
SNA MngAgent service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ MngAgent *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_RPC_Down_Crit situation
Description
SNA RPC service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaRpcService *AND *VALUE
KQH_AVAILABILITY.Status *EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.

Chapter 5. Situations reference 255

 Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_NetView_Down_Warn situation
Description
SnaNetMn service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaNetMn *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_BASE_Down_Crit situation
Description
SnaBase service is down or not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaBase *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.

256 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_PRINT_Down_Warn situation
Description
SnaPrint service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF (*VALUE KQH_AVAILABILITY.Name *EQ SnaPrint *OR *VALUE KQH_AVAILABILITY.Name
*EQ SNAPrint) *AND *VALUE KQH_AVAILABILITY.Status *EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Server_Down_Crit situation
Description
SNA server is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaServr *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Server02_Down_Crit situation
Description
SNA server 02 is down or has not started.
The situation is evaluated for each distinct value of Application_Component.

Chapter 5. Situations reference 257

 Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaSrv02 *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Server03_Down_Crit situation
Description
SNA server 03 is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaSrv03 *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Server04_Down_Crit situation
Description
SNA server 04 is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ SnaSrv04 *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No

258 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_TN3270_Down_Crit situation
Description
TN3270 service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ TN3270 *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_TN5250_Down_Crit situation
Description
TN5250 service is down or has not started.
The situation is evaluated for each distinct value of Application_Component.
Formula
*IF *VALUE KQH_AVAILABILITY.Name *EQ TN5250 *AND *VALUE KQH_AVAILABILITY.Status
*EQ DOWN
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.
KQH_Link_Service_Down situation

Chapter 5. Situations reference 259

 Description
The Link Service is stopped.
The situation is evaluated for each distinct value of Full_Name.
Formula
*IF ( ( *STR KQH_AVAILABILITY.Name *EQ 1,’snademo’ *AND *VALUE
KQH_AVAILABILITY.Status *EQ DOWN ) *OR ( *STR KQH_AVAILABILITY.Name *EQ 1,’snaip’
*AND *VALUE KQH_AVAILABILITY.Status *EQ DOWN ) )
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Critical
Clearing conditions
The situation clears when the condition becomes false.

Data Integration Navigator item

No predefined situations are included for this Navigator item.

Databases Navigator item

No predefined situations are included for this Navigator item.

Event Log Navigator item

The situation descriptions are organized by the Navigator item to which the situations are relevant.
KQH_3270Session_Supp_Crit situation
Description
The TN3270E service has terminated abnormally.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 6 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’Session Integrator Server’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 24 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’Session
Integrator Server’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Critical

260 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Clearing conditions
The situation does not clear automatically.
KQH_APPCSession_Failure_Crit situation
Description
APPC session activation failure occurs.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 17 *AND *VALUE KQH_EVENT_LOG.Event_Source
*EQ ’SNA Server’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Critical
Clearing conditions
The situation does not clear automatically.
KQH_Local_Param_Invalid_Warn situation
Description
XID from the mainframe contains invalid local parameters.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( (*VALUE KQH_EVENT_LOG.Event_ID *EQ 49 *OR *VALUE KQH_EVENT_LOG.Event_ID *EQ
56)*AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’SNA Server’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_TI_Exception_Warn situation
Description
COMTI Exception reports an exception.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 102 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’COMTI’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.

Chapter 5. Situations reference 261

 Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_IHVDLL_LoadingFailed_Warn situation
Description
Unable to load IHV DLL when the virus checking tool is running.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 128 *AND (*VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA Channel Link Service’ *OR *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA DFT Link Service’ *OR *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA DLC Link Service’ *OR *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA IP-DLC Link Service’ *OR *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA SDLC Link Service’ *OR *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA Twinax Link Service’ *OR *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA X.25 Link Service’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_LU62_Resync_Start_Warn situation
Description
The HIS LU62 Resync service cannot initiate an XLN sequence.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 133 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA LU6.2 Resync TP’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.

262 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_Status_Failed_Warn situation
Description
Host Integration Server 2006 fails to activate.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 230 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA DLC Link Service’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_DLUS_PU_Conn_Failed_Warn situation
Description
Failed to contact a DLUS for PU, retry count exceeded.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *EQ 590 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA IP-DLC Link Service’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 624 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’SNA
Server’) *OR ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 4097 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’DrWatson’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 23 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’SNA
Server’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_APPC_TP_Failed_One_Warn situation

Chapter 5. Situations reference 263

 Description
Failed to invoke the APPC Transaction Program (TP).
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *EQ 703 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA Base Service’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 60 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’SNA
Server’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_Unexpected_Logic_Err_Crit situation
Description
Occurence of TN3270 session timeout.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 902 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’TN3270 Server’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Critical
Clearing conditions
The situation does not clear automatically.
KQH_TN3270_Trace_Failed_Warn situation
Description
Windows API SetCurrentDirectory stops with the error code 5L.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 903 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’TN3270 Server’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.

264 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_SNA_Mng_Conn_Failed_Warn situation
Description
SNA Manage Client fails to connect with SNA MngAgent service.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *EQ 5174 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA Manage Client’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 5175 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’SNA
Manage Client’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_SNABase_StartUp_Fail_Warn situation
Description
Dump file is created if the SNABase service has ended abruptly.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 624 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA Server’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning

Chapter 5. Situations reference 265

 Clearing conditions
The situation does not clear automatically.
KQH_APPC_Session_Act_Fail_Warn situation
Description
The APPC session has failed to activate.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 26 *AND *VALUE KQH_EVENT_LOG.Event_Source
*EQ ’SNA Server’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_Primary_HIS_Exist_Warn situation
Description
A primary Host Integration Server already exists.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 658 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’SNA Base’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_HIP_Listener_Event situation
Description
A critical event related to an HIP listener occurred.
The situation is evaluated for each distinct value of Event_ID.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *GE 737 *AND *VALUE KQH_EVENT_LOG.Event_ID
*LE 742 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’HIP’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 731 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’HIP

266 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Service’) *OR ( *VALUE KQH_EVENT_LOG.Event_ID *GE 737 *AND *VALUE
KQH_EVENT_LOG.Event_ID *LE 742 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’HIP
Service’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_HIP_App_State_Event situation
Description
A critical event related to an HIP application state occurred.
The situation is evaluated for each distinct value of Event_ID.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *EQ 807 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’HIP Service’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 808 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’HIP
Service’) *OR ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 815 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’HIP Service’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_HIP_Auth_Error_Event situation
Description
A critical event related to HIP authentication occurred.
The situation is evaluated for each distinct value of Event_ID.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *GE 837 *AND *VALUE KQH_EVENT_LOG.Event_ID
*LE 841 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’HIP’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *GE 837 *AND *VALUE KQH_EVENT_LOG.Event_ID *LE 841 *AND
*VALUE KQH_EVENT_LOG.Event_Source *EQ ’HIP Service’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.

Chapter 5. Situations reference 267

 Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_WIP_COM_Event_Occured situation
Description
The COM warning event related to the WIP application occurred.
The situation is evaluated for each distinct value of Event_ID.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *GE 103 *AND *VALUE KQH_EVENT_LOG.Event_ID
*LE 104 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’COMTI’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *GE 113 *AND *VALUE KQH_EVENT_LOG.Event_ID *LE 116 *AND
*VALUE KQH_EVENT_LOG.Event_Source *EQ ’COMTI’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_WIP_State_Machine_Event situation
Description
The state machine warning events related to WIP occurred.
The situation is evaluated for each distinct value of Event_ID.
Formula
*IF (( *VALUE KQH_EVENT_LOG.Event_ID *EQ 200 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’COMTI’) *OR ( *VALUE KQH_EVENT_LOG.Event_ID
*EQ 300 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ ’COMTI’) *OR ( *VALUE
KQH_EVENT_LOG.Event_ID *EQ 301 *AND *VALUE KQH_EVENT_LOG.Event_Source *EQ
’COMTI’))
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
None. Data is analyzed when it becomes available.

268 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Situation persistence
Not Applicable
Error conditions
Warning
Clearing conditions
The situation does not clear automatically.
KQH_TN3270_Service_Stopped situation
Description
The IPDLC Link Service or TN3270 Service is stopped.
The situation is evaluated for each distinct value of Event_Source.
Formula
*IF ( *VALUE KQH_EVENT_LOG.Event_ID *EQ 1000 *AND *VALUE
KQH_EVENT_LOG.Event_Source *EQ ’Application Error’)
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
None. Data is analyzed when it becomes available.
Situation persistence
Not Applicable
Error conditions
Critical
Clearing conditions
The situation does not clear automatically.

HIS Tracing Navigator item

No predefined situations are included for this Navigator item.

Message Integration Navigator item

No predefined situations are included for this Navigator item.

SNA Server Navigator item

No predefined situations are included for this Navigator item.

Status and Configuration Navigator item

The situation descriptions are organized by the Navigator item to which the situations are relevant.
KQH_SNA_Server_Unreachable situation
Description
The SNA Server is not working.
The situation is evaluated for each distinct value of the SNASER attribute.
Formula
*IF *VALUE KQH_SNA_DOMAIN_TOPOLOGY.StatusText *NE ’Running’
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes

Chapter 5. Situations reference 269

 Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Connection_Inactive situation
Description
SNA connection is inactive.
The situation is evaluated for each distinct value of the NAME attribute.
Formula
*IF *VALUE KQH_STATUS_SNA_CONNECTION.Status *EQ ’Inactive’
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Connection_Failure situation
Description
The SNA connection failed to start.
The situation is evaluated for each distinct value of the NAME attribute.
Formula
*IF *VALUE KQH_STATUS_SNA_CONNECTION.Failcode *EQ 1
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is available for distribution.
Run at startup
No
Sampling interval
5 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Service_Inactive situation
Description
The SNA Service is in the inactive state.

270 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 The situation is evaluated for each distinct value of the NAME attribute.
Formula
*IF *VALUE KQH_STATUS_SERVICE_SNA.Status *EQ ’Inactive’
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.
KQH_SNA_Service_OutOfDate situation
Description
The SNA Service is displayed as Out Of Date.
The situation is evaluated for each distinct value of the NAME attribute.
Formula
*IF *VALUE KQH_STATUS_SERVICE_SNA.bOutOfDate *EQ TRUE
See “Attributes in each attribute group” on page 30 for descriptions of the attributes in
this formula.
Distribution
This situation is automatically distributed to instances of this agent.
Run at startup
Yes
Sampling interval
10 minutes
Situation persistence
The number of times the conditions of the situation must occur for the situation to be
true is 1.
Error conditions
Warning
Clearing conditions
The situation clears when the condition becomes false.

TN3270 Server Navigator item

No predefined situations are included for this Navigator item.

Chapter 5. Situations reference 271

272 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Chapter 6. Take Action commands reference
Take Action commands can be run from the portal client or included in a situation or a policy.

About Take Action commands

When included in a situation, the command runs when the situation becomes true. A Take Action
command in a situation is also referred to as reflex automation. When you enable a Take Action command
in a situation, you automate a response to system conditions. For example, you can use a Take Action
command to send a command to restart a process on the managed system or to send a text message to a
cell phone.

In advanced automation, policies are used to take actions, schedule work, and automate manual tasks. A
policy comprises a series of automated steps called activities that are connected to create a workflow.
After an activity is completed, the Tivoli Enterprise Portal receives return-code feedback, and advanced
automation logic responds with subsequent activities that are prescribed by the feedback.

A basic Take Action command shows the return code of the operation in a message box that is displayed
after the action is completed or in a log file. After you close this window, no further information is
available for this action.

Additional information about Take Action commands

For more information about working with Take Action commands, see “Take Action commands” in the
Tivoli Enterprise Portal User's Guide.

For a list of the Take Action commands for this monitoring agent and a description of each command, see
“Predefined Take Action commands” and the information for each individual command.

Predefined Take Action commands

Not all agents have predefined Take Action commands. But you can create Take Action commands for
any agent.

This monitoring agent contains the following Take Action commands:

v Disable SI Monitoring
v Disable SNA Monitoring
v Disable TN3270 Monitoring
v Enable SI Monitoring
v Enable SNA Monitoring
v Enable TN3270 Monitoring
v Reset DI UpdateCounters
v Set DI UpdateCounters
v Start Enterprise Single Sign On Service
v Start HIS LU62 Resync Service
v Start HIS TCP/IP Resync Service
v Start Link Service
v Start Microsoft MSMQ-MQSeries Bridge Service
v Start Session Integrator Server Service

© Copyright IBM Corp. 2010, 2013 273

v Start SNA DDM Service
v Start SNA MngAgent Service
v Start SNA RPC Service
v Start SnaBase Service
v Start SnaNetMn Service
v Start SnaPrint Service
v Start SnaServer Service
v Start SnaSrv02 Service
v Start SnaSrv03 Service
v Start SnaSrv04 Service
v Start TN3270 Service
v Start TN5250 Service
v Stop Enterprise Single Sign On Service
v Stop HIS LU62 Resync Service
v Stop HIS TCP/IP Resync Service
v Stop Link Service
v Stop Microsoft MSMQ-MQSeries Bridge Service
v Stop Session Integrator Server Service
v Stop SNA DDM Service
v Stop SNA MngAgent Service
v Stop SNA RPC Service
v Stop SnaBase Service
v Stop SnaNetMn Service
v Stop SnaPrint Service
v Stop SnaServer Service
v Stop SnaSrv02 Service
v Stop SnaSrv03 Service
v Stop SnaSrv04 Service
v Stop TN3270 Service
v Stop TN5250 Service

Take Action command descriptions

Each Take Action command description provides information you can use to decide whether to run the
Take Action command or whether to include the Take Action command in a situation or a policy.

The descriptions of the Take Action commands provide the following information:
Description
Actions the command performs on the system to which it is sent, and the permissions required
for the Take Action command to function.
Return codes
Information that the Take Action command returns.

Disable SI Monitoring action

Disables SI Monitoring. This action updates the Disable Performance Counters registry entry for SI Server
to disable the Session Integration Server and Session Integrator Server PLUs attribute groups.

274 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 4
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.
v Return Code: 3
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0195I
– Message: Monitoring is already being disabled.
v Return Code: 8
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0196I
– Message: A registry entry is created and updated, restart server.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0197I
– Message: A registry entry is updated, restart server.
v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1002
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Disable SNA Monitoring action

Disables SNA Monitoring. This action updates the Disable Performance Counters registry entry for SNA
Server to disable the SNA Connections, SNA Logical Unit Sessions and SNA 3270Response Time attribute
groups.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 4
– Return Code Type: GENERAL_ERROR

Chapter 6. Take Action commands reference 275

 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.
v Return Code: 3
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0195I
– Message: Monitoring is already being disabled.
v Return Code: 8
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0196I
– Message: A registry entry is created and updated, restart server.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0197I
– Message: A registry entry is updated, restart server.
v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1002
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Disable TN3270 Monitoring action

Disables TN3270 Monitoring. This action updates the Disable Performance Counters registry entry for
TN3270 Server to disable the TN3270 Server attribute group.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 4
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.
v Return Code: 3
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0195I
– Message: Monitoring is already being disabled.
v Return Code: 8

276 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0196I
– Message: A registry entry is created and updated, restart server.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0197I
– Message: A registry entry is updated, restart server.
v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1002
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Enable SI Monitoring action

Enables SI Monitoring. This action updates the Disable Performance Counters registry entry for SI Server
to enable the Session Integration Server and Session Integrator Server PLUs attribute groups.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 3
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0191I
– Message: Monitoring is already being enabled.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0192I
– Message: Registry does not exist, no changes done.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0193I
– Message: Registry entry updated, restart server.
v Return Code: 4
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.

Chapter 6. Take Action commands reference 277

 v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Enable SNA Monitoring action

Enables SNA Monitoring. This action updates the Disable Performance Counters registry entry for SNA
Server to enable the SNA Connections, SNA Logical Unit Sessions and SNA 3270Response Time attribute
groups.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 3
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0191I
– Message: Monitoring is already being enabled.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0192I
– Message: Registry does not exist, no changes done.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0193I
– Message: Registry entry updated, restart server.
v Return Code: 4
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.
v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)

278 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Enable TN3270 Monitoring action

Enables TN3270 Monitoring. This action updates the Disable Performance Counters registry entry for
TN3270 Server to enable the TN3270 Server attribute group.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 3
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0191I
– Message: Monitoring is already being enabled.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0192I
– Message: Registry does not exist, no changes done.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0193I
– Message: Registry entry updated, restart server.
v Return Code: 4
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.
v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Chapter 6. Take Action commands reference 279

Reset DI UpdateCounters action
Reset DI UpdateCounters. This action resets the UpdateCounters registry entry of Data Integration
services to disable the MSFT DB2 Access Library attribute group.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0192I
– Message: Registry does not exist, no changes done.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0193I
– Message: Registry entry updated, restart server.
v Return Code: 4
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.
v Return Code: 3
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0195I
– Message: Monitoring is already being disabled.
v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Set DI UpdateCounters action

Set DI UpdateCounters. This action sets the UpdateCounters registry entry of Data Integration services to
enable the MSFT DB2 Access Library attribute group.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes

280 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v Return Code: 3
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0191I
– Message: Monitoring is already being enabled.
v Return Code: 4
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0194I
– Message: Error occured while setting registry entry.
v Return Code: 8
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0196I
– Message: A registry entry is created and updated, restart server.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0197I
– Message: A registry entry is updated, restart server.
v Return Code: 1
– Return Code Type: NOT_APPLICABLE
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1001
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1002
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Start Enterprise Single Sign On Service action

Starts the Enterprise Single Sign On Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0034I
– Message: The Enterprise Single Sign On Service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0035I
– Message: The Enterprise Single Sign On Service is already started.

Chapter 6. Take Action commands reference 281

 v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0036E
– Message: Error starting Enterprise Single Sign On Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start HIS LU62 Resync Service action

Starts the HIS LU 6.2 Resync Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0031I
– Message: The HIS LU 6.2 Resynchronization service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0032I
– Message: The HIS LU 6.2 Resynchronization service is already started.

282 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0033E
– Message: Error starting HIS LU 6.2 Resynchronization service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start HIS TCP/IP Resync Service action

Starts the HIS TCP/IP Resync Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0037I
– Message: The HIS TCP/IP Resync Service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0038I
– Message: The HIS TCP/IP Resync Service is already started.

Chapter 6. Take Action commands reference 283

 v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0039E
– Message: Error starting HIS TCP/IP Resync Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start Link Service action

Starts the Link Service that is selected by the user.
System command
To include the Take Action command in a situation or workflow policy, use the following syntax
for the system command:
START_LINK_SERVICE \

[KQH_AVAILABILITY.Name]

You can use attribute substitution to supply the Take Action command arguments from the
situation, for example:
START_LINK_SERVICE \

[&{KQH_AVAILABILITY.Name}]
You can also use attribute substitution in a workflow policy though the format is slightly
different:

284 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 START_LINK_SERVICE \

[&WaitOnSituation:KQH_AVAILABILITY.Name]
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Command arguments
v Name: KQH_AVAILABILITY.Name
– Description: Link Service
– Default: &KQH_AVAILABILITY.Name
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0206I
– Message: The Link Service is started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0207I
– Message: The Link Service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0208I
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 285

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start Microsoft MSMQ-MQSeries Bridge Service action

Starts the Microsoft MSMQ-MQSeries Bridge Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0040I
– Message: The Microsoft MSMQ-MQSeries Bridge Service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0041I
– Message: The Microsoft MSMQ-MQSeries Bridge Service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0042E
– Message: Error starting Microsoft MSMQ-MQSeries Bridge Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

286 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start Session Integrator Server Service action

Starts the Session Integrator Server Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0046I
– Message: The Session Integrator Server Service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0047I
– Message: The Session Integrator Server Service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0048E
– Message: Error starting Session Integrator Server Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 287

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SNA DDM Service action

Starts the SNA DDM Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0007I
– Message: The HIS SNA DDM service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0008I
– Message: The HIS SNA DDM service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0009E
– Message: Error starting HIS SNA DDM service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

288 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SNA MngAgent Service action

Starts the SNA Management Agent Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0001I
– Message: The HIS SNA Management Agent service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0002I
– Message: The HIS SNA Management Agent service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0003E
– Message: Error starting HIS SNA Management Agent service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 289

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SNA RPC Service action

Starts the SNA RPC Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0013I
– Message: The HIS SNA RPC service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0014I
– Message: The HIS SNA RPC service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0015E
– Message: Error starting HIS SNA RPC service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

290 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SnaBase Service action

Starts the SNA Base Service and dependent services.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0004I
– Message: The HIS SNA Base service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0005I
– Message: The HIS SNA Base is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0006E
– Message: Error starting HIS SNA Base service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 291

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SnaNetMn Service action

Starts the SnaNetMn Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0043I
– Message: The SnaNetMn Service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0044I
– Message: The SnaNetMn Service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0045E
– Message: Error starting SnaNetMn Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

292 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SnaPrint Service action

Starts the SNA Print Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0019I
– Message: The HIS SNA Print service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0020I
– Message: The HIS SNA Print service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0021E
– Message: Error starting HIS SNA Print service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 293

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SnaServer Service action

Starts the SNA Server Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0016I
– Message: The HIS SNA Server service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0017I
– Message: The HIS SNA Server service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0018E
– Message: Error starting HIS SNA Server service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

294 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SnaSrv02 Service action

Starts the SNA Server 02 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0053I
– Message: The HIS SNA Server 02 service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH00554I
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0055E
– Message: Error starting HIS SNA Server 02 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 295

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SnaSrv03 Service action

Starts the SNA Server 03 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0056I
– Message: The HIS SNA Server 03 service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0057I
– Message: The HIS SNA Server 03 service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0058E
– Message: Error starting HIS SNA Server 03 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

296 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start SnaSrv04 Service action

Starts the SNA Server 04 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0059I
– Message: The HIS SNA Server 04 service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0060I
– Message: The HIS SNA Server 04 service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0061E
– Message: Error starting HIS SNA Server 04 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 297

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start TN3270 Service action

Starts the TN3270 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0025I
– Message: The HIS TN3270 service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0026I
– Message: The HIS TN3270 service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0027E
– Message: Error starting HIS TN3270 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

298 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Start TN5250 Service action

Starts the TN5250 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0028I
– Message: The HIS TN5250 service was started.
v Return Code: 1
– Return Code Type: ALREADY_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0029I
– Message: The HIS TN5250 service is already started.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0030E
– Message: Error starting HIS TN5250 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 8
– Return Code Type: DOESNT_EXIST
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0201I
– Message: The service is disabled and cannot be started.
v Return Code: 7
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0202E
– Message: The dependency service or group failed to start.
v Return Code: 6
– Return Code Type: PREREQ_NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0203E
– Message: The dependency service does not exist or has been marked for deletion.
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0204E
– Message: The service did not start due to a logon failure.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)

Chapter 6. Take Action commands reference 299

 – Message ID: KQH0231E
– Message: The service failed to start because of insufficient access privileges.
Usage None.

Stop Enterprise Single Sign On Service action

Stops the Enterprise Single Sign On Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0134I
– Message: The Enterprise Single Sign On Service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0135I
– Message: The Enterprise Single Sign On Service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0136E
– Message: Error stopping Enterprise Single Sign On Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop HIS LU62 Resync Service action

Stops the HIS LU 6.2 Resync Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.

300 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0131I
– Message: The HIS LU 6.2 Resynchronization service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0132I
– Message: The HIS LU 6.2 Resynchronization service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0133E
– Message: Error stopping HIS LU 6.2 Resynchronization service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop HIS TCP/IP Resync Service action

Stops the HIS TCP/IP Resync Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0137I
– Message: The HIS TCP/IP Resync Service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING

Chapter 6. Take Action commands reference 301

 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0138I
– Message: The HIS TCP/IP Resync Service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0139E
– Message: Error stopping HIS TCP/IP Resync Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop Link Service action

Stops the Link Service that is selected by the user.
System command
To include the Take Action command in a situation or workflow policy, use the following syntax
for the system command:
STOP_LINK_SERVICE \

[KQH_AVAILABILITY.Name]

You can use attribute substitution to supply the Take Action command arguments from the
situation, for example:
STOP_LINK_SERVICE \

[&{KQH_AVAILABILITY.Name}]
You can also use attribute substitution in a workflow policy though the format is slightly
different:
STOP_LINK_SERVICE \

[&WaitOnSituation:KQH_AVAILABILITY.Name]
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Command arguments
v Name: KQH_AVAILABILITY.Name
– Description: Link Service

302 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Default: &KQH_AVAILABILITY.Name
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0209I
– Message: The Link Service is stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0210I
– Message: The Link Service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0211E
– Message: An error occurred while stopping the Link Service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop Microsoft MSMQ-MQSeries Bridge Service action

Stops the Microsoft MSMQ-MQSeries Bridge Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0140I
– Message: The Microsoft MSMQ-MQSeries Bridge Service was stopped.
v Return Code: 1

Chapter 6. Take Action commands reference 303

 – Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0141I
– Message: The Microsoft MSMQ-MQSeries Bridge Service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0142E
– Message: Error stopping Microsoft MSMQ-MQSeries Bridge Service .
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop Session Integrator Server Service action

Stops the Session Integrator Server Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0146I
– Message: The Session Integrator Server Service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0147I
– Message: The Session Integrator Server Service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0148E
– Message: Error stopping Session Integrator Server Service .
v Return Code: 9

304 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SNA DDM Service action

Stops the SNA DDM Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0107I
– Message: The HIS SNA DDM service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0108I
– Message: The HIS SNA DDM service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0109E
– Message: Error stopping HIS SNA DDM service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8

Chapter 6. Take Action commands reference 305

 – Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SNA MngAgent Service action

Stops the SNA Management Agent Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0101I
– Message: The HIS SNA Management Agent service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0102I
– Message: The HIS SNA Management Agent service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0103E
– Message: Error stopping HIS SNA Management Agent service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

306 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Stop SNA RPC Service action
Stops the SNA RPC Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0113I
– Message: The HIS SNA RPC service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0114I
– Message: The HIS SNA RPC service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0115E
– Message: Error stopping HIS SNA RPC service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SnaBase Service action

Stops the SNA base service and dependent services.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK

Chapter 6. Take Action commands reference 307

 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0104I
– Message: The HIS SNA Base service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0105I
– Message: The HIS SNA Base is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0106E
– Message: Error stopping HIS SNA Base service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SnaNetMn Service action

Stops the SnaNetMn Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0143I
– Message: The SnaNetMn Service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0144I
– Message: The SnaNetMn Service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR

308 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0145E
– Message: Error stopping SnaNetMn Service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SnaPrint Service action

Stops the SNA Print Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0119I
– Message: The HIS SNA Print service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0120I
– Message: The HIS SNA Print service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0121E
– Message: Error stopping HIS SNA Print service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY

Chapter 6. Take Action commands reference 309

 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SnaServer Service action

Stops the SNA Server Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0116I
– Message: The HIS SNA Server service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0117I
– Message: The HIS SNA Server service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0118E
– Message: Error stopping HIS SNA Server service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY

310 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SnaSrv02 Service action

Stops the SNA Server 02 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0153I
– Message: The HIS SNA Server 02 service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0154I
– Message: The HIS SNA Server 02 service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0155E
– Message: Error stopping HIS SNA Server 02 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SnaSrv03 Service action

Stops the SNA Server 03 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.

Chapter 6. Take Action commands reference 311

Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0156I
– Message: The HIS SNA Server 03 service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0157I
– Message: The HIS SNA Server 03 service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0158E
– Message: Error stopping HIS SNA Server 03 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop SnaSrv04 Service action

Stops the SNA Server 04 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0159I
– Message: The HIS SNA Server 04 service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING

312 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0160I
– Message: The HIS SNA Server 04 service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0161E
– Message: Error stopping HIS SNA Server 04 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop TN3270 Service action

Stops the TN3270 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0125I
– Message: The HIS TN3270 service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0126I
– Message: The HIS TN3270 service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0127E
– Message: Error stopping HIS TN3270 service.
v Return Code: 9
– Return Code Type: WARNING

Chapter 6. Take Action commands reference 313

 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Stop TN5250 Service action

Stops the TN5250 Service.
Authorization
User must have administrative (or any other specific) rights to manage the services that are
specific to the monitored application according to the domain or local policy.
Destination systems
_EnDDESTINATIONS_NONE_OR_LIST_EnD
Return codes
v Return Code: 0
– Return Code Type: OK
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0128I
– Message: The HIS TN5250 service was stopped.
v Return Code: 1
– Return Code Type: NOT_RUNNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0129I
– Message: The HIS TN5250 service is already stopped.
v Return Code: 2
– Return Code Type: GENERAL_ERROR
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0130E
– Message: Error stopping HIS TN5250 service.
v Return Code: 9
– Return Code Type: WARNING
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0200W
– Message: The service does not exist as an installed service.
v Return Code: 5
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH0232E
– Message: The service failed to stop because of insufficient access privileges.
v Return Code: 8
– Return Code Type: TIMED_OUT

314 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 – Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1003
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
v Return Code: 12
– Return Code Type: INSUFFICIENT_USER_AUTHORITY
– Operating systems: Windows, Windows (64-bit)
– Message ID: KQH1004
– Message: WARNING::NO MESSAGE FOUND FOR THIS RETURN CODE!!!!!
Usage None.

Chapter 6. Take Action commands reference 315

316 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Chapter 7. Policies reference
Policies are used as an advanced automation technique for implementing more complex workflow
strategies than you can create through simple automation. All agents do not provide predefined policies,
but you can create policies for any agent.

A policy is a set of automated system processes that can take actions, schedule work for users, or
automate manual tasks. You use the Workflow Editor to design policies. You control the order in which
the policy executes a series of automated steps, which are also called activities. Policies are connected to
create a workflow. After an activity is completed, the Tivoli Enterprise Portal receives return-code
feedback, and advanced automation logic responds with subsequent activities prescribed by the feedback.

For more information about working with policies, see “Automation with policies” in the Tivoli Enterprise
Portal User's Guide.

For information about using the Workflow Editor, see the IBM Tivoli Monitoring Administrator's Guide or
the Tivoli Enterprise Portal online help.

Predefined policies
Not all agents have predefined policies. But you can create policies for any agent.

The IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration
Server Agent does not provide predefined policies.

© Copyright IBM Corp. 2010, 2013 317

318 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Chapter 8. Troubleshooting
Problems can be related to IBM Tivoli Monitoring or the specific agent that you are using.

For general troubleshooting information, see the IBM Tivoli Monitoring Troubleshooting Guide. For other
problem-solving options, see “Support information” on page 346.

You can resolve some problems by ensuring that your system matches the system requirements listed in
the Prerequisites topic for the agent in the information center, or in the Requirements and agent
installation and configuration topic of the agent user's guide.

The following activities can help you find a solution to the problem you are having:
v “Gathering product information for IBM Software Support”
v “Using logging” on page 320
v “Consulting the lists of identified problems and workarounds” on page 320

Gathering product information for IBM Software Support

Before contacting IBM Software Support about a problem you are experiencing with this product, gather
the information shown in Table 2.
Table 2. Information to gather before contacting IBM Software Support
Information type Description
Log files Collect trace log files from failing systems. Most logs are
located in a logs subdirectory on the host computer. See
“Principal trace log files” on page 321 for lists of all trace
log files and their locations.

For general information about the IBM Tivoli Monitoring

environment, see the Tivoli Enterprise Portal User's Guide.
Microsoft Host Integration Server information Version number and patch level
Operating system Operating system version number and patch level
Messages Messages and other information displayed on the screen
Version numbers for IBM Tivoli Monitoring Version number of the following members of the
monitoring environment:
v IBM Tivoli Monitoring. Also provide the patch level, if
available.
v IBM Tivoli Composite Application Manager for
Microsoft Applications: Microsoft Host Integration
Server Agent
Screen captures Screen captures of incorrect output, if any
(UNIX systems only) Core dump files If the system stops on UNIX systems, collect the core
dump file from the install_dir/bin directory, where
install_dir is the directory where you installed the
monitoring agent.

You can use the pdcollect tool to collect the most commonly used information from a system. This tool
gathers log files, configuration information, version information, and other data. For more information
about using this tool, see “pdcollect tool” in the IBM Tivoli Monitoring Troubleshooting Guide.

© Copyright IBM Corp. 2010, 2013 319

For information about working with IBM Software Support, see IBM Support Portal Service Requests and
PMRs (http://www.ibm.com/support/entry/portal/Open_service_request/Software/
Software_support_(general)).

Using logging

Logging is the primary troubleshooting feature in the . Logging refers to the text messages and trace data
that is generated by the . Messages and trace data are sent to a file.

Trace data captures transient information about the current operating environment when a component or
application fails to operate as designed. IBM Software Support personnel use the captured trace
information to determine the source of an error or unexpected condition. See “Trace logging” for more
information.

Consulting the lists of identified problems and workarounds

Known problems are organized into types such as those in the following list to make them easier to
locate:
v Installation and configuration
v General usage and operation
v Display of monitoring data
v Take Action commands
Information about symptoms and detailed workarounds for these types of problems is located in
“Problems and workarounds” on page 330.

For general troubleshooting information, see the IBM Tivoli Monitoring Troubleshooting Guide.

Trace logging
Trace logs are used to capture information about the operating environment when component software
fails to operate as designed.

The principal log type is the RAS (Reliability, Availability, and Serviceability) trace log. These logs are in
the English language only. The RAS trace log mechanism is available for all components of IBM Tivoli
Monitoring. Most logs are located in a logs subdirectory on the host computer. See the following
information to learn how to configure and use trace logging:
v “Principal trace log files” on page 321
v “Examples: Using trace logs” on page 323
v “Setting RAS trace parameters by using the GUI” on page 324

Note: The documentation refers to the RAS facility in IBM Tivoli Monitoring as "RAS1."

IBM Software Support personnel use the information captured by trace logging to trace a problem to its
source or to determine why an error occurred. All components in the IBM Tivoli Monitoring environment
have a default tracing level. The tracing level can be changed on a per-component level to adjust the type
of trace information collected, the degree of trace detail, the number of trace logs to be kept, and the
amount of disk space used for tracing.

Overview of log file management

Knowing the naming conventions for log files helps you to find the files.

320 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Agent log file naming conventions

Table 3 provides the names, locations, and descriptions of IBM Tivoli Monitoring general RAS1 log files.
The log file names for the adhere to the following naming convention:
Windows systems
hostname_productcode_program_HEXtimestamp-nn.log
Linux and UNIX systems
hostname_productcode_program_HEXtimestamp-nn.log

Where:
hostname
Host name of the computer where the monitoring component is running.
productcode
Two-character product code. For IBM Tivoli Composite Application Manager for Microsoft
Applications: Microsoft Host Integration Server Agent, the product code is qh.
program
Name of the program being run.
HEXtimestamp
Hexadecimal time stamp representing the time at which the program started.
nn Rolling log suffix.

Principal trace log files

Trace log files are located on various systems.

Table 3 contains locations, file names, and descriptions of trace logs that can help determine the source of
problems with agents.
Table 3. Trace log files for troubleshooting agents
System where log is located File name and path Description
On the Tivoli Enterprise Monitoring v Windows: The file in the Provides details about products that
Server install_dir\InstallITM path are installed.
Note: Trace logging is enabled by
v UNIX: The
default. A configuration step is not
candle_installation.log file in
required to enable this tracing.
the install_dir/logs path
v Linux: The
candle_installation.log file in
the install_dir/logs path
On the Tivoli Enterprise Monitoring The Warehouse_Configuration.log Provides details about the
Server file is in the following location on configuration of data warehousing
Windows systems: for historical reporting.
install_dir\InstallITM

Chapter 8. Troubleshooting 321

Table 3. Trace log files for troubleshooting agents (continued)
System where log is located File name and path Description
On the Tivoli Enterprise Monitoring The name of the RAS log file is as Traces activity on the monitoring
Server follows: server.
v Windows: install_dir\logs\
hostname_ms_timestamp-nn.log
v UNIX: install_dir/logs/
hostname_ms_timestamp-nn.log
v Linux: install_dir/logs/
hostname_ms_timestamp-nn.log
Note: File names for RAS1 logs
include a hexadecimal time stamp.

Also on UNIX systems, a log with a

decimal time stamp is provided:
hostname_productcode_timestamp.log
and hostname_productcode_
timestamp.pid nnnnn in the
install_dir/logs path, where nnnnn
is the process ID number.
On the Tivoli Enterprise Portal Server The name of the RAS log file is as Traces activity on the portal server.
follows:
v Windows: install_dir\logs\
hostname _cq_HEXtimestamp-nn.log
v UNIX: install_dir
/logs/hostname_cq_HEXtimestamp-
nn.log
v Linux: install_dir
/logs/hostname_cq_HEXtimestamp-
nn.log
Note: File names for RAS1 logs
include a hexadecimal time stamp.

Also on UNIX systems, a log with a

decimal time stamp is provided:
hostname_productcode_timestamp
.log and hostname_productcode_
timestamp.pidnnnnn in the
install_dir/logs path, where nnnnn
is the process ID number.
On the Tivoli Enterprise Portal Server The teps_odbc.log file is located in When you enable historical reporting,
the following path: this log file traces the status of the
v Windows: install_dir\InstallITM warehouse proxy agent.
v UNIX: install_dir/logs
v Linux: install_dir/logs

322 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 3. Trace log files for troubleshooting agents (continued)
System where log is located File name and path Description
On the computer that hosts the The RAS1 log files are as follows: Traces activity of the monitoring
monitoring agent v Windows: hostname agent.
_qh_instance_name_kqhagent_
HEXtimestamp-nn.log in the
install_dir\tmaitm6\logs
directory

These logs are in the following

directories:
v Windows: install_dir\tmaitm6\
logs
On the computer that hosts the The agent operations log files are as Shows whether the agent could
monitoring agent follows: connect to the monitoring server.
Shows which situations are started
instance_hostnameQH.LG0 is the and stopped, and shows other events
current log created when the agent while the agent is running. A new
was started. version of this file is generated every
time the agent is restarted.
instance_hostname_QH.LG1 is the
backup of the previous log. IBM Tivoli Monitoring generates one
backup copy of the *.LG0 file with
These logs are in the following the tag .LG1. View the .LG1 tag to
directory depending on the operating learn the following details regarding
system that you are using: the previous monitoring session:
v Windows: install_dir\tmaitm6\ v Status of connectivity with the
logs monitoring server
v Situations that were running
v The success or failure status of
Take Action commands
Definitions of variables:
v timestamp is a time stamp with a format that includes year (y), month (m), day (d), hour (h), and minute (m), as
follows: yyyymmdd hhmm
v HEXtimestamp is a hexadecimal representation of the time at which the process was started.
v install_dir represents the directory path where you installed the IBM Tivoli Monitoring component. install_dir can
represent a path on the computer that hosts the monitoring system, the monitoring agent, or the portal.
v instance refers to the name of the database instance that you are monitoring.
v instance_name refers to the name of the agent instance.
v hostname refers to the name of the computer on which the IBM Tivoli Monitoringcomponent runs.
v nn represents the circular sequence in which logs are rotated. this value includes a range from 1 - 5, by default.
The first is always retained because it includes configuration parameters.
v productcode specifies the product code, for example, um for Universal Agent or nt for Windows systems.

For more information about the complete set of trace logs that are maintained on the monitoring server,
see the IBM Tivoli Monitoring Installation and Setup Guide.

Examples: Using trace logs

You can open trace logs in a text editor to learn some basic facts about your IBM Tivoli Monitoring
environment.

IBM Software Support applies specialized knowledge to analyze trace logs to determine the source of
problems. The following examples are from the Tivoli Enterprise Monitoring Server log.

Chapter 8. Troubleshooting 323

Example one
This excerpt shows the typical log for a failed connection between a monitoring agent and a
monitoring server with the host name server1a:
(Thursday, August 11, 2005, 08:21:30-{94C}kdcl0cl.c,105,"KDCL0_ClientLookup") status=1c020006,
"location server unavailable", ncs/KDC1_STC_SERVER_UNAVAILABLE
(Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1157,"LookupProxy") Unable to connect to
broker at ip.pipe:: status=0, "success", ncs/KDC1_STC_OK
(Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1402,"FindProxyUsingLocalLookup") Unable
to find running CMS on CT_CMSLIST <IP.PIPE:#server1a>
Example two
The following excerpts from the trace log for the monitoring server show the status of an agent,
identified here as "Remote node." The name of the computer where the agent is running is
SERVER5B:
(42C039F9.0000-6A4:kpxreqhb.cpp,649,"HeartbeatInserter") Remote node SERVER5B:QH is ON-LINE.
. . .
(42C3079B.0000-6A4:kpxreqhb.cpp,644,"HeartbeatInserter") Remote node SERVER5B:QH is OFF-LINE.

See the following key points about the preceding excerpts:

v The monitoring server appends the QH product code to the server name to form a unique
name (SERVER5B:QH ) for this instance of the IBM Tivoli Composite Application Manager for
Microsoft Applications: Microsoft Host Integration Server Agent. By using this unique name,
you can distinguish multiple monitoring products that might be running on SERVER5B.
v The log shows when the agent started (ON-LINE) and later stopped (OFF-LINE) in the
environment.
v For the sake of brevity, an ellipsis (...) represents the series of trace log entries that were
generated while the agent was running.
v Between the ON-LINE and OFF-LINE log entries, the agent was communicating with the
monitoring server.
v The ON-LINE and OFF-LINE log entries are always available in the trace log. All trace levels
that are described in “Setting RAS trace parameters by using the GUI” provide these entries.

On Windows systems, you can use the following alternate method to view trace logs:
1. In the Windows Start menu, click Program Files > IBM Tivoli Monitoring > Manage Tivoli
Enterprise Monitoring Services. The Manage Tivoli Enterprise Monitoring Services window is
displayed.
2. Right-click a component and click Advanced > View Trace Log in the menu. For example, if you
want to view the trace log of the IBM Tivoli Composite Application Manager for Microsoft
Applications: Microsoft Host Integration Server Agent, right-click the name of that agent in the
window. You can also use the viewer to access remote logs.

Note: The viewer converts time stamps in the logs to a format that is easier to read.

RAS trace parameters

Pinpoint a problem by setting detailed tracing of individual components of the monitoring agent and
modules

See “Overview of log file management” on page 320 to ensure that you understand log rolling and can
reference the correct log files when you manage log file generation.

Setting RAS trace parameters by using the GUI

On Windows systems, you can use the graphical user interface to set trace options.

324 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
About this task

The IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration
Server Agent uses RAS1 tracing and generates the logs described in Table 3 on page 321. The default
RAS1 trace level is ERROR.

Procedure
1. Open the Manage Tivoli Enterprise Monitoring Services window.
2. Select Advanced > Edit Trace Parms. The Tivoli Enterprise Monitoring Server Trace Parameters
window is displayed.
3. Select a new trace setting in the pull-down menu in the Enter RAS1 Filters field or type a valid
string.
v General error tracing. KBB_RAS1=ERROR
v Intensive error tracing. KBB_RAS1=ERROR (UNIT:kqh ALL)
v Maximum error tracing. KBB_RAS1=ERROR (UNIT:kqh ALL) (UNIT:kra ALL)

Note: As this example shows, you can set multiple RAS tracing options in a single statement.
4. Modify the value for Maximum Log Size Per File (MB) to change the log file size (changes LIMIT
value).
5. Modify the value for Maximum Number of Log Files Per Session to change the number of log files
per startup of a program (changes COUNT value).
6. Modify the value for Maximum Number of Log Files Total to change the number of log files for all
startups of a program (changes MAXFILES value).
7. Optional: Click Y (Yes) in the KDC_DEBUG Setting menu to log information that can help you
diagnose communications and connectivity problems between the monitoring agent and the
monitoring server. The KDC_DEBUG setting and the Maximum error tracing setting can generate a large
amount of trace logging. Use these settings only temporarily, while you are troubleshooting problems.
Otherwise, the logs can occupy excessive amounts of hard disk space.
8. Click OK. You see a message reporting a restart of the monitoring agent so that your changes take
effect.

What to do next

Monitor the size of the logs directory. Default behavior can generate a total of 45 - 60 MB for each agent
that is running on a computer. For example, each database instance that you monitor can generate 45 - 60
MB of log data. See the “Procedure” section to learn how to adjust file size and numbers of log files to
prevent logging activity from occupying too much disk space.

Regularly prune log files other than the RAS1 log files in the logs directory. Unlike the RAS1 log files
that are pruned automatically, other log types can grow indefinitely, for example, the logs in Table 3 on
page 321 that include a process ID number (PID).

Use collector trace logs as an additional source of troubleshooting information.

Note: The KDC_DEBUG setting and the Maximum error tracing setting can generate a large amount of trace
logging. Use these settings only temporarily while you are troubleshooting problems. Otherwise, the logs
can occupy excessive amounts of hard disk space.

Manually setting RAS trace parameters

You can manually edit the RAS1 trace logging parameters.

Chapter 8. Troubleshooting 325

About this task

The uses RAS1 tracing and generates the logs described in Table 3 on page 321. The default RAS1 trace
level is ERROR.

Procedure
1. Open the trace options file:
v Windows systems:
install_dir\tmaitm6\KQHENV
2. Edit the line that begins with KBB_RAS1= to set trace logging preferences. For example, if you want
detailed trace logging, set the Maximum Tracing option: KBB_RAS1=ERROR (UNIT:kqh ALL) (UNIT:kra
ALL)
3. Edit the line that begins with KBB_RAS1_LOG= to manage the generation of log files:
v MAXFILES: The total number of files that are to be kept for all startups of a specific program. When
this value is exceeded, the oldest log files are discarded. The default value is 9.
v LIMIT: The maximum size, in megabytes (MB) of a RAS1 log file. The default value is 5.
v IBM Software Support might guide you to modify the following parameters:
– COUNT: The number of log files to keep in the rolling cycle of one program startup. The default is
3.
– PRESERVE: The number of files that are not to be reused in the rolling cycle of one program
startup. The default value is 1.

Note: The KBB_RAS1_LOG parameter also provides for the specification of the log file directory, log
file name, and the inventory control file directory and name. Do not modify these values or log
information can be lost.
4. Restart the monitoring agent so that your changes take effect.

What to do next

Monitor the size of the logs directory. Default behavior can generate a total of 45 - 60 MB for each agent
that is running on a computer. For example, each database instance that you monitor can generate 45 - 60
MB of log data. See the “Procedure” section to learn how to adjust file size and numbers of log files to
prevent logging activity from occupying too much disk space.

Regularly prune log files other than the RAS1 log files in the logs directory. Unlike the RAS1 log files
that are pruned automatically, other log types can grow indefinitely, for example, the logs in Table 3 on
page 321 that include a process ID number (PID).

Use collector trace logs as an additional source of troubleshooting information.

Note: The KDC_DEBUG setting and the Maximum error tracing setting can generate a large amount of trace
logging. Use these settings only temporarily while you are troubleshooting problems. Otherwise, the logs
can occupy excessive amounts of hard disk space.

Dynamic modification of trace settings

You can dynamically modify the trace settings for an IBM Tivoli Monitoring component, such as, Tivoli
Enterprise Monitoring Server, Tivoli Enterprise Portal Server, most monitoring agents, and other
components. You can access these components, except for a few monitoring agents, from the tracing
utility.

Dynamic modification of the trace settings is the most efficient method, because you can do it without
restarting the component. Settings take effect immediately. Modifications by this method are not
persistent.

326 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Note: When the component is restarted, the trace settings are read again from the .env file. Dynamically
modifying these settings does not change the settings in the .env files. To modify these trace settings
permanently, modify them in the .env files.

ras1

Run this command to modify the trace settings for a Tivoli Monitoring component.

The syntax is as follows:

ras1 set|list (UNIT|COMP: class_name ANY|ALL|Detail|ERROR|Flow|INPUT|Metrics|OUTPUT|STATE)
{(UNIT|COMP: class_name ANY|ALL|Detail|ERROR|Flow|INPUT|Metrics|OUTPUT|STATE)}

You can specify more than one component class to which to apply the trace settings.

Command options
set
Turns on or off tracing depending upon the value of its parameters. If the parameter is ANY, it turns it
off. All other parameters turn on tracing based on the specified type or level.
list
Displays the default level and type of tracing that is set by default.

Parameters

The parameters that determine the component classes to which to apply the trace settings are as follows:
COMP: class_name
Modifies the trace setting for the name of the component class, as specified by class_name , for
example, COMP:KDH. The output contains trace for the specified class.
UNIT: class_name
Modifies the trace setting for any unit that starts with the specified class_name value, for example,
UNIT: kra. The output contains trace for any unit that begins with the specified filter pattern.

The parameters that determine the trace level and type are as follows:
ALL
Displays all trace levels, including every trace point defined for the component. This setting might
result in a large amount of trace, so specify other parameters to exclude unwanted trace. You might
require the ALL parameter to isolate a problem, which is the equivalent to setting "Error Detail Flow
State Input Output Metrics".
ANY
Turns off tracing.
Detail
Displays detailed information about each function.
When entered with the list option, the trace is tagged with Det.
ERROR
Logs internal error conditions.
When entered with the list option, the trace is tagged with ER. The output can also be tagged with
EVERYE+EVERYU+ER.
Flow
Displays control flow data for each function entry and exit.
When entered with the list option, the trace is tagged with Fl.

Chapter 8. Troubleshooting 327

INPUT
Displays input data for each function.
When entered with the list option, the trace is tagged with IN.
Metrics
Displays metrics on each function.
When entered with the list option, the trace is tagged with ME.
OUTPUT
Displays output data for each function.
When entered with the list option, the trace is tagged with OUT.
State
Displays the status for each function.
When entered with the list option, the trace is tagged with St.

Example

If you enter ras1 set (COMP:KDH ALL) (COMP:ACF1 ALL) (COMP:KDE ALL), the trace utility turns on all
levels of tracing for all the files and functions for which KDH, ACF1, and KDE are the classes.
kbbcre1.c, 400, May 29 2007, 12:54:43, 1.1, *
kbbcrn1.c, 400, May 29 2007, 12:54:42, 1.1, *
kdhb1de.c, 400, May 29 2007, 12:59:34, 1.1, KDH
kdh0med.c, 400, May 29 2007, 12:59:24, 1.1, KDH
kdhsrej.c, 400, May 29 2007, 13:00:06, 1.5, KDH
kdhb1fh.c, 400, May 29 2007, 12:59:33, 1.1, KDH
kdhb1oe.c, 400, May 29 2007, 12:59:38, 1.2, KDH
kdhs1ns.c, 400, May 29 2007, 13:00:08, 1.3, KDH
kbbacdl.c, 400, May 29 2007, 12:54:27, 1.2, ACF1
kbbaclc.c, 400, May 29 2007, 12:54:27, 1.4, ACF1
kbbac1i.c, 400, May 29 2007, 12:54:28, 1.11, ACF1
vkdhsfcn.c, 400, May 29 2007, 13:00:11, 1.1, KDH
kdhserq.c, 400, May 29 2007, 12:59:53, 1.1, KDH
kdhb1pr.c, 400, May 29 2007, 12:59:39, 1.1, KDH
kdhsgnh.c, 400, May 29 2007, 12:59:49, 1.1, KDH
kdh0uts.c, 400, May 29 2007, 12:59:23, 1.1, KDH
kdhsrsp.c, 400, May 29 2007, 13:00:13, 1.2, KDH
kdhs1rp.c, 400, May 29 2007, 13:00:12, 1.1, KDH
kdhscsv.c, 400, May 29 2007, 12:59:58, 1.9, KDH
kdebbac.c, 400, May 29 2007, 12:56:50, 1.10, KDE
...

Turning on tracing
To use the tracing utility, you must use a local logon credential for the computer. This tracing method
uses the IBM Tivoli Monitoring Service Console. Access the Service Console by using a web browser.

About this task

When you start the Service Console, information is displayed about the components that are currently
running on that computer. For example, these components are listed as follows:
v Tivoli Enterprise Portal Server: cnp
v Monitoring Agent for Windows OS: nt
v Tivoli Enterprise Monitoring Server: ms

After you log on, you can type a question mark (?) to display a list of the supported commands. Use the
ras1 command to modify trace settings. If you type this command in the field provided in the Service
Console window and click Submit, the help for this command is displayed.

328 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Procedure
1. Open a web browser and enter the URL to access the Service Console.
http://hostname:1920

where hostname is the IP address or host name of the computer on which the IBM Tivoli Monitoring
component is running.
2. Click the hyperlink associated with the component for which you want to modify its trace settings.

Note: In the previous view, if you want to modify tracing for the Tivoli Enterprise Monitoring Server,
select IBM Tivoli Monitoring Service Console under Service Point: system.your host name_ms.
3. Enter a user ID and password to access the system. This ID is any valid user that has access to the
system.
4. Enter the command to turn on the required level of trace for the specified component classes or units.
ras1 set (UNIT|COMP: class_name ALL|Flow|ERROR|Detail|INPUT|Metrics|OUTPUT|STATE)
{(UNIT|COMP: class_name ALL|Flow|ERROR|Detail|INPUT|Metrics|OUTPUT|STATE)}

For example, to turn on the control flow trace for the KDE, the command is:
ras1 (COMP:KDE Flow)

Turning off tracing

You can use the IBM Tivoli Monitoring Service Console to run the ras1 command and dynamically turn
off tracing.

Procedure
1. Open a web browser and enter the URL to access the Service Console.
http://hostname:1920

where hostname is the IP address or host name of the computer on which the IBM Tivoli Monitoring
component is running.
2. Click the hyperlink associated with the component for which you want to modify its trace settings.
3. Enter a user ID and password to access the system. This ID is any valid user that has access to the
system.
4. Enter the command to turn off the required level of trace for the specified component classes or units.
ras1 set (UNIT|COMP: class_name ANY)
{(UNIT|COMP: class_name ANY)}

For example, to turn off tracing for the kbbcrcd class of the Windows OS agent, the command is:
ras1 set (UNIT:kbbcrcd ANY)

Setting trace parameters for the Tivoli Enterprise Console server

In addition to the trace information captured by IBM Tivoli Monitoring, you can also collect additional
trace information for the Tivoli Enterprise Console components that gather event server metrics.

About this task

To collect this information, modify the .tec_diag_config file on the Tivoli Enterprise Console event
server. Use the steps in the following procedure to modify the event server trace parameters.

Procedure
1. Open the $BINDIR/TME/TEC/.tec_diag_config file in an ASCII editor.
2. Locate the entries that configure trace logging for the agent components on the event server. Two
entries are included, one for tec_reception and one for tec_rule:

Chapter 8. Troubleshooting 329

 # to debug Agent Utils
tec_reception Agent_Utils error /tmp/tec_reception
SP
# to debug Agent Utils
tec_rule Agent_Utils error /tmp/tec_rule
3. To gather additional trace information, modify these entries to specify a trace level of trace2:
# to debug Agent Utils
tec_reception Agent_Utils trace2 /tmp/tec_reception
SP
# to debug Agent Utils
tec_rule Agent_Utils trace2 /tmp/tec_rule
4. In addition, modify the Highest_level entries for tec_rule and tec_reception:
tec_reception Highest_level trace2
SP
tec_rule Highest_level trace2

Problems and workarounds

The known problems and workarounds are organized into types of problems that might occur with the ,
for example installation and configuration problems and workspace problems.

Note: You can resolve some problems by ensuring that your system matches the system requirements
listed in the Prerequisites topic for the agent in the IBM Tivoli Composite Application Manager for
Microsoft Applications Information Center.

Note: You can resolve some problems by ensuring that your system matches the system requirements
listed in Requirements and agent installation and configuration.

For general troubleshooting information, see the IBM Tivoli Monitoring Troubleshooting Guide.

Installation and configuration troubleshooting

Problems can occur during installation, configuration, and uninstallation of the agent.

The problems and solutions in Table 4 can occur during installation, configuration, and uninstallation of
the agent.
Table 4. Problems and solutions for installation and configuration
Problem Solution
Diagnosing problems with product browse settings When you have problems with browse settings, complete
(Windows systems only). the following steps:
1. Click Start > Programs > IBM Tivoli Monitoring >
Manage Tivoli Enterprise Monitoring Services. The
Manage Tivoli Enterprise Monitoring Services
window is displayed.
2. Right-click the Windows agent and select Browse
Settings. A text window is displayed.
3. Click Save As and save the information in the text
file.

If requested, you can forward this file to IBM Software

Support for analysis.

330 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 4. Problems and solutions for installation and configuration (continued)
Problem Solution
A message similar to "Unable to find running CMS on If a message similar to "Unable to find running CMS on
CT_CMSLIST" in the log file is displayed. CT_CMSLIST" is displayed in the log file, the agent cannot
connect to the monitoring server. Confirm the following
points:
v Do multiple network interface cards (NICs) exist on
the system?
v If multiple NICs exist on the system, find out which
one is configured for the monitoring server. Ensure
that you specify the correct host name and port
settings for communication in the IBM Tivoli
Monitoring environment.
The system is experiencing high CPU usage. Agent process: View the memory usage of the
KQHCMA process. If CPU usage seems to be excessive,
restart the monitoring agent.

Network cards: The network card configurations can

decrease the performance of a system. Each stream of
packets that a network card receives (assuming that it is
a broadcast or destined for the under-performing system)
must generate a CPU interrupt and transfer the data
through the I/O bus. If the network card in question is a
bus-mastering card, work can be offloaded and a data
transfer between memory and the network card can
continue without using CPU processing power.
Bus-mastering cards are 32-bit and are based on PCI or
EISA bus architectures.
When you install an ITCAM for Microsoft Applications Situation 1: No solution is available for this problem.
32-bit agent on a computer that has a preinstalled 64-bit
version of the same agent, the following situations occur: Situation 2: Restart the 64-bit agent.

Situation 1: The 32-bit agent is not installed. However,

when you run the KinCinfo command, the 32-bit agent is
displayed in the list of installed components.

Situation 2: The preinstalled 64-bit agent stops running.

If you have installed a 64-bit agent for ITCAM for No solution is available for this problem at this time.
Microsoft Applications, information about the agent
processes is not displayed in the Kinviewer window.
When you install a 32-bit agent for ITCAM for Microsoft Ignore this message and proceed with the installation.
Applications, the following message is displayed under
the Install the following features list, :

Undefined GSK component:IBM GSKit Security Interface

You have preinstalled agents of earlier versions of IBM Run the setup.exe file of the Windows OS agent V6.2.2
Tivoli Monitoring for Microsoft Applications on your or later to install the Tivoli Enterprise Monitoring Agent
computer. When you run the ITCAM for Microsoft Framework. Then, upgrade the preinstalled IBM Tivoli
Applications installation wizard to upgrade the agent to Monitoring for Microsoft Applications agents.
V6.2.2, the Select Features window displays a list of all
the agent features that you can install. The installed
agents are selected by default. If you do not want to
upgrade the installed features, you cannot clear the
default selection.

Chapter 8. Troubleshooting 331

Table 4. Problems and solutions for installation and configuration (continued)
Problem Solution
While installing the ITCAM for Microsoft Applications No solution is available for this problem at this time.
agent, though the Tivoli Enterprise Monitoring Agent
Framework is a mandatory feature, you can specify not
to install the Tivoli Enterprise Monitoring Agent
Framework. However, even if you specify not to install
the Tivoli Enterprise Monitoring Agent Framework, the
Tivoli Enterprise Monitoring Agent Framework is
installed.
You have installed two 32-bit Microsoft Application Run the Windows OS agent V6.2.2, Fix Pack 2 setup.exe
agents and the 32/64-bit Agent Compatibility Package file to install the 32/64-bit Agent Compatibility Pack
(ACP) from the ITCAM for Microsoft Applications 64-bit (ACP). You can also reinstall the ACP from the 64-bit
agent. You cannot install additional 32-bit Microsoft agent ITCAM for Microsoft Applications V6.2.2 folder.
application agents on the same managed system.
If you are using IBM Tivoli Monitoring V6.2.1 or V6.2.2, If you are using IBM Tivoli Monitoring V6.2.1, install
bulk-loading fails in the Tivoli Application Dependency IBM Tivoli Monitoring V6.2.1 Fix Pack 3.
Discovery Manager (TADDM). The error log shows an
error related to WindowsOperatingSystem. If you are using IBM Tivoli Monitoring V6.2.2, install
IBM Tivoli Monitoring V6.2.2 Fix Pack 2.
After you upgrade ITCAM for Microsoft Applications Ignore IBM Tivoli Monitoring for Microsoft
from an earlier version to V6.2.2, the following entries Applications in the Add or Remove Programs window.
are created in the Add or Remove Programs window: If you want to modify or remove the installed agents in
v IBM Tivoli Monitoring for Microsoft Applications IBM Tivoli Monitoring for Microsoft Applications, use
IBM Tivoli Monitoring from the Add or Remove
v IBM Tivoli Monitoring
Programs window.
The configuration panel is blank on 64-bit Windows Check the GL component version by running kincinfo -t
systems where the Tivoli Enterprise Monitoring Agent GL from a Windows command line. Example:
Framework (component GL) is version 06.23.00.00 or %CANDLE_HOME%\InstallITM\kincinfo -t GL
06.23.01.00.
If the GL component version is 06.23.00.00 or 06.23.01.00,
take one of the following actions:
v Preferred action: Upgrade the Windows OS Agent to
Version 6.2.3 Fix Pack 2.
v Alternate action: Install the Agent Compatibility (AC)
component from the IBM Tivoli Monitoring V6.2.3 Fix
Pack 1 media. See Installing the Agent Compatibility
(AC) component (http://pic.dhe.ibm.com/infocenter/
tivihelp/v15r1/topic/com.ibm.itm.doc_6.2.3fp1/
itm623FP1_install199.htm#acpinstall).

332 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 5. General problems and solutions for uninstallation
Problem Solution
On Windows systems, uninstallation of IBM Tivoli Be sure that you follow the general uninstallation process
Monitoring fails to uninstall the entire environment. described in the IBM Tivoli Monitoring Installation and
Setup Guide:
1. Remove Tivoli Enterprise Monitoring Server
Application support by completing the following
steps:
a. Use Manage Tivoli Enterprise Monitoring
Services.
b. Select Tivoli Enterprise Monitoring Server.
c. Right-click and select Advanced.
d. Select Remove TEMS application support.
e. Select the agent to remove its application support.
2. Uninstall the monitoring agents first, as in the
following examples:
v Uninstall a single monitoring agent for a specific
database.
-OR-
v Uninstall all instances of a monitoring product,
such as IBM Tivoli Monitoring for Databases.
3. Uninstall IBM Tivoli Monitoring.
The way to remove inactive managed systems (systems Use the following steps to remove, but not uninstall, an
whose status is OFFLINE) from the Navigator tree in the offline managed system from the Navigator tree:
portal is not obvious. 1. Click the Enterprise icon in the Navigator tree.
2. Right-click, and then click Workspace > Managed
System Status.
3. Right-click the offline managed system, and select
Clear offline entry.

To uninstall the monitoring agent, use the procedure

described in the IBM Tivoli Monitoring Installation and
Setup Guide.
You have installed the Windows OS agent V6.2.2 or later Use the following steps to resolve this problem:
on your computer. The Windows OS agent does not start 1. In the KGLWICMA.VER and KUIWICLI.VER files in the
if you uninstall a 32-bit agent for ITCAM for Microsoft InstallITM/ver directory, lower the current VRMF
Applications by using the following methods: values.
v The silent_agent.txt file For example, if the current value is 06220000, change
v The command: tacmd removeSystem -t agentcode -n this value to 06210000.
node 2. Run the setup.exe file for the Windows OS agent to
For example, tacmd removeSystem –t qp –n install the Tivoli Enterprise Monitoring Agent
Primary:MachineName:NT framework.
v The Remove option on the Tivoli Enterprise Portal. 3. Start the Windows OS agent.
The following error message is displayed: The service Note: If IBM Tivoli Monitoring is not displayed in the
did not respond to the start or control request in a Add or Remove Programs window, run the setup.exe
timely fashion. KCICF5100E: Unable to start, see file for ITCAM for Microsoft Applications to install the
Event Log for information. Tivoli Enterprise Monitoring Agent Framework. You can
find the setup.exe file in the Agent_64bit\WINDOWS
directory.

Chapter 8. Troubleshooting 333

Table 5. General problems and solutions for uninstallation (continued)
Problem Solution
You have a 32-bit agent of ITCAM for Microsoft Restart the preinstalled agent. Ignore the IBM Tivoli
Applications installed on your computer. If you uninstall Monitoring entry for V6.2.1 in the Add or Remove
the 32-bit agent, two entries of IBM Tivoli Monitoring are Programs window. To modify or remove the installed
created in the Add or Remove Programs window in the agents, use the IBM Tivoli Monitoring entry for V6.2.2
following situations: in the Add or Remove Programs window.
v With the 32-bit agent, you have Windows OS agent
V6.2.2 or later installed on a managed system and you
uninstall the 32-bit agent from the Tivoli Enterprise
Portal or by using the command: tacmd removeSystem
-t <agentCode> -n <node>
v With the 32-bit agent, you have 64-bit agent of ITCAM
for Microsoft Applications installed on a managed
system and you uninstall the 32-bit agent using the
silent_agent.txt file.
In both the situations, when you uninstall the 32-bit
agent, the preinstalled agent stops running.
When the agent is installed using group deployment, There is no solution at this time.
deploygroup was run multiple times. The group
deployment starts and completes successfully, but there
were multiple entries in the Deploy Status Summary
workspace on the Tivoli Enterprise Portal. When the
command tried to install multiple times, the additional
installations were queued and then were in failed state
though the agent was deployed successfully.
Note:
v When the bundle group contains a single bundle and
the deployment group contains more than one
member (managed system of the same type as AIX or
Linux), the deployment is successful on both systems.
v When the bundle group contains more than one
bundle and the deploy group contains single or
multiple members, the deployment will be executed
on each group member (managed system) depending
on the members present in the bundle group and
deploy group.
v The command creates a transaction for each XX bundle
for each target system; the bundle matching the
operating system for the deployment member is
processed successfully; and remaining transactions
were in a queued or failed state.

Remote deployment troubleshooting

Problems can occur with remote deployment and removal of agent software using the Agent Remote
Deploy process.

Table 6 on page 335 contains problems and solutions related to remote deployment.

334 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 6. Remote deployment problems and solutions
Problem Solution
While you are using the remote deployment feature to Do not close or modify this window. It is part of the
install the IBM Tivoli Composite Application Manager installation process and is dismissed automatically.
for Microsoft Applications: Microsoft Host Integration
Server Agent, an empty command window is displayed
on the target computer. This problem occurs when the
target of remote deployment is a Windows computer.
(For more information about the remote deployment
feature, see the IBM Tivoli Monitoring Installation and
Setup Guide.)
The removal of a monitoring agent fails when you use This problem might occur when you attempt the remote
the remote removal process in the Tivoli Enterprise removal process immediately after you restart the Tivoli
Portal desktop or browser. Enterprise Monitoring Server. You must allow time for
the monitoring agent to refresh its connection with the
Tivoli Enterprise Monitoring Server before you begin the
remote removal process.
The IBM Tivoli Composite Application Manager for No solution is available for this problem at this time.
Microsoft Cluster Server Agent, V622 displays data for
the attributes groups only on Windows Server 2008 R2
for the following attribute groups:
v Clustered Shared Volume
v Clustered Shared Volume IO
v Global update messages
v MRR Messages
v Network Reconnections
v Network Messages
v Resource Control Manager
v Resources Summary

The agent does not display the data on Windows Server

2003 and Windows Server 2008 for the above mentioned
attribute groups.

Agent troubleshooting
A problem can occur with the agent after it has been installed.

Table 7 contains problems and solutions that can occur with the agent after it is installed.
Table 7. Agent problems and solutions
Problem Solution
Log data accumulates too rapidly. Check the RAS trace option settings, which are described
in “Setting RAS trace parameters by using the GUI” on
page 324. The trace option settings that you can set on
the KBB_RAS1= and KDC_DEBUG= lines potentially generate
large amounts of data.

Chapter 8. Troubleshooting 335

Table 7. Agent problems and solutions (continued)
Problem Solution
A configured and running instance of the monitoring IBM Tivoli Monitoring products use Remote Procedure
agent is not displayed in the Tivoli Enterprise Portal, but Call (RPC) to define and control product behavior. RPC
other instances of the monitoring agent on the same is the mechanism that a client process uses to make a
system are displayed in the portal. subroutine call (such as GetTimeOfDay or
ShutdownServer) to a server process somewhere in the
network. Tivoli processes can be configured to use
TCP/UDP, TCP/IP, SNA, and SSL as the protocol (or
delivery mechanism) for RPCs that you want.

IP.PIPE is the name given to Tivoli TCP/IP protocol for

RPCs. The RPCs are socket-based operations that use
TCP/IP ports to form socket addresses. IP.PIPE
implements virtual sockets and multiplexes all virtual
socket traffic across a single physical TCP/IP port
(visible from the netstat command).

A Tivoli process derives the physical port for IP.PIPE

communications based on the configured, well-known
port for the hub Tivoli Enterprise Monitoring Server.
(This well-known port or BASE_PORT is configured by
using the 'PORT:' keyword on the KDC_FAMILIES /
KDE_TRANSPORT environment variable and defaults to
'1918'.)

The physical port allocation method is defined as

(BASE_PORT + 4096*N), where N=0 for a Tivoli
Enterprise Monitoring Server process and N={1, 2, ..., 15}
for another type of monitoring server process. Two
architectural limits result as a consequence of the
physical port allocation method:
v No more than one Tivoli Enterprise Monitoring Server
reporting to a specific Tivoli Enterprise Monitoring
Server hub can be active on a system image.
v No more than 15 IP.PIPE processes can be active on a
single system image.

A single system image can support any number of Tivoli

Enterprise Monitoring Server processes (address spaces)
if each Tivoli Enterprise Monitoring Server on that image
reports to a different hub. By definition, one Tivoli
Enterprise Monitoring Server hub is available per
monitoring enterprise, so this architecture limit has been
reduced to one Tivoli Enterprise Monitoring Server per
system image.

No more than 15 IP.PIPE processes or address spaces can

be active on a single system image. With the first limit
expressed earlier, this second limitation refers specifically
to Tivoli Enterprise Monitoring Agent processes: no more
than 15 agents per system image.

Continued on next row.

336 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 7. Agent problems and solutions (continued)
Problem Solution
Continued from previous row. This limitation can be circumvented (at current
maintenance levels, IBM Tivoli Monitoring V6.1, Fix Pack
4 and later) if the Tivoli Enterprise Monitoring Agent
process is configured to use the EPHEMERAL IP.PIPE
process. (This process is IP.PIPE configured with the
'EPHEMERAL:Y' keyword in the KDC_FAMILIES /
KDE_TRANSPORT environment variable). The number of
ephemeral IP.PIPE connections per system image has no
limitation. If ephemeral endpoints are used, the
Warehouse Proxy agent is accessible from the Tivoli
Enterprise Monitoring Server associated with the agents
using ephemeral connections either by running the
Warehouse Proxy agent on the same computer or by
using the Firewall Gateway feature. (The Firewall
Gateway feature relays the Warehouse Proxy agent
connection from the Tivoli Enterprise Monitoring Server
computer to the Warehouse Proxy agent computer if the
Warehouse Proxy agent cannot coexist on the same
computer.)
The Event Log attribute group displays a specific There is no solution to this problem.
number of event viewer entries on the Tivoli Enterprise
Portal, even if you define the maximum number of event
viewer entries in the Tivoli Enterprise Portal
environment variable.
If you install a 64-bit HIS agent on a 64-bit computer, Restart the HIS agent.
and then install a 32-bit SQL agent, the HIS Agent
service stops working.
On the Tivoli Enterprise Portal, entries for the Microsoft Microsoft HIS is the valid navigator item. There is no
Host Integration Server and the Microsoft HIS, are solution for this problem.
displayed in the Query Editor. However, no query is
applicable for the Microsoft Host Integration Server
navigator item.
If you change the HIS agent startup with a user that has To resolve the issue, follow these steps:
domain administrator privileges in the Agent 1. Stop the OS agent.
Management Services, and then recycle the HIS and OS
2. Navigate to the \\TMAITM6\CAP folder.
agents, two instances of the agent are displayed in the
Agent Management Services workspace. 3. Delete the pas.dat file.
4. Start the OS agent.
In the online help, if you click Tech Action, the There is no solution to this problem.
Additional Information section is displayed.
On the Tivoli Enterprise Portal, the Status Text attribute There is no solution to this problem.
in the MSSNA_Server attribute group does not display a
value when the SNA server is in an active state.
On the Tivoli Enterprise Portal, the Model attribute in The description for the corresponding numeric values
the MSSNA_LUDisplay attribute group displays numeric are:
values instead of the corresponding text values or v If the numeric value is 0, the description is Model12.
description on the portal.
v If the numeric value is 1, the description is Model13.
v If the numeric value is 2, the description is Model14.
v If the numeric value is 3, the description is Model1215.
If you load or unload the HIS performance monitor Recycle the HIS agent.
objects while the agent is active, the HIS agent does not
dynamically update the values and displays the previous
values.

Chapter 8. Troubleshooting 337

Table 7. Agent problems and solutions (continued)
Problem Solution
You have Microsoft HIS 2006, Microsoft HIS 2006 Service There is no solution to this problem.
Pack 1, and Microsoft HIS 2009 on the same managed
system. The Microsoft HIS agent does not generate data
for the following attribute groups:
v SNA Connections
v SNA Logical Unit Sessions
v SNA 3270Response Time

You have 64-bit versions of Microsoft HIS 2006, Microsoft

HIS 2006 service pack 1, and Microsoft HIS 2009 on the
same managed system. The Microsoft HIS agent does not
generate data for the following attribute groups:
v Session Integrator Server
v Session Integrator Server PLUs
You have installed a 32-bit Windows OS agent and a There are two possible solutions to this problem:
64-bit agent of ITCAM for Microsoft Applications on a
64-bit managed system. If the 64-bit agent abruptly stops Solution 1: Restart the 64-bit agent and then use the
running, the Agent Management Service (AMS) fails to following steps to restart the AMS:
restart the agent. The status of the agent in the Agents' 1. Right-click the agent, which is in the unmanaged
Management Status view changes to Unmanaged. state, and click Take Action > Select.
2. From the Name list in the Action panel, select AMS
Start Management.
3. In the Destination Systems panel, select the managed
system node for the agent management that you
want to start.
4. Click OK.

Solution 2: Install the Windows OS agent V6.2.2, Fix

Pack 2.

Workspace troubleshooting
Problems can occur with general workspaces and agent-specific workspaces.

Table 8 on page 339 contains problems and solutions related to workspaces.

338 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 8. Workspace problems and solutions
Problem Solution
The process application components are available, but This problem occurs because the PerfProc performance
the Availability status shows PROCESS_DATA_NOT_ object is disabled. When this condition exists, IBM Tivoli
AVAILABLE. Monitoring cannot collect performance data for this
process. Use the following steps to confirm that this
problem exists and to resolve it:
1. In the Windows Start menu, click Run.
2. Type perfmon.exe in the Open field of the Run
window. The Performance window is displayed.
3. Click the plus sign (+) in the toolbar. The Add
Counters window is displayed.
4. Look for Process in the Performance object menu.
5. Complete one of the following actions:
v If you see Process in the menu, the PerfProc
performance object is enabled and the problem is
coming from a different source. You might need to
contact IBM Software Support.
v If you do not see Process in the menu, use the
Microsoft utility from the Microsoft.com Operations
website to enable the PerfProc performance object.
The Process performance object becomes visible in
the Performance object menu of the Add Counters
windows, and IBM Tivoli Monitoring is able to
detect Availability data.
6. Restart the monitoring agent.

Chapter 8. Troubleshooting 339

Table 8. Workspace problems and solutions (continued)
Problem Solution
Event Log workspace events are unfiltered, are not All events currently in the Application Event Log are
collected more than every 60 seconds, and are removed sent to the Tivoli Enterprise Monitoring Server when the
from the Event Log Views after 1 hour of being received. agent starts. Environment variables that control the
behavior of the Event Log Workspace are stored in the
agent ENV file on the Tivoli Enterprise Monitoring Agent
where the agent is running. These variables are stored:
CDP_DP_CACHE_TTL
This value is the minimum number of seconds
before data (for a particular table) is collected
again. By default this variable is present in the
ENV file and the value is set to 60.
CDP_NT_EVENT_LOG_GET_ALL_ENTRIES_FIRST_TIME
This variable determines whether the agent
sends all events currently in the Application
Event Log to the Tivoli Enterprise Monitoring
Server when the agent starts. Legal values are
YES and NO. By default this variable is present
in the ENV file and the value is set to NO.
CDP_NT_EVENT_LOG_CACHE_TIMEOUT
This variable determines how long in seconds
that events are displayed in the Tivoli Enterprise
Monitoring Server Event Log Views. By default,
this variable is not present in the ENV file. A
default value of 3600 (1 Hour) is used unless
overridden by the presence of this variable in
the agent ENV file. The minimum legal value is
300.
To view or edit the agent ENV file on the Tivoli Enterprise
Monitoring agent where the agent is installed, use
Manage Tivoli Enterprise Monitoring Services to select
the agent. Right-click and select Advanced - Edit ENV
File. The agent must be restarted to implement changes.
The name of the attribute does not display in a bar chart When a chart or graph view that includes the attribute is
or graph view. scaled to a small size, a blank space is displayed instead
of a truncated name. To see the name of the attribute,
expand the view of the chart until sufficient space is
available to display all characters of the attribute name.

340 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 8. Workspace problems and solutions (continued)
Problem Solution
You start collection of historical data but the data cannot Use the following managing options for historical data
be seen. collection:
v Basic historical data collection populates the
Warehouse with raw data. This type of data collection
is turned off by default. For information about
managing this feature including how to set the interval
at which data is collected, see “Managing historical
data” in the IBM Tivoli Monitoring Administrator's
Guide. By setting a more frequent interval for data
collection, you reduce the load on the system incurred
every time data is uploaded.
v Use the Summarization and Pruning agent to collect
specific amounts and types of historical data.
Historical data is not displayed until the
Summarization and Pruning monitoring agent begins
collecting the data. By default, this agent begins
collection at 2 a.m. daily. At that point, data is visible
in the workspace view. For information about how to
modify the default collection settings, see “Managing
historical data” in the IBM Tivoli Monitoring
Administrator's Guide.
Historical data collection is unavailable because of The Sort By, Group By, and First/Last functions column
incorrect queries in the Tivoli Enterprise Portal. are not compatible with the historical data collection
feature. Use of these advanced functions makes a query
ineligible for historical data collection.

Even if data collection has started, you cannot use the

time span feature if the query for the chart or table
includes column functions or advanced query options
(Sort By, Group By, First / Last).

To ensure support of historical data collection, do not use

the Sort By, Group By, or First/Last functions in your
queries.

For information about the historical data collection

function, See “Managing historical data” in the IBM
Tivoli Monitoring Administrator's Guide or the Tivoli
Enterprise Portal online help .
When you use a long process name in the situation, the Truncation of process or service names for situations in
process name is truncated. the Availability table in the portal display is the expected
behavior. The maximum name length is 100 bytes.
Regular (non-historical) monitoring data fails to be Check the formation of the queries you use to gather
displayed. data. For example, look for invalid SQL statements.
No row of data for 64-bit applications is displayed in the The Tivoli Enterprise Portal shows data only for 32-bit
workspaces when the monitoring agent is running on a applications. No solution is available for this problem at
64-bit operating system. this time.
Navigator items and workspace titles are labeled with Ensure that application support has been added on the
internal names such as Kxx:KXX0000 instead of the correct monitoring server, portal server, and portal client.
names (such as Disk), where XX and xx represent the
two-character agent code. For more information about installing application
support, see “Installing and enabling application
support” in the IBM Tivoli Monitoring Installation and
Setup Guide.

Chapter 8. Troubleshooting 341

Table 8. Workspace problems and solutions (continued)
Problem Solution
You have installed a 32-bit agent for ITCAM for Upgrade the Windows OS agent from V6.2.2, Fix Pack 1
Microsoft Applications on a computer where a 64-bit to V6.2.2, Fix Pack 2.
Windows OS agent V6.2.2, Fix Pack 1 is installed. On the
Tivoli Enterprise Portal, when you expand the Windows
OS node, and select the Agent Management Services
navigator item, the installation path of the agent is not
correctly displayed in the Agents' Management
Definitions view. Also, no data is displayed for the agent
version and the build number in the Agents'
Management Status view.
If the 32-bit OS agent and a 64-bit Microsoft Application No solution is available for this problem at this time.
agent are installed on the same managed system, Agent
Management Services data is not displayed in the
Agent's Runtime Status view of the agent. The Agent's
Runtime Status view is available in the Agent
Management Services workspace.
You have installed the ITCAM for Microsoft Applications No solution is available for this problem at this time.
agent and the Windows OS agent in the IPV6
environment. In the Agent Management Services
navigator, the IP address in the Agents' Runtime Status
view is displayed in the IPV4 format instead of the IPV6
format.

Situation troubleshooting
Problems can occur with situations and situation configuration.

Table 9 contains problems and solutions for situations.

Table 9. Situation problems and solutions
Problem Solution
Monitoring activity requires too much disk space. Check the RAS trace logging settings that are described
in “Setting RAS trace parameters by using the GUI” on
page 324. For example, trace logs grow rapidly when
you apply the ALL logging option.
Monitoring activity requires too many system resources. “Disk capacity planning for historical data” on page 245
describes the performance impact of specific attribute
groups. If possible, decrease your use of the attribute
groups that require greater system resources.
A formula that uses mathematical operators appears to This formula is incorrect because situation predicates
be incorrect. For example, if you were monitoring a support only logical operators. Your formulas cannot
Linux system, the formula that calculates when Free have mathematical operators.
Memory falls under 10 percent of Total Memory does Note: The Situation Editor provides alternatives to math
not work: LT #’Linux_VM_Stats.Total_Memory’ / 10 operators. In the example, you can select the % Memory
Free attribute and avoid the need for math operators.
You want to change the appearance of situations when 1. Right-click an item in the navigation tree.
they are displayed in the navigation tree.
2. Click Situations in the menu. The Situation Editor
window is displayed.
3. Select the situation that you want to modify.
4. Use the State menu to set the status and appearance
of the Situation when it triggers.
Note: The State setting is not related to severity
settings in the Tivoli Enterprise Console.

342 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 9. Situation problems and solutions (continued)
Problem Solution
When a situation is triggered in the Event Log attribute A timeout occurs on the cache of events for the NT Event
group, it remains in the Situation Event Console as long Log group. Increase the cache time of Event Log
as the event ID entry is present in the Event Log collection to meet your requirements by adding the
workspace. When this event ID entry is removed from following variable and timeout value to the KpcENV file
the Event Log workspace on the Tivoli Enterprise Portal, for the agent (where pc is the two-letter product code):
the situation is also cleared even if the actual problem CDP_NT_EVENT_LOG_CACHE_TIMEOUT=3600
that caused the event is not resolved, and the event ID
entry is also present in the Windows Event Viewer. This variable determines how long events from the NT
Event Log are kept.
If the Expert Advice for a situation contains a hyperlink The external window responds after you close the
to an external website (for example, a Microsoft TechNet Preview window and Situation Editor window.
website) and you click the hyperlink, the website opens
in an external window. However, the external window
stops responding.
The situation for a specific agent is not visible in the Open the Situation Editor. Access the All managed
Tivoli Enterprise Portal. servers view. If the situation is not displayed, confirm
that the monitoring server has been seeded for the agent.
If not, seed the server, as described in the IBM Tivoli
Monitoring Installation and Setup Guide.
The monitoring interval is too long. Access the Situation Editor view for the situation that
you want to modify. Check the Sampling interval area in
the Formula tab. Adjust the time interval as required.
The situation did not activate at startup. Manually recycle the situation as follows:
1. Right-click the situation and select Stop Situation.
2. Right-click the situation and select Start Situation.
Note: You can permanently avoid this problem by
selecting the Run at Startup check box of the Situation
Editor view for a specific situation.
The situation is not displayed. Click the Action tab and check whether the situation has
an automated corrective action. This action can occur
directly or through a policy. The situation might be
resolving so quickly that you do not see the event or the
update in the graphical user interface.
An Alert event did not occur even though the predicate Check the logs, reports, and workspaces.
was correctly specified.
A situation fires on an unexpected managed object. Confirm that you distributed and started the situation on
the correct managed system.
The product did not distribute the situation to a Click the Distribution tab and check the distribution
managed system. settings for the situation.

Chapter 8. Troubleshooting 343

Table 9. Situation problems and solutions (continued)
Problem Solution
The situation does not fire. This problem can be caused when incorrect predicates
are present in the formula that defines the situation. For
example, the managed object shows a state that normally
triggers a monitoring event, but the situation is not true
because the wrong attribute is specified in the formula.

In the Formula tab, analyze predicates as follows:

1. Click the fx icon in the Formula area. The Show
formula window is displayed.
a. Confirm the following details in the Formula area
of the window:
v The attributes that you intend to monitor are
specified in the formula.
v The situations that you intend to monitor are
specified in the formula.
v The logical operators in the formula match your
monitoring goal.
v The numeric values in the formula match your
monitoring goal.
b. (Optional) Select the Show detailed formula
check box to see the original names of attributes
in the application or operating system that you
are monitoring.
c. Click OK to dismiss the Show formula window.
2. (Optional) In the Formula area of the Formula tab,
temporarily assign numeric values that immediately
trigger a monitoring event. The triggering of the
event confirms that other predicates in the formula
are valid.
Note: After you complete this test, you must restore
the numeric values to valid levels so that you do not
generate excessive monitoring data based on your
temporary settings.

For additional information about situations that do not

fire, see “Situations are not firing” in the IBM Tivoli
Monitoring Troubleshooting Guide.
Situation events are not displayed in the Events Console Associate the situation with a Navigator item.
view of the workspace. Note: The situation does not need to be displayed in the
workspace. It is sufficient that the situation is associated
with any Navigator item.
You do not have access to a situation. Note: You must have administrator privileges to
complete these steps.
1. Click Edit > Administer Users to access the
Administer Users window.
2. In the Users area, select the user whose privileges
you want to modify.
3. In the Permissions tab, Applications tab, and
Navigator Views tab, select the permissions or
privileges that correspond to the user role.
4. Click OK.

344 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Table 9. Situation problems and solutions (continued)
Problem Solution
A managed system seems to be offline. 1. Select Physical View and click the Enterprise Level of
the navigator tree.
2. Click View > Workspace > Managed System Status
to see a list of managed systems and their status.
3. If a system is offline, check network connectivity and
the status of the specific system or application.
Associations of custom situations with navigator items Create the associations again by completing the
break after upgrading the agent support. following steps:
1. Right-click the navigator item, and then click
Situations. A list of situations that are associated with
the navigator item is displayed.
Note: If the custom situation that you want to
associate is available in the list, ignore remaining
steps.
2. Click the Set Situation filter criteria icon.
3. Select the Eligible for Association check box, and
then click OK. A list of situations is displayed.
4. Right-click the situation that you want to associate
with the navigator item, and then click Associate.
The situation is associated with the navigator item.

Take Action commands troubleshooting

Problems can occur with Take Action commands.

Table 10 contains problems and solutions that can occur with Take Action commands.

When each Take Action command runs, it generates a log file listed in Table 3 on page 321.
Table 10. Take Action commands problems and solutions
Problem Solution
Take Action commands often require several minutes to Allow several minutes. If you do not see a message
complete. advising you of completion, try to run the command
manually.
Situations fail to trigger Take Action commands. Attempt to manually run the Take Action command in
the Tivoli Enterprise Portal. If the Take Action command
works, look for configuration problems in the situation.
See “Situation troubleshooting” on page 342. If the Take
Action command fails, for general information about
troubleshooting Take Action commands, see the IBM
Tivoli Monitoring Troubleshooting Guide.
When you run the Stop_SNABase Take Action command No solution is available for this problem at this time.
the return code is 2. Because the Stop_SNABase command
is a base service, the dependent services take time to
stop. Even though the action completes, the following
error message is displayed: Error running command.

Discovery Library Adapter for the agent troubleshooting

Problems can occur when using the Discovery Library Adapter for the .

Chapter 8. Troubleshooting 345

Table 11 contains problems and solutions that can occur when using the Discovery Library Adapter for
IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server
Agent. For additional information about troubleshooting for the Discovery Library Adapter, see the IBM
Tivoli Application Dependency Discovery Manager Information Center (http://publib.boulder.ibm.com/
infocenter/tivihelp/v10r1/topic/com.ibm.taddm.doc_7.2/welcome_page/welcome.html).
Table 11. Discovery Library Adapter for problems and solutions
Problem Solution

Tivoli Common Reporting troubleshooting

Problems can occur with the Tivoli Common Reporting predefined reports for the .

Table 12 contains problems and solutions that can occur with the Tivoli Common Reporting predefined
reports for IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host
Integration Server Agent. See the Tivoli Common Reporting Information Center (http://
publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.tivoli.tcr.doc/tcr_welcome.html) for
more information about troubleshooting for the Tivoli Common Reporting tool.
Table 12. Tivoli Common Reporting for problems and solutions
Problem Solution

Support information
If you have a problem with your IBM software, you want to resolve it quickly.

IBM provides the following ways for you to obtain the support you need:
Online
The following websites contain troubleshooting information:
v Go to the IBM Software Support website (http://www.ibm.com/support/entry/portal/
software) and follow the instructions.
v Go to the Application Performance Management Wiki (http://www.ibm.com/developerworks/
servicemanagement/apm/index.html). Feel free to contribute to this wiki.
IBM Support Assistant
The IBM Support Assistant (ISA) is a free local software serviceability workbench that helps you
resolve questions and problems with IBM software products. The ISA provides quick access to
support-related information and serviceability tools for problem determination. To install the ISA
software, go to the IBM Support Assistant website (http://www.ibm.com/software/support/isa).

Informational, warning, and error messages overview

Messages relay information about how the system or application is performing and can alert you to
exceptional conditions when they occur.

Messages are sent to an output destination, such as a file, database, or console screen.

If you receive a warning or error message, you can do one of the following actions:
v Follow the instructions listed in the Detail window of the message if this information is included there.
v Consult the message details listed in this topic to see what action you can take to correct the problem.

346 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v Consult the message log for message ID, text, time, and date of the message, as well as other data you
can use to diagnose the problem.

Message format
The message format contains a message ID and text, an explanation, and an operator response.

IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server
Agent messages have the following format:

Message ID and text

Explanation
Operator Response

The message ID has the following format:

CCC####severity

where:
CCC Prefix that indicates the component to which the message applies. The following components are
used:
KQH General messages
#### Number of the message
severity
Severity of the message. Three levels of severity are used:
I Informational messages provide feedback about something that happened in the
product or system that might be important. These messages can provide guidance
when you are requesting a specific action from the product.
W Warning messages call your attention to an exception condition. The condition
might not be an error but can cause problems if not resolved.
E Error messages indicate that an action cannot be completed because of a user or
system error. These messages require user response.

The Text of the message provides a general statement regarding the problem or condition that occurred.
The Explanation provides additional information about the message and the possible cause for the
condition. The Operator Response provides actions to take in response to the condition, particularly for
error messages (messages with the "E" suffix).

Note: Many message texts and explanations contain variables, such as the specific name of a server or
application. Those variables are represented in this topic as symbols, such as "&1." Actual messages
contain values for these variables.

Agent messages
The following messages apply to IBM Tivoli Composite Application Manager for Microsoft Applications:
Microsoft Host Integration Server Agent.
KQH0001I
The HIS SNA Management Agent service was started.
Explanation:
The HIS SNA Management Agent service was started.
Operator response:
None.

Chapter 8. Troubleshooting 347

KQH0002I
The HIS SNA Management Agent service is already started.
Explanation:
The HIS SNA Management Agent service is already started.
Operator response:
None.
KQH0003E
Error starting HIS SNA Management Agent service.
Explanation:
Error starting HIS SNA Management Agent service.
Operator response:
Check the event log for more information.
KQH0004I
The HIS SNA Base service was started.
Explanation:
The HIS SNA Base service was started.
Operator response:
None.
KQH0005I
The HIS SNA Base is already started.
Explanation:
The HIS SNA Base service is already started.
Operator response:
None.
KQH0006E
Error starting HIS SNA Base service.
Explanation:
Error starting HIS SNA Base service.
Operator response:
Check the Windows event log for information.
KQH0007I
The HIS SNA DDM service was started.
Explanation:
The HIS SNA DDM service was started.
Operator response:
None.
KQH0008I
The HIS SNA DDM service is already started.
Explanation:
The HIS SNA DDM service is already started.
Operator response:
None.
KQH0009E
Error starting HIS SNA DDM service.

348 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Explanation:
Error starting HIS SNA DDM service.
Operator response:
Check the event log for more information.
KQH0013I
The HIS SNA RPC service was started.
Explanation:
The HIS SNA RPC service was started.
Operator response:
None.
KQH0014I
The HIS SNA RPC service is already started.
Explanation:
The HIS SNA RPC service is already started.
Operator response:
None.
KQH0015E
Error starting HIS SNA RPC service.
Explanation:
Error starting HIS SNA RPC service.
Operator response:
Check the event log for more information.
KQH0016I
The HIS SNA Server service was started.
Explanation:
The HIS SNA Server service was started.
Operator response:
None.
KQH0017I
The HIS SNA Server service is already started.
Explanation:
The HIS SNA Server service is already started.
Operator response:
None.
KQH0018E
Error starting HIS SNA Server service.
Explanation:
Error starting HIS SNA Server service.
Operator response:
Check the event log for more information.
KQH0019I
The HIS SNA Print service was started.
Explanation:
The HIS SNA Print service was started.

Chapter 8. Troubleshooting 349

 Operator response:
None.
KQH0020I
The HIS SNA Print service is already started.
Explanation:
The HIS SNA Print service is already started.
Operator response:
None.
KQH0021E
Error starting HIS SNA Print service.
Explanation:
Error starting HIS SNA Print service.
Operator response:
Check the event log for more information.
KQH0025I
The HIS TN3270 service was started.
Explanation:
The HIS TN3270 service was started.
Operator response:
None.
KQH0026I
The HIS TN3270 service is already started.
Explanation:
The HIS TN3270 service is already started.
Operator response:
None.
KQH0027E
Error starting HIS TN3270 service.
Explanation:
Error starting HIS TN3270 service.
Operator response:
Check the event log for more information.
KQH0028I
The HIS TN5250 service was started.
Explanation:
The HIS TN5250 service was started.
Operator response:
None.
KQH0029I
The HIS TN5250 service is already started.
Explanation:
The HIS TN5250 service is already started.
Operator response:
None.

350 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
KQH0030E
Error starting HIS TN5250 service.
Explanation:
Error starting HIS TN5250 service.
Operator response:
Check the event log for more information.
KQH0031I
The HIS LU 6.2 Resynchronization service was started.
Explanation:
The HIS LU 6.2 Resynchronization service was started.
Operator response:
None.
KQH0032I
The HIS LU 6.2 Resynchronization service is already started.
Explanation:
The HIS LU 6.2 Resynchronization service is already started.
Operator response:
None.
KQH0033E
Error starting HIS LU 6.2 Resynchronization service.
Explanation:
Error starting HIS LU 6.2 Resynchronization service.
Operator response:
Check the event log for more information.
KQH0034I
The Enterprise Single Sign On Service was started.
Explanation:
The Enterprise Single Sign On Service was started.
Operator response:
None.
KQH0035I
The Enterprise Single Sign On Service is already started.
Explanation:
The Enterprise Single Sign On Service is already started.
Operator response:
None.
KQH0036E
Error starting Enterprise Single Sign On Service.
Explanation:
Error starting Enterprise Single Sign On Service.
Operator response:
Check the event log for more information.
KQH0037I
The HIS TCP/IP Resync Service was started.

Chapter 8. Troubleshooting 351

 Explanation:
The HIS TCP/IP Resync Service was started.
Operator response:
None.
KQH0038I
The HIS TCP/IP Resync Service is already started.
Explanation:
The HIS TCP/IP Resync Service is already started.
Operator response:
None.
KQH0039E
Error starting HIS TCP/IP Resync Service.
Explanation:
Error starting HIS TCP/IP Resync Service.
Operator response:
Check the event log for more information.
KQH0046I
The Session Integrator Server Service was started.
Explanation:
The Session Integrator Server Service was started.
Operator response:
None.
KQH0047I
The Session Integrator Server Service is already started.
Explanation:
The Session Integrator Server Service is already started.
Operator response:
None.
KQH0048E
Error starting Session Integrator Server Service.
Explanation:
Error starting Session Integrator Server Service.
Operator response:
Check the event log for more information.
KQH0040I
The Microsoft MSMQ-MQSeries Bridge Service was started.
Explanation:
The Microsoft MSMQ-MQSeries Bridge Service was started.
Operator response:
None.
KQH0041I
The Microsoft MSMQ-MQSeries Bridge Service is already started.
Explanation:
The Microsoft MSMQ-MQSeries Bridge Service is already started.

352 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Operator response:
None.
KQH0042E
Error starting Microsoft MSMQ-MQSeries Bridge Service.
Explanation:
Error starting Microsoft MSMQ-MQSeries Bridge Service.
Operator response:
Check the event log for more information.
KQH0043I
The SnaNetMn Service was started.
Explanation:
The SnaNetMn Service was started.
Operator response:
None.
KQH0044I
The SnaNetMn Service is already started.
Explanation:
The SnaNetMn Service is already started.
Operator response:
None.
KQH0045E
Error starting SnaNetMn Service.
Explanation:
Error starting SnaNetMn Service.
Operator response:
Check the event log for more information.
KQH0049I
The DI UPDATECOUNTERS key was set, restart server.
Explanation:
The DI UPDATECOUNTERS key was set, restart server.
Operator response:
None.
KQH0053I
The HIS SNA Server 02 service was started.
Explanation:
The HIS SNA Server 02 service was started.
Operator response:
None.
KQH0054I
The HIS SNA Server 02 service is already started.
Explanation:
The HIS SNA Server 02 service is already started.
Operator response:
None.

Chapter 8. Troubleshooting 353

KQH0055E
Error starting HIS SNA Server 02 service.
Explanation:
Error starting HIS SNA Server 02 service.
Operator response:
Check the event log for more information.
KQH0056I
The HIS SNA Server 03 service was started.
Explanation:
The HIS SNA Server 03 service was started.
Operator response:
None.
KQH0057I
The HIS SNA Server 03 service is already started.
Explanation:
The HIS SNA Server 03 service is already started.
Operator response:
None.
KQH0058E
Error starting HIS SNA Server 03 service.
Explanation:
Error starting HIS SNA Server 03 service.
Operator response:
Check the event log for more information.
KQH0059I
The HIS SNA Server 04 service was started.
Explanation:
The HIS SNA Server 04 service was started.
Operator response:
None.
KQH0060I
The HIS SNA Server 04 service is already started.
Explanation:
The HIS SNA Server 04 service is already started.
Operator response:
None.
KQH0061E
Error starting HIS SNA Server 04 service.
Explanation:
Error starting HIS SNA Server 04 service.
Operator response:
Check the event log for more information.
KQH0101I
The HIS SNA Management Agent service was stopped.

354 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Explanation:
The HIS SNA Management Agent service was stopped.
Operator response:
None.
KQH0102I
The HIS SNA Management Agent service is already stopped.
Explanation:
The HIS SNA Management Agent service is already stopped.
Operator response:
None.
KQH0103E
Error stopping HIS SNA Management Agent service.
Explanation:
Error stopping HIS SNA Management Agent service.
Operator response:
Check the event log for more information.
KQH0104I
The HIS SNA Base service was stopped.
Explanation:
The HIS SNA Base service was stopped.
Operator response:
None.
KQH0105I
The HIS SNA Base is already stopped.
Explanation:
The HIS SNA Base service is already stopped.
Operator response:
None.
KQH0106E
Error stopping HIS SNA Base service.
Explanation:
Error stopping HIS SNA Base service.
Operator response:
Check the event log for more information.
KQH0107I
The HIS SNA DDM service was stopped.
Explanation:
The HIS SNA DDM service was stopped.
Operator response:
None.
KQH0108I
The HIS SNA DDM service is already stopped.
Explanation:
The HIS SNA DDM service is already stopped.

Chapter 8. Troubleshooting 355

 Operator response:
None.
KQH0109E
Error stopping HIS SNA DDM service.
Explanation:
Error stopping HIS SNA DDM service.
Operator response:
Check the event log for more information.
KQH0113I
The HIS SNA RPC service was stopped.
Explanation:
The HIS SNA RPC service was stopped.
Operator response:
None.
KQH0114I
The HIS SNA RPC service is already stopped.
Explanation:
The HIS SNA RPC service is already stopped.
Operator response:
None.
KQH0115E
Error stopping HIS SNA RPC service.
Explanation:
Error stopping HIS SNA RPC service.
Operator response:
Check the event log for more information.
KQH0116I
The HIS SNA Server service was stopped.
Explanation:
The HIS SNA Server service was stopped.
Operator response:
None.
KQH0117I
The HIS SNA Server service is already stopped.
Explanation:
The HIS SNA Server service is already stopped.
Operator response:
None.
KQH0118E
Error stopping HIS SNA Server service.
Explanation:
Error stopping HIS SNA Server service.
Operator response:
Check the event log for more information.

356 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
KQH0119I
The HIS SNA Print service was stopped.
Explanation:
The HIS SNA Print service was stopped.
Operator response:
None.
KQH0120I
The HIS SNA Print service is already stopped.
Explanation:
The HIS SNA Print service is already stopped.
Operator response:
None.
KQH0121E
Error stopping HIS SNA Print service.
Explanation:
Error stopping HIS SNA Print service.
Operator response:
Check the event log for more information.
KQH0125I
The HIS TN3270 service was stopped.
Explanation:
The HIS TN3270 service was stopped.
Operator response:
None.
KQH0126I
The HIS TN3270 service is already stopped.
Explanation:
The HIS TN3270 service is already stopped.
Operator response:
None.
KQH0127E
Error stopping HIS TN3270 service.
Explanation:
Error stopping HIS TN3270 service.
Operator response:
Check the event log for more information.
KQH0128I
The HIS TN5250 service was stopped.
Explanation:
The HIS TN5250 service was stopped.
Operator response:
None.
KQH0129I
The HIS TN5250 service is already stopped.

Chapter 8. Troubleshooting 357

 Explanation:
The HIS TN5250 service is already stopped.
Operator response:
None.
KQH0130E
Error stopping HIS TN5250 service.
Explanation:
Error stopping HIS TN5250 service.
Operator response:
Check the event log for more information.
KQH0131I
The HIS LU 6.2 Resynchronization service was stopped.
Explanation:
The HIS LU 6.2 Resynchronization service was stopped.
Operator response:
None.
KQH0132I
The HIS LU 6.2 Resynchronization service is already stopped.
Explanation:
The HIS LU 6.2 Resynchronization service is already stopped.
Operator response:
None.
KQH0133E
Error stopping HIS LU 6.2 Resynchronization service.
Explanation:
Error stopping HIS LU 6.2 Resynchronization service.
Operator response:
Check the event log for more information.
KQH0134I
The Enterprise Single Sign On Service was stopped.
Explanation:
The Enterprise Single Sign On Service was stopped.
Operator response:
None.
KQH0135I
The Enterprise Single Sign On Service is already stopped.
Explanation:
The Enterprise Single Sign On Service is already stopped.
Operator response:
None.
KQH0136E
Error stopping Enterprise Single Sign On Service.
Explanation:
Error stopping Enterprise Single Sign On Service.

358 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Operator response:
Check the event log for more information.
KQH0137I
The HIS TCP/IP Resync Service was stopped.
Explanation:
The HIS TCP/IP Resync Service was stopped.
Operator response:
None.
KQH0138I
The HIS TCP/IP Resync Service is already stopped.
Explanation:
The HIS TCP/IP Resync Service is already stopped.
Operator response:
None.
KQH0139E
Error stopping HIS TCP/IP Resync Service.
Explanation:
Error stopping HIS TCP/IP Resync Service.
Operator response:
Check the event log for more information.
KQH0146I
The Session Integrator Server Service was stopped.
Explanation:
The Session Integrator Server Service was stopped.
Operator response:
None.
KQH0147I
The Session Integrator Server Service is already stopped.
Explanation:
The Session Integrator Server Service is already stopped.
Operator response:
None.
KQH0148E
Error stopping Session Integrator Server Service .
Explanation:
Error stopping Session Integrator Server Service .
Operator response:
Check the event log for more information.
KQH0140I
The Microsoft MSMQ-MQSeries Bridge Service was stopped.
Explanation:
The Microsoft MSMQ-MQSeries Bridge Service was stopped.
Operator response:
None.

Chapter 8. Troubleshooting 359

KQH0141I
The Microsoft MSMQ-MQSeries Bridge Service is already stopped.
Explanation:
The Microsoft MSMQ-MQSeries Bridge Service is already stopped.
Operator response:
None.
KQH0142E
Error stopping Microsoft MSMQ-MQSeries Bridge Service .
Explanation:
Error stopping Microsoft MSMQ-MQSeries Bridge Service .
Operator response:
Check the event log for more information.
KQH0143I
The SnaNetMn Service was stopped.
Explanation:
The SnaNetMn Service was stopped.
Operator response:
None.
KQH0144I
The SnaNetMn Service is already stopped.
Explanation:
The SnaNetMn Service is already stopped.
Operator response:
None.
KQH0145E
Error stopping SnaNetMn Service.
Explanation:
Error stopping SnaNetMn Service.
Operator response:
Check the event log for more information.
KQH0149I
The DI UPDATECOUNTERS key was reset, restart server.
Explanation:
The DI UPDATECOUNTERS key was reset, restart server.
Operator response:
None.
KQH0191I
Monitoring is already being enabled.
Explanation:
Monitoring is already being enabled.
Operator response:
None.
KQH0192I
Registry does not exist, no changes done.

360 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
 Explanation:
Registry does not exist, no changes done.
Operator response:
None.
KQH0193I
Registry entry updated, restart server.
Explanation:
Registry entry updated, restart server.
Operator response:
None.
KQH0194I
Error occured while setting registry entry.
Explanation:
Error occured while setting registry entry.
Operator response:
None.
KQH0195I
Monitoring is already being disabled.
Explanation:
Monitoring is already being disabled.
Operator response:
None.
KQH0196I
A registry entry is created and updated, restart server.
Explanation:
A registry entry is created and updated, restart server.
Operator response:
None.
KQH0197I
A registry entry is updated, restart server.
Explanation:
A registry entry is updated, restart server.
Operator response:
None.
KQH0153I
The HIS SNA Server 02 service was stopped.
Explanation:
The HIS SNA Server 02 service was stopped.
Operator response:
None.
KQH0154I
The HIS SNA Server 02 service is already stopped.
Explanation:
The HIS SNA Server 02 service is already stopped.

Chapter 8. Troubleshooting 361

 Operator response:
None.
KQH0155E
Error stopping HIS SNA Server 02 service.
Explanation:
Error stopping HIS SNA Server 02 service.
Operator response:
Check the event log for more information.
KQH0156I
The HIS SNA Server 03 service was stopped.
Explanation:
The HIS SNA Server 03 service was stopped.
Operator response:
None.
KQH0157I
The HIS SNA Server 03 service is already stopped.
Explanation:
The HIS SNA Server 03 service is already stopped.
Operator response:
None.
KQH0158E
Error stopping HIS SNA Server 03 service.
Explanation:
Error stopping HIS SNA Server 03 service.
Operator response:
Check the event log for more information.
KQH0159I
The HIS SNA Server 04 service was stopped.
Explanation:
The HIS SNA Server 04 service was stopped.
Operator response:
None.
KQH0160I
The HIS SNA Server 04 service is already stopped.
Explanation:
The HIS SNA Server 04 service is already stopped.
Operator response:
None.
KQH0161E
Error stopping HIS SNA Server 04 service.
Explanation:
Error stopping HIS SNA Server 04 service.
Operator response:
Check the event log for more information.

362 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
KQH0200W
The service does not exist as an installed service.
Explanation:
The service does not exist as an installed service.
Operator response:
None.
KQH0201I
The service is disabled and cannot be started.
Explanation:
The service is disabled and cannot be started.
Operator response:
None.
KQH0202E
The dependency service or group failed to start.
Explanation:
The dependency service or group failed to start.
Operator response:
None.
KQH0203E
The dependency service does not exist or has been marked for deletion.
Explanation:
The dependency service does not exist or has been marked for deletion.
Operator response:
None.
KQH0204E
The service did not start due to a logon failure.
Explanation:
The service did not start due to a logon failure.
Operator response:
None.
KQH0205E
The service failed to start because of insufficient access privileges.
Explanation:
The service failed to start because of insufficient access privileges.
Operator response:
None.
KQH0206I
The Link Service is started.
Explanation:
The Link Service is started.
Operator response:
None.
KQH0207I
The Link Service is already started.

Chapter 8. Troubleshooting 363

 Explanation:
The Link Service is already started.
Operator response:
None.
KQH0208E
An error occurred while starting the Link Service.
Explanation:
An error occurred while starting the Link Service.
Operator response:
Check the event log for more information.
KQH0209I
The Link Service is stopped.
Explanation:
The Link Service is stopped.
Operator response:
None.
KQH0210I
The Link Service is already stopped.
Explanation:
The Link Service is already stopped.
Operator response:
None.
KQH0211E
An error occurred while stopping the Link Service.
Explanation:
An error occurred while stopping the Link Service.
Operator response:
Check the event log for more information.
KQH0231E
The service failed to start because of insufficient access privileges.
Explanation:
The service failed to start because of insufficient access privileges.
Operator response:
None.
KQH0232E
The service failed to stop because of insufficient access privileges.
Explanation:
The service failed to stop because of insufficient access privileges.
Operator response:
None.

364 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Appendix A. Event mapping
The Tivoli Event Integration Facility (EIF) interface is used to forward situation events to Tivoli
Netcool/OMNIbus or Tivoli Enterprise Console.

EIF events specify an event class, and the event data is specified as name-value pairs that identify the
name of an event slot and the value for the slot. An event class can have subclasses. IBM Tivoli
Monitoring provides the base event class definitions and a set of base slots that are included in all
monitoring events. Agents extend the base event classes to define subclasses that include agent-specific
slots. For events, the event classes correspond to the agent attribute groups, and the agent-specific slots
correspond to the attributes in the attribute group.

The situation editor in the Tivoli Enterprise Portal can be used to perform custom mapping of data to EIF
slots instead of using the default mapping described in this topic. For more information about EIF slot
customization, see the Tivoli Enterprise Portal User's Guide.

Tivoli Enterprise Console requires that event classes and their slots are defined in BAROC (Basic Recorder
of Objects in C) files. Each agent provides a BAROC file that contains event class definitions for the agent
and is installed on the Tivoli Enterprise Monitoring Server in the TECLIB directory (install_dir/cms/
TECLIB for Windows systems and install_dir/tables/TEMS_hostname/TECLIB for UNIX systems) when
application support for the agent is installed. The BAROC file for the agent and the base BAROC files
provided with Tivoli Monitoring must also be installed onto the Tivoli Enterprise Console. For details, see
“Setting up event forwarding to Tivoli Enterprise Console” in the IBM Tivoli Monitoring Installation and
Setup Guide.

Each of the event classes is a child of KQH_Base and is defined in the kqh.baroc (version vNext) file. The
KQH_Base event class can be used for generic rules processing for any event from the IBM Tivoli
Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent.

For events that are generated by situations in the Application Integration HIP attribute group, events are
sent by using the ITM_KQH_APPLICATION_INTEGRATION_HIP event class. This event class contains
the following slots:
v node: STRING
v timestamp: STRING
v net_methods_executed_sec: REAL
v net_methods_executed_sec_enum: STRING
v avg_net_server_time: REAL
v avg_net_server_time_enum: STRING
v avg_com_server_time: REAL
v avg_com_server_time_enum: STRING
v avg_unit_of_work_time: REAL
v avg_unit_of_work_time_enum: STRING
v calls_executing: INTEGER
v calls_executing_enum: STRING
v cnt_of_errors_sec: REAL
v cnt_of_errors_sec_enum: STRING
v com_methods_executed_sec: REAL
v com_methods_executed_sec_enum: STRING
v host_requests_processed_sec: REAL
© Copyright IBM Corp. 2010, 2013 365
v host_requests_processed_sec_enum: STRING
v host_requests_queued: INTEGER
v host_requests_queued_enum: STRING
v host_requests_rejected_sec: REAL
v host_requests_rejected_sec_enum: STRING
v total_requests_accepted: REAL
v total_requests_accepted_enum: STRING
v total_requests_received: REAL
v total_requests_received_enum: STRING
v work_flow_determinant_starts_sec: REAL
v work_flow_determinant_starts_sec_enum: STRING
v work_flow_endpoint_starts_sec: REAL
v work_flow_endpoint_starts_sec_enum: STRING
v work_flow_envelope_starts_sec: REAL
v work_flow_envelope_starts_sec_enum: STRING
v work_flow_starts_sec: REAL
v work_flow_starts_sec_enum: STRING
v work_flow_trm_starts_sec: REAL
v work_flow_trm_starts_sec_enum: STRING
v kilobytes_recv_d_from_an_sna_host_sec: REAL
v kilobytes_recv_d_from_an_sna_host_sec_enum: STRING
v kilobytes_sent_to_an_sna_host_sec: REAL
v kilobytes_sent_to_an_sna_host_sec_enum: STRING
v kilobytes_recv_d_from_a_tcp_ip_host_sec: REAL
v kilobytes_recv_d_from_a_tcp_ip_host_sec_enum: STRING
v kilobytes_sent_to_a_tcp_ip_host_sec: REAL
v kilobytes_sent_to_a_tcp_ip_host_sec_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the Application Integration WIP attribute group, events are
sent by using the ITM_KQH_APPLICATION_INTEGRATION_WIP event class. This event class contains
the following slots:
v node: STRING
v timestamp: STRING
v average_method_call_time: REAL
v average_method_call_time_enum: STRING
v calls_currently_executing: REAL
v calls_currently_executing_enum: STRING
v cumulative_calls: REAL
v cumulative_calls_enum: STRING
v host_resp_time_cics_link: REAL
v host_resp_time_cics_link_enum: STRING
v host_resp_time_cics_non_link_or_ims: REAL
v host_resp_time_cics_non_link_or_ims_enum: STRING
v host_resp_time_tcp_concurrent_server: REAL

366 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v host_resp_time_tcp_concurrent_server_enum: STRING
v host_resp_time_tcp_explicit: REAL
v host_resp_time_tcp_explicit_enum: STRING
v host_resp_time_tcp_implicit: REAL
v host_resp_time_tcp_implicit_enum: STRING
v host_resp_time_tcp_ims_connect_or_otma: REAL
v host_resp_time_tcp_ims_connect_or_otma_enum: STRING
v host_resp_time_tcp_mslink: REAL
v host_resp_time_tcp_mslink_enum: STRING
v link_calls_sec: REAL
v link_calls_sec_enum: STRING
v non_link_calls_sec: REAL
v non_link_calls_sec_enum: STRING
v tcp_concurrent_server_calls_sec: REAL
v tcp_concurrent_server_calls_sec_enum: STRING
v tcp_explicit_calls_sec: REAL
v tcp_explicit_calls_sec_enum: STRING
v tcp_implicit_calls_sec: REAL
v tcp_implicit_calls_sec_enum: STRING
v tcp_ims_connect_or_otma_calls_sec: REAL
v tcp_ims_connect_or_otma_calls_sec_enum: STRING
v tcp_mslink_calls_sec: REAL
v tcp_mslink_calls_sec_enum: STRING
v total_calls_sec: REAL
v total_calls_sec_enum: STRING
v total_errors_sec: REAL
v total_errors_sec_enum: STRING
v kilobytes_recv_d_from_an_sna_host_sec: REAL
v kilobytes_recv_d_from_an_sna_host_sec_enum: STRING
v kilobytes_sent_to_an_sna_host_sec: REAL
v kilobytes_sent_to_an_sna_host_sec_enum: STRING
v kilobytes_recv_d_from_a_tcp_host_sec: REAL
v kilobytes_recv_d_from_a_tcp_host_sec_enum: STRING
v kilobytes_sent_to_a_tcp_host_sec: REAL
v kilobytes_sent_to_a_tcp_host_sec_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the Availability attribute group, events are sent by using the
ITM_KQH_AVAILABILITY event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v application_component: STRING
v name: STRING
v name_enum: STRING

Appendix A. Event mapping 367

v kqh_status: INTEGER
v kqh_status_enum: STRING
v full_name: STRING
v full_name_enum: STRING
v type: INTEGER
v type_enum: STRING
v virtual_size: INTEGER
v page_faults_per_sec: INTEGER
v working_set_size: INTEGER
v thread_count: INTEGER
v pid: INTEGER
v percent_privileged_time: INTEGER
v percent_user_mode_time: INTEGER
v percent_processor_time: INTEGER
v command_line: STRING
v command_line_enum: STRING
v functionality_test_status: INTEGER
v functionality_test_status_enum: STRING
v functionality_test_message: STRING
v functionality_test_message_enum: STRING

For events that are generated by situations in the Event Log attribute group, events are sent by using the
ITM_KQH_EVENT_LOG event class. This event class contains the following slots:
v node: STRING
v log_name: STRING
v event_source: STRING
v event_type: INTEGER
v event_type_enum: STRING
v event_id: INTEGER
v event_category: STRING
v event_category_enum: STRING
v message: STRING
v time_generated: STRING

For events that are generated by situations in the HIS Databases attribute group, events are sent by using
the ITM_KQH_HIS_DATABASES event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v databasename: STRING
v server: STRING
v databasetype: STRING
v system_name: STRING

For events that are generated by situations in the HIS Information attribute group, events are sent by
using the ITM_KQH_HIS_INFORMATION event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING

368 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v pro_name: STRING
v pro_ver: STRING
v role: STRING
v isconfigured: STRING

For events that are generated by situations in the HIS Tracing attribute group, events are sent by using
the ITM_KQH_HIS_TRACING event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v classname: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v fataltrace: INTEGER
v fataltrace_enum: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v system_name: STRING

For events that are generated by situations in the Link Service attribute group, events are sent by using
the ITM_KQH_LINK_SERVICE event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v dllname: STRING
v domain: STRING
v drivername: STRING
v isremotable: INTEGER
v isremotable_enum: STRING
v name: STRING
v title: STRING
v type: INTEGER
v type_enum: STRING
v user: STRING

For events that are generated by situations in the Link Service Distributed attribute group, events are sent
by using the ITM_KQH_LINK_SERVICE_DISTRIBUTED event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v service_name: STRING
v service_title: STRING
v dll_name: STRING
v description: STRING
v system_name: STRING

For events that are generated by situations in the Link Service IPDLC attribute group, events are sent by
using the ITM_KQH_LINK_SERVICE_IPDLC event class. This event class contains the following slots:
v node: STRING

Appendix A. Event mapping 369

v timestamp: STRING
v activationdelaytimer: INTEGER
v activationdelaytimer_enum: STRING
v addresstype: INTEGER
v addresstype_enum: STRING
v backupnns: STRING
v cmdmaxretry: INTEGER
v cmdmaxretry_enum: STRING
v cpname: STRING
v dllname: STRING
v domain: STRING
v drivername: STRING
v isremotable: INTEGER
v isremotable_enum: STRING
v lennode: STRING
v livetimetimeout: INTEGER
v livetimetimeout_enum: STRING
v localaddress: STRING
v maxactivationattempts: INTEGER
v maxactivationattempts_enum: STRING
v maxbtureceive: INTEGER
v maxbtureceive_enum: STRING
v maxbtusend: INTEGER
v maxbtusend_enum: STRING
v name: STRING
v networkname: STRING
v nodeid: STRING
v nopreferrednns: INTEGER
v nopreferrednns_enum: STRING
v primarynns: STRING
v receiveacktimeout: INTEGER
v receiveacktimeout_enum: STRING
v resolvedip: STRING
v title: STRING
v type: INTEGER
v type_enum: STRING
v usedynamicpudefinition: INTEGER
v usedynamicpudefinition_enum: STRING
v user: STRING
v delayed_path_switch_timer: INTEGER
v delayed_path_switch_timer_enum: STRING
v disable_progressive_arb: INTEGER
v disable_progressive_arb_enum: STRING
v use_ipv6: INTEGER
v use_ipv6_enum: STRING

370 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v vrn_not_limited_resource: INTEGER
v vrn_not_limited_resource_enum: STRING

For events that are generated by situations in the Link Service SDLC attribute group, events are sent by
using the ITM_KQH_LINK_SERVICE_SDLC event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v service_name: STRING
v service_title: STRING
v dll_name: STRING
v description: STRING
v system_name: STRING

For events that are generated by situations in the Managed Application Integration attribute group,
events are sent by using the ITM_KQH_MANAGED_APPLICATION_INTEGRATION event class. This
event class contains the following slots:
v node: STRING
v timestamp: STRING
v average_host_response_time: REAL
v average_host_response_time_enum: STRING
v average_method_call_time: REAL
v average_method_call_time_enum: STRING
v calls_currently_executing: INTEGER
v calls_currently_executing_enum: STRING
v cumulative_calls: REAL
v cumulative_calls_enum: STRING
v total_calls_sec: REAL
v total_calls_sec_enum: STRING
v total_errors_sec: REAL
v total_errors_sec_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the MQBridge attribute group, events are sent by using the
ITM_KQH_MQBRIDGE event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v gateway_starting_time: INTEGER
v gateway_starting_time_enum: STRING
v mqs_to_msmq_threads: INTEGER
v mqs_to_msmq_threads_enum: STRING
v mqs_to_msmq_tx_threads: INTEGER
v mqs_to_msmq_tx_threads_enum: STRING
v msmq_to_mqs_threads: INTEGER
v msmq_to_mqs_threads_enum: STRING
v msmq_to_mqs_tx_threads: INTEGER
v msmq_to_mqs_tx_threads_enum: STRING

Appendix A. Event mapping 371

v gateway_starting_time_in_seconds: INTEGER
v gateway_starting_time_in_seconds_enum: STRING
v system_name: STRING

For events that are generated by situations in the MQBridge Channel attribute group, events are sent by
using the ITM_KQH_MQBRIDGE_CHANNEL event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v lu62sideinforecord: STRING
v mcauser: STRING
v name: STRING
v queuemanagername: STRING
v tcpaddress: STRING
v tcpport: STRING
v transporttype: INTEGER
v transporttype_enum: STRING

For events that are generated by situations in the MQBridge Connected Network attribute group, events
are sent by using the ITM_KQH_MQBRIDGE_CONNECTED_NETWORK event class. This event class
contains the following slots:
v node: STRING
v timestamp: STRING
v mqseriesqmngr: STRING
v name: STRING
v replytoqmngr: STRING
v startup: INTEGER
v startup_enum: STRING

For events that are generated by situations in the MQBridge Message Pipe attribute group, events are
sent by using the ITM_KQH_MQBRIDGE_MESSAGE_PIPE event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v cachereresh: INTEGER
v cachereresh_enum: STRING
v longretrycount: INTEGER
v longretrycount_enum: STRING
v longretrydelay: INTEGER
v longretrydelay_enum: STRING
v maxmessagecount: INTEGER
v maxmessagecount_enum: STRING
v maxmessagesize: INTEGER
v maxmessagesize_enum: STRING
v maxtime: INTEGER
v maxtime_enum: STRING
v shortretrycount: INTEGER
v shortretrycount_enum: STRING

372 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v shortretrydelay: INTEGER
v shortretrydelay_enum: STRING
v startup: INTEGER
v startup_enum: STRING
v transmitqueue: STRING
v system_name: STRING

For events that are generated by situations in the MQBridge MQS to MSMQ attribute group, events are
sent by using the ITM_KQH_MQBRIDGE_MQS_TO_MSMQ event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v mqs_queue_depth: INTEGER
v mqs_queue_depth_enum: STRING
v msg_count: REAL
v msg_count_enum: STRING
v starting_retry_count: INTEGER
v starting_retry_count_enum: STRING
v starting_time: INTEGER
v starting_time_enum: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v suspension_starting_time: INTEGER
v suspension_starting_time_enum: STRING
v suspension_time: INTEGER
v suspension_time_enum: STRING
v kilo_byte_count: REAL
v kilo_byte_count_enum: STRING
v starting_time_in_seconds: INTEGER
v starting_time_in_seconds_enum: STRING
v suspension_time_in_seconds: INTEGER
v suspension_time_in_seconds_enum: STRING
v suspension_starting_time_in_seconds: INTEGER
v suspension_starting_time_in_seconds_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the MQBridge MQS to MSMQ Tx attribute group, events
are sent by using the ITM_KQH_MQBRIDGE_MQS_TO_MSMQ_TX event class. This event class contains
the following slots:
v node: STRING
v timestamp: STRING
v mqs_queue_depth: INTEGER
v mqs_queue_depth_enum: STRING
v msg_count: REAL
v msg_count_enum: STRING

Appendix A. Event mapping 373

v starting_retry_count: INTEGER
v starting_retry_count_enum: STRING
v starting_time: INTEGER
v starting_time_enum: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v suspension_starting_time: INTEGER
v suspension_starting_time_enum: STRING
v suspension_time: INTEGER
v suspension_time_enum: STRING
v kilo_byte_count: REAL
v kilo_byte_count_enum: STRING
v starting_time_in_seconds: INTEGER
v starting_time_in_seconds_enum: STRING
v suspension_time_in_seconds: INTEGER
v suspension_time_in_seconds_enum: STRING
v suspension_starting_time_in_seconds: INTEGER
v suspension_starting_time_in_seconds_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the MQBridge MSMQ to MQS attribute group, events are
sent by using the ITM_KQH_MQBRIDGE_MSMQ_TO_MQS event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v mqs_queue_depth: INTEGER
v mqs_queue_depth_enum: STRING
v msg_count: REAL
v msg_count_enum: STRING
v starting_retry_count: INTEGER
v starting_retry_count_enum: STRING
v starting_time: INTEGER
v starting_time_enum: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v suspension_starting_time: INTEGER
v suspension_starting_time_enum: STRING
v suspension_time: INTEGER
v suspension_time_enum: STRING
v kilo_byte_count: REAL
v kilo_byte_count_enum: STRING
v starting_time_in_seconds: INTEGER
v starting_time_in_seconds_enum: STRING
v suspension_time_in_seconds: INTEGER
v suspension_time_in_seconds_enum: STRING

374 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v suspension_starting_time_in_seconds: INTEGER
v suspension_starting_time_in_seconds_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the MQBridge MSMQ to MQS Tx attribute group, events
are sent by using the ITM_KQH_MQBRIDGE_MSMQ_TO_MQS_TX event class. This event class contains
the following slots:
v node: STRING
v timestamp: STRING
v mqs_queue_depth: INTEGER
v mqs_queue_depth_enum: STRING
v msg_count: REAL
v msg_count_enum: STRING
v starting_retry_count: INTEGER
v starting_retry_count_enum: STRING
v starting_time: INTEGER
v starting_time_enum: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v suspension_starting_time: INTEGER
v suspension_starting_time_enum: STRING
v suspension_time: INTEGER
v suspension_time_enum: STRING
v kilo_byte_count: REAL
v kilo_byte_count_enum: STRING
v starting_time_in_seconds: INTEGER
v starting_time_in_seconds_enum: STRING
v suspension_time_in_seconds: INTEGER
v suspension_time_in_seconds_enum: STRING
v suspension_starting_time_in_seconds: INTEGER
v suspension_starting_time_in_seconds_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the MQBridge Service attribute group, events are sent by
using the ITM_KQH_MQBRIDGE_SERVICE event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v cachereresh: INTEGER
v cachereresh_enum: STRING
v f2qr_maxthreads: INTEGER
v f2qr_maxthreads_enum: STRING
v f2qt_maxthreads: INTEGER
v f2qt_maxthreads_enum: STRING
v name: STRING

Appendix A. Event mapping 375

v q2fd_maxthreads: INTEGER
v q2fd_maxthreads_enum: STRING
v q2fo_maxthreads: INTEGER
v q2fo_maxthreads_enum: STRING
v encryption: INTEGER
v encryption_enum: STRING

For events that are generated by situations in the MSFT DB2 Access Library attribute group, events are
sent by using the ITM_KQH_MSFT_DB2_ACCESS_LIBRARY event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v commits_second: REAL
v commits_second_enum: STRING
v odbc_executes_second: REAL
v odbc_executes_second_enum: STRING
v odbc_prepares_second: REAL
v odbc_prepares_second_enum: STRING
v odbc_rows_fetched_second: REAL
v odbc_rows_fetched_second_enum: STRING
v ole_db_avg_data_access_time: REAL
v ole_db_avg_data_access_time_enum: STRING
v ole_db_executes_second: REAL
v ole_db_executes_second_enum: STRING
v ole_db_getdata_calls_second: REAL
v ole_db_getdata_calls_second_enum: STRING
v ole_db_prepares_second: REAL
v ole_db_prepares_second_enum: STRING
v ole_db_rows_fetched_second: REAL
v ole_db_rows_fetched_second_enum: STRING
v open_connections: INTEGER
v open_connections_enum: STRING
v open_statements: INTEGER
v open_statements_enum: STRING
v packets_received_second: REAL
v packets_received_second_enum: STRING
v packets_sent_second: REAL
v packets_sent_second_enum: STRING
v rollbacks_second: REAL
v rollbacks_second_enum: STRING
v transactions_second: REAL
v transactions_second_enum: STRING
v kilobytes_received_second: REAL
v kilobytes_received_second_enum: STRING
v kilobytes_sent_second: REAL
v kilobytes_sent_second_enum: STRING

376 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v avg_host_processing_time_in_millisec: REAL
v avg_host_processing_time_in_millisec_enum: STRING
v odbc_avg_execution_time_in_millisec: REAL
v odbc_avg_execution_time_in_millisec_enum: STRING
v odbc_avg_fetch_time_in_millisec: REAL
v odbc_avg_fetch_time_in_millisec_enum: STRING
v odbc_avg_prepare_time_in_millisec: REAL
v odbc_avg_prepare_time_in_millisec_enum: STRING
v ole_db_avg_execution_time_in_millisec: REAL
v ole_db_avg_execution_time_in_millisec_enum: STRING
v ole_db_avg_fetch_time_in_millisec: REAL
v ole_db_avg_fetch_time_in_millisec_enum: STRING
v ole_db_avg_prepare_time_in_millisec: REAL
v ole_db_avg_prepare_time_in_millisec_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the Performance Object Status attribute group, events are
sent by using the ITM_KQH_PERFORMANCE_OBJECT_STATUS event class. This event class contains
the following slots:
v node: STRING
v timestamp: STRING
v query_name: STRING
v object_name: STRING
v object_type: INTEGER
v object_type_enum: STRING
v object_status: INTEGER
v object_status_enum: STRING
v error_code: INTEGER
v error_code_enum: STRING
v last_collection_start: STRING
v last_collection_start_enum: STRING
v last_collection_finished: STRING
v last_collection_finished_enum: STRING
v last_collection_duration: REAL
v average_collection_duration: REAL
v average_collection_duration_enum: STRING
v refresh_interval: INTEGER
v number_of_collections: INTEGER
v cache_hits: INTEGER
v cache_misses: INTEGER
v cache_hit_percent: REAL
v intervals_skipped: INTEGER

Appendix A. Event mapping 377

For events that are generated by situations in the Session Integrator Server attribute group, events are
sent by using the ITM_KQH_SESSION_INTEGRATOR_SERVER event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v chains_received_per_sec: REAL
v chains_received_per_sec_enum: STRING
v chains_transmitted_per_sec: REAL
v chains_transmitted_per_sec_enum: STRING
v sessions: INTEGER
v sessions_enum: STRING
v sessions_connected: INTEGER
v sessions_connected_enum: STRING
v sessions_online: INTEGER
v sessions_online_enum: STRING
v transactions_per_sec: REAL
v transactions_per_sec_enum: STRING
v data_kilo_bytes_received_sec: REAL
v data_kilo_bytes_received_sec_enum: STRING
v data_kilo_bytes_transmitted_sec: REAL
v data_kilo_bytes_transmitted_sec_enum: STRING
v system_name: STRING

For events that are generated by situations in the Session Integrator Server PLUs attribute group, events
are sent by using the ITM_KQH_SESSION_INTEGRATOR_SERVER_PLUS event class. This event class
contains the following slots:
v node: STRING
v timestamp: STRING
v chains_received_per_sec: REAL
v chains_received_per_sec_enum: STRING
v chains_transmitted_per_sec: REAL
v chains_transmitted_per_sec_enum: STRING
v sessions: INTEGER
v sessions_enum: STRING
v sessions_connected: INTEGER
v sessions_connected_enum: STRING
v transactions_per_sec: REAL
v transactions_per_sec_enum: STRING
v data_kilo_bytes_received_sec: REAL
v data_kilo_bytes_received_sec_enum: STRING
v data_kilo_bytes_transmitted_sec: REAL
v data_kilo_bytes_transmitted_sec_enum: STRING
v system_name: STRING
v name: STRING

378 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
For events that are generated by situations in the SNA 3270 Response Times attribute group, events are
sent by using the ITM_KQH_SNA_3270_RESPONSE_TIMES event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v pct_responses_threshold_1: INTEGER
v pct_responses_threshold_1_enum: STRING
v pct_responses_threshold_2: INTEGER
v pct_responses_threshold_2_enum: STRING
v pct_responses_threshold_3: INTEGER
v pct_responses_threshold_3_enum: STRING
v pct_responses_threshold_4: INTEGER
v pct_responses_threshold_4_enum: STRING
v pct_responses_threshold_5: INTEGER
v pct_responses_threshold_5_enum: STRING
v system_name: STRING
v name: STRING

For events that are generated by situations in the SNA APPC Mode attribute group, events are sent by
using the ITM_KQH_SNA_APPC_MODE event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v allowlzandrle: INTEGER
v allowlzandrle_enum: STRING
v autoactivate: INTEGER
v autoactivate_enum: STRING
v comment: STRING
v endpointonly: INTEGER
v endpointonly_enum: STRING
v maxrcvcompression: INTEGER
v maxrcvcompression_enum: STRING
v maxsendcompression: INTEGER
v maxsendcompression_enum: STRING
v mincontwin: INTEGER
v mincontwin_enum: STRING
v name: STRING
v partmincontwin: INTEGER
v partmincontwin_enum: STRING
v priority: INTEGER
v priority_enum: STRING
v rxpacing: INTEGER
v rxpacing_enum: STRING
v rxru: INTEGER
v rxru_enum: STRING
v sessionlimit: INTEGER
v sessionlimit_enum: STRING

Appendix A. Event mapping 379

v txpacing: INTEGER
v txpacing_enum: STRING
v txru: INTEGER
v txru_enum: STRING

For events that are generated by situations in the SNA Configured Users attribute group, events are sent
by using the ITM_KQH_SNA_CONFIGURED_USERS event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v name: STRING
v dynremote: INTEGER
v dynremote_enum: STRING
v encryption: INTEGER
v encryption_enum: STRING
v usertype: INTEGER
v usertype_enum: STRING

For events that are generated by situations in the SNA Connection Configuration attribute group, events
are sent by using the ITM_KQH_SNA_CONNECTION_CONFIGURATION event class. This event class
contains the following slots:
v node: STRING
v timestamp: STRING
v activation: INTEGER
v activation_enum: STRING
v adapter: STRING
v affiliateapplication: STRING
v allowincoming: INTEGER
v allowincoming_enum: STRING
v blockid: STRING
v comment: STRING
v compressionlevel: INTEGER
v compressionlevel_enum: STRING
v dynamicludef: INTEGER
v dynamicludef_enum: STRING
v localcontrolpoint: STRING
v localnetname: STRING
v name: STRING
v nodeid: STRING
v partnerconnectionname: STRING
v peerrole: INTEGER
v peerrole_enum: STRING
v remoteblockid: STRING
v remotecontrolpoint: STRING
v remoteend: INTEGER
v remoteend_enum: STRING

380 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v remotenetname: STRING
v remotenodeid: STRING
v retrydelay: INTEGER
v retrydelay_enum: STRING
v retrylimit: INTEGER
v retrylimit_enum: STRING
v service: STRING
v statustext: STRING
v xidformat: INTEGER
v xidformat_enum: STRING

For events that are generated by situations in the SNA Connections attribute group, events are sent by
using the ITM_KQH_SNA_CONNECTIONS event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v throughput_frames_per_sec: REAL
v throughput_frames_per_sec_enum: STRING
v data_kilo_bytes_received_sec: REAL
v data_kilo_bytes_received_sec_enum: STRING
v data_kilo_bytes_transmitted_sec: REAL
v data_kilo_bytes_transmitted_sec_enum: STRING
v throughput_frames_kilobytes_per_sec: REAL
v throughput_frames_kilobytes_per_sec_enum: STRING
v name: STRING

For events that are generated by situations in the SNA Domain attribute group, events are sent by using
the ITM_KQH_SNA_DOMAIN event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v auditlevel: INTEGER
v auditlevel_enum: STRING
v broadcastmeantime: INTEGER
v broadcastmeantime_enum: STRING
v clientbackupdomainname: STRING
v clientbackupsponsornames: STRING
v clientdomainbackuptype: INTEGER
v clientdomainbackuptype_enum: STRING
v configserver: STRING
v datetimesaved: STRING
v dispverbconnection: STRING
v eventlogserver: STRING
v ipxspx: INTEGER
v ipxspx_enum: STRING
v name: STRING
v namedpipes: INTEGER
v namedpipes_enum: STRING

Appendix A. Event mapping 381

v netviewconnection: STRING
v popupserver: STRING
v rtmendofsession: INTEGER
v rtmendofsession_enum: STRING
v rtmoverflow: INTEGER
v rtmoverflow_enum: STRING
v rtmthreshold1: INTEGER
v rtmthreshold1_enum: STRING
v rtmthreshold2: INTEGER
v rtmthreshold2_enum: STRING
v rtmthreshold3: INTEGER
v rtmthreshold3_enum: STRING
v rtmthreshold4: INTEGER
v rtmthreshold4_enum: STRING
v rtmtimeruntil: INTEGER
v rtmtimeruntil_enum: STRING
v security3270: INTEGER
v security3270_enum: STRING
v securityappc: INTEGER
v securityappc_enum: STRING
v securitylua: INTEGER
v securitylua_enum: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v tcpip: INTEGER
v tcpip_enum: STRING

For events that are generated by situations in the SNA Domain Topology attribute group, events are sent
by using the ITM_KQH_SNA_DOMAIN_TOPOLOGY event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v domainname: STRING
v servername: STRING
v rolename: STRING
v statustext: STRING
v transportstring: STRING

For events that are generated by situations in the SNA Logical Unit Sessions attribute group, events are
sent by using the ITM_KQH_SNA_LOGICAL_UNIT_SESSIONS event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v throughput_frames_per_sec: REAL
v throughput_frames_per_sec_enum: STRING
v data_kilo_bytes_received_sec: REAL

382 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v data_kilo_bytes_received_sec_enum: STRING
v data_kilo_bytes_transmitted_sec: REAL
v data_kilo_bytes_transmitted_sec_enum: STRING
v throughput_frames_kilobyte_per_sec: REAL
v throughput_frames_kilobyte_per_sec_enum: STRING
v name: STRING

For events that are generated by situations in the SNA LU AppcLocal attribute group, events are sent by
using the ITM_KQH_SNA_LU_APPCLOCAL event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v name: STRING
v service: STRING
v connection: STRING
v netname: STRING
v number: INTEGER
v number_enum: STRING
v poolmember: INTEGER
v poolmember_enum: STRING
v syncpoint: INTEGER
v syncpoint_enum: STRING
v syncpointclient: STRING
v incominglu: STRING
v tptimeout: INTEGER
v tptimeout_enum: STRING

For events that are generated by situations in the SNA LU AppcRemote attribute group, events are sent
by using the ITM_KQH_SNA_LU_APPCREMOTE event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v name: STRING
v service: STRING
v connection: STRING
v netname: STRING
v incomingmode: STRING
v isparallel: INTEGER
v isparallel_enum: STRING
v security: INTEGER
v security_enum: STRING
v syncpoint: INTEGER
v syncpoint_enum: STRING
v seckeyhex: STRING
v seckeychar: STRING

For events that are generated by situations in the SNA LU Display attribute group, events are sent by
using the ITM_KQH_SNA_LU_DISPLAY event class. This event class contains the following slots:

Appendix A. Event mapping 383

v node: STRING
v timestamp: STRING
v associatedlu: STRING
v comment: STRING
v compression: INTEGER
v compression_enum: STRING
v connectionname: STRING
v model: INTEGER
v model_enum: STRING
v modeloverride: INTEGER
v modeloverride_enum: STRING
v name: STRING
v number: INTEGER
v number_enum: STRING
v poolname: STRING
v userwkssecure: INTEGER
v userwkssecure_enum: STRING

For events that are generated by situations in the SNA LU LUA attribute group, events are sent by using
the ITM_KQH_SNA_LU_LUA event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v comment: STRING
v compression: INTEGER
v compression_enum: STRING
v connectionname: STRING
v highprioritymode: INTEGER
v highprioritymode_enum: STRING
v name: STRING
v number: INTEGER
v number_enum: STRING
v poolname: STRING
v userwkssecure: INTEGER
v userwkssecure_enum: STRING

For events that are generated by situations in the SNA LU Print attribute group, events are sent by using
the ITM_KQH_SNA_LU_PRINT event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v associatedlu: STRING
v comment: STRING
v compression: INTEGER
v compression_enum: STRING
v connectionname: STRING
v name: STRING
v number: INTEGER

384 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v number_enum: STRING
v poolname: STRING
v userwkssecure: INTEGER
v userwkssecure_enum: STRING

For events that are generated by situations in the SNA LU3270 attribute group, events are sent by using
the ITM_KQH_SNA_LU3270 event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v comment: STRING
v compression: INTEGER
v compression_enum: STRING
v connectionname: STRING
v name: STRING
v number: INTEGER
v number_enum: STRING
v poolname: STRING
v userwkssecure: INTEGER
v userwkssecure_enum: STRING
v system_name: STRING

For events that are generated by situations in the SNA Pool attribute group, events are sent by using the
ITM_KQH_SNA_POOL event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v comment: STRING
v name: STRING
v system_name: STRING

For events that are generated by situations in the SNA Pool Display attribute group, events are sent by
using the ITM_KQH_SNA_POOL_DISPLAY event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v assocprint: INTEGER
v assocprint_enum: STRING
v comment: STRING
v model: INTEGER
v model_enum: STRING
v modeloverride: INTEGER
v modeloverride_enum: STRING
v name: STRING

For events that are generated by situations in the SNA Print Session attribute group, events are sent by
using the ITM_KQH_SNA_PRINT_SESSION event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v activation: INTEGER

Appendix A. Event mapping 385

v activation_enum: STRING
v bfilter: INTEGER
v bfilter_enum: STRING
v bottommargin: INTEGER
v bottommargin_enum: STRING
v charsperline: INTEGER
v charsperline_enum: STRING
v checkpdtfile: INTEGER
v checkpdtfile_enum: STRING
v codepage: INTEGER
v codepage_enum: STRING
v codepagecustomfile: STRING
v codepagelanguage: INTEGER
v codepagelanguage_enum: STRING
v comment: STRING
v facename: STRING
v facenameoverride: INTEGER
v facenameoverride_enum: STRING
v filter: STRING
v fontsize: INTEGER
v fontsize_enum: STRING
v fontsizeoverride: INTEGER
v fontsizeoverride_enum: STRING
v ignoretransparentsections: INTEGER
v ignoretransparentsections_enum: STRING
v leftmargin: INTEGER
v leftmargin_enum: STRING
v linesperinch: INTEGER
v linesperinch_enum: STRING
v lpioverride: INTEGER
v lpioverride_enum: STRING
v marginoverride: INTEGER
v marginoverride_enum: STRING
v name: STRING
v nohorizontalscaling: INTEGER
v nohorizontalscaling_enum: STRING
v noverticalscaling: INTEGER
v noverticalscaling_enum: STRING
v pagesetupoverride: INTEGER
v pagesetupoverride_enum: STRING
v pdtfile: STRING
v printerdevicename: STRING
v printerfile: STRING
v printtofile: INTEGER
v printtofile_enum: STRING

386 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v rightmargin: INTEGER
v rightmargin_enum: STRING
v service: STRING
v sessiontype: INTEGER
v sessiontype_enum: STRING
v statustext: STRING
v topmargin: INTEGER
v topmargin_enum: STRING
v uniqueextension: INTEGER
v uniqueextension_enum: STRING

For events that are generated by situations in the SNA Server attribute group, events are sent by using
the ITM_KQH_SNA_SERVER event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v isoffline: INTEGER
v isoffline_enum: STRING
v name: STRING
v rolename: STRING
v statustext: STRING
v transportstring: STRING

For events that are generated by situations in the SNA Service attribute group, events are sent by using
the ITM_KQH_SNA_SERVICE event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v comment: STRING
v controlpoint: STRING
v name: STRING
v networkname: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v statustext: STRING

For events that are generated by situations in the SNA Service Print attribute group, events are sent by
using the ITM_KQH_SNA_SERVICE_PRINT event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v activationretryinterval: INTEGER
v activationretryinterval_enum: STRING
v activationretrylimit: INTEGER
v activationretrylimit_enum: STRING
v alwaysdonl: INTEGER
v alwaysdonl_enum: STRING
v delayprintstart: INTEGER
v delayprintstart_enum: STRING
v doallff: INTEGER

Appendix A. Event mapping 387

v doallff_enum: STRING
v embeddedcodes: INTEGER
v embeddedcodes_enum: STRING
v flushfinalff: INTEGER
v flushfinalff_enum: STRING
v ignorecharsunder3f: INTEGER
v ignorecharsunder3f_enum: STRING
v name: STRING
v noeventlogonskippingtransparentsection: INTEGER
v noeventlogonskippingtransparentsection_enum: STRING
v nospaceafterff: INTEGER
v nospaceafterff_enum: STRING
v statustext: STRING
v usefixedtabs: INTEGER
v usefixedtabs_enum: STRING
v useproportionalfontchange: INTEGER
v useproportionalfontchange_enum: STRING

For events that are generated by situations in the SNA Service TN3270 attribute group, events are sent by
using the ITM_KQH_SNA_SERVICE_TN3270 event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v certcn: STRING
v closedelay: INTEGER
v closedelay_enum: STRING
v comment: STRING
v idletimeout: INTEGER
v idletimeout_enum: STRING
v inboundru: INTEGER
v inboundru_enum: STRING
v lognormal: INTEGER
v lognormal_enum: STRING
v logsna: INTEGER
v logsna_enum: STRING
v name: STRING
v outboundru: INTEGER
v outboundru_enum: STRING
v port: INTEGER
v port_enum: STRING
v printerflowcontrol: INTEGER
v printerflowcontrol_enum: STRING
v refreshtime: INTEGER
v refreshtime_enum: STRING
v securityhigh: INTEGER
v securityhigh_enum: STRING

388 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v securitylow: INTEGER
v securitylow_enum: STRING
v securitymedium: INTEGER
v securitymedium_enum: STRING
v socketlisten: INTEGER
v socketlisten_enum: STRING
v statusdelay: INTEGER
v statusdelay_enum: STRING
v statustext: STRING
v tnmodeonly: INTEGER
v tnmodeonly_enum: STRING
v usenameresolution: INTEGER
v usenameresolution_enum: STRING

For events that are generated by situations in the SNA Service TN5250 attribute group, events are sent by
using the ITM_KQH_SNA_SERVICE_TN5250 event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v comment: STRING
v name: STRING
v port: INTEGER
v port_enum: STRING
v statustext: STRING

For events that are generated by situations in the Status APPC Local LU attribute group, events are sent
by using the ITM_KQH_STATUS_APPC_LOCAL_LU event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v name: STRING
v servicename: STRING
v sessioncount: INTEGER
v sessioncount_enum: STRING
v sessionlimit: INTEGER
v sessionlimit_enum: STRING
v system_name: STRING

For events that are generated by situations in the Status APPC Session attribute group, events are sent by
using the ITM_KQH_STATUS_APPC_SESSION event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v appclu: STRING
v mode: STRING
v partnerlu: STRING
v sessionid: STRING

Appendix A. Event mapping 389

For events that are generated by situations in the Status Client Connection attribute group, events are
sent by using the ITM_KQH_STATUS_CLIENT_CONNECTION event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v clientappl: STRING
v clientmachine: STRING
v clientconnecttime: STRING
v domain: STRING
v user: STRING
v userid: STRING
v system_name: STRING

For events that are generated by situations in the Status LU3270 attribute group, events are sent by using
the ITM_KQH_STATUS_LU3270 event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v activestate: INTEGER
v activestate_enum: STRING
v connectionname: STRING
v hostappl: STRING
v name: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v statustext: STRING
v system_name: STRING

For events that are generated by situations in the Status Print Session attribute group, events are sent by
using the ITM_KQH_STATUS_PRINT_SESSION event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v name: STRING
v printstate: INTEGER
v printstate_enum: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v statustext: STRING
v type: INTEGER
v type_enum: STRING
v system_name: STRING

For events that are generated by situations in the Status Service Print attribute group, events are sent by
using the ITM_KQH_STATUS_SERVICE_PRINT event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v name: STRING
v kqh_status: INTEGER

390 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v kqh_status_enum: STRING
v statustext: STRING

For events that are generated by situations in the Status Service SNA attribute group, events are sent by
using the ITM_KQH_STATUS_SERVICE_SNA event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v appcsessions: INTEGER
v appcsessions_enum: STRING
v boutofdate: INTEGER
v boutofdate_enum: STRING
v lu3270sessions: INTEGER
v lu3270sessions_enum: STRING
v name: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v statustext: STRING
v users: INTEGER
v users_enum: STRING

For events that are generated by situations in the Status Service TN3270 attribute group, events are sent
by using the ITM_KQH_STATUS_SERVICE_TN3270 event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v name: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v statustext: STRING
v system_name: STRING

For events that are generated by situations in the Status Service TN5250 attribute group, events are sent
by using the ITM_KQH_STATUS_SERVICE_TN5250 event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v name: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v statustext: STRING
v system_name: STRING

For events that are generated by situations in the Status SNA Connection attribute group, events are sent
by using the ITM_KQH_STATUS_SNA_CONNECTION event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v failcode: INTEGER

Appendix A. Event mapping 391

v failcode_enum: STRING
v failtime: STRING
v inactivestate: INTEGER
v inactivestate_enum: STRING
v name: STRING
v servicename: STRING
v kqh_status: INTEGER
v kqh_status_enum: STRING
v statustext: STRING

For events that are generated by situations in the Status TN3270 Session attribute group, events are sent
by using the ITM_KQH_STATUS_TN3270_SESSION event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v client: STRING
v name: STRING
v system_name: STRING

For events that are generated by situations in the Status TN5250 Session attribute group, events are sent
by using the ITM_KQH_STATUS_TN5250_SESSION event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v appclu: STRING
v client: STRING
v mode: STRING
v partnerlu: STRING
v tnsessionid: STRING
v system_name: STRING

For events that are generated by situations in the TN3270 Server attribute group, events are sent by using
the ITM_KQH_TN3270_SERVER event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v connections_active: INTEGER
v connections_active_enum: STRING
v rus_inbound: INTEGER
v rus_inbound_enum: STRING
v rus_inbound_per_sec: REAL
v rus_inbound_per_sec_enum: STRING
v rus_outbound: INTEGER
v rus_outbound_enum: STRING
v rus_outbound_per_sec: REAL
v rus_outbound_per_sec_enum: STRING
v ru_throughput: INTEGER
v ru_throughput_enum: STRING

392 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v ru_throughput_per_sec: REAL
v ru_throughput_per_sec_enum: STRING
v sessions_active: INTEGER
v sessions_active_enum: STRING
v sessions_configured: INTEGER
v sessions_configured_enum: STRING
v sessions_ended_lulu: INTEGER
v sessions_ended_lulu_enum: STRING
v sessions_ended_normal: INTEGER
v sessions_ended_normal_enum: STRING
v sessions_failed: INTEGER
v sessions_failed_enum: STRING
v sessions_failed_inactivity: INTEGER
v sessions_failed_inactivity_enum: STRING
v sessions_failed_no_resource: INTEGER
v sessions_failed_no_resource_enum: STRING
v sessions_succeeded: INTEGER
v sessions_succeeded_enum: STRING
v tcp_throughput: INTEGER
v tcp_throughput_enum: STRING
v tcp_throughput_per_sec: REAL
v tcp_throughput_per_sec_enum: STRING
v tn3270_server: INTEGER
v tn3270_server_enum: STRING
v users_active: INTEGER
v users_active_enum: STRING
v tcp_kilo_bytes_received: REAL
v tcp_kilo_bytes_received_enum: STRING
v tcp_kilo_bytes_received_sec: REAL
v tcp_kilo_bytes_received_sec_enum: STRING
v tcp_kilo_bytes_sent: REAL
v tcp_kilo_bytes_sent_enum: STRING
v tcp_kilo_bytes_sent_sec: REAL
v tcp_kilo_bytes_sent_sec_enum: STRING
v tcp_kilo_throughput: REAL
v tcp_kilo_throughput_enum: STRING
v tcp_kilo_throughput_per_sec: REAL
v tcp_kilo_throughput_per_sec_enum: STRING
v system_name: STRING

For events that are generated by situations in the Trace SNA Application attribute group, events are sent
by using the ITM_KQH_TRACE_SNA_APPLICATION event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v appctrace: INTEGER

Appendix A. Event mapping 393

v appctrace_enum: STRING
v cpictrace: INTEGER
v cpictrace_enum: STRING
v csvtrace: INTEGER
v csvtrace_enum: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v lu62trace: INTEGER
v lu62trace_enum: STRING
v luatrace: INTEGER
v luatrace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING

For events that are generated by situations in the Trace SNA Base attribute group, events are sent by
using the ITM_KQH_TRACE_SNA_BASE event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v lu62trace: INTEGER
v lu62trace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING

For events that are generated by situations in the Trace SNA Manage Client attribute group, events are
sent by using the ITM_KQH_TRACE_SNA_MANAGE_CLIENT event class. This event class contains the
following slots:
v node: STRING
v timestamp: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING

For events that are generated by situations in the Trace SNA Mng Agent attribute group, events are sent
by using the ITM_KQH_TRACE_SNA_MNG_AGENT event class. This event class contains the following
slots:
v node: STRING
v timestamp: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER

394 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v internalmessagetrace_enum: STRING

For events that are generated by situations in the Trace SNA NetView attribute group, events are sent by
using the ITM_KQH_TRACE_SNA_NETVIEW event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v dlctrace: INTEGER
v dlctrace_enum: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v lu62trace: INTEGER
v lu62trace_enum: STRING
v snatrace: INTEGER
v snatrace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING

For events that are generated by situations in the Trace SNA Print attribute group, events are sent by
using the ITM_KQH_TRACE_SNA_PRINT event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v appctrace: INTEGER
v appctrace_enum: STRING
v cpictrace: INTEGER
v cpictrace_enum: STRING
v csvtrace: INTEGER
v csvtrace_enum: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v lu62trace: INTEGER
v lu62trace_enum: STRING
v luatrace: INTEGER
v luatrace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING

For events that are generated by situations in the Trace SNA Server attribute group, events are sent by
using the ITM_KQH_TRACE_SNA_SERVER event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v dlctrace: INTEGER
v dlctrace_enum: STRING
v enabledtraces: INTEGER

Appendix A. Event mapping 395

v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v lu62trace: INTEGER
v lu62trace_enum: STRING
v snatrace: INTEGER
v snatrace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING

For events that are generated by situations in the Trace SNA Server Manager attribute group, events are
sent by using the ITM_KQH_TRACE_SNA_SERVER_MANAGER event class. This event class contains
the following slots:
v node: STRING
v timestamp: STRING
v appctrace: INTEGER
v appctrace_enum: STRING
v cpictrace: INTEGER
v cpictrace_enum: STRING
v csvtrace: INTEGER
v csvtrace_enum: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v lu62trace: INTEGER
v lu62trace_enum: STRING
v luatrace: INTEGER
v luatrace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING

For events that are generated by situations in the Trace TN3270 attribute group, events are sent by using
the ITM_KQH_TRACE_TN3270 event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v appctrace: INTEGER
v appctrace_enum: STRING
v cpictrace: INTEGER
v cpictrace_enum: STRING
v csvtrace: INTEGER
v csvtrace_enum: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING

396 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v lu62trace: INTEGER
v lu62trace_enum: STRING
v luatrace: INTEGER
v luatrace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING
v tracestate: INTEGER
v tracestate_enum: STRING

For events that are generated by situations in the Trace TN5250 attribute group, events are sent by using
the ITM_KQH_TRACE_TN5250 event class. This event class contains the following slots:
v node: STRING
v timestamp: STRING
v appctrace: INTEGER
v appctrace_enum: STRING
v cpictrace: INTEGER
v cpictrace_enum: STRING
v csvtrace: INTEGER
v csvtrace_enum: STRING
v enabledtraces: INTEGER
v enabledtraces_enum: STRING
v internalmessagetrace: INTEGER
v internalmessagetrace_enum: STRING
v lu62trace: INTEGER
v lu62trace_enum: STRING
v luatrace: INTEGER
v luatrace_enum: STRING
v t3270trace: INTEGER
v t3270trace_enum: STRING

Appendix A. Event mapping 397

398 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Appendix B. Documentation library
A variety of publications are relevant to the use of the IBM Tivoli Composite Application Manager for
Microsoft Applications: Microsoft Host Integration Server Agent.

The Using the publications topic contains information about accessing and using publications. You can find
this topic in the following information centers:
v IBM Tivoli Monitoring and OMEGAMON® XE Information Center (http://pic.dhe.ibm.com/
infocenter/tivihelp/v61r1/index.jsp)
v ITCAM Information Center (http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/index.jsp)
To open the Using the publications topic in the information center, select Using the publications in the
Contents pane.

To find publications from the previous version of a product, click Previous versions under the name of
the product in the Contents pane.

IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft

Host Integration Server Agent library

The documentation for this agent and other product components is located in the IBM Tivoli Monitoring
Information Center (http://pic.dhe.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.itm.doc_6.3/
welcome.htm)IBM Tivoli Monitoring for Virtual Environments Information Center (http://
publib.boulder.ibm.com/infocenter/tivihelp/v16r1/topic/com.ibm.tivoli.itmvs.doc_7.2/
VSwelcome.htm)ITCAM for Microsoft Applications Information Center (http://publib.boulder.ibm.com/
infocenter/tivihelp/v24r1/topic/com.ibm.itcamms.doc_7.1/welcome.htm)ITCAM for Applications
Information Center (http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/
com.ibm.itcama.doc_7.2/welcome.htm).

One document is specific to the . The IBM Tivoli Composite Application Manager for Microsoft
Applications: Microsoft Host Integration Server Agent User’s Guide provides agent-specific information
for configuring, using, and troubleshooting the .

The Offering Guide also provides information about installing and configuring the component products in
the offering.

The Prerequisites topic in the information center contains information about the prerequisites for each
component.

Use the information in the user's guide for the agent with the Tivoli Enterprise Portal User's Guide to
monitor Microsoft Host Integration Server resources.

Prerequisite publications
To use the information in this publication effectively, you must have some prerequisite knowledge.

See the following publications to gain the required prerequisite knowledge:

v IBM Tivoli Monitoring Administrator's Guide
v IBM Tivoli Monitoring Agent Builder User's Guide
v IBM Tivoli Monitoring Command Reference
v IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS

© Copyright IBM Corp. 2010, 2013 399

v IBM Tivoli Monitoring Installation and Setup Guide
v IBM Tivoli Monitoring High Availability Guide for Distributed Systems
v IBM Tivoli Monitoring: Messages
v IBM Tivoli Monitoring Troubleshooting Guide
v IBM Tivoli Monitoring Universal Agent User's Guide
v IBM Tivoli Universal Agent API and Command Programming Reference Guide
v IBM Tivoli Monitoring: i5/OS™ Agent User's Guide
v IBM Tivoli Monitoring: Linux OS Agent User's Guide
v IBM Tivoli Monitoring: UNIX OS Agent User's Guide
v IBM Tivoli Monitoring: UNIX Logs OS Agent User's
v IBM Tivoli Monitoring: Windows OS Agent User's Guide
v Tivoli Enterprise Portal User's Guide
v IBM Tivoli Performance Analyzer User's Guide
v IBM Tivoli Warehouse Proxy Agent User's Guide
v IBM Tivoli Warehouse Summarization and Pruning Agent User's Guide

Related publications
The publications in related information centers provide useful information.

See the following information centers, which you can find by accessing Tivoli Documentation Central
(http://www.ibm.com/developerworks/wikis/display/tivolidoccentral/Home):
v IBM Tivoli Monitoring
v IBM Tivoli Netcool/OMNIbus
v IBM Tivoli Application Dependency Discovery Manager
v IBM Tivoli Enterprise Console

Other sources of documentation

You can obtain additional technical documentation about monitoring products from other sources.

See the following sources of technical documentation about monitoring products:

v Service Management Connect (SMC)
See the introductory information about SMC (http://www.ibm.com/developerworks/
servicemanagement/).
For information about Tivoli products, see the Application Performance Management community on
SMC (http://www.ibm.com/developerworks/servicemanagement/apm/index.html).
Connect, learn, and share with Service Management professionals. Get access to developers and
product support technical experts who provide their perspectives and expertise. You can use SMC for
these purposes:
– Become involved with transparent development, an ongoing, open engagement between external
users and developers of Tivoli products where you can access early designs, sprint demos, product
roadmaps, and pre-release code.
– Connect one-on-one with the experts to collaborate and network about Tivoli and Integrated Service
Management.
– Benefit from the expertise and experience of others using blogs.
– Collaborate with the broader user community using wikis and forums.

400 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
v IBM Integrated Service Management Library (http://www.ibm.com/software/brandcatalog/
ismlibrary/) is an online catalog that contains integration documentation as well as other
downloadable product extensions.
v IBM Redbook publications (http://www.redbooks.ibm.com/) include Redbooks® publications,
Redpapers, and Redbooks technotes that provide information about products from platform and
solution perspectives.
v Technotes (http://www.ibm.com/support/entry/portal/software), which are found through the IBM
Software Support website, provide the latest information about known product limitations and
workarounds.
v Tivoli wikis
Tivoli Wiki Central (http://www.ibm.com/developerworks/wikis/display/tivoli/Home) is the home
for interactive wikis that offer best practices and scenarios for using Tivoli products. The wikis contain
white papers contributed by IBM employees, and content created by customers and business partners.
Two of these wikis are of particular relevance to IBM Tivoli Monitoring:
– Tivoli Distributed Monitoring and Application Management Wiki (http://www-10.lotus.com/ldd/
tivmonitorwiki.nsf) provides information about IBM Tivoli Monitoring and related distributed
products, including IBM Tivoli Composite Application Manager products.
– Tivoli System z® Monitoring and Application Management Wiki (http://www.ibm.com/
developerworks/wikis/display/tivoliomegamon/Home) provides information about the
OMEGAMON XE products, Tivoli NetView® for z/OS®, Tivoli Monitoring Agent for z/TPF, and
other System z monitoring and application management products.

Appendix B. Documentation library 401

402 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the
products, services, or features discussed in this document in other countries. Consult your local IBM
representative for information on the products and services currently available in your area. Any
reference to an IBM product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product, program, or service that
does not infringe any IBM intellectual property right may be used instead. However, it is the user's
responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this
document. The furnishing of this document does not give you any license to these patents. You can send
license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing

Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any other country where such
provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"

WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore,
this statement might not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the publication.
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.

© Copyright IBM Corp. 2010, 2013 403

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the
exchange of information between independently created programs and other programs (including this
one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases
payment of a fee.

The licensed program described in this document and all licensed material available for it are provided
by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or
any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the
results obtained in other operating environments may vary significantly. Some measurements may have
been made on development-level systems and there is no guarantee that these measurements will be the
same on generally available systems. Furthermore, some measurement may have been estimated through
extrapolation. Actual results may vary. Users of this document should verify the applicable data for their
specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their
published announcements or other publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of
those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without
notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without
notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the
products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing
application programs conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly tested under all
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs. You may copy, modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application programs conforming
to IBM‘s application programming interfaces.

404 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Each copy or any portion of these sample programs or any derivative work, must include a copyright
notice as follows:

© IBM 2009. Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp.
2009. All rights reserved.

If you are viewing this information in softcopy form, the photographs and color illustrations might not be
displayed.

Trademarks
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be
trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at
Copyright and trademark information (www.ibm.com/legal/copytrade.shtml).

Intel, Intel logo, and Intel Xeon, are trademarks or registered trademarks of Intel Corporation or its
subsidiaries in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or
its affiliates.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or
both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Notices 405
406 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Index
Special characters attribute groups (continued)
MQBridge MQS to MSMQ 82
MQBridge MQS to MSMQ Tx 86
performance considerations 342 MQBridge MSMQ to MQS 91
MQBridge MSMQ to MQS Tx 95
MQBridge Service 99
A MSFT DB2 Access Library 101
Activation attribute 131, 168 overview 25
Activation Delay Timer attribute 61 Performance Object Status 110
Activation Retry Interval attribute 181 Session Integrator Server 115
Activation Retry Limit attribute 181 Session Integrator Server PLUs 118
Active State attribute 198 SNA 3270 Response Times 121
activities 317 SNA APPC Mode 124
Adapter attribute 131 SNA Configured Users 128
additional information SNA Connection Configuration 130
attributes 25 SNA Connections 136
situations 249 SNA Domain 138
Take Action commands 273 SNA Domain Topology 146
Workspaces 13 SNA Logical Unit Sessions 147
Address Type attribute 61 SNA LU AppcLocal 149
Affiliate Application attribute 131 SNA LU AppcRemote 152
agent SNA LU Display 155
functions 1 SNA LU LUA 158
problems and workarounds 335 SNA LU Print 160
Agent Management Services 5 SNA LU3270 162
Allow Do NL attribute 181 SNA Pool 165
Allow Incoming attribute 131 SNA Pool Display 166
Allow LZ and RLE attribute 124 SNA Print Session 167
APPC Configuration workspace 21 SNA Server 177
APPC LU attribute 195, 212 SNA Service 178
APPC Sessions attribute 203 SNA Service Print 180
APPC Trace attribute 221, 231, 236, 239, 242 SNA Service TN3270 185
Application Component attribute 47 SNA Service TN5250 191
Application Integration Status APPC Local LU 193
situations 252 Status APPC Session 194
workspaces Status Client Connection 195
descriptions 15 Status LU3270 197
Application Integration HIP attribute group 30 Status Print Session 199
Application Integration WIP attribute group 38 Status Service Print 201
Application Integration workspace 15 Status Service SNA 203
Associated LU attribute 155, 161 Status Service TN3270 205
AssocPrint attribute 166 Status Service TN5250 206
attribute group 30 Status SNA Connection 208
attribute groups Status TN3270 Session 210
Application Integration HIP 30 Status TN5250 Session 211
Application Integration WIP 38 TN3270 Server 213
Availability 47 Trace SNA Application 221
Event Log 51 Trace SNA Base 224
HIS Databases 53 Trace SNA Manage Client 226
HIS Information 54 Trace SNA Mng Agent 227
HIS Tracing 55 Trace SNA NetView 228
Link Service 57 Trace SNA Print 230
Link Service Distributed 59 Trace SNA Server 233
Link Service IPDLC 60 Trace SNA Server Manager 236
Link Service SDLC 69 Trace TN3270 239
list of all 25 Trace TN5250 242
Managed Application Integration 70 attributes 30
MQBridge 73 Activation 131, 168
MQBridge Channel 75 Activation Delay Timer 61
MQBridge Connected Network 77 Activation Retry Interval 181
MQBridge Message Pipe 79 Activation Retry Limit 181

© Copyright IBM Corp. 2010, 2013 407

attributes (continued) attributes (continued)
Active State 198 Control Point 179
Adapter 131 Count of Errors Per Second 32
additional information 25 CPIC Trace 222, 231, 236, 239, 243
Address Type 61 CPName 62
Affiliate Application 131 CSV Trace 222, 231, 237, 240, 243
Allow Do NL 181 Cumulative Calls 39, 71
Allow Incoming 131 Data Kilobyte Received Per Second 137, 148
Allow LZ and RLE 124 Data Kilobyte Transmitted Per Second 138, 148
APPC LU 195, 212 Data Kilobytes Received Per Second 117, 120
APPC Sessions 203 Data Kilobytes Transmitted Per Second 118
APPC Trace 221, 231, 236, 239, 242 Data Kiloytes Transmitted Per Second 120
Application Component 47 Database Name 53
Application Integration HIP 30 Database Type 54
Application Integration WIP 38 Date Time Saved 140
Associated LU 155, 161 Delay Print Start 182
AssocPrint 166 Delayed Path Switch Timer 67
Audit Level 139 Description 60, 70
Auto Activate 124 Disable Progressive ARB 68
Availability 47 DLC Trace 228, 234
Available Display Verb Connection 141 DLL Name 60, 69
Available Net View Connection 142 DllName 57, 62
Average Collection Duration 114 Do All FF 182
Average COM Server Time 32 Domain 57, 62, 196
Average Dot Net Server Time 31 Domain Name 146
Average Host Processing Time in millisec 108 Dot Net Methods Executed Per Sec 31
Average Host Response Time 70 DriverName 58, 63
Average Method Call Time 39, 71 Dynamic Lu Definition 132
Average Unit of Work Time 32 DynRemote 129
Backup NNS 61 Embedded Codes 182
Block ID 132 Enabled Traces 222, 224, 226, 227, 229, 232, 234, 237, 240,
Bottom Margin 168 243
Broadcast Mean Time 139 Encryption 101, 129
Cache Hit Percent 115 Endpoint Only 125
Cache Hits 114 Error Code 112
Cache Misses 114 Event Category 52
Cache Refresh 79, 99 Event ID 52
Calls Currently Executing 39, 71 Event Log 51
Calls Executing 32 Event Source 52
Certificate CN 185 Event Type 52
Chains Received Per Second 115, 119 Eventlog Server 141
Chains Transmitted Per Second 116, 119 F2QR Maximum Threads 100
Chars Per Line 169 F2QT Maximum Threads 100
Check PDT File 169 Face Name 170
Class Name 56 Face Name Override 171
Client 211, 212 Failcode 208
Client Application 196 Fatal Trace 56
Client Backup Domain Name 139 Filter 171
Client Backup Sponsor Names 140 Filter Flag 168
Client Connect Time 196 Flush Final FF 182
Client Domain Backup Type 140 Font Size 171
Client Machine 196 Font Size Override 171
Close Delay 185 Full Name 48
CMD Maximum Retry 62 Functionality Test Message 51
Code Page 169 Functionality Test Status 51
Code Page Custom File 170 Gateway Starting Time in millisec 73
Code Page Language 170 Gateway Starting Time in seconds 75
COM Methods Executed Per Second 33 High Priority Mode 159
Command Line 50 HIS Databases 53
Comment 125, 132, 155, 158, 161, 163, 165, 166, 170, 179, HIS Information 54
186, 192 HIS Tracing 55
Commits Per Second 102 Host Application 198
Compression 156, 158, 161, 163 Host Requests Processed Per Second 33
Compression Level 132 Host Requests Queued 33
Config Server 140 Host Requests Rejected Per Second 34
Connection Name 150, 153, 156, 159, 161, 163, 198 Host Response Time CICS Link 40
Connections Active 213 Host Response Time CICS Non Link or IMS 40

408 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
attributes (continued) attributes (continued)
Host Response Time TCP Concurrent Server 40 Message 53
Host Response Time TCP Explicit 41 Message Count 83, 87, 91, 96
Host Response Time TCP Implicit 41 Minimum Contention Winner 126
Host Response Time TCP IMS Connect or OTMA 41 Mode 195, 212
Host Response Time TCP MSLink 42 Model 156, 167
Idle Timeout 186 Model Override 156
Ignore Chars Under 3F 183 ModelOverride 167
Ignore Transparent Sections 172 MQBridge 73
Inactive State 209 MQBridge Channel 75
Inbound RU 186 MQBridge Connected Network 77
Incoming Lu 151 MQBridge Message Pipe 79
Incoming Mode 153 MQBridge MQS to MSMQ 82
Internal Message Trace 56, 223, 225, 226, 228, 229, 232, MQBridge MQS to MSMQ Tx 86
234, 237, 240, 244 MQBridge MSMQ to MQS 91
Intervals Skipped 115 MQBridge MSMQ to MQS Tx 95
Ipx Spx 141 MQBridge Service 99
Is Configured 55 MQS Queue Depth 83, 87, 91, 95
Is Parallel 153 MQS to MSMQ Threads 74
IsOffline 177 MQS to MSMQ Transacted Threads 74
IsRemotable 58, 63 MQSeries QMNGR 78
Kilobyte Count 85, 89, 93, 97 MSFT DB2 Access Library 102
Kilobytes Received from a TCP Host Per Second 46 MSMQ to MQS Threads 74
Kilobytes Received from a TCP/IP Host Per Second 37 MSMQ to MQS Transacted Threads 74
Kilobytes Received from an SNA Host Per Second 36, 45 Name 38, 46, 47, 58, 65, 73, 76, 78, 86, 90, 95, 99, 100, 110,
Kilobytes Received Per Second 107 121, 123, 126, 129, 133, 138, 141, 149, 150, 152, 157, 159,
Kilobytes Sent Per Second 107 161, 163, 165, 167, 173, 178, 179, 183, 187, 192, 193, 198,
Kilobytes Sent to a TCP Host Per Second 46 200, 202, 204, 205, 207, 209, 211
Kilobytes Sent to a TCP/IP Host Per Second 37 Named Pipes 141
Kilobytes Sent to an SNA Host Per Second 37, 45 Network Name 150, 153, 179
Last Collection Duration 114 NetworkName 65
Last Collection Finished 113 No Event Log On Skipping Transparent Section 183
Last Collection Start 113 No Horizontal Scaling 173
Last Failed Time 209 No Preferred NNS 65
Left Margin 172 No Space After FF 184
LENNode 63 No Vertical Scaling 174
Lines Per Inch 172 Node 31, 38, 47, 51, 53, 54, 55, 57, 59, 61, 69, 70, 73, 75, 77,
Link Calls Per Second 42 79, 82, 87, 91, 95, 99, 102, 110, 115, 118, 121, 124, 129, 130,
Link Service 57 137, 138, 146, 147, 149, 152, 155, 158, 160, 162, 165, 166,
Link Service Distributed 59 168, 177, 178, 180, 185, 191, 193, 194, 196, 197, 199, 201,
Link Service IPDLC 60 203, 205, 207, 208, 210, 211, 213, 221, 224, 226, 227, 228,
Link Service SDLC 69 230, 233, 236, 239, 242
Livetime Timeout 63 Node ID 133
Local Address 64 NodeID 65
Local Control Point 133 Non Link Calls Per Second 42
Local Network Name 133 Number 150, 157, 159, 162, 164
Log Name 52 Number of Collections 114
Log Normal 187 Object Name 111
Log SNA 187 Object Status 111
Long Retry Count 79 Object Type 111
Long Retry Delay 80 ODBC Average Execution Time in millisec 108
LPI Override 173 ODBC Average Fetch Time in millisec 108
LU3270 Sessions 204 ODBC Average Prepare Time in millisec 108
LU62 Side Info Record 76 ODBC Executes Per Second 102
LU62 Trace 223, 225, 229, 232, 235, 238, 241, 244 ODBC Prepares Per Second 103
LUA Trace 223, 233, 238, 241, 244 ODBC Rows Fetched Per Second 103
Managed Application Integration 70 OLE DB Average Data Access Time 103
Margin Override 173 OLE DB Average Execution Time in millisec 109
Maximum Activation Attempts 64 OLE DB Average Fetch Time in millisec 109
Maximum BTU Receive 64 OLE DB Average Prepare Time in millisec 109
Maximum BTU Send 64 OLE DB Executes Per Second 104
Maximum Message Count 80 OLE DB GetData Calls Per Second 104
Maximum Message Size 80 OLE DB Prepares Per Second 104
Maximum Receive Compression 125 OLE DB Rows Fetched Per Second 105
Maximum Send Compression 125 Open Connections 105
Maximum Time 81 Open Statements 105
MCA User 76 Out of Date 203

Index 409
attributes (continued) attributes (continued)
Outbound RU 187 RUs Outbound Per Second 214
overview 25 Rx Pacing 127
Packets Received Per Second 106 RX RU 127
Packets Sent Per Second 106 Security 154
Page Faults per Sec 49 Security 3270 144
Page Setup Override 174 Security APPC 145
Partner Connection Name 133 Security High 189
Partner LU 195, 212 Security Key/(Char) 155
Partner Minimum Contention Winner 126 Security Key/(Hex) 154
PDTFile 174 Security Low 189
Peer Role 134 Security LUA 145
Percent Privileged Time 50 Security Medium 189
Percent Processor Time 50 Server 54
Percent Response Threshold 1 122 Server Name 146
Percent Response Threshold 2 122 Service 136, 175
Percent Response Threshold 3 122 Service Name 60, 69, 150, 153, 193, 209
Percent Response Threshold 4 123 Service Title 60, 69
Percent Response Threshold 5 123 Session Count 193
Percent User Mode Time 50 Session ID 195
Performance Object Status 110 Session Integrator Server 115
PID 49 Session Integrator Server PLUs 118
Pool Member 151 Session Limit 127, 194
Pool Name 157, 160, 162, 164 Session Type 176
Popup Server 142 Sessions 116, 119
Port 188, 192 Sessions Active 215
PrimaryNNS 66 Sessions Configured 216
Print State 200 Sessions Connected 116, 120
Printer Device Name 174 Sessions Ended LULU 216
Printer File 175 Sessions Ended Normal 216
Printer Flow Control 188 Sessions Failed 217
Printer To File 175 Sessions Failed Inactivity 217
Priority 127 Sessions Failed No Resource 217
Product Name 55 Sessions Online 117
Product Version 55 Sessions Succeeded 217
Q2FD Maximum Threads 100 Short Retry Count 81
Q2FO Maximum Threads 101 Short Retry Delay 81
Query Name 111 SNA 3270 Response Times 121
Queue Manager Name 76 SNA APPC Mode 124
Receive Acknowledge Timeout 66 SNA Configured Users 129
Refresh Interval 114 SNA Connection Configuration 130
Refresh Time 188 SNA Connections 136
Remote Block ID 134 SNA Domain 138
Remote Control Point 134 SNA Domain Topology 146
Remote End 134 SNA Logical Unit Sessions 147
Remote Network Name 135 SNA LU AppcLocal 149
Remote Node ID 135 SNA LU AppcRemote 152
Reply to Queue Manager 78 SNA LU Display 155
ResolvedIP 66 SNA LU LUA 158
Retry Delay 135 SNA LU Print 160
Retry Limit 135 SNA LU3270 162
Right Margin 175 SNA Pool 165
Role 55 SNA Pool Display 166
Role Name 147, 178 SNA Print Session 167
Rollbacks Per Second 106 SNA Server 177
RTM End of Session 142 SNA Service 178
RTM Overflow 142 SNA Service Print 180
RTM Threshold 1 143 SNA Service TN3270 185
RTM Threshold 2 143 SNA Service TN5250 191
RTM Threshold 3 143 Sna Trace 230, 235
RTM Threshold 4 144 Socket Listen 190
RTM Timer Until 144 Starting Retry Count 83, 87, 92, 96
RU Throughput 215 Starting Time 84, 88, 92, 96
RU Throughput Per Second 215 Starting Time in seconds 85, 89, 94, 98
RUs Inbound 213 Startup 78, 82
RUs Inbound Per Second 214 Status 48, 84, 88, 92, 96, 145, 179, 199, 200, 202, 204, 206,
RUs Outbound 214 207, 210

410 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
attributes (continued) attributes (continued)
Status APPC Local LU 193 Trace SNA NetView 228
Status APPC Session 194 Trace SNA Print 230
Status Client Connection 195 Trace SNA Server 233
Status Delay 190 Trace SNA Server Manager 236
Status LU3270 197 Trace State 242
Status Print Session 199 Trace TN3270 239
Status Service Print 201 Trace TN5250 242
Status Service SNA 203 Traces 56
Status Service TN3270 205 Transactions Per Second 107, 117, 120
Status Service TN5250 206 Transmit Queue 82
Status SNA Connection 208 Transport String 147, 178
Status text 199, 201, 206 Transport Type 77
Status Text 136, 147, 176, 178, 180, 184, 190, 192, 202, 205, Tx Pacing 128
207, 210 TX RU 128
Status TN3270 Session 210 Type 48, 58, 66, 201
Status TN5250 Session 211 Unique Extension 176
Suspension Starting Time 84, 88, 93, 97 Use Dynamic PU Definition 67
Suspension Starting Time in seconds 86, 90, 94, 98 Use Fixed Tabs 184
Suspension Time 85, 89, 93, 97 Use IPv6 68
Suspension Time in seconds 85, 90, 94, 98 Use Name Resolution 191
Sync Point 151, 154 Use Proportional Font Change 184
Sync Point Client 151 User 59, 67, 197
System Name 38, 46, 54, 57, 60, 70, 72, 75, 82, 86, 90, 94, User ID 197
99, 110, 118, 121, 123, 164, 165, 194, 197, 199, 201, 206, 208, User Type 130
211, 213, 221 User Workstation Secure 157, 160, 162, 164
T3270 Trace 224, 225, 230, 233, 235, 238, 241, 245 Users 205
TCP Address 76 Users Active 219
TCP Concurrent Server Calls Per Second 43 Virtual Size 49
TCP Explicit Calls Per Second 43 VRN Not Limited Resource 68
TCP Implicit Calls Per Second 43 Work Flow Determinant Starts Per Second 35
TCP IMS Connect or OTMA calls sec 44 Work Flow Endpoint Starts Per Second 35
TCP IP 146 Work Flow Envelope Starts Per Second 35
TCP Kilobytes Received 219 Work Flow Starts Per Second 36
TCP Kilobytes Received Per Second 219 Work Flow TRM Starts Per Second 36
TCP Kilobytes Sent 220 Working Set Size 49
TCP Kilobytes Sent Per Second 220 XID Format 136
TCP MSLink Calls Per Second 44 Audit Level attribute 139
TCP Port 77 Auto Activate attribute 124
TCP Throughput 218 Availability
TCP Throughput in Kilobytes 220 situations 252
TCP Throughput in Kilobytes Per Second 221 workspaces
TCP Throughput Per Second 218 descriptions 17
Thread Count 49 Availability attribute group 47
Throughput Frames Per Second 137, 148 Availability workspace 17
Throughput KiloFrames Per Second 138, 149 Available Display Verb Connection attribute 141
Time Generated 53 Available Net View Connection attribute 142
Timestamp 31, 38, 47, 53, 54, 55, 57, 59, 61, 69, 70, 73, 76, Average Collection Duration attribute 114
77, 79, 83, 87, 91, 95, 99, 102, 110, 115, 118, 121, 124, 129, Average COM Server Time attribute 32
130, 137, 139, 146, 147, 149, 152, 155, 158, 160, 163, 165, Average Dot Net Server Time attribute 31
166, 168, 177, 179, 180, 185, 191, 193, 194, 196, 197, 200, Average Host Processing Time in millisec attribute 108
202, 203, 205, 207, 208, 210, 211, 213, 221, 224, 226, 227, Average Host Response Time attribute 70
228, 231, 233, 236, 239, 242 Average Method Call Time attribute 39, 71
Title 58, 66 Average Unit of Work Time attribute 32
TN Mode Only 191
TN Session ID 212
TN3270 Server 213, 218
Top Margin 176
B
Backup NNS attribute 61
Total Calls Per Second 44, 72
Block ID attribute 132
Total Errors Per Second 45, 72
Bottom Margin attribute 168
Total Requests Accepted 34
Broadcast Mean Time attribute 139
Total Requests Received 34
TP Timeout 152
Trace SNA Application 221
Trace SNA Base 224 C
Trace SNA Manage Client 226 Cache Hit Percent attribute 115
Trace SNA Mng Agent 227 Cache Hits attribute 114

Index 411
Cache Misses attribute 114 Data on Connection and LU Statistics workspace 20
Cache Refresh attribute 79, 99 data sources 6
calculate historical data disk space 245 Data Transfer Statistics workspace 18
Calls Currently Executing attribute 39, 71 Database Name attribute 53
Calls Executing attribute 32 Database Type attribute 54
capacity planning for historical data 245 Databases
Certificate CN attribute 185 situations 260
Chains Received Per Second attribute 115, 119 workspaces
Chains Transmitted Per Second attribute 116, 119 descriptions 19
Channel and Message Pipe Configuration workspace 19 Databases workspace 19
Chars Per Line attribute 169 Date Time Saved attribute 140
Check PDT File attribute 169 Delay Print Start attribute 182
Class Name attribute 56 Delayed Path Switch Timer attribute 67
Client Application attribute 196 Description attribute 60, 70
Client attribute 211, 212 descriptions 251
Client Backup Domain Name attribute 139 detailed 324
Client Backup Sponsor Names attribute 140 developerWorks website 400
Client Connect Time attribute 196 Disable Progressive ARB attribute 68
Client Domain Backup Type attribute 140 Disable SI Monitoring action 275
Client Machine attribute 196 Disable SNA Monitoring action 275
Close Delay attribute 185 Disable TN3270 Monitoring action 276
CMD Maximum Retry attribute 62 Discovery Library Adapter
Code Page attribute 169 problems and workarounds 346
Code Page Custom File attribute 170 disk capacity planning for historical data 245
Code Page Language attribute 170 DLC Trace attribute 228, 234
COM Methods Executed Per Second attribute 33 DLL Name attribute 60, 69
Command Line attribute 50 DllName attribute 57, 62
commands Do All FF attribute 182
tacmd addSystem 10 documentation
Take Action 273 See publications
Comment attribute 125, 132, 155, 158, 161, 163, 165, 166, 170, Domain attribute 57, 62, 196
179, 186, 192 Domain Name attribute 146
Commits Per Second attribute 102 Dot Net Methods Executed Per Sec attribute 31
components 3 DriverName attribute 58, 63
IBM Tivoli Monitoring 3 Dynamic Lu Definition attribute 132
Compression attribute 156, 158, 161, 163 DynRemote attribute 129
Compression Level attribute 132
Config Server attribute 140
configuration 10
agent 7
E
Embedded Codes attribute 182
fields 10
Enable SI Monitoring action 277
problems and workarounds 330
Enable SNA Monitoring action 278
remote 10
Enable TN3270 Monitoring action 279
values 10
Enabled Traces attribute 222, 224, 226, 227, 229, 232, 234, 237,
configuring the monitoring agent 7
240, 243
Connection Name attribute 150, 153, 156, 159, 161, 163, 198
Encryption attribute 101, 129
Connections Active attribute 213
Endpoint Only attribute 125
Control Point attribute 179
enhancements 3
Count of Errors Per Second attribute 32
Error Code attribute 112
CPIC Trace attribute 222, 231, 236, 239, 243
event
CPName attribute 62
mapping 365
CSV Trace attribute 222, 231, 237, 240, 243
Event Category attribute 52
Cumulative Calls attribute 39, 71
Event ID attribute 52
Event Log
situations 260
D workspaces
data collection 6 descriptions 19
Data Integration Event Log attribute group 51
situations 260 Event Log workspace 19
workspaces Event Source attribute 52
descriptions 18 Event Type attribute 52
Data Integration workspace 18 Eventlog Server attribute 141
Data Kilobyte Received Per Second attribute 137, 148
Data Kilobyte Transmitted Per Second attribute 138, 148
Data Kilobytes Received Per Second attribute 117, 120
Data Kilobytes Transmitted Per Second attribute 118
Data Kiloytes Transmitted Per Second attribute 120

412 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
F installation (continued)
remote 10
F2QR Maximum Threads attribute 100 installing language packs 7
F2QT Maximum Threads attribute 100 installing the monitoring agent 7
Face Name attribute 170 Integrated Service Management Library documentation 400
Face Name Override attribute 171 interface
Failcode attribute 208 user 5
Fatal Trace attribute 56 Internal Message Trace attribute 56, 223, 225, 226, 228, 229,
Filter attribute 171 232, 234, 237, 240, 244
Filter Flag attribute 168 Intervals Skipped attribute 115
Flush Final FF attribute 182 Ipx Spx attribute 141
Font Size attribute 171 Is Configured attribute 55
Font Size Override attribute 171 Is Parallel attribute 153
Full Name attribute 48 IsOffline attribute 177
Functionality Test Message attribute 51 IsRemotable attribute 58, 63
Functionality Test Status attribute 51

G K
Kilobyte Count attribute 85, 89, 93, 97
Gateway Starting Time in millisec attribute 73 Kilobytes Received from a TCP Host Per Second attribute 46
Gateway Starting Time in seconds attribute 75 Kilobytes Received from a TCP/IP Host Per Second
attribute 37
Kilobytes Received from an SNA Host Per Second
H attribute 36, 45
High Priority Mode attribute 159 Kilobytes Received Per Second attribute 107
HIP Byte Transfer Statistics workspace 15 Kilobytes Sent Per Second attribute 107
HIP Host Request Statistics workspace 16 Kilobytes Sent to a TCP Host Per Second attribute 46
HIP Method Execution Statistics workspace 16 Kilobytes Sent to a TCP/IP Host Per Second attribute 37
HIP Work Flow Process Statistics workspace 16 Kilobytes Sent to an SNA Host Per Second attribute 37, 45
HIS Databases attribute group 53 KQH_3270Session_Supp_Crit situation 260
HIS Information attribute group 54 KQH_APPC_Session_Act_Fail_Warn situation 266
HIS Tracing KQH_APPC_TP_Failed_One_Warn situation 264
situations 269 KQH_APPCSession_Failure_Crit situation 261
workspaces KQH_DLUS_PU_Conn_Failed_Warn situation 263
descriptions 19 KQH_ESSO_Server_Down_Warn situation 252
HIS Tracing attribute group 55 KQH_HIP_App_State_Event situation 267
HIS Tracing workspace 19 KQH_HIP_Auth_Error_Event situation 267
historical data KQH_HIP_Listener_Event situation 266
calculate disk space 245 KQH_IHVDLL_LoadingFailed_Warn situation 262
disk capacity planning 245 KQH_Link_Service_Down situation 260
Host Application attribute 198 KQH_Local_Param_Invalid_Warn situation 261
Host Requests Processed Per Second attribute 33 KQH_LU_RESYNCSVC_Down_Crit situation 253
Host Requests Queued attribute 33 KQH_LU62_Resync_Start_Warn situation 262
Host Requests Rejected Per Second attribute 34 KQH_Many_Host_Req_Queued situation 252
Host Response Time CICS Link attribute 40 KQH_Many_Host_Req_Rejected situation 252
Host Response Time CICS Non Link or IMS attribute 40 KQH_MQBridge_Down_Crit situation 254
Host Response Time TCP Concurrent Server attribute 40 KQH_Primary_HIS_Exist_Warn situation 266
Host Response Time TCP Explicit attribute 41 KQH_SIS_Server_Down_Crit situation 254
Host Response Time TCP Implicit attribute 41 KQH_SNA_BASE_Down_Crit situation 256
Host Response Time TCP IMS Connect or OTMA attribute 41 KQH_SNA_Connection_Failure situation 270
Host Response Time TCP MSLink attribute 42 KQH_SNA_Connection_Inactive situation 270
KQH_SNA_DDM_Down_Crit situation 255
KQH_SNA_Mng_Conn_Failed_Warn situation 265
I KQH_SNA_MNGAGENT_Down_Crit situation 255
KQH_SNA_NetView_Down_Warn situation 256
IBM Tivoli Monitoring 3 KQH_SNA_PRINT_Down_Warn situation 257
overview 1 KQH_SNA_RPC_Down_Crit situation 255
Idle Timeout attribute 186 KQH_SNA_Server_Down_Crit situation 257
Ignore Chars Under 3F attribute 183 KQH_SNA_Server_Unreachable situation 269
Ignore Transparent Sections attribute 172 KQH_SNA_Server02_Down_Crit situation 257
Inactive State attribute 209 KQH_SNA_Server03_Down_Crit situation 258
Inbound RU attribute 186 KQH_SNA_Server04_Down_Crit situation 258
Incoming Lu attribute 151 KQH_SNA_Service_Inactive situation 270
Incoming Mode attribute 153 KQH_SNA_Service_OutOfDate situation 271
installation 10 KQH_SNABase_StartUp_Fail_Warn situation 265
agent 7 KQH_Status_Failed_Warn situation 263
problems and workarounds 330 KQH_TCP_RESYNC_Down_Crit situation 253

Index 413
KQH_TI_Exception_Warn situation 261 messages (continued)
KQH_TN3270_Down_Crit situation 259 for IBM Tivoli Composite Application Manager for
KQH_TN3270_Service_Stopped situation 269 Microsoft Applications: Microsoft Host Integration Server
KQH_TN3270_Trace_Failed_Warn situation 264 Agent 347
KQH_TN5250_Down_Crit situation 259 format 347
KQH_Unexpected_Logic_Err_Crit situation 264 Microsoft Host Integration Server
KQH_WIP_COM_Event_Occured situation 268 situations 252
KQH_WIP_State_Machine_Event situation 268 workspaces
descriptions 15
Microsoft Host Integration Server workspace 15
L Minimum Contention Winner attribute 126
Mode attribute 195, 212
language packs 7
Model attribute 156, 167
installing 7
Model Override attribute 156
silent installation 7
ModelOverride attribute 167
Last Collection Duration attribute 114
MQBridge attribute group 73
Last Collection Finished attribute 113
MQBridge Channel attribute group 75
Last Collection Start attribute 113
MQBridge Connected Network attribute group 77
Last Failed Time attribute 209
MQBridge Message Pipe attribute group 79
Left Margin attribute 172
MQBridge MQS to MSMQ attribute group 82
LENNode attribute 63
MQBridge MQS to MSMQ Tx attribute group 86
Lines Per Inch attribute 172
MQBridge MSMQ to MQS attribute group 91
Link Calls Per Second attribute 42
MQBridge MSMQ to MQS Tx attribute group 95
Link Service attribute group 57
MQBridge Service attribute group 99
Link Service Distributed attribute group 59
MQS Queue Depth attribute 83, 87, 91, 95
Link Service IPDLC attribute group 60
MQS TO MSMQ Status workspace 20
Link Service SDLC attribute group 69
MQS to MSMQ Threads attribute 74
Link Service Statistics workspace 20
MQS to MSMQ Transacted Threads attribute 74
list of messages 347
MQSeries QMNGR attribute 78
Livetime Timeout attribute 63
MSFT DB2 Access Library attribute group 101
Local Address attribute 64
MSMQ TO MQS Status workspace 20
Local Control Point attribute 133
MSMQ to MQS Threads attribute 74
Local Network Name attribute 133
MSMQ to MQS Transacted Threads attribute 74
Log Name attribute 52
Log Normal attribute 187
Log SNA attribute 187
Long Retry Count attribute 79 N
Long Retry Delay attribute 80 Name attribute 38, 46, 47, 58, 65, 73, 76, 78, 86, 90, 95, 99,
LPI Override attribute 173 100, 110, 121, 123, 126, 129, 133, 138, 141, 149, 150, 152, 157,
LU3270 Sessions attribute 204 159, 161, 163, 165, 167, 173, 178, 179, 183, 187, 192, 193, 198,
LU62 Side Info Record attribute 76 200, 202, 204, 205, 207, 209, 211
LU62 Trace attribute 223, 225, 229, 232, 235, 238, 241, 244 Named Pipes attribute 141
LUA Trace attribute 223, 233, 238, 241, 244 Network Name attribute 150, 153, 179
NetworkName attribute 65
new in this release 3
M No Event Log On Skipping Transparent Section attribute 183
No Horizontal Scaling attribute 173
Managed Application Integration attribute group 70
No Preferred NNS attribute 65
Managed WIP Calls Request Response Stats workspace 16
No Space After FF attribute 184
Margin Override attribute 173
No Vertical Scaling attribute 174
Maximum Activation Attempts attribute 64
Node attribute 31, 38, 47, 51, 53, 54, 55, 57, 59, 61, 69, 70, 73,
Maximum BTU Receive attribute 64
75, 77, 79, 82, 87, 91, 95, 99, 102, 110, 115, 118, 121, 124, 129,
Maximum BTU Send attribute 64
130, 137, 138, 146, 147, 149, 152, 155, 158, 160, 162, 165, 166,
Maximum Message Count attribute 80
168, 177, 178, 180, 185, 191, 193, 194, 196, 197, 199, 201, 203,
Maximum Message Size attribute 80
205, 207, 208, 210, 211, 213, 221, 224, 226, 227, 228, 230, 233,
Maximum Receive Compression attribute 125
236, 239, 242
Maximum Send Compression attribute 125
Node ID attribute 133
Maximum Time attribute 81
NodeID attribute 65
MCA User attribute 76
Non Link Calls Per Second attribute 42
Message attribute 53
Number attribute 150, 157, 159, 162, 164
Message Count attribute 83, 87, 91, 96
Number of Collections attribute 114
Message Integration
situations 269
workspaces
descriptions 19 O
Message Integration workspace 20 Object Name attribute 111
messages Object Status attribute 111
contents 347 Object Type attribute 111

414 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
ODBC Average Execution Time in millisec attribute 108 problems and workarounds (continued)
ODBC Average Fetch Time in millisec attribute 108 Discovery Library Adapter 346
ODBC Average Prepare Time in millisec attribute 108 install 330
ODBC Exec Prepare and Fetch Statistics workspace 18 remote deployment 334
ODBC Executes Per Second attribute 102 situations 342
ODBC Prepares Per Second attribute 103 Take Action commands 345
ODBC Rows Fetched Per Second attribute 103 Tivoli Common Reporting 346
OLE DB Average Data Access Time attribute 103 workspaces 338
OLE DB Average Execution Time in millisec attribute 109 Product Name attribute 55
OLE DB Average Fetch Time in millisec attribute 109 Product Version attribute 55
OLE DB Average Prepare Time in millisec attribute 109 publications 399, 400
OLE DB Executes Per Second attribute 104 developerWorks website 400
OLE DB GetData Calls Per Second attribute 104 IBM Tivoli Monitoring 399
OLE DB Prepares Per Second attribute 104 Integrated Service Management Library 400
OLE DB Rows Fetched Per Second attribute 105 prerequisite 399
OLEDB Exec Prepare and Fetch Statistics workspace 19 Redbooks 400
Open Connections attribute 105 related 400
Open Statements attribute 105 Technotes 400
operating systems 7 wikis 400
Out of Date attribute 203
Outbound RU attribute 187
overview
IBM Tivoli Monitoring 1
Q
Q2FD Maximum Threads attribute 100
Q2FO Maximum Threads attribute 101
queries, using attributes 25
P Query Name attribute 111
Packets Received Per Second attribute 106 Queue Manager Name attribute 76
Packets Sent Per Second attribute 106
Page Faults per Sec attribute 49
Page Setup Override attribute 174
Partner Connection Name attribute 133
R
ras1 326
Partner LU attribute 195, 212
Receive Acknowledge Timeout attribute 66
Partner Minimum Contention Winner attribute 126
Redbooks 400
PDTFile attribute 174
Refresh Interval attribute 114
Peer Role attribute 134
Refresh Time attribute 188
Percent Privileged Time attribute 50
remote
Percent Processor Time attribute 50
installation and configuration 10
Percent Response Threshold 1 attribute 122
Remote Block ID attribute 134
Percent Response Threshold 2 attribute 122
Remote Control Point attribute 134
Percent Response Threshold 3 attribute 122
remote deployment
Percent Response Threshold 4 attribute 123
problems and workarounds 334
Percent Response Threshold 5 attribute 123
Remote End attribute 134
Percent User Mode Time attribute 50
Remote Network Name attribute 135
performance considerations 342
Remote Node ID attribute 135
Performance Object Status attribute group 110
Reply to Queue Manager attribute 78
Performance Object Status workspace 18
requirements 7
PID attribute 49
Reset DI UpdateCounters action 280
policies 317
ResolvedIP attribute 66
Pool and LU Configuration workspace 21
Response Failure Statistics workspace 20
Pool Member attribute 151
response file template 7
Pool Name attribute 157, 160, 162, 164
Retry Delay attribute 135
Popup Server attribute 142
Retry Limit attribute 135
Port attribute 188, 192
Right Margin attribute 175
prerequisite publications 399
Role attribute 55
PrimaryNNS attribute 66
Role Name attribute 147, 178
Print Session Statistics workspace 21
Rollbacks Per Second attribute 106
Print State attribute 200
RTM End of Session attribute 142
Print Status and LU Statistics workspace 21
RTM Overflow attribute 142
Printer Device Name attribute 174
RTM Threshold 1 attribute 143
Printer File attribute 175
RTM Threshold 2 attribute 143
Printer Flow Control attribute 188
RTM Threshold 3 attribute 143
Printer To File attribute 175
RTM Threshold 4 attribute 144
Priority attribute 127
RTM Timer Until attribute 144
problems and workarounds 330
RU Throughput attribute 215
agent-specific 335
RU Throughput Per Second attribute 215
agent-specific workspaces 338
RU Transfer Statistics workspace 23
configuration 330

Index 415
RUs Inbound attribute 213 situations (continued)
RUs Inbound Per Second attribute 214 KQH_Primary_HIS_Exist_Warn 266
RUs Outbound attribute 214 KQH_SIS_Server_Down_Crit 254
RUs Outbound Per Second attribute 214 KQH_SNA_BASE_Down_Crit 256
Rx Pacing attribute 127 KQH_SNA_Connection_Failure 270
RX RU attribute 127 KQH_SNA_Connection_Inactive 270
KQH_SNA_DDM_Down_Crit 255
KQH_SNA_Mng_Conn_Failed_Warn 265
S KQH_SNA_MNGAGENT_Down_Crit 255
KQH_SNA_NetView_Down_Warn 256
Security 3270 attribute 144
KQH_SNA_PRINT_Down_Warn 257
Security APPC attribute 145
KQH_SNA_RPC_Down_Crit 255
Security attribute 154
KQH_SNA_Server_Down_Crit 257
Security High attribute 189
KQH_SNA_Server_Unreachable 269
Security Key/(Char) attribute 155
KQH_SNA_Server02_Down_Crit 257
Security Key/(Hex) attribute 154
KQH_SNA_Server03_Down_Crit 258
Security Low attribute 189
KQH_SNA_Server04_Down_Crit 258
Security LUA attribute 145
KQH_SNA_Service_Inactive 270
Security Medium attribute 189
KQH_SNA_Service_OutOfDate 271
Server attribute 54
KQH_SNABase_StartUp_Fail_Warn 265
Server Name attribute 146
KQH_Status_Failed_Warn 263
Service attribute 136, 175
KQH_TCP_RESYNC_Down_Crit 253
Service Name attribute 60, 69, 150, 153, 193, 209
KQH_TI_Exception_Warn 261
Service Title attribute 60, 69
KQH_TN3270_Down_Crit 259
Session Count attribute 193
KQH_TN3270_Service_Stopped 269
Session ID attribute 195
KQH_TN3270_Trace_Failed_Warn 264
Session Integrator PLUs Statistics workspace 16
KQH_TN5250_Down_Crit 259
Session Integrator Server attribute group 115
KQH_Unexpected_Logic_Err_Crit 264
Session Integrator Server PLUs attribute group 118
KQH_WIP_COM_Event_Occured 268
Session Integrator Server Statistics workspace 17
KQH_WIP_State_Machine_Event 268
Session Limit attribute 127, 194
overview 249
Session Type attribute 176
predefined 249
Sessions Active attribute 215
problems and workarounds 342
Sessions attribute 116, 119
Situation Editor 249
Sessions Configured attribute 216
situations, using attributes 25
Sessions Connected attribute 116, 120
SNA 3270 Response Times attribute group 121
Sessions Ended LULU attribute 216
SNA APPC Mode attribute group 124
Sessions Ended Normal attribute 216
SNA Configured Users attribute group 128
Sessions Failed attribute 217
SNA Connection Configuration attribute group 130
Sessions Failed Inactivity attribute 217
SNA Connections attribute group 136
Sessions Failed No Resource attribute 217
SNA Domain attribute group 138
Sessions Online attribute 117
SNA Domain Topology attribute group 146
Sessions Succeeded attribute 217
SNA Domain Topology workspace 15
Set DI UpdateCounters action 280
SNA Logical Unit Sessions attribute group 147
Short Retry Count attribute 81
SNA LU APPC Local and Remote workspace 22
Short Retry Delay attribute 81
SNA LU AppcLocal attribute group 149
silent installation 7
SNA LU AppcRemote attribute group 152
silent installation of language packs 7
SNA LU Display attribute group 155
situations 251
SNA LU LUA attribute group 158
additional information
SNA LU Print attribute group 160
predefined, defined 249
SNA LU3270 attribute group 162
KQH_3270Session_Supp_Crit 260
SNA Pool attribute group 165
KQH_APPC_Session_Act_Fail_Warn 266
SNA Pool Display attribute group 166
KQH_APPC_TP_Failed_One_Warn 264
SNA Print Session attribute group 167
KQH_APPCSession_Failure_Crit 261
SNA Server
KQH_DLUS_PU_Conn_Failed_Warn 263
situations 269
KQH_ESSO_Server_Down_Warn 252
workspaces
KQH_HIP_App_State_Event 267
descriptions 20
KQH_HIP_Auth_Error_Event 267
SNA Server and Connection Configuration workspace 22
KQH_HIP_Listener_Event 266
SNA Server attribute group 177
KQH_IHVDLL_LoadingFailed_Warn 262
SNA Server workspace 21
KQH_Link_Service_Down 260
SNA Service and Domain Configuration workspace 22
KQH_Local_Param_Invalid_Warn 261
SNA Service attribute group 178
KQH_LU_RESYNCSVC_Down_Crit 253
SNA Service Print attribute group 180
KQH_LU62_Resync_Start_Warn 262
SNA Service TN3270 attribute group 185
KQH_Many_Host_Req_Queued 252
SNA Service TN5250 attribute group 191
KQH_Many_Host_Req_Rejected 252
Sna Trace attribute 230, 235
KQH_MQBridge_Down_Crit 254

416 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
Socket Listen attribute 190 Suspension Starting Time in seconds attribute 86, 90, 94, 98
Start Enterprise Single Sign On Service action 281 Suspension Time attribute 85, 89, 93, 97
Start HIS LU62 Resync Service action 282 Suspension Time in seconds attribute 85, 90, 94, 98
Start HIS TCP/IP Resync Service action 283 Sync Point attribute 151, 154
Start Link Service action 284 Sync Point Client attribute 151
Start Microsoft MSMQ-MQSeries Bridge Service action 286 System Name attribute 38, 46, 54, 57, 60, 70, 72, 75, 82, 86, 90,
Start Session Integrator Server Service action 287 94, 99, 110, 118, 121, 123, 164, 165, 194, 197, 199, 201, 206, 208,
Start SNA DDM Service action 288 211, 213, 221
Start SNA MngAgent Service action 289
Start SNA RPC Service action 290
Start SnaBase Service action 291
Start SnaNetMn Service action 292
T
T3270 Trace attribute 224, 225, 230, 233, 235, 238, 241, 245
Start SnaPrint Service action 293
tacmd addSystem command 10
Start SnaServer Service action 294
Take Action commands
Start SnaSrv02 Service action 295
additional information 273
Start SnaSrv03 Service action 296
Disable SI Monitoring 275
Start SnaSrv04 Service action 297
Disable SNA Monitoring 275
Start TN3270 Service action 298
Disable TN3270 Monitoring 276
Start TN5250 Service action 299
Enable SI Monitoring 277
Starting Retry Count attribute 83, 87, 92, 96
Enable SNA Monitoring 278
Starting Time attribute 84, 88, 92, 96
Enable TN3270 Monitoring 279
Starting Time in seconds attribute 85, 89, 94, 98
overview 273
Startup attribute 78, 82
predefined 273, 317
Status and Configuration
problems and workarounds 345
situations 269
Reset DI UpdateCounters 280
workspaces
Set DI UpdateCounters 280
descriptions 21
Start Enterprise Single Sign On Service 281
Status and Configuration workspace 22
Start HIS LU62 Resync Service 282
Status APPC Local LU attribute group 193
Start HIS TCP/IP Resync Service 283
Status APPC Session attribute group 194
Start Link Service 284
Status attribute 48, 84, 88, 92, 96, 145, 179, 199, 200, 202, 204,
Start Microsoft MSMQ-MQSeries Bridge Service 286
206, 207, 210
Start Session Integrator Server Service 287
Status Client Connection attribute group 195
Start SNA DDM Service 288
Status Delay attribute 190
Start SNA MngAgent Service 289
Status LU3270 attribute group 197
Start SNA RPC Service 290
Status Print Session attribute group 199
Start SnaBase Service 291
Status Service Print attribute group 201
Start SnaNetMn Service 292
Status Service SNA attribute group 203
Start SnaPrint Service 293
Status Service TN3270 attribute group 205
Start SnaServer Service 294
Status Service TN5250 attribute group 206
Start SnaSrv02 Service 295
Status SNA Connection attribute group 208
Start SnaSrv03 Service 296
Status text attribute 199, 201, 206
Start SnaSrv04 Service 297
Status Text attribute 136, 147, 176, 178, 180, 184, 190, 192, 202,
Start TN3270 Service 298
205, 207, 210
Start TN5250 Service 299
Status TN3270 Session attribute group 210
Stop Enterprise Single Sign On Service 300
Status TN5250 Session attribute group 211
Stop HIS LU62 Resync Service 300
Stop Enterprise Single Sign On Service action 300
Stop HIS TCP/IP Resync Service 301
Stop HIS LU62 Resync Service action 300
Stop Link Service 302
Stop HIS TCP/IP Resync Service action 301
Stop Microsoft MSMQ-MQSeries Bridge Service 303
Stop Link Service action 302
Stop Session Integrator Server Service 304
Stop Microsoft MSMQ-MQSeries Bridge Service action 303
Stop SNA DDM Service 305
Stop Session Integrator Server Service action 304
Stop SNA MngAgent Service 306
Stop SNA DDM Service action 305
Stop SNA RPC Service 307
Stop SNA MngAgent Service action 306
Stop SnaBase Service 307
Stop SNA RPC Service action 307
Stop SnaNetMn Service 308
Stop SnaBase Service action 307
Stop SnaPrint Service 309
Stop SnaNetMn Service action 308
Stop SnaServer Service 310
Stop SnaPrint Service action 309
Stop SnaSrv02 Service 311
Stop SnaServer Service action 310
Stop SnaSrv03 Service 311
Stop SnaSrv02 Service action 311
Stop SnaSrv04 Service 312
Stop SnaSrv03 Service action 311
Stop TN3270 Service 313
Stop SnaSrv04 Service action 312
Stop TN5250 Service 314
Stop TN3270 Service action 313
take actions
Stop TN5250 Service action 314
descriptions 274
support
TCP Address attribute 76
list of messages 347
TCP Concurrent Server Calls Per Second attribute 43
Suspension Starting Time attribute 84, 88, 93, 97
TCP Data Transfer Statistics workspace 23

Index 417
TCP Explicit Calls Per Second attribute 43 Transport Type attribute 77
TCP Implicit Calls Per Second attribute 43 troubleshooting 319
TCP IMS Connect or OTMA calls sec attribute 44 agent-specific 335
TCP IP attribute 146 agent-specific workspaces 338
TCP Kilobytes Received attribute 219 Discovery Library Adapter 346
TCP Kilobytes Received Per Second attribute 219 installation 330
TCP Kilobytes Sent attribute 220 problems and workarounds 330
TCP Kilobytes Sent Per Second attribute 220 remote deployment 334
TCP MSLink Calls Per Second attribute 44 situations 342
TCP Port attribute 77 Take Action commands 345
TCP Throughput attribute 218 Tivoli Common Reporting 346
TCP Throughput in Kilobytes attribute 220 turn off trace 329
TCP Throughput in Kilobytes Per Second attribute 221 turn on trace 328
TCP Throughput Per Second attribute 218 uninstallation 330
Technotes 400 workspaces 338
Thread Count attribute 49 Tx Pacing attribute 128
Throughput Frames Per Second attribute 137, 148 TX RU attribute 128
Throughput KiloFrames Per Second attribute 138, 149 Type attribute 48, 58, 66, 201
Time Generated attribute 53
Timestamp attribute 31, 38, 47, 53, 54, 55, 57, 59, 61, 69, 70,
73, 76, 77, 79, 83, 87, 91, 95, 99, 102, 110, 115, 118, 121, 124,
129, 130, 137, 139, 146, 147, 149, 152, 155, 158, 160, 163, 165,
U
Unique Extension attribute 176
166, 168, 177, 179, 180, 185, 191, 193, 194, 196, 197, 200, 202,
Use Dynamic PU Definition attribute 67
203, 205, 207, 208, 210, 211, 213, 221, 224, 226, 227, 228, 231,
Use Fixed Tabs attribute 184
233, 236, 239, 242
Use IPv6 attribute 68
Title attribute 58, 66
Use Name Resolution attribute 191
Tivoli Common Reporting
Use Proportional Font Change attribute 184
problems and workarounds 346
User attribute 59, 67, 197
Tivoli Enterprise Console
User ID attribute 197
event mapping 365
user interface options 5
TN Mode Only attribute 191
User Type attribute 130
TN Session ID attribute 212
User Workstation Secure attribute 157, 160, 162, 164
TN3270 Server
Users Active attribute 219
situations 273
Users attribute 205
workspaces
descriptions 23
TN3270 Server attribute 218
TN3270 Server attribute group 213 V
TN3270 Server workspace 23 views
TN3270 Status and Session workspace 22 APPC Configuration workspace 21
TN5250 Status and Session workspace 23 Application Integration workspace 15
Top Margin attribute 176 Availability workspace 17
Total Calls Per Second attribute 44, 72 Channel and Message Pipe Configuration workspace 19
Total Errors Per Second attribute 45, 72 Data Integration workspace 18
Total Requests Accepted attribute 34 Data on Connection and LU Statistics workspace 20
Total Requests Received attribute 34 Data Transfer Statistics workspace 18
TP Timeout attribute 152 Databases workspace 19
trace Event Log workspace 19
turn off 329 HIP Byte Transfer Statistics workspace 15
turn on 328 HIP Host Request Statistics workspace 16
trace settings 326 HIP Method Execution Statistics workspace 16
Trace SNA Application attribute group 221 HIP Work Flow Process Statistics workspace 16
Trace SNA Base attribute group 224 HIS Tracing workspace 19
Trace SNA Manage Client attribute group 226 Link Service Statistics workspace 20
Trace SNA Mng Agent attribute group 227 Managed WIP Calls Request Response Stats workspace 16
Trace SNA NetView attribute group 228 Message Integration workspace 20
Trace SNA Print attribute group 230 Microsoft Host Integration Server workspace 15
Trace SNA Server attribute group 233 MQS TO MSMQ Status workspace 20
Trace SNA Server Manager attribute group 236 MSMQ TO MQS Status workspace 20
Trace State attribute 242 ODBC Exec Prepare and Fetch Statistics workspace 18
Trace TN3270 attribute group 239 OLEDB Exec Prepare and Fetch Statistics workspace 19
Trace TN5250 attribute group 242 Performance Object Status workspace 18
Traces attribute 56 Pool and LU Configuration workspace 21
tracing 324 Print Session Statistics workspace 21
Transactions Per Second attribute 107, 117, 120 Print Status and LU Statistics workspace 21
Transmit Queue attribute 82 Response Failure Statistics workspace 20
Transport String attribute 147, 178 RU Transfer Statistics workspace 23

418 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide
views (continued) workspaces (continued)
Session Integrator PLUs Statistics workspace 16 SNA Domain Topology 15
Session Integrator Server Statistics workspace 17 SNA LU APPC Local and Remote 22
SNA Domain Topology workspace 15 SNA Server 20, 21
SNA LU APPC Local and Remote workspace 22 SNA Server and Connection Configuration 22
SNA Server and Connection Configuration workspace 22 SNA Service and Domain Configuration 22
SNA Server workspace 21 Status and Configuration 21, 22
SNA Service and Domain Configuration workspace 22 TCP Data Transfer Statistics 23
Status and Configuration workspace 22 TN3270 Server 23
TCP Data Transfer Statistics workspace 23 TN3270 Status and Session 22
TN3270 Server workspace 23 TN5250 Status and Session 23
TN3270 Status and Session workspace 22 WIP Byte Transfer Statistics 17
TN5250 Status and Session workspace 23 WIP Host Response Statistics 17
WIP Byte Transfer Statistics workspace 17 WIP Method Call Statistics 17
WIP Host Response Statistics workspace 17 Workspaces
WIP Method Call Statistics workspace 17 additional information 13
Virtual Size attribute 49 overview 13
VRN Not Limited Resource attribute 68

X
W XID Format attribute 136
wikis 400
WIP Byte Transfer Statistics workspace 17
WIP Host Response Statistics workspace 17
WIP Method Call Statistics workspace 17
Work Flow Determinant Starts Per Second attribute 35
Work Flow Endpoint Starts Per Second attribute 35
Work Flow Envelope Starts Per Second attribute 35
Work Flow Starts Per Second attribute 36
Work Flow TRM Starts Per Second attribute 36
workarounds 330
Workflow Editor 317
Working Set Size attribute 49
workspaces
APPC Configuration 21
Application Integration 15
Availability 17
Channel and Message Pipe Configuration 19
Data Integration 18
Data on Connection and LU Statistics 20
Data Transfer Statistics 18
Databases 19
descriptions 15
Event Log 19
HIP Byte Transfer Statistics 15
HIP Host Request Statistics 16
HIP Method Execution Statistics 16
HIP Work Flow Process Statistics 16
HIS Tracing 19
Link Service Statistics 20
Managed WIP Calls Request Response Stats 16
Message Integration 19, 20
Microsoft Host Integration Server 15
MQS TO MSMQ Status 20
MSMQ TO MQS Status 20
ODBC Exec Prepare and Fetch Statistics 18
OLEDB Exec Prepare and Fetch Statistics 19
Performance Object Status 18
Pool and LU Configuration 21
predefined 13
Print Session Statistics 21
Print Status and LU Statistics 21
problems and workarounds 338
Response Failure Statistics 20
RU Transfer Statistics 23
Session Integrator PLUs Statistics 16
Session Integrator Server Statistics 17

Index 419
420 IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Host Integration Server Agent User's
Guide



Printed in USA