# 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