TRANSFER Reference Manual

CREATE-FOLDER-B10
TISERV UOW Descriptions
2–172 069139, Update 1 to 40969 Tandem Computers Incorporated
OPTIONS
provides additional criteria for saving items.
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 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 ensures a unique key.
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 can be stored in the depot:
QUANTITY
must be in the range 0 through 9999.