TRANSFER Reference Manual

SAVE-ITEM
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–443
SAVE-ITEM Operation
SAVE-ITEM saves the item identified by ITEM-ID in the folder identified by FOLDER-
NAME at the correspondent depot. The saved item remains in the folder until it either
is automatically removed after the folder item retention time or until you explicitly
unsave it with the UNSAVE-ITEM UOW in this or a later session.
Items are stored according to the folder's ordering criteria, as follows:
TIME-SAVED (T)—The item is saved in chronological order.
CREATOR-NAME (C)—The item is saved in alphabetic order by the node name
and then the correspondent name of the creator.
EARLIEST-DELIV-DATE (E)—A package header item that is unalterable is saved
in earliest delivery date order. An item that is not a package header or is a
package header and is alterable is saved in creation date order.
If a folder has an APPLIC-DEFINED ordering discipline, items must be saved with the
SAVE-ITEM-BY-KEY UOW. If a SAVE-ITEM is issued on a folder with APPLIC-
DEFINED ordering, the error E-INCORRECT-FLD-ORDER is returned.
If a folder was created by TRANSFER A01/A02, items are ordered in ascending
sequence by TIME-SAVED (T), unless the folder-ordering criteria were subsequently
altered by the ALTER-FOLDER-ORDER UOW.
The item retention time for items saved with the SAVE-ITEM UOW is always set to the
default for the folder.
If a folder does not allow duplicate ordering keys, any attempt to save more than one
item with the same ordering key returns the error E-DUP-ORDERING-KEY.
If a SAVE-ITEM UOW is issued concurrently with the ALTER-FOLDER-ORDER
UOW, the error E-CONCURRNT-FLD-UPDATE is returned. This error prevents an
item from being saved with an incorrect ordering key.
If a SAVE-ITEM 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
while the folder is being deleted.
If the depot storage statistics facility is active, statistics increase depending on the
value of COUNT-ITEMS-ONCE and the status of the item.