August 15, 2023

tAS400Input – Docs for ESB 6.x

tAS400Input

Reads a database and extracts fields based on a query.

tAS400Input executes a DB query with a strictly defined order which
must correspond to the schema definition. Then it passes on the field list to the next
component via a Row > Main link.

tAS400Input Standard properties

These properties are used to configure tAS400Input running in the Standard Job framework.

The Standard
tAS400Input component belongs to the Databases family.

The component in this framework is generally available.

Basic settings

Use an existing connection

Select this check box and in the Component
List
click the relevant connection component to reuse the connection
details you already defined.

Note:

When a Job contains the parent Job and the child Job, if you need to share an
existing connection between the two levels, for example, to share the connection created by
the parent Job with the child Job, you have to:

  1. In the parent level, register the database connection to be shared
    in the Basic settings view of the
    connection component which creates that very database connection.

  2. In the child level, use a dedicated connection component to read
    that registered database connection.

For an example about how to share a database connection across Job levels, see


Talend Studio
User Guide
.

Property type

Either Built-in or Repository
.

 

Built-in: No property data stored
centrally.

 

Repository: Select the repository
file in which the properties are stored. The fields that follow are
completed automatically using the data retrieved.

Save_Icon.png

Click this icon to open a database connection wizard and store the
database connection parameters you set in the component Basic settings view.

For more information about setting up and storing database connection
parameters, see
Talend Studio User
Guide
.

DB Version

Select the AS 400 version in use

Host

Database server IP address

Port

Listening port number of DB server.

Database

Name of the database

Username and Password

DB user authentication data.

To enter the password, click the […] button next to the
password field, and then in the pop-up dialog box enter the password between double quotes
and click OK to save the settings.

Schema and Edit
Schema

A schema is a row description. It defines the number of fields (columns) to
be processed and passed on to the next component. The schema is either Built-In or stored remotely in the Repository.

This component offers the
advantage of the dynamic schema feature. This allows you to retrieve unknown columns
from source files or to copy batches of columns from a source without mapping each
column individually. For further information about dynamic schemas, see
Talend Studio

User Guide.

This dynamic schema
feature is designed for the purpose of retrieving unknown columns of a table and is
recommended to be used for this purpose only; it is not recommended for the use of
creating tables.

 

Built-in: The schema is created and
stored locally for this component only. Related topic: see
Talend Studio User Guide
.

 

Repository: The schema already exists
and is stored in the Repository, hence can be reused. Related topic: see

Talend Studio User
Guide
.

 

Click Edit schema to make changes to the schema.
If the current schema is of the Repository type, three
options are available:

  • View schema: choose this option to view the
    schema only.

  • Change to built-in property: choose this
    option to change the schema to Built-in for
    local changes.

  • Update repository connection: choose this
    option to change the schema stored in the repository and decide whether to propagate
    the changes to all the Jobs upon completion. If you just want to propagate the
    changes to the current Job, you can select No
    upon completion and choose this schema metadata again in the [Repository Content] window.

Query type and Query

Enter your DB query paying particularly attention to properly
sequence the fields in order to match the schema definition.

If using the dynamic schema
feature, the SELECT query must include the * wildcard, to retrieve all of the columns from the table
selected.

Advanced settings

Additional JDBC parameters

Specify additional connection properties for the DB connection you are
creating. This option is not available if you have selected the
Use an existing connection check
box in the Basic settings.

Trim all the String/Char columns

Select this check box to remove leading and trailing whitespace from
all the String/Char columns.

Trim column

Remove leading and trailing whitespace from defined columns.

tStat
Catcher Statistics

Select this check box to collect log data at the component
level.

Usage

Usage rule

This component offers the flexibility of the DB query and covers all
possible SQL queries.

Dynamic settings

Click the [+] button to add a
row in the table and fill the Code field
with a context variable to choose your database connection dynamically from
multiple connections planned in your Job. This feature is useful when you
need to access database tables having the same data structure but in
different databases, especially when you are working in an environment where
you cannot change your Job settings, for example, when your Job has to be
deployed and executed independent of
Talend Studio
.

The Dynamic settings table is
available only when the Use an existing
connection
check box is selected in the Basic settings view. Once a dynamic parameter is
defined, the Component List box in the
Basic settings view becomes unusable.

For examples on using dynamic parameters, see Scenario: Reading data from databases through context-based dynamic connections and Scenario: Reading data from different MySQL databases using dynamically loaded connection parameters. For more information on Dynamic
settings
and context variables, see
Talend Studio User Guide
.

Scenario: Handling data with AS/400

This scenario describes a Job that writes the user information into AS/400, and then reads
the information in AS/400 and displays it on the console.

components-tas400input_s1_job.png

Adding and linking the components

  1. Create a new Job and add a tFixedFlowInput component, a
    tAS400Output component, a tAS400Input component, and a tLogRow component by typing their names in the design workspace
    or dropping them from the Palette.
  2. Connect tFixedFlowInput to tAS400Output using a Row >
    Main connection.
  3. Do the same to connect tAS400Input to tLogRow.
  4. Connect tFixedFlowInput to tAS400Input using a Trigger
    > OnSubjobOk connection.

Configuring the components

Writing the data into AS/400

  1. Double-click tFixedFlowInput to open its
    Basic settings view.

    components-tas400input_s1_tfixedflowinput.png

  2. Click the […] button next to Edit
    schema
    and in the [Schema]
    dialog box define the schema by adding three columns: id of Integer type, and name
    and city of String type.

    components-tas400input_s1_tfixedflowinput_schema.png

    Click OK to close the [Schema] dialog box and accept the propagation prompted by the
    pop-up dialog box.
  3. In the Mode area, select Use Inline Content (delimited file) and enter the
    following user information in the Content
    field.

  4. Double-click tAS400Output to open its Basic settings view.

    components-tas400input_s1_tas400output.png

  5. In the Host, Database, Username and
    Password fields, enter the information
    required for the connection to AS/400.
  6. In the Table field, specify the table into which you want
    to write the data. In this example, it is doct1018.
  7. Select Drop table if exists and create from
    the Action on table drop-down list, and select
    Insert from the Action on data drop-down list.

Retrieving the data from AS/400

  1. Double-click tAS400Input to open its Basic settings view.

    components-tas400input_s1_tas400input.png

  2. In the Host, Database, Username and
    Password fields, enter the information
    required for the connection to AS/400.
  3. Click the […] button next to Edit
    schema
    and in the [Schema]
    dialog box define the schema by adding three columns: id of Integer type, and name
    and city of String type. The data structure
    is same as the structure you have defined for tFixedFlowInput.
  4. In the Table Name field, enter or browse to the table
    into which you write the data. In this example, it is doct1018.
  5. In the Query field, enter the SQL query sentence to be
    used to retrieve the user data from AS/400. In this example, it is SELECT * FROM doct1018.
  6. Double-click tLogRow to open its Basic settings view.

    components-tas400input_s1_tlogrow.png

  7. In the Mode area, select Table (print values in cells of a table) for better
    readability of the result.

Saving and executing the Job

  1. Press Ctrl + S to save the Job.
  2. Press F6 or click Run on the Run tab to run the
    Job.

    components-tas400input_s1_result.png

    As shown above, the user information is written into AS/400, and then the data is
    retrieved from AS/400 and displayed on the console.

Document get from Talend https://help.talend.com
Thank you for watching.
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x