TRANSFER Reference Manual

SAVE-ITEM-B00
TISERV UOW Descriptions
2–446 069139, Update 1 to 40969 Tandem Computers Incorporated
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 other than APPLIC-
DEFINED, in which the item is to be saved. The folder can be a private folder
owned by the correspondent, a folder shared by a group, or a bulletin board, if the
correspondent is a member of the group that owns it.
You can specify the special WASTEBASKET folder 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.
FLAGS
describes miscellaneous flags that are used by the SAVE-ITEM-B00 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 (relative), 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.
If you set QUANTITY to 0, and UNITS to C, F, or P:
C Equates UNSAVE-TIME to the item retention time used as the default at
folder creation, as specified in the depot profile.
F Equates UNSAVE-TIME to the item retention time assigned to the folder.
The retention time for the individual item becomes the same as the
retention time for the folder in which it resides.