TRANSFER Reference Manual

GET-RECIP-REC
TISERV UOW Descriptions
2–380 069139, Update 1 to 40969 Tandem Computers Incorporated
To indicate problems with an item handle:
4062 E-INVALID-ITEM
-4063 W-ITEM-NOT-RETURNED
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.
NUM-RETURNED
is the number of records returned in the response.
RECIPS-RETURNED
contains the records returned, and includes for each record fields that indicate:
Recipient name and type (RECIP-NAME and RECIP-TYPE)
Delivery error and status flags set by the TAREQ processes that delivered the
package (DELIV-ERR and DELIV-STATUS-FLAGS)
The time and date at the recipient node when the package was delivered
(DATE-DELIVERED).
The TRANSFER delivery system assigns only enough space to accommodate the
NUM-RETURNED elements in RECIPS-RETURNED. If another UOW response
follows this one in the same IPC, this next response begins immediately after the
element last returned.
GET-RECIP-REC Operation
GET-RECIP-REC retrieves local recipient records for the package identified by
RECIP-KEY. The records are placed in the array named RECIPS-RETURNED in
ascending order by system name, based upon the collating sequence configured for the
TRANSFER system.
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.
If there are X400 recipient records for the requested item, the warning W-X400-
NAMES is returned in the RETN-CODE-DETAIL field and W-EOF is returned in the
RETN-CODE field. Clients can determine whether X400 recipients exist without
requesting the GET-X400-RECIP UOW.
The retrieval can begin with the exact recipient name specified in RECIP-KEY if such a
recipient name exists; or with the next one, depending on the value of the SKIP-
EXACT field in the OPTIONS structure.
To reference the first recipient in the recipient list, specify an empty RECIP-NAME
field, set RECIP-NAME to all blanks or begin the field with a null character.