TRANSFER Reference Manual

UNSAVE-ITEM
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–507
UNSAVE-ITEM Operation
UNSAVE-ITEM removes the item identified by ITEM-ID from the folder identified by
FOLDER-NAME.
Prior to any UNSAVE-ITEM request for an item, you can issue a SAVE-ITEM request
to save the item in the WASTEBASKET folder. If you save the item, the application
can access the item and reclaim it should the need arise at any time before ending the
current session.
When an item is unsaved from a folder, the item is scheduled for deletion from the
system. The item descriptor and associated data are deleted if three conditions are
satisfied:
1. The item is not saved in any folder at the particular node.
2. The item is not the component of any other item.
3. The item is a package and the delivery window has passed.
If a transaction containing an UNSAVE-ITEM UOW is aborted after the UNSAVE is
completed, the folder can have an invalid reference to the deleted item. Subsequent
SCAN-FOLDER UOWs for the folder return the item ID, but UOWs requiring access to
the item descriptor or data result in an ITEM-NOT-FOUND error code. To avoid such
a situation, save the item in the WASTEBASKET folder before removing it from the
desired folder. Issue the SAVE-ITEM in the WASTEBASKET in the same TMF
transaction as the UNSAVE-ITEM. The TRANSFER delivery system keeps items in the
WASTEBASKET until the current session ends.