# Application Server

Running the Server |

The operation side of the Application Server is handled by the server daemon, a platform-independent PxPlus program called *appserv/server. This program is designed to run as a background task and is responsible for:

- Listening for client/server connections
- Responding to requests
- Launching new sessions
- Moving traffic between the client- and server-side processes

The Start-In directory for the server daemon is an important consideration. When the daemon launches new processes (applications), it will start them in the same directory in which the server daemon was started. This occurs unless either the application requested had a designated Start-In directory, or the client requested a specific Start-In directory.

Associated files should be given a path that is relative to the Start-In directory of the server daemon.

## Command Line Syntax

The server daemon Command line syntax is described as follows:

| In Windows: | PVXpath$ [state] [ini] *appserv\server –ARG ServerName
| In UNIX/Linux: | PVXpath$ \*appserv/server –ARG ServerName

Where:

| PVXpath | Path to PxPlus.
| state | Option setting for governing the initial WindX window: null - Normal window -mn - To start minimized –hd - To start hidden
| ini | Optional user-defined INI file (or ..\Lib\_appserv\apssrv.ini). Do not use a * in the INI path, as PxPlus does not resolve them as it does program names. (Windows Only)
| ServerName | Name of a server defined in the configuration. Case insensitive. May be quoted.

## Starting the Server Daemon - Examples

The following are examples of a Start command for an Application Server daemon:

Under Windows

If the Start-In Directory is C:\PxPlus:

C:\pxplus\pxplus.exe -mn "C:\pxplus\Lib\_appserv\appsrv.ini"
*appserv\server -ARG "MainServer"

Under UNIX/Linux

Method 1: From a Shell script

> #!/bin/sh
> TERM=ansi; export TERM
> cd /usr/pvx
> /usr/pvx/pvx \*appserv/server -ARG MainServer </dev/null >/dev/null 2>&1

Method 2: Directly from /etc/inittab. This uses "/ "as its starting directory.

> pvd1:2345:respawn:/usr/pvx/pvx \*appserv/server -ARG MainServer
> </dev/null >/dev/null 2>&1

Method 3: From the /etc/rc set of directories (Linux Method)

Create a file in /etc/init.d. The simplest method is to copy an existing script from that directory and modify it to start the above command line. The script should contain the START( ) and STOP( ) functions required. Use symbolic links in the /etc/rc?.d directories to link to your script.

## Stopping the Server Daemon

Under Windows

Right click on the PxPlus Application Server icon for the server daemon in the Windows Taskbar, then select Close or Interrupt.

Under UNIX/Linux

Send a SIGBREAK to the server daemon process.

Example:

> Kill -2 pid

Where:

pid is the process ID of the server daemon.