Disk Forwarding Agent(4.3)

Owned by Jenni Wallin
Aug 26, 2024

The Disk forwarding agent creates files on the local file system containing the received data. Files are created when a Begin Batch message is received, and closed when an End Batch message is received. In addition, the Filename Template service offers the possibility to compress (gzip) the files, or to further process them, using commands.

To ensure that downstream systems will not use the files until they are closed, they are stored in a temporary directory until the End Batch message is received. This behavior also applies to Cancel Batch messages. If a Cancel Batch is received, file creation is cancelled.

Configuration

The Disk forwarding agent consists of two tabs: Disk and Filename Template. For information on Filename Sequence, see Workflow Template (3.0).

SettingDescription

Input Type

The agent can act on two input types: bytearray or MultiForwardingUDR. The default input type is bytearray. If nothing else is stated, the documentation refers to input of type bytearray.

For more information, see MultiForwardingUDR(3.0).

Directory

Enter the absolute pathname of the target directory on the local file system of the EC, where the forwarded files are to be stored.

The files are temporarily stored in the automatically created subdirectory DR_TMP_DIR, in the target directory. When an End Batch message is received, the files are moved from the subdirectory to the target directory.

Create Directory

Select this check box to create the directory, or the directory structure, of the path that you specify in Directory.

Note!

The directories are created when the workflow is executed.

Compression

The compression type of the target files. This determines if the agent compresses the files or not.

  • No Compression - The agent does not compress the files. This is the default setting.

  • Gzip - The agent compresses the files using gzip.

Command

If you enter a command, it is executed for each temporary file successfully closed, using the parameter values that you enter in Arguments. 

Arguments

This field is optional. Each parameter value that you enter must be be separated from the preceding value with a space.

The temporary filename is inserted as the second last parameter, and the final filename is inserted as the last parameter, automatically. This means that if, for instance, you do not enter any parameters in the field, the arguments will be as follows:

$1=<temporary_filename>   $2=<final_filename>

If you enter three parameters in the field Arguments, the arguments are set as:

$1=<parameter_value_#1>   $2=<parameter_value_#2>   $3=<parameter_value_#3>   $4=<temporary_filename>   $5=<final_filename>

Produce Empty Files

If you select this check box, files are produced even if they contain no data.

This section contains the following subsections: