ADAPTER START Statement

Controls adapter start times.

Syntax

ADAPTER START
GROUPS {groupName[NOSTART]},[,...]
...
;

Usage

The ADAPTER START statement is optional. If the statement is absent, all output adapters start in parallel, followed by all input adapters in parallel.

Using the ADAPTER START statement, adapters can be put into startup groups, where each group is started sequentially. This is ensures that certain adapters are started, and load their data, before others.

Adapter groups are created implicitly when their name is used in the GROUP clause of the ATTACH ADAPTER statement. The order in which each groupName appears determines the order in which the adapter groups start. Adapters that are not assigned to one of the ordered groups are placed in a group that starts after all of the ordered groups have started. By default, all output adapters in a group start in parallel, followed by all input adapters in parallel.

NOSTART identifies adapters that should not start automatically with the rest of the adapters. The user can start these adapters using the external XMLRPC interface (esp_client.exe).

Errors are generated when ADAPTER START:
  • References a group that does not exist.
  • Does not reference all adapter start groups created with the ATTACH ADAPTER statement.
  • References the same group more than once.

Example

The ATTACH ADAPTER statement creates two named adapters groups (RunGroup1, NoRunGroup), each containing one adapter. The ADAPTER START statement is executed with instructions to start RunGroup1. The NOSTART syntax instructs the project server not to start NoRunGroup.

ATTACH INPUT ADAPTER csvInRun
 TYPE dsv_in
 TO TradeWindow
 GROUP RunGroup1
 PROPERTIES 
   blockSize=1, 
   dateFormat='%Y/%m/%d %H:%M:%S', 
   delimiter=',', 
   dir='$ProjectFolder/../data', 
   expectStreamNameOpcode=false, 
   fieldCount=0, 
   file='stock-trades.csv', 
   filePattern='*.csv', 
   hasHeader=true, 
   safeOps=false, 
   skipDels=false, 
   timestampFormat= '%Y/%m/%d %H:%M:%S';

ATTACH INPUT ADAPTER csvInNoRun
 TYPE dsv_in
 TO TradeWindow
 GROUP NoRunGroup
 PROPERTIES 
   blockSize=1, 
   dateFormat='%Y/%m/%d %H:%M:%S', 
   delimiter=',', 
   dir='$ProjectFolder/../data', 
   expectStreamNameOpcode=false, 
   fieldCount=0, 
   file='stock-trades.csv', 
   filePattern='*.csv', 
   hasHeader=true, 
   safeOps=false, 
   skipDels=false, 
   timestampFormat= '%Y/%m/%d %H:%M:%S';

ADAPTER START GROUPS NoRunGroup NOSTART, RunGroup1;