TRANSFER Reference Manual

GET-RECIP-REC-C20
TISERV UOW Descriptions
2–390 069139, Update 1 to 40969 Tandem Computers Incorporated
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. To
retrieve a recipient list beginning with the first recipient in the list, for example:
1. Set SKIP-EXACT to Y
2. Set GET-EXACT to N
3. Set GENERIC-SUFFIX to N
When you specify filtering criteria in OPTIONS and FILTER-VALUES, only recipient
records that meet all of these criteria are returned.
The number of recipient records retrieved might be less than the number requested if
there are fewer recipients than meet the request criteria. In this case, the warning W-
EOF is returned in the RETN-CODE field.
The recipients for the local copy of any package include:
All recipients explicitly added by a client, regardless of the nodes at which the
recipients are registered
Those local recipients who were derived from distribution lists, if the TRANSFER
delivery system has already attempted delivery to the recipients
Possibly some, but not necessarily all, local recipients who were derived from
distribution lists, if the TRANSFER delivery system has not yet attempted delivery
to those recipients
Possibly some, but not necessarily all, remote recipients who were derived from
distribution lists, whether or not the TRANSFER delivery system has already
attempted to deliver the package to those recipients
GET-RECIP-REC-C20 Operation for Remote Recipients
Local records concerning remote recipients do not necessarily contain up-to-date
status information; therefore, you should obtain status information for remote
recipients from the corresponding remote copy of TISERV. To obtain status
information, do the following:
1. Send a pair of GET-CONFIG-NAME UOWs to your local TISERV to retrieve the
names of the PATHMON and TISERV on the remote system.
2. Start a session with the remote TISERV (you must have a depot on the remote
system).
3. Send the GET-RECIP-REC-C20 request to the remote system.