TRANSFER Reference Manual

SAVE-ITEM
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–441
SAVE-ITEM
(UOW Code 110)
SAVE-ITEM saves an item in a folder that has any ordering discipline except APPLIC-
DEFINED; the SAVE-ITEM-BY-KEY UOW must be used to save items in folders with
APPLIC-DEFINED ordering.
SAVE-ITEM can still be used to save items in folders created by TRANSFER A01/A02.
SAVE-ITEM differs from the SAVE-ITEM-B00 UOW in that it does not have an unsave
option to have items automatically removed at a specified time. Unless the item is
automatically removed after the folder item retention time, you should use the
UNSAVE-ITEM UOW to remove items from a folder.
DEF save-item-uow.
02 hdr.
03 self-ident PIC AA VALUE "UW".
03 uow-code TYPE BINARY 16 UNSIGNED VALUE 110.
02 item-id.
03 dummy PIC X(12).
02 folder-name PIC X(80).
END.
DEF save-item-rsp.
02 hdr.
03 self-ident PIC AA VALUE "UW".
03 uow-code TYPE BINARY 16 UNSIGNED VALUE 110.
02 retn-code TYPE BINARY 16.
02 retn-code-detail TYPE BINARY 16.
END.
HDR
is the UOW header. The UOW-CODE value is 110.
ITEM-ID
identifies the item to be saved. To refer to an item produced by a previous UOW
within the same IPC, you can replace ITEM-ID with ITEM-HANDLE, which is
defined in the “Commonly Used Fields” subsection of this manual.
FOLDER-NAME
is the name of the folder in which the item is to be saved. The folder can be either
a private folder owned by the correspondent, or a folder or bulletin board owned
by a group in which the correspondent is a member.
You can enter the special folder names WASTEBASKET and OUTLOG in this
field. You can also specify the INBOX folder, but this is not recommended
because the TRANSFER delivery system already saves items in this folder when
appropriate. Clients can automatically remove packages from the INBOX folder
when saving them elsewhere by including an UNSAVE-ITEM UOW in the
interprocess message.