Appendix C:

Stats File Formats

The stats files provide information about the use of your BBS in a format compatible with data base software. Templates for using these files with FileMaker Pro are in the "TeleFinder Utilities.sea" self-extracting archive.

This file provides information about the success and duration of each call to your BBS. The file contains a plain ASCII text record for each call. At the end of each record is a single carriage return. A single Tab separates each field from the next.

 


 

"call_stats" File Format

The call_stats file format is:

User Name &endash;- A string containing the user's logon name.

Connect Date &endash;- The date in short, localized format.

Connect Time &endash;- The local time without seconds in localized format.

Elapsed Time of Call &endash;- The duration of the connection in Hours, Minutes, Seconds. The elapsed time contains leading zeros, and is separated by the local time separator.

Elapsed Time of Call &endash;- Total seconds elapsed; numeric string.

Connect Code &endash;- A string expressing the type of connection. The possible codes are:

"OK" &endash;- Normal successful connection.

"PW" &endash;- Call not completed due to password error.

"NU" &endash;- New user registered.

"ER" &endash;- Error or no response during logon.

"LO" &endash;- User connected but did not log on or register.

BBS Node Name &endash;- A string containing the name of the BBS node which made the connection.

 


 

"file_transfer_stats" File Format

This file provides information about files sent to and received from your BBS. The file contains a record for each file transfer attempt. At the end of each record is a single carriage return. A single Tab separates each field from the next.

 

The file_transfer_stats file format is:

User Name &endash;- The user's logon name; an alpha-numeric string.

Date of completion &endash;- The date in short, local format.

Time of completion &endash;- Local time without seconds in local format.

File Name &endash;- The name of the file; an alpha-numeric string.

File's Folder Name &endash;- The name of the folder the file is in; an alpha-numeric string.

File's Volume Name &endash;- The name of the volume the file is on; an alpha-numeric string.

Elapsed Time of Transfer &endash;- The duration of the transfer. Hours, minutes, seconds, with leading zeros separated by the local time separator.

Kilobytes Sent &endash;- Kilobytes successfully sent; a numeric string.

File Size &endash;- File size in kilobytes; a numeric string.

CPS of Transfer &endash;- Average characters per second for the transfer; a numeric string.

Re-Transmits &endash;- The number of blocks re-transmitted to correct errors; a numeric string.

Connect Rate BPS &endash;- Bits per second from connect message, if available; a numeric string.

Completion Code &endash;- A string expressing the success or failure of the transfer. The possible codes are:

"XMRX" &endash;- file received with XMODEM successfully.

"XMTX" &endash;- file sent with XMODEM successfully.

"XMFL" &endash;- XMODEM transfer failed.

"ZMRX" &endash;- file received with ZMODEM successfully.

"ZMTX" &endash;- file sent with ZMODEM successfully.

"ZMFL" &endash;- ZMODEM transfer failed.

"BGRX" &endash;- file received with Background Protocol successfully.

"BGTX" &endash;- file sent with Background Protocol successfully.

"BGFL" &endash;- Background Protocol transfer failed.

 

BBS Node Name &endash;- A string containing the name of the BBS node which transferred the file.

Full Path &endash;- A string containing the the full path to the file.