Copyright © TIBCO Software Inc. All rights reserved
Copyright © TIBCO Software Inc. All rights reserved


Chapter 1 Overview : Functional Components

Functional Components
The adapter consists of the following two applications, as illustrated in Figure 2.
A publication service that processes data from files and publishes the contents as TIBCO Rendezvous or TIBCO EMS messages.
A subscription service that subscribes to TIBCO Rendezvous or TIBCO EMS messages, processes received messages, and writes the contents to a file.
For each adapter instance, you can configure the format of the incoming or outgoing TIBCO Rendezvous or TIBCO EMS message, the file format, and many file-handling options.
Figure 2 Functional Components
FF
FilePublisher
FilePublisher is an adapter publication service, you can use it by specifying the following options:
Data Transfer Mode: determines whether FilePublisher transfers data in Block mode or Record mode. Each of these modes in turn has a guaranteed mode and a reliable mode. For guaranteed delivery, you can use ECM with the RV message transport, and you can use durable topics for the EMS transport. For details, see Data Transfer Modes.
File Processing Options: determines the service can run once, or can be configured to run continuously. When configured for the latter, it processes and publishes files when it receives an event such as a timer event (polling), or an event generated by a message (trigger).
Transport Options: supports TIBCO Rendezvous, TIBCO Rendezvous Certified Messaging (RVCM), and TIBCO EMS message transport.
Publication Options: in Record mode, after processing a file, the service provides options to publish the objects generated during the file processing. These options include capabilities for checkpoint restart, to batch objects for publication, delay publication, invoke a callout before publication, or to publish an object only if all of its associations have no errors.
Continuous File Processing
FilePublisher accesses input files either by polling for them or through use of a trigger subject. The polling and trigger-subject methods can operate together. If trigger messages are received while files are being published, the adapter queues files and publishes what is in the queue after the current file. A trigger-subject file takes precedence over a polling-method file.
Polling Method
In the polling method, FilePublisher performs the following operations:
1.
2.
3.
4.
Figure 3 FilePublisher Workflow When Polling
FilePublisher creates a progress file (.PRG) that can be used for viewing the status of file processing. A progress file tracks how far into the file we have published and have received acknowledgements from all subscribers. It is used for recovery.
Trigger-Subject Method
In the trigger-subject method, FilePublisher subscribes to a subject that triggers publishing. If the trigger subject contains a file name in the message, FilePublisher publishes the file as is from its current location. The file is not moved after it is published.
Figure 4 Using a Trigger Subject With a File Name
 
FileSubscriber
As an adapter subscription service, you can use FileSubscriber by specifying the following options:
Data Transfer Mode: determines whether FileSubscriber transfers data in Block Mode or Record Mode. Each of these modes in turn has a guaranteed mode and a reliable mode. For guaranteed delivery, you can use either ECM with the RV message transport or durable topics for the EMS transport. For details, see Data Transfer Modes.
Processing and File Generation Options: the service can be configured to generate files in a specific library; the service also provides options for executing a command or calling a program before or after generating an output file, and for determining when and how to generate the output file.
Transport Options: supports the TIBCO Rendezvous, TIBCO Rendezvous Certified Messaging (RVCM), and TIBCO EMS message transport (reliable and certified).
Depending on the chosen transport option, FileSubscriber listens to either TIBCO Rendezvous or EMS messages on predefined subjects or destinations and generates output records to a file. FileSubscriber keeps the output in a temporary file and maintains a progress file (Figure 5).
Figure 5 FileSubscriber Workflow
 
Generating Output Files
The format of an output file is shown in Figure 6.
Figure 6 Format of an Output File
When FileSubscriber writes the output file, it uses the filePrefix parameter as the output file name. You can also optionally append the system date and time to the file name by using the appendDateTime parameter.

Copyright © TIBCO Software Inc. All rights reserved
Copyright © TIBCO Software Inc. All rights reserved