> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pdia-data-integration/10.2-data-integration/pdi-transformation-steps-reference-overview/copybook-input-pdi-step/options-copybook-input-step/options-tab-copybook-input-step.md).

# Options tab

![Options tab, Copybook Input step](/files/AovUXHRyqGCXveD1EZow)

Use this tab to define PDI output stream options.

## **Output record information**

Use this section to specify details about the records for output.

| Option                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Store record as a binary field**    | Specify an additional output field to contain the binary bytes that make up the record currently being processed. You can use the stored binary field as the input for the data fields downstream from the Copybook Input step.                                                                                                                                                                                                                                                                                                                                                                       |
| **Create field with record number**   | Specify an additional output field to contain the record number within the file. For fixed-length record definitions, multiplying this number by the fixed record size yields the offset of the record within the input file. This field will reset to zero when a new data file is read. Also, the counter is specific to a copy of the step, so changes to the [**Change Number of Copies to Start**](/pdia-data-integration/10.2-data-integration/data-integration-perspective-in-the-pdi-client/work-with-transformations-cp/use-the-transformation-menu.md) option may cause unexpected results. |
| **Create field with record checksum** | Specify an additional output field to contain a hex string representation of the `sha1` checksum of the source record byte data.**Note:** This option is useful for debugging conversion errors, but it could be resource intensive.                                                                                                                                                                                                                                                                                                                                                                  |

\## \*\*Conversion errors\*\*

Use this section to specify how to handle errors during conversion.

* **Ignore conversion errors**

  Select this check box to log multiple conversion error messages such as malformed records, bad enclosure strings, wrong number of fields, and premature line ends. The errors are logged in JSON object format in a single PDI row. See [Use Error Handling](/pdia-data-integration/10.2-data-integration/pdi-transformation-steps-reference-overview/copybook-input-pdi-step/use-error-handling-copybook-input-step.md) for details about the format.

  Clear this check box if you want conversion errors in the source binary files to stop the transformation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/copybook-input-pdi-step/options-copybook-input-step/options-tab-copybook-input-step.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.