TRANSFER Programming Manual

Certification of Receipt
Conventions for Application Interface
A–10 069138, Update 1 to 040970 Tandem Computers Incorporated
Certification of Receipt Some applications must receive certification of package delivery. After reading the
INBOX folder, the mail client calls the ACK-RECEIPT UOW under these conditions:
When the PS MAIL 6530 or PS MAIL 3270 Scan Screen is displayed or the
PS MAIL TTY index function is used, and a user requests any function that
specifically references a single package (such as discard, read, or file a package),
the mail client acknowledges receipt of the package and then attempts the
requested operation.
When a user attempts to read the entire INBOX without using the SCAN
operation, the mail client acknowledges receipt of each package before
displaying it.
Note The information in the remainder of this appendix pertains specifically to the PS MAIL client.
Invoking PS MAIL
Processes from Your
Application
You can invoke PS MAIL through the MAIN-C30 entry point. You write a SCREEN
COBOL program unit that requests a session ID from the TRANSFER delivery system
and then invokes PS MAIL 6530. The calling interface to PS MAIL changes
periodically; refer to the Softdoc for current information.
Invoking Application
Software from PS MAIL
You can extend the features supplied by PS MAIL to handle specialized output; for
example, displaying mail in a special format or copying mail to some device other than
a terminal. To handle this type of task, you must supply your own application
software, known in this case as a user mail extension and identified by the program
unit name M6530-EXTRAS or M3270-EXTRAS.
To invoke the user mail extension, press the shifted F15 (SF15) function key (MAIL
EXTN) on the terminal when any of the following screens are displayed: Scan, Scan
Menu, Create Mail, Create Mail Menu, Show Enclosures, or Show Enclosures Menu.
This action causes PS MAIL to call your user mail extension.
COPY MAIL Function For the COPY MAIL function, PS MAIL reports an error if the package header contains
more than 13 text records. This can occur if another application sends packages
containing more text records. PS MAIL can only copy up to 13 text records in a
package header.
When copying information from a package into the workspace, PS MAIL does not
copy data records to the new package. Instead, PS MAIL copies only the component
list for the package. Thus, if an application places additional records in the package
header, PS MAIL does not preserve those records in the newly made package.
Invoking ADMIN
or TMANAGER
from Your Application
You can write an application to invoke the ADMIN or TMANAGER clients supplied
by Tandem. The interfaces to ADMIN and TMANAGER are subject to change; for
current information, refer to the latest Softdoc.