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

NonStop TS/MP Pathsend and Server Programming Manual–132500
3-1
3
Writing Pathsend Requesters
This section explains how to write programs that use Pathsend procedure calls to make
requests to Pathway servers. These programs can be either one of the following:
•
Standard requesters—programs that initiate application requests
•
Nested servers—servers that act as requesters by making requests to servers in other
server classes
Nested servers are described further in Section 4, Writing Pathway Servers
. However,
this section (Section 3) describes the use of Pathsend procedure calls to perform
requester functions, whether by a standard requester or a nested server. The terms
Pathsend program and Pathsend process are used to refer to any program or process that
uses Pathsend calls, whether it is a standard requester or a nested server.
Pathsend programs are Guardian requesters, as described in the Guardian Programmer’s
Guide. You can write Pathsend programs in C, C++, COBOL85, Pascal, pTAL, or TAL.
You should be familiar with the Guardian requester/server model as implemented in the
programming language you are using.
In addition, if you are using the Transaction Management Facility (TMF) subsystem,
you should be familiar with the programming guidelines and considerations for TMF
requesters, as described in the NonStop TM/MP Application Programmer’s Guide. Note
that the NonStop TM/MP Application Programmer’s Guide describes requesters that use
calls to Guardian procedures rather than Pathsend procedures. In Pathsend requesters
that use the TMF subsystem, calls to Pathsend procedures are used instead of calls to
WRITEREAD and associated Guardian procedures, and there are other differences as
described in this section.
An example of a Pathsend requester program that is also a nested server is given in
Example B-1
on page B-2.
The Pathsend Procedure Calls
Pathsend programs use six procedures that are part of the Guardian procedure library:
SERVERCLASS_SEND_
SERVERCLASS_SEND_INFO_
SERVERCLASS_DIALOG_ABORT_
SERVERCLASS_DIALOG_BEGIN_
SERVERCLASS_DIALOG_END_
SERVERCLASS_DIALOG_SEND_
Later parts of this section describe how to use these procedures in context-free and
context-sensitive Pathsend programs. Section 5, Pathsend Procedure Call Reference
,
gives detailed syntax and usage considerations for the procedures.