TS/MP 2.5 Pathsend and Server Programming Manual

3 Writing Pathsend Requestors
This chapter 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 requestors—programs that initiate application requests
• Nested servers—servers which act as requestors by making requests to servers in other
server-classes
Nested servers are described further in chapter 4, “Writing Pathway Servers” (page 61). However,
this chapter describes the use of Pathsend procedure calls to perform requestor functions, whether
by a standard requestor 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
requestor or a nested server.
Pathsend programs are Guardian requestors, as described in the Guardian Programmer’s Guide.
You can write Pathsend programs in C, C++, COBOL85, Pascal, pTAL, or TAL. You must be familiar
with the Guardian requestor/server model as implemented in the programming language you are
using.
In addition, if you are using the TMF subsystem, you must be familiar with the programming
guidelines and considerations for TMF requestors, as described in the HP NonStop Transaction
Management Facility (TMF) Application Programmer’s Guide . Note that the HP NonStop Transaction
Management Facility (TMF) Application Programmer’s Guide describes requestors that use calls
to Guardian procedures rather than Pathsend procedures. In Pathsend requestors 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 chapter.
An example of a Pathsend requestor program that is also a nested server is given in Example
3 (page 136).
The Pathsend Procedure Calls
Pathsend programs use the following 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_
SERVERCLASS_DIALOG_BEGINL_
SERVERCLASS_DIALOG_SENDL_
GETTSMPVERSION
SERVERCLASS_SENDL64_ Procedure
SERVERCLASS_DIALOG_BEGINL64_
SERVERCLASS_DIALOG_SENDL64_
SERVERCLASS_SEND_INFO64_
For enabling 64-bit user space features in TS/MP 2.5 application, call 64-bit user space APIs in
the OSS environment and with LP64 memory option. For enabling 64-bit user space in the Guardian
environment call 64-bit APIs using the Mixed data-model programming.
NOTE: The Mixed model programming uses 64-bit pointers generated by
SEGMENT_ALLOCATE64_ and the same pointers are used in the ILP32 memory model. In this
way, 64-bit APIs can be used on the Guardian environment.
50 Writing Pathsend Requestors