TRANSFER Reference Manual

CREATE-FOLDER-B00
TISERV UOW Descriptions
2–166 069139, Update 1 to 40969 Tandem Computers Incorporated
APPLIC-ORDER-TYPE
can be used to distinguish 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 and 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 the 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 of
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 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.