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

%DZ

millisecond part of the current UTC time available from MW 1.7.0, VW 4.0.4

3 digits, zero padded

%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. For example, %Do{-2h} means offset -2 hours, ie. expression will look 2 hours in the past.

%CG

output channel group number

3 digits, zero-padded

%CN

output channel number

3 digits, zero-padded

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

%FN

use original file name

string

%TN

trial number. If upload is unsuccessful, this number will be incremented when next 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)

%P

output priority of the file

1-2 digits

Message Conversion - File name format

%TT

TTAA part of the message heading

4 letters

%T1

T1 part of the message heading

1 letter

%T2

T2 part of the message heading

1 letter

%A1

A1 part of the message heading

1 letter

%A2

A2 part of the message heading

1 letter

%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-2 digits

%IG

input channel group number of the (first) message assembled to the file available from MW 1.8, VW 4.2

3 digits, zero-padded

%IN

input channel number of the (first) message assembled to the file available from MW 1.8, VW 4.2

3 digits, zero-padded

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/*