TRANSFER Release D30 Documentation Supplement

TRANSFER D30 Documentation Supplement
TRANSFER Release D30 Documentation Supplement—118474 1-7
ALTER-SESS-SUFFIX
ACK-RECEIPT-D30 Operation
The ACK-RECEIPT-D30 UOW performs the same function as ACK-RECEIPT after
a matching recipient record is found according to the RECIPIENT-INDICATOR
and, optionally, the SUFFIX-TO-MATCH.
ACK-RECEIPT-D30 sets the EXAMINED flag in the recipient record in the package
identified by ITEM-ID that was found depending on RECIPIENT-INDICATOR. This
strategy has the following effect:
•
If the package is flagged by the sender for certification and the ACK-RECEIPT-D30
UOW is issued against the package for the first time by this recipient, the
TRANSFER delivery system transmits an acknowledgment package to the sender.
Acknowledgment is transmitted also if the sender requested receipt notification for
this recipient (unless the corresponding flag is set to “Y” to suppress this).
•
When the expiration date is reached, the TRANSFER delivery system checks the
EXAMINED flag. If this flag is set, the TRANSFER delivery system performs no
action. If this flag is not set and the DONT-REMOVE-ON-EXPIRE flag is not set,
the TRANSFER delivery system removes the package from the INBOX if the
package is still there and notifies the sender that the package was not examined by
the recipient.
It is not necessary to call ACK-RECEIPT-D30 from within a TMF transaction. ACK-
RECEIPT-D30 automatically starts and ends a transaction if one is required to perform
the request and no transaction ID is present.
The TRANSFER delivery system automatically marks a package delivered to a group's
INBOX folder as having been examined. This strategy prevents the generation of
messages pertaining to the expiration of the package.
See ACK-RECEIPT for depot storage statistics facility information pertaining to ACK-
RECEIPT-D30.
ALTER-SESS-SUFFIX
ALTER-SESS-SUFFIX changes the suffix stored in the session record. Any item created
after this UOW uses the new suffix for the sender portion of the Item descriptor record.
This UOW provides a way for gateway programs to more easily process incoming
messages.
DEF alter-sess-suffix-uow.
02 hdr
03 self-ident PIC AA VALUE "UW".
03 uow-code TYPE BINARY 16 UNSIGNED VALUE 133.
02 new-suffix PIC X(120).
END.
DEF alter-sess-suffix-rsp.
02 hdr
03 self-ident PIC AA VALUE "UW".
03 uow-code TYPE BINARY 16 UNSIGNED VALUE 133.
Note. The suffix comparison is case sensitive.