4.1 Introduction

4.2 Using Connection Objects

4.3 Making One-Talker, One-Listener Connections

4.4 Working With Groups of Connections

4.5 Resetting Switches

4.6 PPX Server's Runtime Database

4.1 Introduction

This chapter summarizes the Point-to-Point Service functions and is organized by task. ppxSubmit is asynchronous; all other Point-to-Point Switching functions are synchronous.

4.2 Using Connection Objects

Use the following functions to work with connection objects:

Function	Description
ppxCreateConnection	Creates a connection.
ppxOpenConnection	Opens a named connection and gets a handle to the connection.
ppxCloseConnection	Closes a connection, disconnecting any talker and/or listeners.
ppxDestroyNamedConnection	Destroys resources associated with a named connection.
ppxSetTalker	Sets the talker to a connection.
ppxAddListeners	Adds listeners to a connection.
ppxRemoveListeners	Removes listeners from a connection.
ppxSetDefaultPattern	Sets a default pattern for a connection.

4.3 Making One-Talker, One-Listener Connections

Use the following convenience functions to make one-talker, one-listener connections:

Function	Description
ppxConnect	Makes a simplex, duplex, or quad connection.
ppxDisconnect	Disconnects a simplex, duplex, or quad connection.

4.4 Working With Groups of Connections

Use the following functions to perform atomatic actions on groups of connections (in a single transaction):

Function	Description
ppxBegin	Starts a list of Point-to-Point switching commands.
ppxSubmit	Submits the list of switching commands.
ppxBeginCancel	Cancels a begin/submit block.

4.5 Resetting Switches

Use the following functions to reset switches:

Function	Description
ppxRestoreConnections	Restores the system to the switch connections specified in the Point-to-Point Switching configuration file.
ppxCloseSwitch	Forces the PPX server to close an open switch.

4.6 PPX Server's Runtime Database

ppxShowDB outputs the contents of the PPX runtime connection database to a file.