TRANSFER Reference Manual

ADD-ITEM-REC
TISERV UOW Descriptions
2–32 069139, Update 1 to 40969 Tandem Computers Incorporated
REC-TYPE describes what kind of record is being accessed. This field is not
interpreted by the TRANSFER delivery system, but is stored with the item record
and is returned by the GET-ITEM-REC UOW. Records are stored first in
increasing order by REC-TYPE and, within each REC-TYPE, in increasing order by
REC-SEQ-NUM.
The values 100 through 999 are assigned for use by Tandem application packages.
You can use these values in the REC-TYPE field, but they should have the same
meaning for your application as they do for such software. These record types
include subject text, forward and response text, and unformatted ASCII text. An
item can contain records of many different types and multiple records of the same
type. See the TRANSFER Programming Guide for specific values applicable to
Tandem clients.
REC-SEQ-NUM
is the sequence number to be assigned to the record. The number can range from
1 through 9999; the value 0 is invalid for this field. This field provides unique key
values for multiple records having the same item ID and record type. To assign
the next highest unused sequence number within the record type specified, set
REC-SEQ-NUM to -1. In the response, the sequence number that TISERV assigned
to the record is returned. If the item contains no records, TISERV assigns the
sequence number 1 to the new record.
DATA-BYTE-COUNT
is the length, in bytes, of the record to be added. This must be a value ranging
from 0 through 2000.
CLIENT-DATA
is the data record to be added. The length of this data must be consistent with
DATA-BYTE-COUNT.
Note UOWs must start on word boundaries. If DATA-BYTE-COUNT contains an odd value and other UOWs
follow this one in the request, you must append a one-byte filler field to CLIENT-DATA.