Writer attributes

You use writer attributes to specify how the gateway provides a communication flow between Netcool/OMNIbus and Siebel Communications. You can override the default values by setting attributes in the configuration file.

The following table describes the attributes used to create a Siebel writer.

Note: For details of the data type definitions for the alerts tables forwarded to the ObjectServer, see the IBM® Tivoli Netcool/OMNIbus Administration Guide, SC23-6381.
Table 1. Writer attributes

Attribute name

Type

Description
ACTIVITY_INSERT_ INT_OBJ string

Use this attribute to specify the integration object defining Siebel field names populated by journal inserts from Tivoli® Netcool/OMNIbus.

ACTIVITY_INSERT_XML_TAG string

Use this attribute to specify the Siebel XML Tag for the Netcool Activity Insert integration object.

ACTIVITY_UPSERT_WF string

Use this attribute to specify the alias for the workflow declared in the Siebel eai.cfg file. This workflow implements the EAI Netcool Insert Activity (http) business service.

CLOSE_ACTION_SQL string

Use this attribute to specify the name of the file containing the close action SQL to be performed at the ObjectServer. No action is taken if no attribute is supplied. Used in bidirectional implementations of this gateway.
CLOSE_MAP string

Use this attribute to specify the name of the close map.
CLOSE_PROBLEMS string

Use this attribute to specify whether a service request is closed in Siebel if its corresponding NetcoolEvent is deleted:

TRUE: Enables service request closure in Siebel when events are deleted.

FALSE: Disables service request closure.

The default is TRUE.
CONVERSIONS_TABLE string

Use this attribute to specify the conversion table within the ObjectServer that the gateway uses.

Note: The table specified must be created and the correct conversion values inserted before this attribute can function correctly.
COUNTER_PART string

Use this attribute to specify the name of the counterpart reader in a bidirectional gateway configuration. This defines a link between the reader and the writer of one half of the bidirectional gateway and prevents the gateway from sending an alert straight back to the ObjectServer from which it was received.

Note: The reader must be running for the attribute value to be applied.
DATE_FORMAT string

Use this attribute to specify the format of date required.

The default is %m/%d/%y %H/%M/%S.
DEFAULT_CODE string

Use this attribute to specify the message that is returned when a alert fails to be created.

The default is default.
DELETED_SR_INT_OBJ string

Use this attribute to specify the integration object definitions used by Siebel to format Service Request closure data for export to the gateway.

EAI_PAGE string

Use this attribute to specify the web page for interfacing with Siebel Web Engine for communication with Siebel server.

Tip: You must specify a value for this attribute.
EVENT_ID string

Use this attribute to specify the Siebel field name containing Siebel's unique identifier for service requests.

FEEDBACK_FIELD string

Use this attribute to specify the name of field in FEEDBACK_SERVER where the feedback mechanism should write the service request number.
FEEDBACK_SERVER string

Use this attribute to specify the name of ObjectServer where the feedback mechanism should write the service request number.

Tip: You must specify a value for this attribute.

FILTER_CONDITION

 string

Use this attribute to specify which records are retrieved when the cache is being rebuilt on startup. The gateway ignores this attribute if the REBUILD_CACHE attribute is set to FALSE.
GW_HOST string

Use this attribute to specify the hostname where the gateway is running and where Siebel should send HTTP messages.

Tip: You must specify a value for this attribute.
GW_PORT integer

Use this attribute to specify the port on which gateway listens for HTTP connections from Siebel.

Tip: You must specify a value for this attribute.
HTTP_TIMEOUT integer

Use this attribute to specify the timeout value used in the HTTP communication between the gateway and Siebel.

INSERTED_JRNL_INT_ OBJ string

Use this attribute to specify the integration object definitions used by Siebel to format Service Request Activity (journal) data for export to the gateway.

JOURNAL_ACTION_SQL string

Use this attribute to specify the name of the file containing the journal action SQL to be performed at the ObjectServer. No action is taken if no attribute is supplied. Used in bidirectional implementations of this gateway.

JOURNAL_MAP string

Use this attribute to specify the name of the journal map.
KEY_FIELD string

