TRANSFER Reference Manual

SAVE-ITEM-B00
TISERV UOW Descriptions
2–448 069139, Update 1 to 40969 Tandem Computers Incorporated
-4269 W-TIME-TOO-LONG
4906 E-ERR-ITEMDESC-FILE
4912 E-ERR-FOLDER-FILE
4922 E-ERR-INV-FOLDER-FILE
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.
SAVE-ITEM-B00 Operation
SAVE-ITEM-B00 saves the item identified by ITEM-ID in the folder identified by
FOLDER-NAME at the correspondent depot.
The folder in which an item is being saved must not have an ordering discipline of
APPLIC-DEFINED. If a SAVE-ITEM-B00 is issued on a folder with APPLIC-DEFINED
ordering discipline, E-INCORRECT-FLD-ORDER is returned.
An item cannot be saved in the same folder more than once. If an application tries to
save the same item in a folder where the item has already been saved, the warning W-
REC-ALREADY-EXISTS is returned; if the item was previously saved, the unsave
time specified in subsequent requests is disregarded.
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.
If the folder does not allow duplicate ordering keys and you attempt to save more than
one item with the same ordering key, E-DUP-ORDERING-KEY is returned.
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.
If a SAVE-ITEM-B00 UOW is issued concurrently with the ALTER-FOLDER-ORDER
UOW, the error E-CONCURRNT-FLD-UPDATE is returned. This prevents an item
from being saved with an incorrect ordering key.
If a SAVE-ITEM-B00 UOW is issued concurrently with the DELETE-FOLDER UOW,
the error E-CONCURRNT-FLD-UPDATE is returned. This prevents an application
from saving an item in a folder that is currently being deleted.