Record-processing OTD Node Functions

The following list explains these primary nodes in the record-processing OTD, including their functions:

• BatchRecord: Represents the OTD’s root node.

• Configuration: Each sub-node within this node corresponds to an adapter configuration parameter and contains the corresponding settings information, except for the Parse or Create parameter. See BatchRecord Connectivity Map Properties for details.

  • InputStreamAdapter and OutputStreamAdapter: Allow you to use and control the data-streaming features of the OTD. For details on their operation, see Streaming Data Between Components.

    ---

    Note –

    You can transfer data using the Payload node or by using data streaming (InputStreamAdapter and OutputStreamAdapter nodes), but you cannot use both methods in the same OTD.

    ---

    ---

    Note –

    For the record-processing OTD, these configuration nodes are read-only. They are provided only for the purpose of accessing and checking the configuration information at run time.

    ---

• Record: A properties node that represents either:

  • The current record just retrieved via the get() method, if the call succeeded

  • The current record to be added to the data payload when put() is called

• Payload: The in-memory buffer containing the data payload byte array you are parsing or creating.

  ---

  Caution –

  It is a good practice to use a byte array in all cases. Failure to do so can cause loss of data.

  ---

  • put(): Adds whatever is currently in the Record node to the data payload. The method returns true if the call is successful.

  • get(): Retrieves the next record from the data payload (or stream), and populates the Record node with the record retrieved. get() returns true if the call is successful.

  • finish(): Allows you to indicate a successful completion of either a parse or create loop for both put() and get().

    ---

    Note –

    Use reset() to indicate any errors and to allow the OTD to clean up any unneeded internal data structures.

    ---