TS/MP Pathsend and Server Programming Manual (H06.05+, J06.03+)

5 Pathsend Procedure Call Reference
Pathsend programs use six procedures that are part of the Guardian procedure library. This section
provides the syntax and semantics of these procedure calls, preceded by information about how
to call the procedures from each of the languages supported by Pathsend. The descriptions are in
alphabetic order by procedure name.
For each procedure, the reference information includes:
• A brief description of what the procedure does
• The syntax of the procedure call (in TAL)
• Parameter definitions
• Additional usage considerations for the call, where applicable
Lengthy usage considerations that apply to several different Pathsend procedures are grouped at
the end of the section.
You invoke all the procedures by using a function-type statement in which the procedure returns a
numeric completion code (as an integer value).
Table 5 (page 75) lists the Pathsend procedure calls by name and gives the purpose of each one.
Table 5 Summary of Pathsend Procedure Calls
PurposeProcedure
Requests that the specified dialog be aborted.SERVERCLASS_DIALOG_ABORT_
Initiates a dialog with a server process in a server class and sends the first message in
the dialog.
SERVERCLASS_DIALOG_BEGIN_
Ends the specified dialog.SERVERCLASS_DIALOG_END_
Initiates a send within the specified dialog.SERVERCLASS_DIALOG_SEND_
Initiates a context-free send operation to a server process in the specified server class.SERVERCLASS_SEND_
Initiates a context-free send operation to a server process in the specified server class.
It supports the data transmission of up to 2 MB.
SERVERCLASS_SENDL_
Gets error information about the last call to any of the other Pathsend procedures.SERVERCLASS_SEND_INFO_
Initiates a context-free send operation to a server process in the specified server class.
It supports the data transmission of up to 2 MB.
SERVERCLASS_SEND64_
Initiates a dialog with a server process in a server class and sends the first message in
the dialog.
SERVERCLASS_DIALOG_BEGIN64_
Initiates a send within the specified dialog.SERVERCLASS_DIALOG_SEND64_
Gets error information about the last call to any of the other Pathsend procedures.SERVERCLASS_SEND_INFO64_
The procedures whose names begin with SERVERCLASS_DIALOG_ are used for requests to
context-sensitive servers. The SERVERCLASS_SEND_ procedure is used for requests to context-free
servers. The SERVERCLASS_SEND_INFO_ procedure is used to obtain information about both
context-free and context-sensitive requests.
The method for accessing these procedures from a Pathsend program depends on the programming
language you use. You can write Pathsend programs in C, C++, COBOL85, Pascal, pTAL, or TAL.
The topics that follow explain how to call the Pathsend procedures from each of the supported
programming languages.
75