# General

The MQTT Consumer step requires **Setup**, **Security**, **Batch**, **Fields**, **Result fields**, and **Options** definitions to stream messages.

![MQTT Consumer dialog box](https://3411831820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAYwCj9fPr1B2pjC11IOQ%2Fuploads%2Fgit-blob-09a150edf02f999ef7775453177fce13160b4321%2FPDITransStep_MQTTConsumer_PropertiesDialogBox.png?alt=media)

Enter the following information for the **Step Name** and **Transformation** fields:

| Option             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Step name**      | Specifies the unique name of the step on the canvas. The **Step name** is set to **MQTT Consumer** by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Transformation** | <p>Specify the child transformation to execute by performing any of the following actions:</p><ul><li>Entering its path</li><li>Clicking <strong>Browse</strong> to select an existing child transformation</li><li>Clicking <strong>New</strong> to create and save a new child transformation. See <a href="general-mqtt-consumer-reuse/create-and-save-a-new-child-transformation-mqtt-consumer-reuse">Create and Save a New Child Transformation</a> for more details.</li></ul><p>If you select a transformation that has the same root path as the current transformation, the variable\*${Internal.Entry.Current.Directory}\* is automatically inserted in place of the common root path. For example, if the current transformation's path is: <code>/home/admin/transformation.ktr</code> and you select a transformation in the directory <code>/home/admin/path/sub.ktr</code>, then the path is automatically converted to: <code>*${Internal.Entry.Current.Directory}*/path/sub.ktr</code></p><p>If you are working with a repository, you must specify the name of the transformation. If you are not working with a repository, you must specify the XML file name of the transformation.</p><p>Transformations previously specified by reference are automatically converted to be specified by the transformation name in the Pentaho Repository.</p> |

\*\*Note:\*\* The selected child transformation must start with the \*\*Get Records from Stream\*\* step.