TRANSFER Reference Manual

ALTER-FOLDER-DESCR
TISERV UOW Descriptions
2–70 069139, Update 1 to 40969 Tandem Computers Incorporated
ASCENDING-SEQUENCE
determines whether items are saved within the folder in ascending or
descending key order.
Y Save items in ascending key order.
N Save items in descending key order.
Variable length APPLIC-DEFINED keys that are used with descending key
order do not collate in the correct order unless the application pads the key
with enough bytes to make it a constant length for all entries in the folder.
A folder ordered by CREATOR-NAME in descending sequence is an example
of a field that is variable length and is automatically padded to be 120 bytes.
For a folder ordered by CREATOR-NAME in ascending sequence, the amount
of disk space used corresponds directly to the length of creator names and the
number of items saved in a folder. Considering creator names of a maximum
of 20 characters, the cost of descending sequence over ascending sequence in
terms of disk space is approximately 100 bytes per item saved in a folder
ordered by CREATOR-NAME.
ALLOW-DUPLICATES
determines whether or not multiple items with the same ordering key can be
saved in a folder.
Y Duplicate ordering keys are allowed.
N Duplicate ordering keys are not allowed. This field has no effect if the
ORDERING-DISCIPLINE is TIME-SAVED (T); TIME-SAVED
ordering already ensures a unique key. This option is illegal for
special folders INBOX, OUTLOG, and WASTEBASKET.
RESERVED-2 through RESERVED-7
are reserved for use by Tandem. These fields must be set to N.
ITEM-RETENTION-TIME
specifies the length of time an item is stored in the folder if no retention time was
specified when the item was saved.
QUANTITY
must be in the range 0 through 9999.
UNITS
is the unit of time denoted in QUANTITY. UNITS can be set to D (for days), H
(for hours), or M (for minutes). For any unit, 0 means no maximum (items are
saved forever).