A.11 Computer Associates (CA) Unicenter

Table A-11 Computer Associates (CA) Unicenter Adapter Properties

Property

Specify…

AlarmColumns

A comma-separated list that determines which alarm columns display and the order in which the alarm items display in the Alarms view. Add the Node keyword to the beginning of the column, as in the following example:

Node,Ack,Ann,Number,Console,Description

The possible alarm columns are: Console, Attrib, Type, Ack, Ann, TimeGen, MsgNum, Exit, Node, User, Station, Number, DuplicateIDs, Description, Device, Workload, PInfo, UserData, Category, Source, Tag.

This property might seem redundant when considering alarms generated from objects below the server level in Unicenter. But in some cases, it is the only way to identify the hostname of the source of an alarm directly from the Alarms view.

AutoShowDSM

If True, automatic discovery of DSM level elements occurs when the adapter starts. If False, it is necessary to manually discover DSM level elements by using the Details > Show Operation option. The default is False.

Command.Ping

The command used for the Ping function. The syntax varies among operating systems. The default is ping ‑t.

Command.TraceRoute

The command used for the TraceRoute function. The syntax varies among operating systems. The default is tracert.

EventManagerHosts

The hostnames of the machines on which Unicenter is installed. The default is localhost. Set this property to one or more comma-separated hostnames that instruct the adapter where to look for Event Manager (EM) consoles.

The following values are relative to the location of the ORB itself, not the Operations Center server:

  • localhost: A special hostname used if the UniORB runs on the same server as a Unicenter server. This causes the ORB to access the Unicenter log files using the local path name x:/NSM/LOGS instead of a UNC name.

  • fully.qualified.hostname: Use this value if the UniORB needs to map a UNC name to access Unicenter log files, located on \\hostname\UNISHARE$.

If the Unicenter Enterprise Managers reside on different machines than the Unicenter World-View and the UniORB, set the EventManagerHosts adapter property to the machines on which the Unicenter Enterprise Manager is installed.

If this property is blank, the adapter searches for EM consoles on all of the hosts that Unicenter objects reference in their DSM_Address property.

MaxAlarmAgeHours

The number of hours that Operations Center performs initial alarm retrieval. Set to a larger number, such as 72. This provides three days worth of event messages. If the message count climbs too high during retrieval, lower the number. Coordinate with the MaxAlarms property. The default is 12.

MaxAlarms

The maximum number of alarms that the adapter queries and retains. The default is 5000. Larger customers might want to increase this value to 20,000–50,000 to obtain messages that cover the previous three days or more. Coordinate with the MaxAlarmAgeHours property.

MineTNGIcons

The default is False, meaning no icons are mined. If True, icons are mined from Unicenter and copied into the /OperationsCenter_install_path/html/images/large and /OperationsCenter_install_path/html/images/small directories. All adapters use the icons in the .../html/images directory.

OperationTimeout

The amount of time, in milliseconds, that an operation initiated from Operations Center waits for a reply. The default is 60000.

ReadOnlyConnection

Enables operations for users who have a read-only connection. If True, disables all operations that affect the adapter state. If False, no restrictions apply. The default is False.

RepositoryName

The name of the database repository used by Unicenter. This is a case-sensitive value. Set it to the exact value on the menu that Unicenter displays when opening applications that access the repository.

By default, when SQL Server is the repository for Unicenter, the RepositoryName is the uppercase name of the server on which the repository is installed. Set in conjunction with RepositoryPassword.

RepositoryPassword

The password for the repository named in RepositoryName. This is a case-sensitive value.

RepositoryUser

The user name used to access the Unicenter repository. The default is sa.

Script.onError

A script that executes if the adapter fails for any reason. For example, the script can print the reason for the failure as msg using log.info(msg).

Script.onInitialized

A script that executes when the adapter initializes. All of the Script.* properties are optional.

Script.onStarted

A script that executes when the adapter starts, either manually or automatically when the Operations Center server starts.

Script.onStopped

A script that executes after manually stopping the adapter.

ServerHost

The fully qualified TCP/IP hostname of the server on which UniORB is installed.

ServerPort

The TCP/IP port number on which UniORB runs, as specified in the Control Panel applet. The default is 1580.

Polling

If true, polls to retrieve events in batches. If false, the adapter listens for events. The default is false.