TRANSFER Reference Manual

COPY-ITEM-B40
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–151
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. (However, if the original item is submitted as a package, all date
fields in the copy are reset to their default values. In particular, the copy is alterable
and unsubmitted, even if the original is not.) 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.
If you request copying of external objects, the external objects capability must be
enabled by your system manager; otherwise, the error E-EXTOBJS-DISABLED is
returned. Also, the correspondent running your application must have a valid
GUARDIAN 90 user ID stored in its depot; otherwise, E-BAD-ID-OR-PASSWORD is
returned.
Only original recipient records can be copied (that is, those originally added by client
applications, not those derived from distribution lists).
If you request copying of components, then all components of the original item are
also attached to the copied item; specifically, new copies of component items are not
made. Similar rules apply to primary and alternate attachments.
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 statements 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 data records copied are not
calculated but are copied from the original item.