Application Server

Client Configuration

A WindX thin-client implementation is required to establish a user interface connection from a remote system to the PxPlus Application Server. The Windows thin-client employs the Application Server *CLIENT program to connect to the server. *CLIENT is also used by the spawning process to initiate new sessions on the client workstation. See WindX Thin-Client for information on using WindX.

The Command line syntax is described as follows:

PVXpath$ [state] [ini] *client –ARG ServName[Socket] ["App"] [parms]

Where:

PVXpath

Path to PxPlus (e.g. C:\pxplus\pxplus.exe).

state

Option setting for governing the initial WindX window. Either null for normal window, -mn to start minimized, –hd to start hidden.

ini

Optional user-defined INI file. The initial session will use this INI for its client-side PxPlus characteristics. Spawned sessions will reuse the same INI, unless specifically overridden during the spawn.

ServName

IP Address or DNS resolvable name of the server to which to connect.

Socket

TCP/IP port (socket) to which the server daemon is listening. Default is 10000.

"App"

Optional lead program or configured application name that the server is to run. Quotes are required if it contains spaces. If Null or not given, then the request is for a PxPlus Console Mode Session.

parms

Optional dashed parameters. See *CLIENT Dashed Parameters below.

-ARG=xxx	-KA	-USR1=xxx
-CMD=xxx	-LANG=xx	-USR2=xxx
-DIR=xxx	-LOGIN	-USR3=xxx
-FID=xxx	-SSL	-USR4=xxx

*CLIENT Dashed Parameters

The following parameters may be included on the Command line in any order as long as they are entered after the lead program name, "App" (or Socket, if no application is given):

-ARG=xxx	This is an "addition to" value, whereby you can request additional command line arguments for the server-side process. These are in addition to any application configured command line arguments. Extra command line arguments are supplied to the server-side process after any configured –ARG values. *Example:* Server-Side_Process_Command Application$ -ARG arg1 arg2 ExtraArg1 ExtraArg2 The application configuration may be set to refuse such an addition (quoting is optional, but required if there are spaces).
-CMD=xxx	This is an "addition to" value, whereby you can request additional command line options for the server-side process. *Examples:* -CMD=-XT=1 or -CMD=-XT=0 -NE=1 or -CMD="-XT=0 -NE=1" Extra command line options are supplied to the server-side process after the program name but before any –ARG xxx values. *Example:* Server-Side_Process_Command Application XtraCmdLineOptions$-ARG … … The application configuration may be set to refuse such an addition (quoting is optional, but required if there are spaces).
-DIR=xxx	Server-side Start-In directory. This is an override value, whereby you can request a specific directory in which to start the server session. The Application Configuration may be set to not allow such an override (quoting of value is optional, even if the path contains spaces).
-FID=xxx	FID(0) value requested. This is an override value, whereby you can request a specific FID(0) for this session. The Application configuration may be set to not allow such an override. The maximum FID(0) value is 12 characters (quotes are optional). *Example:* -FID=T999 or -FID="JoesPC"
-KA	Indication that the client is to use TCP/IP KeepAlives on its end of the connection.
-LANG=xx	Two-character Language Code for displaying message boxes and dialogue information ( e.g. -LANG=EN for English). The following rules are used to select the correct language suffix. An attempt is made to load the apsmesg.?? message library in a specific order. If an attempt succeeds, then that is considered to be the correct language suffix for all message library and NOMADS Panel library files. Attempts will continue until successful, or "EN" is chosen as the default. The order of the attempts is: 1. %LANG$ Global variable set possibly via a START_UP program 2. Environment variable PVXLANG 3. Environment variable LANG 4. Default of EN
-LOGIN	Forces a login to the server. By default, CLIENT will first attempt an anonymous connection to the server. Depending on the server's configuration, the server may accept anonymous requests, or it may require a login. If the server is set for login, then the user is presented with the login screen. By setting –LOGIN, you are telling the CLIENT program to skip the attempt at an anonymous session and force the user to log in.
-SSL	Indication that the *CLIENT program is to connect to the server using SSL. If the server is using SSL, the client must also use it.
-USR1=xxx to -USR4=xxx	You may specify user-defined strings containing any information you wish. This information will be available to your server-side process from the %APS object as properties. If the strings supplied contain spaces, then you should enclose the string in quotes. *Example:* -USR1="My Directory Info"