Creating an Automatic Open Client Connection

How do I create an automatic Open Client connection?

You can do this in two ways:

  1. Use a URL with a session name parameter

This is a URL that holds a session name for an Open Client Service defined in the Open Client Administration.

Note: You must create the Open Client Service using the Open Client Administration module.

 

Note: The Open Client Administration component is used by System Administrators to set up connections details, which are sent to system users to enable them to access the application. General system users would not use this area to log onto Open Client applications, they would perhaps have a launch page created by their administrator, which contains connection details and made secure through the use of challenge responses.

 

http://myServer/connect?SESSION_NAME=MyService


  1. Use a URL with all of the connection parameters set

This is a URL that includes all the connection parameters.

http://myserver/connect?SessionType=TELNET_SESSION&Hostname=MYHOST&Port=6023&Username=USER&Password=PWORD&CSS_UNIT=px&WIDTH_FACTOR=9&HEIGHT_FACTOR=20&IMAGE_PATHS=_proiv&UPLOAD_MAX=1000000&DO_POLL=true

Warning: Users can view all of the connection parameters and this may pose a security issue.

The parameters are:

Item

Description

SessionType

Select a Session Type that determines the connection type you want the service to establish with the PROIV application server.

 

Telnet with No Host Login (Windows)

Selecting this option specifies Telnet processing and no auto-login. Typically, you would select this option for an Open Client service where you want the login to be performed automatically by the Open Client service, or manually by the user.

 

Telnet with Host Login (Unix)

Selecting this option specifies Telnet processing and auto-login on a Unix platform. Typically, you would select this option where automatic login is not being performed by the Open Client service. If you select this option then you must also provide the details (user name and password) required by the proxy connector to enable it to handle the login negotiations with the PROIV application server.

Hostname

The IP address or system name of the machine where the PROIV application server is installed. The web browser connects to the Open Client servlet which then connects to this host. Click here to view a diagram of the communication between the web browser, Open Client, and the PROIV application server. .

Port

The port which the PROIV application server listens to for connections. The default values are 23 on Unix and 6023 on Microsoft Windows

Username

The user name used at login. If you use Microsoft Windows, the user name is used for the PROIV login process. If you use Unix, the user name is used to log onto the Unix operating system, not PROIV.

Password

The password used at login. If you use Microsoft Windows, the password is used for the PROIV login process. If you use Unix, the password is used to log onto the Unix operating system, not PROIV.

CSS_UNIT

Select the CSS positioning units that are used for the rendition of the PROIV application.

em

Em is a relative, scalable unit of length. An em is equal to the current font-size, for example, if the font-size of the document is 12pt, 1em is equal to 12pt. Ems are scalable, therefore 2em would equal 24pt, .5em would equal 6pt. The scalable nature of ems unit ensures that the PROIV rendition will scale in relation to the base font-size and the rendition will scale to fit many types of viewing device.

px

Pixels are fixed-size, absolute units of length that are used in screen media. Pixels units are not scalable so if your PROIV application is to be viewed by all users on a standard monitor, then consider setting the CSS positioning to px. If the PROIV application is to be used on many types of viewing device, consider using em positioning.

If you have existing PROIV applications (that are based on the PROIV grid structure with a default cell size of 9x20 pixels) that you want to deploy with Open Client, selecting the px setting ensures that the applications are rendered with the minimum of changes.

WIDTH_FACTOR

The scaling factor used to convert columns for CSS positioning. You can specify the width of the PROIV rendition in the browser, whereby increasing the width factor moves the PROIV rendition further to the right in browser.

HEIGHT_FACTOR

The scaling factor used to convert rows for CSS positioning. You can specify the height of the PROIV rendition in the browser, whereby increasing the height factor moves the PROIV rendition further down the browser.

IMAGE_PATHS

A list of resources to be used by the Open Client. Enter a comma-separated list of resources which is searched from left to right.

For example:

_proiv

Contains all of the PROIV Developer and PROIV Demo images. The  ‘_’ (underscore) will do a lower case conversion on the image name supplied by PROIV, prior to an attempt to locate it. This feature is useful for people who move systems between Microsoft Windows and Unix, as Unix is case sensitive.

Note: Images in the BMP file format are not supported by Open Client. It is advisable to convert them to JPG or PNG format.

 

UPLOAD_MAX

Set the maximum upload size for the file send and receive process. The send and receive process in Open Client requires user interaction, it is not a transparent process. Therefore, when a file is required by the PROIV Virtual Machine, a message box displays which prompts the user to locate the file and manually upload it to PROIV.  To avoid the system bottlenecks, it is advisable to set an upload file size limit to prevent users from uploading huge files.

DO_POLL

If this enabled, the Open Client is in poll mode. The Poll Mode attempts to avoid possible timeouts when the web browser waits for a response from the PROIV Virtual Machine by requesting the information repetitively until the answer is received, and then the connection is dropped.

Comment on this topic

Topic ID: 800018

Table of Contents

Index

Glossary

-Search-

Back