TRANSFER Reference Manual

ATTACH-EXTOBJ
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–135
ATTACH-EXTOBJ Operation
ATTACH-EXTOBJ attaches the specified external object to the specified item or
primary external object, as a primary or alternate attachment. The possibilities are:
A primary attachment to an item
An alternate attachment to an item
An alternate attachment to a primary external object
This UOW can only be issued within a TMF transaction.
The OPTIONS field indicates what type of object the parent is, how the parent is
specified, what sort of attachment to make, and whether or not the TRANSFER
delivery system should make a copy of the external object. The following examples
show the possible settings for OPTIONS:
For a primary attachment to an item:
PARENT-IS-ITEM is set to Y.
PARENT-IS-OBJECT-NAME is set to N. If PARENT-IS-OBJECT-NAME is set
to Y, E-PARENT-MUST-BE-ITEM is returned.
ALTERNATE-ATTACHMENT is set to N.
The item must be alterable; otherwise, E-ITEM-UNALTERABLE is returned. The
PARENT field must contain the item ID or an item handle.
For an alternate attachment to an item:
PARENT-IS-ITEM is set to Y.
PARENT-IS-OBJECT-NAME is set to N. If PARENT-IS-OBJECT-NAME is set
to Y, E-PARENT-MUST-BE-ITEM is returned.
ALTERNATE-ATTACHMENT is set to Y.
The PARENT field must contain the item ID or an item handle.
For an alternate attachment to a primary external object:
PARENT-IS-ITEM is set to N.
PARENT-IS-OBJECT-NAME is set to Y if the object is specified by name.
PARENT-IS-OBJECT-NAME is set to N if the object is specified by object ID or
item handle.
ALTERNATE-ATTACHMENT is set to Y. If ALTERNATE-ATTACHMENT
is set to N, E-MUST-BE-ALTERNATE is returned.
The PARENT field must contain an object name, an object ID, or an item handle
that refers to the object.
If the MAKE-COPY subfield is set to Y, the TRANSFER delivery system makes its own
copy of the object to be attached. Notice that if the object is large, copying could take
significant time. If the MAKE-COPY field is set to N, the TRANSFER delivery system