File Name Formats

The following table lists the file name format specifiers that can be used in various sections where file name formats are specified. Certain specifiers are common, i.e. they can be used for each file name specification. Certain specifiers are restricted, e.g. the format that is using a part of message heading cannot be used for file renaming (because there is no message heading involved).

Format Meaning Form
Common specifiers
time-related specifiers are based on the time stamp associated with the file or message
%OC CCCC of originating centre 4 letters
%DY year 4 digits
%Dy year (last two digits only) 2 digits
%Dc year since 1988 (A = 1988) 1 letter
%Dm month of year 2 digits
%Dd day of month 2 digits
%Dj day of year 3 digits
%Dn current month's name (3-letter abbreviation) 3 letters
%DH hour of day 2 digits
%DM minute of hour 2 digits
%DS second of minute 2 digits
%Do{xu} offset all subsequent date/time elements (%Dx) by x (positive or negative number). The u defines unit for the offset - m means minutes; h means hours; d means days
%CG channel group number digits
%CN channel number digits
File Renaming specifiers
Only the common specifiers are allowed
File Relay channel - File name format
%FN use original file name
%FN%Sn skip n starting characters (e.g. %FN%S4 will change "filename.dat" to "name.dat")
%FN%En skip n ending characters (e.g. %FN%E4 will change "filename.dat" to "filename")
%{FN:n} substring of the original file name starting at offset n (e.g. %{FN:4} will change "filename.dat" to "name.dat")
%{FN:n:m} substring of the original file name starting at offset n, with the length of m characters (e.g. %{FN:4:4} will change "filename.dat" to "name")
%{FN::m} substring of the original file name starting at the beginning, with the length of m characters (e.g. %{FN::4} will change "filename.dat" to "file")
string
%FV file version number (short) 2 digits
%FL file version number (long) 8 digits
%Fn number of digits used to represent the file version number (1-8) n digits
File Relay / File assembly channel - Temporary file name format
same as File Relay channel - File name format and:
%FN use original file name string
%TN trial number, in case of unsuccessful upload when additional upload is attempted digit(s)
Input asynchronous channel - File name (with save to file option)
%FV file version number (short) 2 digits
%FL file version number (long) 8 digits
%Fn number of digits used to represent the file version number (1-8) digit(s)
Message Conversion - File name format
%TT TTAA part of the message heading 4 letters
%ix ii part of the message heading
x = replacement sign if no ii
x = $: suppressed if no ii
letters
%CC CCCC part of the message heading (issuing centre indicator) 4 letters
%YG YYGGgg part of the message heading 6 digits
%Bx BBB part of the heading of the first message
x = replacement sign if no BBB
x = $: suppressed if no BBB and previous '_' or '-' character will be removed
3 letters
%GY YY of the message heading (the day indicator of the DTG group) 2 digits
%GG GG of the message heading (the hour indicator of the DTG group) 2 digits
%Gg gg of the message heading (the minute indicator of the DTG group) 2 digits
%YY year of the message date (detected internally, not from DTG) 4 digits
%Yy year (last two digits) of the message date (detected internally, not from DTG) 2 digits
%Ym month of the message date (detected internally, not from DTG) 2 digits
%P output priority of the message 1 digit
File Assembly channel - File name format
same as message conversion (heading information substituted from the first message in the assembled file) and %FV, %FL, %Fn

Any characters may be inserted in between the format identifiers; they will be taken as they are.

If the file version identifier (%FV) is not part of the format string it is assumed that the actual second is part of the name and there will be a delay of at least 1 second between new files to avoid having duplicated names, which may led to a loss of data. For VMSsystems the final file name should include a dot ('.') otherwise the temporary file name will be appended to the final file name because of the renaming behaviour of the VMS.

Example
Examples of a File Name Format
format vw_%Dy_%Dm%Dd--%TT%i$-%CC-%YG-%B+.%FV
heading line SMDL01 EDZW 121200
actual time 12.07.2004
file version 23
resultant name vw_04_0712--SMDL01-EDZW-121200-+++.23
format vw_%Dy_%Dm%Dd--%TT%i$-%CC-%YG-%B$.%FV
heading line SMDL01 EDZW 121200
actual time 12.07.2004
file version 03
resultant name vw_04_0712--SMDL01-EDZW-121200.03
format vw_%Dy_%Dm%Dd--%TT%i$‑%CC‑%YG‑%B+.%FL
heading line PGZZ01 EGRR 121200
actual time 12.07.2004
file version 23
resultant name vw_04_0712--PGZZ01-EGRR-121200-+++.0023
format %TT%i$_%CC_%YG_%B$.msg
heading line PGZZ01 EGRR 121200
actual time 12.07.2004
file version 23
resultant name PGZZ01_EGRR_121200.msg
format %Do{-5m}%DY_%Dm_%Dd/*
actual time 20.03.2015 00:03:00
resultant name pattern 2015_03_19/*
format %Do{-5m}%DY_%Dm_%Dd/*
actual time 20.03.2015 00:05:00
resultant name pattern 2015_03_20/*