TRANSFER Reference Manual

ALTER-FOLDER-ORDER
TISERV UOW Descriptions
2–78 069139, Update 1 to 40969 Tandem Computers Incorporated
To indicate other problems:
4010 E-BAD-TRANSACTION
4051 E-MUST-BE-YN
4052 E-RESERVED-MUST-BE-N
4093 E-SECURITY-VIOLATION
4105 E-CONCURRNT-FLD-UPDATE
4201 E-CONTEXT-ERR
4265 E-INVALID-ORD-DISCIPLN
4266 E-INVALID-APP-ORD-TYPE
4267 E-ITEMS-IN-FLD
4902 E-ERR-PROFILE-FILE
4912 E-ERR-FOLDER-FILE
4968 E-SPECIAL-FLD
RETN-CODE-DETAIL
is an error number returned by a subsystem other than the TRANSFER delivery
system or is a further qualification of an error detected by the TRANSFER delivery
system.
ALTER-FOLDER-ORDER Operation
ALTER-FOLDER-ORDER updates the ordering criteria for the specified folder. Field
values in this UOW indicate the new ordering criteria.
Folder order affects the sequence in which items are saved and subsequently
referenced. Each item saved in a folder has an associated ordering key. The ordering
key can be information associated with the item, such as the name of the item's creator
or information provided by the TRANSFER application. Every folder is ordered by
the value of the ordering key associated with each item stored in the folder.
SCAN-FOLDER, SCAN-FOLDER-B00, and SCAN-FOLDER-BY-KEY UOWs retrieve
item IDs in ordering-key sequence. The SCAN-FOLDER-BY-KEY UOW, however, is
restricted to folders with an APPLIC-DEFINED ordering discipline.
A folder must be empty before you can alter the ordering criteria. If an ALTER-
FOLDER-ORDER UOW is issued for a folder that contains items, TISERV returns the
error E-ITEMS-IN-FLD.