# Application Server

Sample Setup Procedure |

This page describes a typical procedure for setting up and running the Application Server for use with a PxPlus client-server application. Configuration details are slightly different, depending on whether the server is a Windows or a UNIX/Linux system.

The procedure uses the following sample PxPlus application saved as app1:

> 0010 PRINT 'CS'
> 0020 BEGIN:
> 0030 PRINT @(0,0),"Wecome to the Applicaton Server",
> 0040 PRINT @(0,3),"You are currently running "+PGN,
> 0050 PRINT @(0,4),"Local Work Directory: "+LWD,
> 0060 PRINT @(0,5),"User ID: "+WHO
> 0070 PRINT @(0,7),"Press any key to escape to console mode:",
> 0080 OBTAIN (0,SIZ=1)X$
> 0090 ESCAPE
> 0100 GOTO BEGIN

Windows: | The Windows configuration assumes that app1 is saved on the server system in the directory C:\app\.
UNIX/Linux: | The UNIX\Linux configuration assumes that app1 is saved on the server system in the directory /home/user1/app/. UNIX\Linux examples also assume a user login on a machine named user1, which has access to run PxPlus. This user also has a home directory of /home/users1/ and a password of password. Change these references to your user name, password, and home directory.

## Step 1: Start the Configuration Utility

Launch the user interface to the Server Configuration utility.

Windows: | From the Windows Start menu, select Start > Programs > PVX Plus Technologies > PxPlus version_number > Application Server > App Server Configuration. Another method is to enter the following in PxPlus console mode: RUN "*appserv/config".
UNIX/Linux: | Start *NTHost. At the system prompt, enter: #\usr\pvx \*nthost -arg 10000 root 000 10005. This will launch an *NTHost session on the server as user ID root starting from port 10000 to 10005.

## Step 2: Create a New Application Server

Once the Server Configuration utility is started, the interface will appear in a new window. It is divided into tabbed panels, indicating the different options and fields available for configuring the new server.

Enter a new name in the Server field (e.g. app), then click the New button.

## Step 3: Specify Server Properties

Click on the Server tab to begin entering the primary attributes for the currently selected server.

Windows: | In the Server panel, keep Socket 10000, select the KeepAlives check box, and change the Start-In Directory to "C:\app\".
UNIX/Linux: | In the Server panel, keep Socket 10000, enter User Name (Default User section) as user1, and change the Start-In Directory to "/home/user1/app".

## Step 4: Define Client Preferences

In the Clients panel, ensure that the Client Must Login check box is selected, and keep the following (default) information for these Timeouts (Seconds) options:

New Connections | 60
User Requests | 300
Admin Requests | 1800
Re-Connect Timeout | 180

## Step 5: Configure Application Properties

In the Apps panel, click the New button. In the New - App Props panel, enter App Name as app1 and Lead Program as app1. From the Client Type drop box, select Any Client Type.

## Step 6: Configure User Properties

In the Users panel, select the New button.

Windows: | In the New/Current Users Properties panel, enter Remote User Name as user1, Full Name as user1, and Password as password. Select the User Can Change Password check box. Select Run Any Configured App from the drop box in the Miscellaneous section.
UNIX/Linux: | In the New/Current Users Properties panel, enter Remote User Name as user1, Full Name as user1, and Password as password (i.e. valid user ID and password). Select the User Can Change Password check box. Select Run Any Configured App from the drop box in the Miscellaneous section. Select the Server User Name Same as Remote User Name check box.

## Step 7: Start the Server

In the Server panel, click the Start button to run the server. Once the server has started, a PID (Process ID) will appear in the Status box to indicate that the server is now running.

## Step 8: Run the WindX Client

On the client system, ensure that WindX (Plug-in) is installed. Create a shortcut that includes a Target similar to the following:

> "C:\pxplus\pxplus.exe" -mn "*client" -ARG 1.160.10.240 10000 "app1"

Where:

"C:\pxplus\pxplus.exe" | Example path to PxPlus on the client system.
-mn | Starts minimized.
"*client" | PxPlus program used to connect the client to the Application Server.
-ARG | Keyword marking the start of the argument list.
1.160.10.240 | Example IP address of the server.
10000 | TCP/IP port (socket) to which the server daemon is listening.
"app1" | Lead program that the server is to run.

When you click on (run) the shortcut, the Client Log In dialog will display. Enter User Name as user1 and Password as password, then click OK to connect to the Application Server. If the connection is successful, the WindX session will start up in a new interface window.