TRANSFER Reference Manual

DETACH-EXTOBJ
TISERV UOW Descriptions
2–222 069139, Update 1 to 40969 Tandem Computers Incorporated
RETN-CODE-DETAIL
is an error number returned by a subsystem other than the TRANSFER delivery
system or is a further qualification of an error detected by the TRANSFER delivery
system.
DETACHED-POSITION
is the position in the attachment list that was occupied by the detached object
relative to the other items in the list.
DETACH-EXTOBJ Operation
DETACH-EXTOBJ detaches an external object from an item or a primary external
object. Specifically, you can detach:
A primary external object from an item
An alternate external object from an item
An alternate external object from a primary external object
This UOW can only be issued within a TMF transaction.
The PARENT and OBJECT-NAME fields are used with the OPTIONS field. The
OPTIONS field determines the following:
Whether the PARENT field specifies an item or a primary external object
Whether the objects specified by the PARENT and OBJECT-NAME fields are
identified by object name, object ID, or item handle
Whether a primary or alternate attachment is being detached
The following examples show the possible settings for OPTIONS.
For detachment of a primary object from an item:
PARENT-IS-ITEM is set to Y.
PARENT-IS-OBJECT-NAME is set to N. If PARENT-IS-OBJECT is set to Y, E-
PARENT-MUST-BE-ITEM is returned.
CHILD-IS-OBJECT-NAME is set to Y if the object is specified by name.
CHILD-IS-OBJECT-NAME is set to N if the object is specified by object ID or
item handle.
ALTERNATE-ATTACHMENT is set to N.
The PARENT field must contain an item ID or an item handle. If the REL-
POSITION field contains 0, the OBJECT-NAME field must contain either the name
of the object or the object ID or item handle that refers to the object. The item must
be alterable; otherwise, E-ITEM-UNALTERABLE is returned.