TRANSFER Reference Manual

SAVE-ITEM-BY-KEY
TISERV UOW Descriptions
2–454 069139, Update 1 to 40969 Tandem Computers Incorporated
SAVE-ITEM-BY-KEY Operation
SAVE-ITEM-BY-KEY saves the item identified by ITEM-ID in the folder identified by
FOLDER-NAME at the correspondent depot.
The folder in which the item is being saved must have an ordering discipline of
APPLIC-DEFINED. If a SAVE-ITEM-BY-KEY UOW is issued on a folder with an
ordering discipline other than APPLIC-DEFINED, the error E-INCORRECT-FLD-
ORDER is returned.
You cannot save an item in the same folder more than once. If you try to save the
same item in a folder where the item has already been saved, the warning W-REC-
ALREADY-EXISTS is returned. This restriction applies even if APPLIC-KEY has a
different value. If the item was previously saved, the unsave time specified in a
second request or in additional requests is disregarded.
If the folder does not allow duplicate ordering keys and you attempt to save more than
one item with the same ordering key, the error E-DUP-ORDERING-KEY is returned.
For two ordering keys to be duplicates, they must be exactly the same length (APPLIC-
KEY-LEN) and each character must match exactly.
If a SAVE-ITEM-BY-KEY UOW is issued concurrently with the ALTER-FOLDER-
ORDER UOW, the error E-CONCURRNT-FLD-UPDATE is returned. This restriction
prevents an item from being saved with an incorrect ordering key.
If a SAVE-ITEM-BY-KEY UOW is issued concurrently with the DELETE-FOLDER
UOW, the error E-CONCURRNT-FLD-UPDATE is returned. You cannot save an item
in a folder that is being deleted.
If the RETN-CODE is E-TSCHED-UNAVAIL, the item is not saved in the folder. The
unsave could not be scheduled, so no saving was performed. To save the item, you
must either wait for TSCHED to become available or save the item without an unsave
date and time specified.
To change an unsave time once the time has been set in a folder, you must:
1. Save the item in another folder; this is to prevent the item from being deleted
immediately after the unsave, but before the resave
2. Resave the item in the desired folder with the new time
3. Unsave the item from the first folder, if desired