TRANSFER Reference Manual

GET-EXTOBJ
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–251
GET-EXTOBJ UOW Operation
GET-EXTOBJ returns the external object attachments to a specified object, whether the
parent object is an item or a preliminary external object. You can request the following
types of attachments:
Primary attachments to an item
Alternate attachments to an item
Alternate attachments to a primary external object
Access to the item is granted if the item is saved in any shared group folders accessible
to the group of which the correspondent is a member. If the correspondent does not
have access privileges to the item specified in the UOW, the error E-ITEM-NOT-
FOUND is returned.
The PARENT field is used with the OPTIONS field, so that you can indicate the type of
parent and the type of attachments and filter the attachments by their user values.
Table 2-13 lists the possible settings for OPTIONS:
Table 2-13. GET-EXTOBJ OPTIONS Settings
Type of Attachment
PARENT-
IS-ITEM
Value
PARENT-IS-OBJECT-
NAME Value
ALTERNATE-
ATTACHMENT
Value PARENT Value
Primary attachment Y N N Item ID or item
handle
Alternate attachment Y N Y Item ID or item
handle
Alternate attachment
to a primary external
object
N Y if object is specified
by object name,
N if object is specified
by object ID or item
handle.
Y Object name,
object ID, or
item handle that
refers to the
object
If PARENT-IS-OBJECT-NAME is not set to N for a primary or alternate attachment,
E-PARENT-MUST-BE-ITEM is returned.
If ALTERNATE-ATTACHMENT is set to N for an alternate attachment, E-MUST-BE-
ALTERNATE is returned.
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.
If you request a number of attachments that is greater than the number of attachments
beyond START-POSITION, W-EOF is returned.
Because a returned object is a GUARDIAN 90 file, the correspondent running your
application must have a valid GUARDIAN 90 user ID stored in the TRANSFER MAIL
profile; otherwise, E-BAD-ID-OR-PASSWORD is returned. If the GUARDIAN 90 user