A.10 Computer Associates Spectrum

Table A-10 Computer Associates Spectrum Adapter Properties

Property

Specify…

Alarm Columns

A comma-separated list that determines which alarm columns display and the order in which the alarm items display (date/time, rule, etc.) in the Alarms view. The default list is:

modelName,Ack=Acknowledged,description

Ask the Spectrum Administrator to determine which the columns are available. Specify each column name using the correct case.

CORBA Callback Port

Specifies the port used by the SPECTRUM OSAgent to perform callback communications to the adapter. Specify a value between 1 and 65535. The default is 1581.

Call Performance Logging

If True, this debug option causes the Spectrum Integration to note the timing and context of each call it makes to the SpectroServer. This information is valuable when attempting to optimize performance on larger Spectrum installations. The default is False.

Connection Retry Delay

Applicable for Spectrum version 9.x adapters only. The minimum delay (in seconds) between “keep alive” connection attempts to the Spectrum server. Default is 30.

Device Extra Relations

A comma-separated list of the hex numbers of additional relationships to display for device-class objects. The Spectrum Integration defines a set of relationships that are commonly used for devices. The Spectrum administrator can define additional relationships. Also, unusual relationships might be in use in an environment. If children exist in a relationship listed here, the model contains the generated children.

Exclude Model Class

Specify the numeric value of one or more Model Classes to filter out alarms or elements. Separate values with a comma.

For example, to exclude any Spectrum elements or alarms with a Model Class of Port, type 15.

Follow Remote Links

If True, the Spectrum Integration attempts to follow remote model links. These links lead from one SpectroServer to another, in the distributed SpectroServer configuration. Additional required steps for configuring SpectroServer security to fully implement this feature are described in Understanding Spectrum Adapter Features. The default is true.

Model Domain ID to IP Address Map

Applicable for Spectrum version 8.x adapters only. The IP address of a specific model domain that is communicated to the Spectrum Integration. This directly specifies a model domain IP address if it cannot reach a particular model domain through the common lookup mechanism. This comma-separated list uses the following format, where 0xnnnnnnnn is the model domain identifier and y.y.y.y is the IP address of the hosting SpectroServer:

0xnnnnnnnn=y.y.y.y

Model Name to Properties Files Map

Applicable for Spectrum version 8.x adapters only. The model names and their associated property files to load. By default, Operations Center loads the CsStandard.30 file, which displays in the main element property pages. The format is:

model_name=one_or_more_filenames_separated_by_commas

Model names are separated by semicolons:

model_name=file1, file2, fileN;model_name=file1

The default is:

Gen_IF_Port=CsMonMdlIn.30,CsMonMdlOut.30

This creates two additional element properties pages entries for elements of model type:

Gen_IF_Port : CsMonMdlIn.30 and CsMonModlOut.30

To determine available files, search the directory of model names in Spectrum_home/SG‑Support/CsGib, and add the file names and the model types to the adapter property. It is necessary to look through the models of interest and identify the data to display.

Name Service Port

The port number on which the Spectrum CORBA Name Service is configured to listen. The default is 14006.

Non-Device Extra Relations

A comma-separated list of the hex numbers of additional relationships to display for non-device-class objects. The Spectrum Integration defines a set of relationships that are commonly used for non-devices. The Spectrum administrator can define additional relationships. Also, unusual relationships might be in use in an environment. If children exist in a relationship listed here, the model contains the generated children.

ORB Init Parameters

Use this property only under the direction of Support.

ORB Timeout

The length of time, in seconds, to wait for a SpectroServer response to calls. Use this property only under the direction of Support. The default is 60.

OSAgent

The IP address or domain name of a machine that is running an OSAgent to use if the integration cannot locate and default to an initial OSAgent. In a conventional installation, this is the machine on which the SpectroServer runs.

Polling

Polls the remote agents to check for connection. The default is false. Set this property to true when Show Global Collections is enabled.

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 upon adapter initialization. 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.

Show Global Collections

Applicable for Spectrum version 9.x adapters only. If true, the Spectrum adapter includes global collections in the Elements hierarchy tree. The default is false.

The Polling property must be set to true when this feature is enabled.

SpectroServer

The CORBA name of the SpectroServer, which is almost always the same as the short name of the system on which the SpectroServer is running. For example, if the SpectroServer runs on qa4sun0.mosol.com, the SpectroServer name is qa4sun0. Verify the CORBA name by running the osfind command in the SpectroServer installation.

Specify the host name, and not the fully-qualified domain name. Because the Spectrum services are only advertised using the host name, the adapter cannot connect to the SpectroServer using the fully-qualified domain name.

Spectrum Cause File Directory

Applicable for Spectrum version 9.x adapters only. The Spectrum Cause Files map the Spectrum cause id (for alarms) to the desciption of the alarms cause. Specify the Operations Center directory where you have saved copies of these files from your Spectrum installation at SpectrumInstall/SG-Support/CsPCause at integration setup.

Spectrum Installation Directory

Applicable for Spectrum version 8.x adapters only. The Spectrum installation directory. Enables the integration to gather additional information about properties of the Spectrum Models.

If the Operations Center server is not on the same system as the SpectroServer, consider copying the files to the Operations Center server. The SpectroServer does not need to run; however, the files must be available. Another option is to set up a remote file link. The default is /opt/spectrum.

Spectrum OneClick Topology Config Directory

Applicable for Spectrum version 9.x adapters only. Location of the XML files needed to retrieve the properties to be consistent with the Spectrum OneClick client.

Defaults to /SPECTRUM/tomcat/webapps/spectrum/WEB-INF/topo/config. Replace the default the Operations Center directory where you have saved copies of these files from your Spectrum installation at SpectrumInstall/tomcat/webapps/spectrum/WEB-INF/topo/config at integration setup.

Spectrum User

The user names added to the Spectrum .hostrc files on the SpectroServers to be connected. The SpectroServer does not permit Operations Center to connect to it unless the Spectrum user name matches an entry in the .hostrc file.

Universe

Applicable for Spectrum version 8.x adapters only. Do not modify this internal setting.

Use Default Algorithm for Global Collections Status

Applicable for Spectrum version 9.x adapters only. If true, status information of children is propagated to the Global Collections parent folders. If false, no status is propagated and parent folders remain in the unknown state.The default is false.