TRANSFER Reference Manual

READ-PROF-REC-A02
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–437
READ-PROF-REC-A02 Operation
READ-PROF-REC-A02 reads a user-maintained record from the depot Profile file and
returns the data portion of the record. Although the profile record header is not
returned, the record type and sequence number from this header are made available as
separate fields (REC-TYPE and REC-SEQ-NUM).
The TRANSFER delivery system pads or truncates each record to a fixed length before
returning the record. The length of the DATA-STRING in the response is the value
specified by MAX-DATASIZE in the request, rounded up to an even number.
The record is read from the depot (correspondent) identified by CORR-NAME, and is
selected in accordance with REC-TYPE, REC-SEQ-NUM, and specified OPTIONS. If
the DEPOT-FLAG was set to indicate a system control record, the single copy of this
record in the system was read. The record is returned to the array named RECS-
RETURNED.
The following warning conditions can occur:
W-EOF—The number of records satisfying the search criteria is less than or equal
to NUM-REQUESTED. All records satisfying the search criteria are returned.
W-DATA-TRUNCATED—At least one record returned was longer than MAX-
DATASIZE. A truncated version of that record was returned.
W-DATASIZE-ADJUSTED—An odd number was specified for MAX-DATASIZE.
The TRANSFER delivery system used a value that is one more than that specified.
If more than one warning condition occurs, the warning message that appears first in
the preceding list is returned. If W-DATA-TRUNCATED and W-DATASIZE-
ADJUSTED both occur, the message W-DATA-TRUNCATED is returned.