TRANSFER Programming Manual

Packages and Items
Conventions for Application Interface
069138, Update 1 to 040970 Tandem Computers Incorporated A–5
If a user provides text for the subject field while creating an electronic mail message
through a Tandem PS MAIL client, the client inserts within a package header a subject
text record with a REC-TYPE of 115 and a sequence number (REC-SEQ-NUM) of 1
within that record type. When the client reads a package, it searches for the subject
text record as a record with REC-TYPE 115 and REC-SEQ-NUM 1. If such a record is
not present, the client selects the record with the lowest REC-SEQ-NUM having a
REC-TYPE of 115.
The subject text record contains up to 140 bytes of ASCII text. This text must consist of
displayable characters only. When the Tandem client reads this record, it requests no
more than 140 bytes. If the record contains fewer bytes, it is padded with blanks to 140
bytes; if the record contains more than 140 bytes, the excess bytes are truncated from
the record.
The unformatted text record (REC-TYPE 120) can contain up to 2000 bytes of ASCII
text. A client looks for unformatted text records either in the package header or in a
separate item identified by either ITEM-TYPE 120 or ITEM-TYPE 121. Any item
created by the Tandem client with ITEM-TYPE 120 or 121 contains only records with
REC-TYPE 120. Records with REC-TYPE 120 are displayed from the package header.
The recipients of a package are displayed using the records in the package header with
REC-TYPE values of 340 and 323, indicating TO-recipients and BCC-recipients,
respectively. These records are each 70 bytes long and contain ASCII text, including
lists of recipient names separated by commas. The recipient names are resolved as
fully as possible at the time the package is submitted and are stored in that form. For
records of REC-TYPE 340 and 323, the REC-SEQ-NUM values must start with 1 and
must then increase by 1 for each additional record.