|
Other manuals for this model:
manual abstract
TISERV UOW Descriptions
ATTACH-EXTOBJ
verifies that it has read access to the object and sets up pointers to the object in the
TRANSFER database.
When the TRANSFER delivery system copies a file for primary or alternate
attachment, it generates a name for the new file. The TRANSFER delivery system
establishes a value for use as the initial file name when the system is initialized or
converted from an earlier version, and then increments this value each time it must
allocate a file name. The initial value is A^^^^^^^, where ^ denotes a space. The file
names are constructed so that the first character is alphabetic, the second is
alphanumeric or a space, and the remaining are numeric or spaces. The last possible
name assigned for a single node is ZZ999999.
If the TRANSFER delivery system cannot find the external object, E-EXTOBJ-NOT-
FOUND is returned. Notice that the fully qualified object name used in the search is
also returned to allow for error checking. If the TRANSFER delivery system
encounters a problem while copying the external object, E-EXTOBJ-ERR is returned
and the value in RETN-CODE-DETAIL gives more information about the error.
The item or primary object can have more than one attachment. Where related
attachments are used, your application must use the USER-VALUES field to group
these attachments together.
The TRANSFER delivery system maintains the attachments in a list that is ordered by
a value called the relative position (that is, this value denotes the position of the
attachment in the list relative to other attachments). The first relative position is 1 and,
in a list of n attachments, the last relative position is n. Through the REL-POSITION
field, your application can specify a relative position for the attachment currently
requested. If that position is already taken, the attachment in that position, and all
subsequent attachments, are moved forward by one position. If you want to place an
attachment at the end of the list, but do not know the position value for the last
attachment, you specify the value -1. In summary, the legal values for the REL-
POSITION field are -1 or a value between 1 and n + 1 (where n reflects the current last
relative position used); in no case can this value exceed 9999. If you enter an illegal
value, E-INVALID-REL-POSITION is returned.
The correspondent running your application must have access to the item or primary
external object specified as the parent; otherwise, E-ITEM-NOT-FOUND or E-
PRIMARY-NOT-FOUND is returned. The correspondent has such access if the parent
is an item that is saved in a folder at the correspondent's depot, or is a primary
external object that is attached to such an item.
If the current attachment causes the total number of primary or alternate attachments
to the parent to exceed 9999, then E-TOO-MANY-ATTACHMENTS is returned.
For the OBJECT-TYPE field, you must specify the value 1, indicating a file managed by
the GUARDIAN 90 operating system; this is the only type of external object supported
by the current software version. Using any other value in this field results in the
return of E-INVALID-OBJECT-TYPE.
In the OBJECT-NAME field, you must specify the file name in external format. If you
enter a partially qualified name, the name is fully qualified by the GUARDIAN 90
procedure FNAMEEXPAND, using the DEFAULTS field of the UOW to determine the
2–136
069139, Update 1 to 40969 Tandem Computers Incorporated
...Other models in this manual:
Desktops - HP NonStop L-Series (517.86 kb)