TRANSFER Reference Manual

ALTER-FOLDER-ORDER
TISERV UOW Descriptions
2–76 069139, Update 1 to 40969 Tandem Computers Incorporated
APPLIC-ORDER-TYPE
distinguishes between types of ordering disciplines and is meaningful only if
ORDERING-DISCIPLINE is APPLIC-DEFINED (A). If ORDERING-DISCIPLINE
is not APPLIC-DEFINED, the field is ignored.
This field is not interpreted by the TRANSFER delivery system, but is stored as
part of the folder's ordering criteria. The field is returned by the GET-FOLDER-
ORDER and GET-FOLDER-DESCR UOWs. Your TRANSFER application can
have several types of APPLIC-DEFINED ordering; you can use APPLIC-ORDER-
TYPE to distinguish between types.
The field can have a value from 0 through 9999; values 100 through 999 are
reserved for Tandem. If a number outside the range from 0 through 9999 is
specified, TISERV returns the error E-INVALID-APP-ORD-TYPE.
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 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 you can save multiple items with the same
ordering key 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.