TRANSFER Reference Manual

DETACH-EXTOBJ
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–223
For detachment of an alternate object from 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.
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 Y.
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.
For detachment of an alternate object from a primary external object:
PARENT-IS-ITEM is set to N.
PARENT-IS-OBJECT-NAME is set to Y if the parent is specified by object
name. PARENT-IS-OBJECT-NAME is set to N if the parent is specified by
object ID or item handle.
CHILD-IS-OBJECT-NAME is set to Y if the object is specified by name.
CHILD-IS-OBJECT-NAME is set to N if 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, object ID, or item handle that
refers to the parent object. 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.
To refer to an item or object produced by a previous UOW within the same IPC,
you can use an item handle in place of the item ID or object ID, as noted earlier in
this section.
If the parent item or primary external object does not exist or is not accessible to the
correspondent, then E-ITEM-NOT-FOUND or E-PRIMARY-NOT-FOUND is returned.
You can specify the object to be detached either by relative position or object name. If
the REL-POSITION field contains a value other than 0, the TRANSFER delivery
system detaches the attachment in the position indicated by that value. If, however,
the REL-POSITION field contains 0, the TRANSFER delivery system searches the
attachment list for the object named in the OBJECT-NAME field and detaches that
object. (The value in REL-POSITION must always be either 0 or a number ranging
from 1 through 9999; otherwise, E-INVALID-REL-POSITION is returned.)
If the specified attachment is not found, the TRANSFER delivery system returns
E-NO-ATTACHMENT.