Directives 

PROCESS SERVER

Establish Remote Server

Formats

1. Identify Remote Server:

PROCESS SERVER "server" ON "address"

2. Terminate Remote Server:

PROCESS SERVER "server" CLOSE

Where:

address

TCP address and services identifier for the server; e.g. "[tcp]192.1.1.100;15000".

To identify an instance of PxServer, an address string consisting of the following three components can be used:

[pxs]

Identifies the server as an instance of PxServer

host

Identifies the machine on which PxServer is running (or the name localhost can be substituted if PxServer is running on the same machine as PxPlus)

port

Identifies the port number on which PxServer is listening

Alternatives to the TCP address are explained in Format 1.

server

Name to be associated with a program server. Length is from 1 to 12 characters; e.g. "INVENTORY".

Description

The PROCESS SERVER directive is used to identify a remote program server or the PxServer to a CALLing application.

If desired, "address" can be set to "LOCAL", which results in any RPC call to this server simply becoming a local CALL directive. Alternatively, the address can specify a pipe on UNIX or a DLL on Windows.

To terminate the remote server connection, use the CLOSE keyword.

Format 1

Identify Remote Server

PROCESS SERVER "server" ON "address"

Establishes the remote server with a logical name (between 1 and 12 characters in length). The server address may take one of several forms, depending on the circumstances:

Examples:

 

process server "Inventory" on "[tcp]192.1.1.100;15000"

TCP address and port/service identifier for the server.

 

process server "Inventory" on "LOCAL"

LOCAL keyword results in any CALL to this server becoming local.

 

process server "Inventory" on "|/u/sys001/inventory"

(UNIX/Linux Only) Pathname of | (pipe) server instead of TCP address.

 

process server "Inventory" on "[DLL]c:\app\server.dll;Entry"

(Windows Only) Pathname DLL and entry point instead of TCP address.

 

process server "server" on "[pxs]host;port"

Identifies the server as PxServer, the host machine on which PxServer is running, and the port number on which PxServer is listening.

Format 2

Terminate Remote Server

PROCESS SERVER "server" CLOSE

Terminates the remote server connection identified by the name "server".

Example:

process server "Inventory" close

See Also

[RPC] Remote Process Control
Remote Process Capability