# Setup tab

![Setup tab](/files/m8wzJkvKmmZ6Ex84V3Tm)

In this tab, define your specific data stream within Amazon Kinesis Data Streams and the related starting location for consuming records. The records in the Amazon Kinesis Data Streams are stored by the data stream name and geographical areas known as regions. A Kinesis Data Streams application reads the records from the data stream. The name property of the Kinesis application specifies a consumer of the data stream and uniquely identifies the last point at which this consumer has read from the data stream.

Groups of records in Amazon Kinesis Data Streams are known as shards. The shard iterator property narrows the location of the records in a shard if a given application name has never been used to read from a data stream before. See <https://docs.aws.amazon.com/streams/latest/dev/key-concepts.html> and <https://docs.aws.amazon.com/streams/latest/dev/kinesis-record-processor-implementation-app-java.html> for more information on Amazon Kinesis Data Streams applications and shards.

| Option               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Region**           | Specify the Amazon geographical area where the data stream occurs. You can only select one region.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Stream name**      | Specify the name of the specific data stream within Amazon Kinesis Data Streams that contains the records to be consumed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Application Name** | Specify the name property of the existing Amazon Kinesis Data Streams application used to get records from a data stream. A given **Application Name** must not be used with more than one **Stream name**. Do not consume records from more than one data stream at a time.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Shard iterator**   | <p>If you are using an application (as specified in <strong>Application Name</strong>) for the first time to locate records to consume, select how to further refine the starting location for consuming data. The following iterator options are available:- <strong><code>TRIM\_HORIZON</code></strong></p><p>The last untrimmed record (the oldest data record).</p><ul><li><strong><code>LATEST</code></strong></li></ul><p>The most recent records.</p><ul><li><strong><code>AT\_TIMSTAMP</code></strong></li></ul><p>A specified point in time. If you select this option, use <strong>Date</strong> and <strong>Time</strong> to specify that point in time.</p><p>The default value is LATEST.</p> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pdia-data-integration/10.2-data-integration/pdi-transformation-steps-reference-overview/kinesis-consumer/options-kinesis-consumer/setup-tab-kinesis-consumer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.