2003-07-13 15:21:46 +00:00
|
|
|
<HTML>
|
|
|
|
|
<!-- $Id$ -->
|
|
|
|
|
<HEAD>
|
|
|
|
|
<TITLE>Netmail Tracking (Via)</TITLE>
|
|
|
|
|
</HEAD>
|
|
|
|
|
|
|
|
|
|
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
|
|
|
|
|
<BODY
|
|
|
|
|
BGCOLOR="#FFFFFF"
|
|
|
|
|
TEXT="#000000"
|
|
|
|
|
LINK="#0000FF"
|
|
|
|
|
VLINK="#000080"
|
|
|
|
|
ALINK="#FF0000"
|
|
|
|
|
>
|
|
|
|
|
<PRE>
|
|
|
|
|
**********************************************************************
|
|
|
|
|
FTSC FIDONET TECHNICAL STANDARDS COMMITTEE
|
|
|
|
|
**********************************************************************
|
|
|
|
|
|
|
|
|
|
Publication: FTS-4009
|
|
|
|
|
Revision: 1
|
|
|
|
|
Title: Netmail tracking (Via)
|
|
|
|
|
Author: FTSC
|
|
|
|
|
Issue Date: 16 May 2003
|
|
|
|
|
Review Date: 16 May 2005
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
Contents:
|
|
|
|
|
1. Current practice
|
|
|
|
|
2. Control paragraph specification
|
|
|
|
|
3. Examples
|
|
|
|
|
4. Deprecated formats
|
|
|
|
|
A. References
|
|
|
|
|
B. History
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
Status of this document
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
This document is a Fidonet Technical Standard (FTS), issued by the
|
|
|
|
|
FTSC for the benefit of the Fidonet community.
|
|
|
|
|
|
|
|
|
|
This document is based on the FSP-1010 proposal by Colin Turner,
|
|
|
|
|
2:443/13, and Joaquim Homrighausen, 2:201/330.
|
|
|
|
|
|
|
|
|
|
This document is released to the public domain, and may be used,
|
|
|
|
|
copied or modified for any purpose whatsoever.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. Current practice
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
|
As Netmail messages are routed through FidoNet, or as they are
|
|
|
|
|
processed on a system, Via control paragraphs are added to track
|
|
|
|
|
their progress.
|
|
|
|
|
|
|
|
|
|
The Via control paragraphs are stored in a block which starts after
|
|
|
|
|
any message text. New Via lines should be added to the end of the
|
|
|
|
|
block separated from the preceding control paragraph by a single
|
|
|
|
|
ASCII carriage-return character (0Dh). There is no limit to the
|
|
|
|
|
number of Via control paragraphs in each message.
|
|
|
|
|
|
|
|
|
|
Note that the "Via" tag is in mixed case, not all upper case like
|
|
|
|
|
most control tags.
|
|
|
|
|
|
|
|
|
|
A Via control paragraph is typically added:
|
|
|
|
|
|
|
|
|
|
when a Netmail packer packs the Netmail for transmission to
|
|
|
|
|
another system;
|
|
|
|
|
|
|
|
|
|
when a netmail tracker inspects a Netmail.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2. Control paragraph specification
|
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
|
|
The Via control paragraph is formatted as a number of fields,
|
|
|
|
|
separated by single space (20h) characters, as follows
|
|
|
|
|
|
|
|
|
|
^AVia <FTN Address> @YYYYMMDD.HHMMSS[.Precise][.Time Zone]
|
|
|
|
|
<Program Name> <Version> [Serial Number]<CR>
|
|
|
|
|
|
|
|
|
|
Where ^A denotes the ASCII <SOH> (01h) character, and <CR> is the
|
|
|
|
|
carriage-return character (0Dh).
|
|
|
|
|
|
|
|
|
|
The fields are defined as follows:
|
|
|
|
|
|
|
|
|
|
FTN Address
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
This field is mandatory and is the FidoNet Technology address of
|
|
|
|
|
the system inserting the control paragraph, using standard Fidonet
|
|
|
|
|
addressing notation, Z:N/F[.P][@domain]
|
|
|
|
|
|
|
|
|
|
@YYYYMMDD.HHMMSS
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
This field is mandatory and consists of a time stamp. This is the
|
|
|
|
|
time at which the stamp was placed. The subcomponents are
|
|
|
|
|
|
|
|
|
|
YYYY, the calendar year, in full four digit, decimal form;
|
|
|
|
|
MM, the calendar month, in the range 01 to 12, this must be a
|
|
|
|
|
zero padded, two digit decimal number;
|
|
|
|
|
DD, the day of the month, in the range 01 to 31, this must be a
|
|
|
|
|
zero padded, two digit decimal number;
|
|
|
|
|
HH, hours, in the range 00 to 23, this must be a zero padded,
|
|
|
|
|
two digit decimal number;
|
|
|
|
|
MM, minutes, in the range 00 to 59, this must be a zero padded,
|
|
|
|
|
two digit decimal number;
|
|
|
|
|
SS. seconds, in the range 00 to 59, this must be a zero padded,
|
|
|
|
|
two digit decimal number.
|
|
|
|
|
|
|
|
|
|
Precise
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
This field is optional and takes the form of extra precision in the
|
|
|
|
|
time stamp.
|
|
|
|
|
|
|
|
|
|
If this field is present:
|
|
|
|
|
|
|
|
|
|
it must begin with a single period character;
|
|
|
|
|
|
|
|
|
|
this period must be followed by one or more decimal digits;
|
|
|
|
|
|
|
|
|
|
the field has ended when another period or space is encountered;
|
|
|
|
|
|
|
|
|
|
each decimal digit in the field following this character
|
|
|
|
|
represents the time of the via line in fractions of a second,
|
|
|
|
|
such that the the first digit represents tenths of a second,
|
|
|
|
|
the second digit represents hundreds of a second and so on.
|
|
|
|
|
|
|
|
|
|
Robust implementations must check to ensure this field is numeric to
|
|
|
|
|
avoid confusion with the Time Zone field.
|
|
|
|
|
|
|
|
|
|
Time Zone
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
This field is optional, and must be a short, widely accepted
|
|
|
|
|
alphabetical abbreviation of the time zone that the time stamp
|
|
|
|
|
in the Via line pertains to.
|
|
|
|
|
|
|
|
|
|
The use of various Time Zone values is deprecated, implementations
|
|
|
|
|
should attempt to convert the timestamp in the control paragraph to
|
|
|
|
|
Universal Time (GMT or UTC) and use the "UTC" Time Zone indicator,
|
|
|
|
|
where possible.
|
|
|
|
|
|
|
|
|
|
The Time Zone field may only be omitted when it is not possible for
|
|
|
|
|
the implementation to determine the correct offset from UTC, and in
|
|
|
|
|
this case the time stamp must represent local time on the generating
|
|
|
|
|
system.
|
|
|
|
|
|
|
|
|
|
Robust implementations must check to ensure this field is not
|
|
|
|
|
numeric to avoid confusion with the Precise field.
|
|
|
|
|
|
|
|
|
|
Program Name
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
This field is a mandatory string field of up to ten (10) characters
|
|
|
|
|
naming the product inserting the Via line.
|
|
|
|
|
|
|
|
|
|
Version
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
This field is a mandatory string field of up to ten (10) characters
|
|
|
|
|
specifying the version of the product inserting the Via line,
|
|
|
|
|
including any alpha, beta or gamma status.
|
|
|
|
|
|
|
|
|
|
Serial Number
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
This field is an optional string field of up to ten (10) characters
|
|
|
|
|
identifying the specific copy of the product inserting the Via line.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3. Examples
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
Example of valid usage are
|
|
|
|
|
|
|
|
|
|
^AVia 1:2/3 @19990305.043212.UTC O/T-Track+ 2.69
|
|
|
|
|
^AVia 1:2/3@fidonet @19980331.231202.UTC FrontDoor 2.32.mL
|
|
|
|
|
^AVia 1:2/3.0 @19990101.002102.UTC FastEcho 1.46.1 21321
|
|
|
|
|
^AVia 1:2/3 @19990323.230132 FakeMail 1.2
|
|
|
|
|
^AVia 1:2/3 @20030403.182824.UTC Gleipner/Java 1.0/pre
|
|
|
|
|
^AVia 1:2/3 @20030403.193223.UTC hpt 1.2.2-stable/os2
|
|
|
|
|
^AVia D'Bridge 1.58 1:2/3 04/03 20:47
|
|
|
|
|
^AVia 1:2/3@fidonet @20030404.030004.UTC O/T-Track+ 2.66b
|
|
|
|
|
^AVia Squish/386 1.11 1:2/3, Thu Apr 03 2003 at 23:16 UTC
|
|
|
|
|
^AVia 1:2/3 FTrack 3.1/W32 04 Apr 2003 09:33:07 UTC+1000
|
|
|
|
|
^AVia ifmail 1:2/3@fidonet, Fri Apr 11 2003 at 06:01 (2.15)
|
|
|
|
|
^AVia RTrk+ 1:2/3@fidonet, Apr 22 2003 at 18:25
|
|
|
|
|
^AVia BBBS/NT v4.01 Flag-4 1:2/3.0, @030505155114 EDT+5
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4. Deprecated formats
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
Some other formats for the Via line are in use today, but these
|
|
|
|
|
formats are rather variable and inconsistent in nature, while
|
|
|
|
|
the format specified above is both more widespread and more
|
|
|
|
|
consistent.
|
|
|
|
|
|
|
|
|
|
New implementations may need to parse these formats, but must not
|
|
|
|
|
generate them.
|
|
|
|
|
|
|
|
|
|
The formats in use include, but are not limited to
|
|
|
|
|
|
|
|
|
|
<NAME> [VERSION] [SERIAL] <ADDRESS> <TIMESTAMP> <TIMEZONE>
|
|
|
|
|
<NAME> <ADDRESS>, <TIMESTAMP> <TIMEZONE> <VERSION>
|
|
|
|
|
|
|
|
|
|
Not that the time stamp in the above formats is also widely
|
|
|
|
|
variable, and takes forms which include, but may not be limited to
|
|
|
|
|
|
|
|
|
|
<Day> <Month> <Year> AT <Hour>:<Min>:[Sec]
|
|
|
|
|
<Day of Week> <Month> <Day of Month> <Year> <Hour>:<Min>:<Sec>
|
|
|
|
|
ON <Day of Month> <Month> <Year> <Hour>:<Min>:<Sec>
|
|
|
|
|
<Month>/<Day> <Hour>:<Min>
|
|
|
|
|
@YYMMDDHHMMSS
|
|
|
|
|
|
|
|
|
|
In the last listed format, observe in particular the two digit year
|
|
|
|
|
and lack of period to separate the date from time.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
A. References
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
[FTS-1] "A Basic FidoNet(r) Technical Standard Revision 16", Randy
|
|
|
|
|
Bush. September 1995.
|
|
|
|
|
|
|
|
|
|
[FSC-46] "A Product Identifier for FidoNet Message Handlers",
|
|
|
|
|
Joaquim Homrighausen, August 1994.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
B. History
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
Rev.1, 20030516: First release (revised from FSP-1010 by FTSC; note
|
|
|
|
|
the lack of a colon after the "Via" tag)
|
|
|
|
|
|
|
|
|
|
**********************************************************************
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<A HREF="index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Back" Border="0">Go Back</A>
|
|
|
|
|
|
|
|
|
|
</BODY>
|
|
|
|
|
</HTML>
|
