Input Tab

The input fields for the Parse Copybook Data activity are described here.

Input Field Data Type Description
bytes Binary A byte sequence that contains COBOL, PL/I, or RPG data. This input field is available only if you choose Bytes for the Input Type field under the General tab.

If your COBOL, PL/I, or RPG data is a text string, you must convert the text to bytes before passing the input data to the related activity. Do so by, for example, calling the string-to-base64() XPath function.

fileName String The location and name of the file to read. This input field is available only if you choose File from the Input Type drop-down menu under the General tab.

The file’s binary content is the input for the activity.

forceCharacterSet String A runtime override for the Character Set setting of the Parse Copybook Data activity. For details, see the description of the field Character Set in the section Parse Copybook Data — Configuration.

If you do not specify a value for forceCharacterSet, the Character Set setting under the General tab is in effect. Otherwise, the forceCharacterSet value applies.

Note: Invalid character-set names cause the Plug-in to throw a ParseCopybookDataException exception while executing the activity.

forceCharacterSetDisp1 String A runtime override for the Character Set for DISPLAY-1 Items setting of the Parse Copybook Data activity. For details, see the description for the Character Set for DISPLAY-1 Items field in Parse Copybook Data — Configuration. This field is available only if you select a COBOL copybook.

If you specify a value for forceCharacterSetDisp1, that value applies. Otherwise, the setting in the Character Set for DISPLAY-1 Items field under the General tab is in effect.

Note: Invalid character-set names cause the Plug-in to throw a ParseCopybookDataException exception while executing the activity.

noOfRecords Number The number of records to read from the input binary content. Specifying no value or specifying -1 as the value causes the activity to read all the records in the input file.

This input field, available only if you choose File for the Input Type field on the General tab, is useful if you read the input file in parts to minimize memory usage.

For details, see Parsing of a Large Number of Records.

recordDelimiter Binary This is a runtime override for Record Delimiter field. You can supply any base64Binary value to be used as a record delimiter. This value is only applied when Multiple Records is selected.

Note that the Plug-in does not validate the actual value of the delimiter supplied in the binary data but only uses the length of the recordDelimiter value to advance the reading position before parsing another record.

For details on mapping and transforming input data, see the TIBCO ActiveMatrix BusinessWorks Process Design Guide.