Copyright © Cloud Software Group, Inc. All rights reserved

Pre-Processing and Post-Processing Files

You can configure TIBCO Adapter for Files (IBM i) to perform the following pre- and post-processing tasks:

•	Process a file before or after it is published, or before or after it is written.

•	Execute an IBM i command or program before or after a file is published, or before or after an output file is generated.

To perform these actions, you use the executeBeforeProcess and executeAfterProcess configuration parameters; these parameters are found in the FileType section, FILE_OPTIONS element in the configuration file for either FilePublisher or FileSubscriber.

If you want to have a program called, you must include the IBM i command call as part of the parameter. If you specify a valid command or program name that is not in the FilePublisher’s or FileSubscriber’s library list, then you must include the library name in the parameter.

 

When a program is called by either FilePublisher or FileSubscriber, FilePublisher or FileSubscriber stops processing the current file until the called program has finished executing.

Pre-Processing Files

When you configure the adapter to pre-process files, the following occurs:

•

FilePublisher  When FilePublisher has a file that is to be published, FilePublisher executes the command or program. You must provide for a parameter that FilePublisher returns to the command or program. When FilePublisher executes the command, it supplies the name of the file that is to be published as a parameter.

•	FileSubscriber  When FileSubscriber has an output file to be generated, FileSubscriber executes the command or program. You must provide for a parameter that FileSubscriber passes to the command or call program. When FileSubscriber invokes the command, it passes the name of the file as a parameter.

Sample Configuration

Suppose that you want to call a CL program named PROCFILE, which is in a library named PGMLIB, before you publish a file. In the FileType section, FILE_OPTIONS element of the FilePublisher configuration file, you would include the executeBeforeProcess parameter and include the file name, as follows:

executeBeforeProcess=”CALL PGMLIB/PROCFILE”

 

For the CL program, you must include a CL variable that receives the name of the file that is to be published. For example:

PGM PARM(&FILENAME)

and

DCL VAR(&FILENAME) TYPE(*CHAR) LEN(50)

When the CL program is called, the CL variable &FILENAME contains the name of the library and the file that are to be published. For example, if the file to be published is FT111, and the library name of the output library is TIBRVOUT:

&FILENAME = ‘TIBRVOUT/FT111’

Post-Processing Files

When you configure the adapter to post-process files, the following occurs:

•

FilePublisher   When FilePublisher has finished publishing a file, FilePublisher executes the command or program. You must provide for two parameters that FilePublisher returns to the command or program. When FilePublisher executes the command or program, it supplies the name of the file that was published and the file status as parameters. The file name parameter passed includes the library name. The file status parameter is 0 if the file was published successfully, or 1 if there was an error publishing the file.

•

FileSubscriber   When FileSubscriber has finished generating an output file, FileSubscriber executes the command or program. You must provide for two parameters that FileSubscriber returns to the command or program. When FileSubscriber executes the command, it supplies the name of the file that was written and the file status as a parameter. The file name parameter passed includes the library name. The file status parameter is “0” if the file was processed successfully, or “1” if there was an error processing the file.

Copyright © Cloud Software Group, Inc. All rights reserved