TRANSFER Reference Manual

COPY-ITEM
TISERV UOW Descriptions
2–146 069139, Update 1 to 40969 Tandem Computers Incorporated
COPY-ITEM Operation
COPY-ITEM makes a copy of an existing item, thus creating a new item. If the COPY-
DATA field is set to Y, the new item contains the same client data as the item specified
by ITEM-ID. This operation is equivalent to issuing a CREATE-ITEM request,
followed by one ADD-ITEM-REC request for each client record in the original item.
The new item is identified by the ID in NEW-ITEM-ID.
If the item to be copied is not saved in any of the correspondent's private folders or in
any of the group folders owned by groups of which the correspondent is a member,
the error E-ITEM-NOT-FOUND is returned.
If the item is a package header, the TRANSFER delivery system copies alterable fields
into the new item descriptor; these are the fields that you can modify with the ALTER-
ITEM-DESCR UOW. All other descriptor fields in the copy operation contain default
values assigned by the TRANSFER delivery system.
If COPY-RECIPS is set to Y, the TRANSFER delivery system copies all recipients
associated with the item if the item is a package header item.
If COPY-COMPNTS is set to Y, the TRANSFER delivery system attaches all
components of the original item to the copied item, and increments the parent
count of each component by 1.
If you must retain access to the new item beyond the end of the current session, you
must either save that item in a folder or attach the item to another item. The new item
is saved in an internal temporary folder upon creation and is removed from that folder
when the session is terminated.
If the depot storage statistics facility is active, storage amounts for the item data and
any primary attachments associated with the item are entered in the copied item
descriptor record. These amounts are calculated if either of the following conditions is
true:
The copied item does not include the primary attachments associated with the
item.
The item is an unalterable item.
If the copied item has the same primary attachments as the original item and the
original item is alterable, the statistics for the number of copied data records are not
calculated but are copied from the original item.
You cannot use the COPY-ITEM UOW to copy packages with an APPLIC-ID or ITEM-
TYPE value of 100. If you attempt to do so, E-COPY-ITEM-DISALLOWED is returned.
If you must copy such a package, your application must read it and construct a user
copy by using the GET-ITEM-REC UOW.
If the item being copied is a package that has been submitted for delivery, the new
item descriptor has a value of 0 for REPLY-BY-DATE, SUBMIT-TIMED, SUBMIT-
EVERY, and SUBMIT-UNTIL.