TRANSFER Reference Manual

SAVE-ITEM-BY-KEY
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–451
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, with an ordering discipline of APPLIC-DEFINED, in
which the item is to be saved. The folder can be a private folder owned by the
correspondent, or a folder or bulletin board owned by a group of which the
correspondent is a member. Special folders INBOX and WASTEBASKET cannot
be entered in this field.
FLAGS
describes miscellaneous flags that are used by the SAVE-ITEM-BY-KEY UOW.
DATE-IS-REL
is a flag that indicates whether the given date is relative or absolute.
Y The date is a relative date.
N The date is an absolute date.
RESERVED-1 through RESERVED-7
are reserved for use by Tandem. These fields must be set to N.
UNSAVE-TIME
is the time when the item is automatically removed from the folder. This date can
be relative or absolute, depending on the DATE-IS-REL flag.
In DELTA-TIME, UNITS is the unit of time denoted in QUANTITY. You can
set UNITS to D (for days), H (for hours), or M (for minutes). The date must be
in the future. If the date is in the past, the error E-PAST-DATE-TIME is
returned.