The Adapter can be executed by either:
Adapter can be installed as a regular Windows service. This enables the system to control its status (Run, Pause, Stop, Automatic) as it would a regular Windows Service.
Installing the Adapter as a Windows Service which is done by running the Adapter executable from the command line using the -i to install it as service and -u to uninstall it.
Running the Adapter executable from the command line. The Adapter command line can be run in the following manner:
Command line options:
TextFileAdapter.exe -i | -u | -v | -d [-t] [-f configurationFileName] [-l logFileName] [-n serviceName] [-a OblicoreAddress] [-p OblicorePort] [-la LogGerheaDed] [-lp LogServerPort]
|
Parameter |
Function |
|---|---|
|
-i |
Install service |
|
-u |
Remove service |
|
-v |
Show version |
|
-d |
Run Adapter as console application |
|
-t |
Check only-check configuration file and stop |
|
-f |
Set configuration file name |
|
-l |
Set log file name |
|
-n |
Set service name |
|
-a |
Set application server address |
|
-p |
Set application server port number (1024-49151) |
|
-la |
Set log server address |
|
-lp |
Set log server port number (1024-49151) |
This type of execution is commonly used in projects. This allows the execution of the Adapter via a .bat file and also allows using the Windows Scheduler to control the timing of the Adapter execution. To schedule the Adapter using the Windows Scheduler, it is necessary to configure its running mode to be Run Once.
RunOnce: (optional [yes/no]). When set in the configuration file to "no", once executed the Adapter runs continuously. When set to "yes" the file Adapter runs, reads records and stops automatically when no new records appear. A file Adapter reads the whole file, then waits a few seconds and tries to read new records (depending on the SleepTime settings). If there are no new records, it stops. An SQL Adapter runs each one of the queries only once. If RepeatUntilDry is set to "no", it stops immediately. If RepeatUntilDry is set to "yes", it waits (depending on the SleepTime). It tries to run the query again (depending on the query's sleep time), and if there are no new records, it then stops.
For details on the SleepTime and RepeatUntilDry attributes, refer to Adapter Configuration Specifications.
The CA Business Service Insight Interface section of the configuration file consists of attributes specifying the two connection modes to CA Business Service Insight: online and offline.
In online mode, the Adapter connects to CA Business Service Insight, retrieves the translation tables and control commands from CA Business Service Insight, then sends Events, statuses, and translation requests back to CA Business Service Insight. In offline mode, the Adapter works with a local translation table file and writes the Events to an output file.
Offline mode is commonly used when first developing an Adapter and testing it.
Using ConsoleDebugMode set to "yes" allows debug messages to appear on the console.
For details on the various indicators, refer to Adapter Configuration Specifications, specifically the ConsoleDebugMode attribute.
|
Copyright © 2012 CA.
All rights reserved.
|
|