Introduction : FilePublisher

FilePublisher
FilePublisher publishes input files as a series of TIBCO EMS/Rendezvous messages.
It publishes input files either by polling for them or by using a trigger subject to determine which input files to accept. The polling and trigger-subject methods can operate together. If files are being published and trigger messages to publish are received, the Adapter queues the files and publishes what is in the queue after the current file. A trigger-subject file takes precedence over a polling-method file.
You must identify which data sets contain the file(s) that you want to publish. You can use the Options section of the configuration file to identify a default input data set, process data set, and output data set. In addition, you can specify and override an input data set, a process data set, or an output data set for each file type in the configuration file.
Configuring FilePublisher
You can use the FilePublisher configuration file to configure the following aspects of the Publisher. See FilePublisher Configuration File for a list of the sample configuration files and data sets available with the Adapter.
Polling Method
The polling method supports only partitioned data sets (PDSs). In the polling method, FilePublisher does the following:
1.
2.
3.
4.
Figure 3 FilePublisher Workflow When Polling
Trigger-subject Method
The trigger-subject method supports:
In the trigger-subject method, FilePublisher subscribes to a subject that triggers publishing.
Trigger Subject for PDS Only
If the trigger subject contains a member name (file name) in the message, FilePublisher assumes the file is in the input data set and processes it:
a.
b.
Figure 4 Using a Trigger Subject With the File Name in Message (PDS Only)
Trigger-Subject for PDS, SEQ, GDG, and VSAM
If the trigger subject contains a fully-qualified data set name in the message, FilePublisher publishes the file as is from its current location. The file is not moved after it is published (see Figure 5).
Figure 5 Using a Trigger Subject With a Fully-qualified Data Set Name
Progress File
Regardless of the method used, FilePublisher creates a progress file that can be used for viewing the status of file processing.
By convention, the publisher's progress file is named <processDataset>.PRG.
Block Transfer and Record Transfer Mode
Files can be read or written in block transfer mode or in record mode. Block transfer mode means that the file is read in blocks without regard to its record or field structure. The blocks of data are published and must be subscribed to in block transfer mode as well.
Adapter for Files z/OS supports both fixed-block (FB) and variable-block (VB) files. File attributes are obtained by the catalog lookup service embedded in the Adapter.
In addition, each of the above data transfer modes has a guaranteed and reliable mode, as follows:
Explicit Confirmation Mode (ECM) – guaranteed mode for RV transport
Durable Subscribers – guaranteed delivery for EMS transport