TS/MP 2.5 Pathsend and Server Programming Manual

5 Pathsend Procedure Call Reference
Pathsend programs use six procedures that are part of the Guardian procedure library. This chapter
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 chapter.
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 74) 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_
Initiates a dialog with a server process in a server-class and sends the first message in
the dialog. Normally, SERVERCLASS_DIALOG_BEGIN_ sends messages up to 32K
SERVERCLASS_DIALOG_BEGINL_
whereas, SERVERCLASS_DIALOG_BEGINL_ supports the data transmission of up to 2
MB.
Ends the specified dialog.SERVERCLASS_DIALOG_END_
Initiates a send within the specified dialog.SERVERCLASS_DIALOG_SEND_
Initiates a send within the specified dialog. It supports the data transmission of up to 2
MB
SERVERCLASS_DIALOG_SENDL_
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. This procedure call is applicable only
in LP64 data model.
SERVERCLASS_SENDL64_
Initiates a dialog with a server process in a server-class and sends the first message in
the dialog. This procedure call is applicable only in LP64 data model.
SERVERCLASS_DIALOG_BEGINL64_
Initiates a send within the specified dialog. This procedure call is applicable only in
LP64 data model.
SERVERCLASS_DIALOG_SENDL64_
Gets error information about the last call to any of the other Pathsend procedures. This
procedure call is applicable only in LP64 data model.
SERVERCLASS_SEND_INFO64_
Provides a programmatic way to find the TS/MP version running on the system.GETTSMPVERSION
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
74 Pathsend Procedure Call Reference