TS/MP Pathsend and Server Programming Manual (G06.24+, H06.03+)

Writing Pathsend Requesters
NonStop TS/MP Pathsend and Server Programming Manual–132500
3-11
Writing Requesters That Interoperate With
NonStop TUXEDO Servers
Writing Requesters That Interoperate With
NonStop TUXEDO Servers
Pathsend requesters can call on the services of NonStop TUXEDO servers in either of
two ways:
•
Directly, by making calls to the NonStop TUXEDO Application Transaction
Monitor Interface (ATMI) functions
•
Indirectly, by using the Pathway to TUXEDO (PWY2TUX) translation server
To communicate directly with a NonStop TUXEDO server by calling the ATMI
functions, a Pathsend requester must also act as a NonStop TUXEDO client, as follows:
•
It must be compiled as a NonStop Kernel Open System Services (OSS) process;
therefore, it must be written in a Tandem language that supports Open System
Services (such as C).
•
It must link in the ATMI functions. For example, if the requester is a C program, it
can be linked to the ATMI functions by being compiled with the buildclient
command.
•
It must join a NonStop TUXEDO application by calling the tpinit() ATMI function
or one of the ATMI functions that implicitly calls tpinit(), such as tpalloc() or
tpcall().
•
It must follow the restrictions on Pathsend procedure calls that apply to NonStop
TUXEDO clients: namely, it cannot make nowait calls (calls with bit 15 of the
flags parameter set to 1) to the SERVERCLASS_SEND_,
SERVERCLASS_DIALOG_BEGIN_, and SERVERCLASS_DIALOG_SEND_
procedures.
A requester using this method of interoperation can use request/response messages,
conversations, or both.
For more information about writing a NonStop TUXEDO client and calling the ATMI
functions, refer to the NonStop TUXEDO System Application Development Guide. For
the syntax of the ATMI function calls, refer to the NonStop TUXEDO System Reference
Manual.
To communicate indirectly with a NonStop TUXEDO server by using the Pathway to
TUXEDO translation server, a Pathsend requester program (or a SCREEN COBOL
requester program) must be written according to the guidelines in the NonStop TUXEDO
System Pathway Translation Servers Manual. Refer to that manual for further
information. A Pathsend requester using the Pathway to TUXEDO translation server
must use context-free Pathsend calls (calls to SERVERCLASS_SEND_); the translation
server does not support dialogs (conversations).