Use this attribute to specify the key field used in the Netcool SR Insert integration object populated with a unique value by Tivoli Netcool/OMNIbus.

MODIFIED_SR_INT_OBJ string

Use this attribute to specify the integration object definitions used by Siebel to format service request update data for export to the gateway.

OPEN_ACTION_SQL string

Use this attribute to specify the name of the file containing the open action SQL to be performed at the ObjectServer. No action is taken if no attribute is supplied. Used in bidirectional implementations of this gateway.

OPEN_MAP string

Use this attribute to specify the name of the open map.
PASSWORD string

Use this attribute to specify the password of the user specified in USER attribute.

Tip: You must specify a value for this attribute.

REBUILD_CACHE

 string

Use this attribute to specify whether the gateway queries the ObjectServer and rebuilds the cache on startup.

The default is FALSE.
SIEBEL_VERSION integer

Use this attribute to specify the version of Siebel being to which the gateway connects.

Tip: You must set this attribute to 7.
SR_DELETE_INT_OBJ string

Use this attribute to specify the integration object defining Siebel field names modified by deletes from Tivoli Netcool/OMNIbus.

SR_DELETE_XML_TAG string

Use this attribute to specify the Siebel XML tag for the Netcool SR Delete integration object.

SR_GET_ID_WF string

Use this attribute to specify the alias for the Workflow declared in the Siebel eai.cfg file. This workflow implements the EAI Netcool Get Service Request Id (http) business service.

SR_INSERT_INT_OBJ string

Use this attribute to specify the integration Object defining Siebel field names populated by inserts from Netcool/OMNIbus.

SR_INSERT_XML_TAG string

Use this attribute to specify the Siebel XML Tag for the Netcool SR Insert Integration Object.

SR_MODIFY_INT_OBJ string

Use this attribute to specify the integration Object defining Siebel field names modified by updates from Tivoli Netcool/OMNIbus.

SR_MODIFY_XML_TAG string

Use this attribute to specify the Siebel XML Tag for the Netcool SR Modify Integration Object.

SR_QUERY_INT_OBJ string

Use this attribute to specify the integration object facilitating Siebel's response to Tivoli Netcool/OMNIbus inserts by providing new service request SR numbers.

SR_QUERY_XML_TAG string

Use this attribute to specify the Siebel XML tag for the Netcool SR Get Id integration object.

SR_UPSERT_WF string

Use this attribute to specify the alias for the workflow declared in the Siebel eai.cfg file. This workflow implements the EAI Netcool Insert SR (http) business service.

SWE_HOST string

Use this attribute to specify the hostname where Siebel Web Engine is running.

You must specify a value for this attribute.
SWE_PORT integer

Use this attribute to specify the port on the SWE_HOST host machine on which Siebel Web Engine is listening for HTTP requests from the gateway.

SEPARATOR_CHAR string

Use this attribute to enable overriding of the internally used name-value pair separator character. The separator character specified must be a character that will not be used within any value assigned to a string-valued ObjectServer field.

The default is ^.

Note: The value of this property can be expressed as a character or as a hexadecimal. For example, the default value ^ can alternatively be written as 0x5e in hexadecimal.
THREADPOOL_SIZE integer

Use this attribute to specify the number of threads that the gateway can use to forward events from the ObjectServer to Siebel. If this attribute is set to 1, the gateway forwards one event at a time. If this attribute is set to a value greater than 1, the gateway can forward multiple events simultaneously.

Note: To use multi-threading, you must configure Siebel correctly. You must set the Maximum Tasks parameter of the EAI Object Manager component to the same value as that set for this attribute.
TYPE string

Use this attribute to specify the type of writer.

You must set this attribute to SIEBEL.
UPDATE_ACTION_SQL string

Use this attribute to specify the name of the file containing the update action SQL to be performed at the ObjectServer. No action is taken if no attribute is supplied. Used in bidirectional implementations of this gateway.

UPDATE_MAP string

Use this attribute to specify the name of the update map.
USERNAME string

Use this attribute to specify the username for logging in to Siebel.