Building stream-to-stream production objects

Stream-to-stream mode, which is the new production object default, parses binary large object (blob) data as input, and generates blob data as output.

Create stream-to-stream production object

1. Click New below the Stream Input Fields pane.The Input Field Information window appears. An input field defines a single piece of an input transaction, for example, a record or message, gathered by an acquisition AIM.

2. When the Input Field Information window displays, complete these options:

   • Name – enter the input field’s name. To make the name easily recognizable, append _fld or _f to the name.

     The default field names are Field1, Field2, and so on. Allowable characters are A – Z, a-z, 0-9, and underscore (_). The name must start with an underscore or alphabetic character. Append “_f”, “_fld”, or “_field” to the field name, as in “pid_f”, “pid_fld”, or “pid_field.”

   • Offset – select one of the following option to define the Offset:

     Option	Description
     By Value Offset	If the input field always lives at a specific location in the input transaction., enter the input field location relative to the beginning of the value in the Offset field. The first position in a field is always byte 0 (zero), and the maximum record size is 9,999. Set the associated length to the field length. For example, if the field is an ID number that is always six numbers, set the length to 6.
     Follows-fld	If the current input field location might change, select the name of the preceding input field from the drop-down list, which displays only if you have previously defined a field. Always define the position of the first field in an input transaction with the value offset and define all subsequent fields with the Follows-fld offset. If the transaction format changes at a later time and you must insert a field, you only need to modify the entry for the input field that follows the new inserted field.
     Redefines-fld	If the current input field begins at the same location as another input field, select the other input field name from the drop-down list
     Follows-Pattern, Anchor Field	If the input field begins after a specific character pattern., enter a unique pattern in the Pattern field. Set the additional field options as necessary: Select Inclusive to include the pattern when computing the input field offset. Select Anchor to indicate which input field the pattern starts with or follows. This field is required if the input field is optional. Use this field whenever possible, because Impact searches for the pattern at the start of the transaction if this field is not defined. Select Redefine Anchor to indicate that the pattern begins with the Anchor field value. If this field is not selected, Impact searches for the pattern after the Anchor field value.

3. When you select Follows-Pattern, Anchor Field, additional options display:

   Option	Description
   Pattern Anchor	Pattern – when the input field begins after a specific character pattern., enter a unique pattern. Inclusive – include the pattern when computing the input field offset. Anchor – indicate which input field the pattern starts with or follows. This field is required if the input field is optional. Use this field whenever possible, because e-Biz Impact searches for the pattern at the start of the transaction if this field is not defined. Redefine Anchor – indicate that the pattern begins with the Anchor field value. If this field is not selected, e-Biz Impact searches for the pattern after the Anchor field value.
   Scope	Limit – search from the beginning of the transaction for the number of characters specified in the associated field. Separator – search from the beginning of the transaction to the first occurrence of the character selected from the drop-down list. End-of-data (default) – search from the beginning of the transaction. Sep. patterns – search from the beginning of the transaction to the first occurrence of one of the specified patterns entered in the associated field. e-Biz Impact uses the first encountered pattern as the offset location

4. Define the Length:

   Option	Description
   By Value	If the current input field is always a specific number of characters in length, select this option and enter the number of characters in the associated field.
   Separator	If the end of the field is identified by a specific character., select the appropriate character from the drop-down list, or enter your own. Separator values include \t (tab), \r (CR), \n (CRLF).
   Separator Patterns	If the field ends after a specific pattern of characters is found, enter the separator used to separate the patterns in the Pattern Separator List. To separate the patterns in the list with a carriage return or line feed (CRLF), accept the default. The prefix or suffix used in the Pattern Separator List is not part of the actual pattern separator. Discard – discard the separator and start at the next defined field, rather than starting at the separator itself. Optional Sep – indicates that the separator is optional, and if e-Biz Impact does not find the separator, the ending location for this input field is the end of the data.
   Separator-Is-Fld/Datalink	Separator-Is-Fld/Datalink – if the field ending location is identified by the another input field’s content, select this option and select the field name from the Use Input Field drop-down list. If the input field ending location is identified by a datalink, select this option and select the datalink name from the Use the Datalink field, or click the ellipsis button to create a new datalink. Pattern – select this option to use the entire contents of the identified Input Field as a separator pattern for this Input Field’s ending location. If this option is not selected, TRAN-IDE uses the first byte of the identified Input Field as the separator character for this Input Field’s ending location. Discard – discard the separator and start at the next defined field, rather than starting at the separator itself. If you do not select this option, the separator pattern is included in the data of the Input Field that follows this Input Field. Optional Sep. – indicates that the separator is optional, and if e-Biz Impact does not find the separator, the ending location for this input field is the end of the data.
   Value-of-Fld	If another input field holds a value that identifies the current field length, select that input field name from the drop-down list.
   Multiple Separators	If the input field end location can be identified by more than one character, enter those characters in the associated field, separating them with a space character, or select them from the drop-down list. e-Biz Impact uses, as the ending location, the location of whichever separator it finds first in the incoming transaction.
   End-of-data	If the field ends at the end of the incoming data stream, select this option.

   If you want separators in the output transaction, you must add them back into the data stream.

5. Click OK to save your entries and close the window.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF