TRANSFER Reference Manual

GET-ITEM-REC
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–305
DATA-STRING
contains the data portion of the record. The length of the data in DATA-
STRING can be modified, but should be consistent with the value in MAX-
DATASIZE. The TRANSFER delivery system assigns only enough space to
accommodate the NUM-RETURNED elements in RECS-RETURNED. If
another UOW response follows this one in the same IPC, this next response
begins immediately after the element last returned.
GET-ITEM-REC Operation
GET-ITEM-REC retrieves one or more data records from the item identified by
STARTING-KEY, and places them in the array named RECS-RETURNED. The values
supplied in OPTIONS and NUM-REQUESTED determine which records are retrieved.
Because of SCREEN COBOL restrictions that prohibit arrays with variable-length
records, you must deal with records of fixed length, as specified in MAX-DATASIZE.
Access to the item is granted if the item is saved in any shared group folders accessible
to the group of which the correspondent is a member. If the correspondent does not
have access privileges to the item specified in the UOW, the error E-ITEM-NOT-
FOUND is returned.
If there are fewer records than specified by NUM-REQUESTED, the number of records
retrieved is less than the number requested. In this case, the warning W-EOF is
returned in the RETN-CODE field.
The TRANSFER delivery system does not retrieve records for different items in a
single UOW (in other words, retrievals cannot cross item boundaries).