====== CHAIN.TXT ======

''CHAIN.TXT'' drop file format invented by Wayne Bell to interface [[wp>WWIV]] BBS software with external programs((referred to as "chains" in WWIV parlance)).

The ''CHAIN.TXT'' is a plain text file consisting of CRLF-delimited lines, parsed one line at a time.

^Line No  ^Example              ^Description                                     ^
^1        |27                   |User Number                                     |
^2        |EDITOR               |User's Handle                                   |
^3        |Bob Marx             |User's real name                                |
^4        |Zapp                 |Callsign                                        |
^5        |25                   |User's Age                                      |
^6        |M                    |Gender                                          |
^7        |100                  |GOLD                                            |
^8        |10/14/91             |Date of Current/Last Login                      |
^9        |80                   |Screen Columns                                  |
^10       |25                   |Screen Rows                                     |
^11       |255                  |Security Level                                  |
^12       |0                    |1 = CoSysop, 0 = User                           |
^13       |0                    |1 = Sysop, 0 = User                             |
^14       |1                    |1 = ANSI, 0 = NO ANSI                           |
^15       |1                    |1 = Remote, 0 = Local console                   |
^16       |86220                |Seconds remaining until logoff                  |
^17       |C:\WWIV\GFILES\      |Directory where Text files are to be stored     |
^18       |C:\WWIV\DATA\        |Directory where WWIV and network files are found|
^19       |911022.LOG           |Name of Current Daily Log File                  |
^20       |2400                 |''%%"KB"%%'' if local login, or BAUDRATE if remote login|
^21       |0                    |COM Port                                        |
^22       |B.U.G. Bytes BBS     |BBS Name                                        |
^23       |Pat Marr             |SYSOP's Name                                    |
^24       |64000                |Time of Call, Expressed as Seconds Past Midnight|
^25       |0                    |Seconds on the system so far (time used this call)|
^26       |1079                 |Uploads, expressed as KILOBYTES Uploaded        |
^27       |19                   |Uploads, expressed as # OF FILES Uploaded       |
^28       |2                    |Downloads, expressed as KILOBYTES               |
^29       |2                    |Downloads, expressed as # OF Files              |
^30       |8N1                  |8 Bits, No Parity, 1 Stop Bit                   |
^31       |2400                 |COM port baud (DTE) rate                        |
^32       |0                    |WWIVnet node number                             |

Two fields are commonly transposed or inverted by door authors: the CoSysop flag (line 12) comes //before// the Sysop flag (line 13), and line 15 is ''1'' for a remote caller, ''0'' for the local console.

Synchronet writes lines 01 through 30. Lines 31 and 32 are written by WWIV itself and may be absent from ''CHAIN.TXT'' files created by other BBS software.

Synchronet writes lines 01 through 06 in **upper case**, including the user's handle and real name.

===== See Also =====
  * [[:ref:|ref index]]
  * [[ref:files#drop_files]]
  * [[https://docs.wwivbbs.org/en/wwiv51/doors/|Official WWIV reference]]

{{tag>chain.txt}}
