TRANSFER Reference Manual

READ-PROF-REC-A02
TISERV UOW Descriptions
2–434 069139, Update 1 to 40969 Tandem Computers Incorporated
ANY-SEQ-NUM
is meaningful only if ANY-REC-TYPE is set to N.
If ANY-REC-TYPE is set to N and ANY-SEQ-NUM is set to Y, any
subsequent profile records whose REC-TYPE field matches the given REC-
TYPE field can be returned.
If ANY-REC-TYPE is set to N and ANY-SEQ-NUM is set to N, at most one
record whose REC-TYPE and REC-SEQ-NUM match the given values is
returned.
DEPOT-FLAG
determines whether the UOW references a depot profile record or a system
control record.
Y The UOW references a depot profile record, as indicated by CORR-
NAME.
N The UOW references a system control record.
If you make no entry in this field, Y is the default value.
NUM-REQUESTED
specifies the number of records to be returned. The length of the response
depends on how many records you request. The records are returned starting
with the lowest record type and lowest sequence number matching the OPTIONS
selected. All records within a record type are returned in sequence number order
before records of the next higher record type.
MAX-DATASIZE
refers to the data portion of each record; this value is the maximum number of
bytes that can be retrieved. Records that are shorter than this length are
automatically padded with the padding character specified by PAD-CHAR.
Records that are longer than this length are truncated, but the length returned by
DATA-LEN is the actual length prior to truncation. You should specify an even-
numbered maximum length so that all elements of the returned array are word
aligned; but if you specify an odd-numbered maximum length, the TRANSFER
delivery system automatically increments this value by 1. MAX-DATASIZE, like
NUM-REQUESTED, directly affects the length of the response. The maximum
value of MAX-DATASIZE is 1500 bytes.
PAD-CHAR
is the character used to pad returned records that are shorter than the maximum
length specified by MAX-DATASIZE. The PAD-CHAR is usually a space.