When you create a To File destination component for a channel and you indicate that all output messages are to be written to a single file, you can use one or more format specifiers to indicate to Iguana that a new file is to be created after a specified time period has elapsed. For example, if you specify the file specifier %d, a new file is created every day.

	New Feature in Iguana 4.1 Format specifiers are new in version 4.1 of Iguana.

	These format specifiers are also used to create a unique output file name if your channel is writing each message to a separate output file and is using a custom timestamp to generate the file name.

The following format specifiers create a new file every hour:

The following format specifiers create a new file every day:

The following format specifiers create a new file every week:

The following format specifiers create a new file every month:

The following format specifiers create a new file every year:

The following format specifiers are primarily for use in custom IDs that can be defined when writing each message to a separate file:

If two or more format specifiers are supplied, a new file is created for whichever time period is more frequent. For example, if you type %Y%B%d.txt in the File field, file names such as 2009July17.txt are generated, and a new file is created every day.

	If a file already exists, a new version of the file is created. An index, enclosed in parentheses, distinguishes the old file from the new one. For example, if a file named 2009July17.txt already exists, a new file named 2009July17(1).txt is created.

	Providing multiple format specifiers is recommended, as this makes it easier to keep track of when message files were generated.

	If you are using format specifiers to create a custom timestamp, the following format specifiers are required: %Y (year) %m (month) %d (day) %H (hour) %M (minute) %S (second) %f (millisecond) See To File for more information on creating a custom timestamp for your channel's To File destination component.