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

NonStop TS/MP Pathsend and Server Programming Manual–132500

5-1

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 of the procedures by using a function-type statement in which the

procedure returns a numeric completion code (as an integer value).

Table 5-1

lists the Pathsend procedure calls by name and gives the purpose of each one.

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++,

Table 5-1. Summary of Pathsend Procedure Calls

Procedure Purpose

SERVERCLASS_DIALOG_ABORT_ Requests that the specified dialog be aborted

SERVERCLASS_DIALOG_BEGIN_ Initiates a dialog with a server process in a server

class and sends the first message in the dialog

SERVERCLASS_DIALOG_END_ Ends the specified dialog

SERVERCLASS_DIALOG_SEND_ Initiates a send within the specified dialog

SERVERCLASS_SEND_ Initiates a context-free send operation to a server

process in the specified server class

SERVERCLASS_SEND_INFO_ Gets error information about the last call to any of

the other Pathsend procedures