9.5.1 Overview of the adaptor configuration definition file (AdaptorCompositionDefinition.xml)

Organization of this subsection
(1) Format
(2) File name
(3) File storage location
(4) Details of definition
(5) Order of CB definitions

(1) Format

The format is shown in the subsections for the individual definitions.

(2) File name

AdaptorCompositionDefinition.xml

(3) File storage location

You store this file in the following directory:

working-directory\conf\xml\

(4) Details of definition

The definitions in the adaptor configuration definition file have a hierarchical structure. The following figure shows the structure of the adaptor configuration definition file.

Figure 9-1 Structure of the adaptor configuration definition file

[Figure]

The individual definitions that have a hierarchical structure have parent-child relationships. For example, an input adaptor definition is a child element of an adaptor group definition and is defined within the tag for the adaptor group definition. Similarly, the adaptor group definition is the parent element of the input adaptor definition.

The table below lists and describes the definitions in the adaptor configuration definition file. For details about each definition, see the section indicated in the table.

Table 9-2 List of definitions in the adaptor configuration definition file

No.DefinitionDescriptionSection
1Common definition
(CommonDefinition)
Adaptor trace definition
(AdaptorTraceDefinition tag)
Defines information common to all standard adaptors.9.6
2Adaptor group definitionIn-process group definition
(InprocessGroupDefinition tag)
Defines input adaptors or output adaptors that are to be started in the in-process connection mode.9.7
3RMI group definition
(RMIGroupDefinition tag)
Defines input adaptors or output adaptors that are to be started in the RMI connection mode.
4Adaptor definitionInput adaptor definition
(InputAdaptorDefinition tag)
Defines the callback that constitutes an input adaptor.
You specify this definition for each input adaptor.
9.8
5Output adaptor definition
(OutputAdaptorDefinition tag)
Defines the callback that constitutes an output adaptor.
You specify this definition for each output adaptor.
6CB definitionCB definition for input
(InputCBDefinition tag)
File input connector definition
(FileInputConnectorDefinition tag)
Defines the file input connector processing that is used for reading files.9.9, 9.10
7HTTP packet input connector definition
(HttpPacketInputConnectorDefinition tag)
Defines the HTTP packet input connector processing that is used for reading HTTP packets.
8CB definition for output
(OutputCBDefinition tag)
File output connector definition
(FileOutputConnectorDefinition tag)
Defines the file output connector processing used for file output.
9Dashboard output connector definition
(DashboardOutputConnectorDefinition tag)
Defines the dashboard output connector processing used for dashboard output.
10CB definition for editing
(DataEditCBDefinition tag)
Format conversion definition
(FormatDefinition tag)
Defines the format conversion processing that is performed in order to use file input or output.9.9, 9.11
11Mapping definition
(MappingDefinition tag)
Defines mapping processing.
12Filter definition
(FilterDefinition tag)
Defines record filtering processing.
13Record extraction definition
(RecordExtractionDefinition tag)
Defines record extraction processing.
14CB definition for sending
(SendCBDefinition tag)
Input stream definition
(streamInfo tag)
Defines the input streams to which input adaptors are to connect.9.9, 9.12
15CB definition for receiving
(ReceiveCBDefinition tag)
Output stream definition
(streamInfo tag)
Defines the output streams to which output adaptors are to connect.

(5) Order of CB definitions

The order of the CB definitions is not the same for the input and the output adaptor definitions. The following shows the order of the CB definitions for each.

Order of CB definitions for input adaptor definition:
  1. CB definition for input (such as file input connector definition)
  2. CB definition for editing (such as format conversion definition)
  3. CB definition for sending (such as input stream definition)
Order of CB definitions for output adaptor definition:
  1. CB definition for receiving (such as output stream definition)
  2. CB definition for editing (such as format conversion definition)
  3. CB definition for output (such as file output connector definition)

You specify the CB definitions for editing depending on the functions to be used, as described below.

For details about the callback processing defined in a CB definition, see 10. Details About Definitions in the Definition Files.