Adapter Specific Properties

You can predefine TRA properties in TIBCO ActiveMatrix Adapter for Files for Unix/Win.

The following table lists the predefined properties in the alphabetical order. Properties that start with ntservice are available only on Microsoft Windows platforms.

Properties for Publication Service and Subscription Service

The following table lists properties applicable to both Publication Service and Subscription Service:
Property Description
adfiles.traceOldMessages Either ON or OFF. The default value is OFF.

When it is set to ON, it enables 4.x style log messages and disables 5.x style log messages.

adfiles.EEMEnabled Either ON or OFF. The default value is OFF.

It enables or disables Business Event Messages. See Creating Business Event Messages on using this property.

adfiles.perfMon Either ON or OFF. The default value is OFF.
adfiles.addCustomHawkMethodsToClassMAgent Either ON or OFF. The default value is OFF.

When it is set to ON, you can add custom methods to the adapter standard microagent.

adfiles.SFTUseJMSMapMsg Either ON or OFF. The default value is OFF.

When it is set to ON, SFT mode is enabled to exchange JMS map messages.

adfiles.trace.devdebug Either ON or OFF. The default value is OFF.

When it is set to ON, debug log is enabled for issue investigation for the adapter at run time.

adfiles.trace.extended Either ON or OFF. The default value is OFF.

When it is set to ON, the Log4J log is enabled.

adfiles.trace.thread Either ON or OFF. The default value is OFF.

When it is set to ON, the thread ID is traced in the Log4J log.

adfiles.trace.log4j.properties Specifies the path for the Log4J properties. The default path is %TIB_ADFILES_HOME%/bin/adfiles.log4j.properties.

Properties Only for Publication Service

The following properties are for only applicable for Publication Service:
Property Description
adfiles.logSftProgressEveryNBlocks The default value is not to log progress status.

The value is integer. When you set the value to 10, the adapter prints a progress status every 10 messages.

adfiles.sendLotEndWithDataMsg Either ON or OFF. The default value is ON.

When it is set to ON and the Data Format is Business Document, Publication Service sends the LotEnd attribute either in an independent message or with the very last data message of a file.

See TIBCO ActiveMatrix Adapter for Files for Unix/Win Concepts about the LotEnd attribute.

adfiles.schemaDiagnosticsFile Format Either txt or xml. The default value is xml.

When Publication Service finds records that do not match the schemas, Publication Service writes them to a file either as plain text or in XML-like format.

adfiles.matchFieldCountAndRecordLength Either ON or OFF. The default value is OFF.

It enables or disables checking field count and record length when validating a record.

adfiles.quotedField Either ON or OFF. The default value is OFF.

If ON, the fields in double quotes are treated and processed as one field.

adfiles.JMSCompress Either ON or OFF. The default value is OFF.

When it is set to ON, the JMS messages are compressed before being sent.

adfiles.DeltaFlushInterval The default value is 3.

In Delta Publishing mode, when no new data is appended to an input file after a specified amount of polling, the data remaining in memory is considered as complete data and published.

adfiles.LBEnabled Either ON or OFF. The default value is OFF.

When it is set to ON, Load Balancing mode is enabled, so multiple adapter configurations of the same Publication Service can process separate files in parallel.

adfiles.NullNumberFieldAsZero Either ON or OFF. The default value is OFF.

It enables or disables treating null fields of integer type as zero.

adfiles.PublishEmptyField Either ON or OFF. The default value is OFF.

When it is set to ON, the empty fields are published. When it is set to OFF, the empty fields are skipped and not published.

adfiles.BDGroupingFactor At runtime, this value overrides the Grouping Factor value specified at design time. This property only applies to the Business Document data format.
adfiles.pub.multithread4Bigfile Either ON or OFF. The default value is OFF.

When it is set to ON, multiple threads are used to process a file. Subscription Service writes messages randomly.

This property is valid only for Record Transfer mode.

adfiles.pub.multithreadCount Defines the number of threads that are used to process a file.

Properties Only for Subscription Service

The following properties are for only applicable for Subscription Service:
Property Description
adfiles.startSubscriberOnNewFileBoundary Either ON or OFF. The default value is ON.

When it is set to ON, a subscriber discards partial files and starts processing only from the beginning of a new file upon restart. This property only applies to Simple File Transfer mode, JMS transport, and Durable Delivery mode.

adfiles.dontAddEOLToFinalRecord Either ON or OFF. The default value is OFF.

When it is set to ON, EOL is not added to the final record of a file. This property only applies to Simple File Transfer mode with TEXT File Transfer mode, and File Content Encoding is anything other than ASCII.

adfiles.toggleChildRecordsOrdering Either ON or OFF. The default value is OFF.

When it is set to ON, the sequence of the child orders is reversed in the generated file. When it is set to OFF, the sequence of the child orders does not change. This property takes effect only when no child records are reordered in TIBCO Business Studio.

adfiles.sub.discardDuplicateMessages Either ON or OFF. The default value is OFF.

When it is set to ON, this property prevents Subscription Service from writing duplicate messages to the output file, which is caused by Publication Service restart. This property only applies to the Business Document data format.

adfiles.useBDEmbeddedFileName Either ON or OFF. The default value is OFF.

When it is set to ON, Subscription Service uses the filename embedded in the LotId attribute in the incoming Business Document message when creating the output file instead of using the filename specified in TIBCO Business Studio. This property only applies to the Business Document data format.

See TIBCO ActiveMatrix Adapter for Files for Unix/Win Concepts about the LotId attribute.

adfiles.io.sub.exit4issue Either ON or OFF. The default value is ON.

When it is set to ON, Subscription Service does not confirm messages and exits when an IO error occurs. When it is set to OFF, Subscription Service confirms messages, ignores IO errors, and continues to process other messages.