home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / bbs / qwkdocs / qwkspec.arj / MESSAGES.TXT < prev    next >
Encoding:
Text File  |  1991-05-28  |  3.3 KB  |  74 lines
  1.  
  2.  
  3.               Format of the exported messages in Messages.Dat
  4.  
  5.  
  6.          This file contains records with a length of 128 bytes.  There
  7.          are 3 types of these records: (1) Packet Header, (2) Message
  8.          Header, and (3) Message Text.  All unused fields in the
  9.          records are normally filled with spaces, although you will
  10.          sometimes find the final Message text record will be filled
  11.          with nulls (#0) after the last text.
  12.  
  13.  
  14.                               Packet Header
  15.  
  16.          Packet Header - is always the first record in the file and
  17.          only occurs once.  It contains only normal ascii text
  18.          (limitted to at most 128 characters) and should always
  19.          start with "Produced by ".  The remaining text normally
  20.          includes a product name and copyright message.
  21.  
  22.  
  23.                               Message Header
  24.  
  25.          A message header immediately preceeds zero or more message
  26.          text records.  Each Message header has the following
  27.          format:
  28.  
  29.          Start
  30.           Pos  Length              Description
  31.         ------ ------ -----------------------------------------
  32.            1      1   Message status flag (see below)
  33.            2      7   Message number (ascii left justified)
  34.            9      8   Date (MM-DD-YY)
  35.           17      5   Time (HH:MM)
  36.           22     25   To (left justified space filled - uppercase)
  37.                       (Be sure to check the to field to spot
  38.                       configuration type messages)
  39.           47     25   From (left justified space filled - uppercase)
  40.           72     25   Subject (left justified space filled - uppercase)
  41.                       (a subject starting "NE:" should not be
  42.                       echoed into a network)
  43.           97     12   Password (not really used leave blank)
  44.          109      8   Message reference number (ascii left justified)
  45.          117      6   Number of blocks (ascii left justified - number
  46.                       of 128 byte blocks including 1 for the message
  47.                       header)
  48.          123      1   Message active (ß or #225 = Active,
  49.                       Γ or #226 = Inactive)
  50.          124      1   Conference number (Binary byte)
  51.  
  52.          Message Status Flag has the following possibilities:
  53.  
  54.          '~'   Private, unread       ' '  Public, read
  55.          '`'   Private, read         '-'  Public, unread
  56.          '*'   Private, unread
  57.          '+'   Private, read
  58.  
  59.  
  60.                              Message Text Records
  61.  
  62.          The message text records immediately follow the the message
  63.          header.  They contain straight ascii text (lines are
  64.          normally limitted to 72 chars/line although you may see
  65.          longer lines).  Each line is followed by a "π" or #227
  66.          character to mark the end of the line (in place of the normal
  67.          CR/LF that would exist in a straight text file).  The text
  68.          continues consecutavly and text lines do continue across
  69.          block boundaries.  Some systems may have problems with
  70.          messages longer than 99 lines, although more recently this
  71.          no longer seems to be a limit.  The last block should be
  72.          padded with blanks to fill the block, although on input you
  73.          may find it padded with nulls (#0).
  74.