# General

The JMS Consumer step requires definitions for setup, batch, field, and result fields to stream messages.

![JMS Consumer dialog box](https://2745965000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvZoINBz5C5WnDZQlbOJQ%2Fuploads%2Fgit-blob-5b3841497a819e29f6e5e44143fc3df7147f8d6a%2FPDITransStep_JMSConsumer_PropertiesDialogBox.png?alt=media)

Enter the following information in the transformation step fields.

| Option             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Step name**      | Specifies the unique name of the step on the canvas. The **Step name** is set to JMS Consumer by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Transformation** | <p>Specify the child transformation to execute by performing any of the following actions:- Entering its path.</p><ul><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-jms-consumer/create-and-save-a-new-child-transformation">Create and save a new child transformation</a> for more details.</li></ul><p>Note that the selected child transformation must start with the Get Records from Stream step.</p><p>If you select a transformation that has the same root path as the current transformation, the variable <em>${Internal.Entry.Current.Directory}</em> 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> |