TRANSFER Reference Manual

GET-ITEM-REC-B40
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–311
DATA-LEN
contains the length of the data (non-key) portion of the record prior to
retrieval, regardless of the value specified by MAX-DATASIZE.
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 MAX-DATASIZE.
The TRANSFER delivery system assigns only enough space to accommodate the
NUM-RETURNED elements in RECS-RETURNED. If another UOW response
follows the GET-ITEM-REC-B40 response in the same IPC, the next response
begins immediately after the last GET-ITEM-REC-B40 element.
GET-ITEM-REC-B40 Operation
GET-ITEM-REC-B40 retrieves one or more data records from the item identified by
STARTING-KEY, and places them in the array named RECS-RETURNED. Unlike
GET-ITEM-REC, this UOW also retrieves the data records of external objects (External
objects are EDIT or TTEXT files managed by the GUARDIAN 90 operating system);
the TRANSFER delivery system treats each line in the file as a single record.
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.
To retrieve records from an external object attachment for an item or primary external
object, set the EXTOBJ-REC field to Y. (If you set this field to N, the normal item data
is retrieved using REC-TYPE and REC-SEQ-NUM in the STARTING-KEY field, and
the fields pertaining to external objects are ignored.) In addition, you must specify the:
Type of parent (ITEM or primary object in the PARENT-IS-ITEM field).
Type of attachment (primary or alternate in the ALTERNATE-ATTACHMENT
field).
Position in the list of attachments where the external object resides (in the EXTOBJ-
REL-POSITION field).
Record number of the record to be read in the external object file (in the EXTOBJ-
REC-NUM field). To read the first record in the file, set this field to -1. To read the
file sequentially, set the EXTOBJ-REC-NUM field in the request UOW to the
EXTOBJ-REC-NUM value for the last record returned in the previous request.
The values supplied in OPTIONS and NUM-REQUESTED determine which records
are retrieved. Because SCREEN COBOL prohibits arrays with variable-length records,
you must deal with records of fixed length, as specified in MAX-DATASIZE.
The combination of OPTIONS selected determines which portion of the record key
(item ID, record type, and sequence number) is used in selecting the record. Whether