TRANSFER Reference Manual

ATTACH-EXTOBJ
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–137
default volume and subvolume. If the node name is not included with the file name,
the TRANSFER delivery system assumes that the file is on the local system. If the
name expansion fails, E-INVALID-FILENAME is returned.
The TRANSFER delivery system does not support the attachment of partitioned files.
If you attempt to make such an attachment, E-PARTITIONED-FILE is returned.
You can attach an audited file to an object. When the TRANSFER delivery system
honors your request, however, it returns the warning W-AUDITED-FILE to indicate
that any copies made of the file are not audited.
The correspondent running your application must have a valid GUARDIAN 90 user
ID stored in the TRANSFER MAIL profile; otherwise, BAD-ID-OR-PASSWORD is
returned. Both the GUARDIAN 90 user ID under which the TRANSFER delivery
system is running and the GUARDIAN 90 user ID stored in the correspondent's
profile must indicate at least read access to the file; otherwise, E-EXTOBJ-ERR is
returned, with a RETN-CODE-DETAIL of 48 (security violation).
If MAKE-COPY is set to Y, the TRANSFER delivery system makes its own copy of the
file to be attached, and handles the security aspects. However, if MAKE-COPY is set
to N, it is your responsibility to ensure that all local recipients have access to the file to
be attached. If the TRANSFER user ID owns the file, the TRANSFER delivery system
manages the security of this file and modifies the security to reflect the value specified
in the system configuration entity, EXTOBJ-SECURITY. Remember that the
GUARDIAN 90 user ID stored in the correspondent's profile still needs read access to
the file.
If MAKE-COPY is set to Y and the ATTACH-EXTOBJ UOW completes successfully
but the transaction is aborted for some reason, the file created by the TRANSFER
delivery system continues to exist. To minimize the risk of this event, issue this UOW
as near to the end of the transaction as possible. (If a file is created under these
circumstances, the system administrator receives a message to purge it when the
TCHECK utility is run.)
If your system manager has disabled the external objects capability, E-EXTOBJS-
DISABLED is returned. Your application can check the status of this capability by
issuing the GET-CONFIG-NAME UOW for the EXTOBJS-ENABLED entity. (If it is set
to Y, external objects are enabled; if it is set to N, they are disabled.)
The object ID returned by this UOW is stored in the item ID table for the IPC. Thus,
UOWs that follow this one in the same IPC can reference the object by using an item
handle.