TRANSFER Reference Manual

ALTER-FOLDER-ORDER
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–75
FOLDER-NAME
is the name of an existing folder that is empty. You can enter the special folder
names INBOX, WASTEBASKET, and OUTLOG if the folders are empty.
These special folders cannot have APPLIC-DEFINED (A) ordering discipline.
An attempt to use APPLIC-DEFINED ordering for these folders returns the
error E-SPECIAL-FLD.
These special folders must allow duplicates. An attempt to set the ALLOW-
DUPLICATES option to N for these folders returns the error E-SPECIAL-FLD.
ORDERING-DISCIPLINE
specifies what information TISERV should use as the ordering key when saving
items in the folder as follows:
TIME-SAVED (T)
saves items in chronological order of the time a SAVE-ITEM UOW is executed
for the items. TRANSFER versions A01 and A02 use the TIME-SAVED
ordering discipline exclusively. Folders created by TRANSFER A01 or A02
are ordered in ascending sequence by time saved unless the ordering criteria is
altered.
CREATOR-NAME (C)
saves items in alphabetic order by the node name and then the correspondent
name of the creator.
EARLIEST-DELIV-DATE (E)
saves items that are package headers and are unalterable by earliest delivery
date; save items that are not package headers or are package headers and are
alterable by creation date.
APPLIC-DEFINED (A)
saves items in order of the ordering key specified by the application in the
SAVE-ITEM-BY-KEY UOW. An application can specify the same ordering key
for multiple items if duplicates are allowed; if duplicates are not allowed, the
application is responsible for ensuring the uniqueness of the key.
If this field contains a character other than T, C, E, or A, TISERV returns the error
E-INVALID-ORD-DISCIPLN.