Recording Connectors contain the full connection details to a PROIV environment and are a mandatory and permanent feature of a Recording. They contain the same information as an Open Client service, or a PIV file, which is used to connect to a PROIV Server. Refer Open Client documentation for more information.

You can create a catalogue of Recording Connectors, they can be added, deleted and maintained on the Recording Connectors window. The connection details are dependent on the Session Type that is selected, i.e. Windows or UNIX. Consequently, you will notice that there are more fields enabled when a UNIX Session Type is selected.

Recording Connectors can be created when you initially create a Recording, or you can open the Recording Connectors window from the Admin Options on the PROIV Assure Toolbar, and then you can create or amend the connection details. In addition, you can test the connections from those windows and feedback is provided if the connection is successful or fails, or displays a PROIV message box, if applicable.

Recording Connectors are permanent part of the Recording itself and as such they cannot be amended once set. When you amend a Recording Connector, you are changing that particular connection configuration, and any Recording that may use the Record Connector is not affected by the change.

It is also important to note that the Recording Connector details are logged against a Test Run.

To add a Recording Connector, follow these steps:

  1. Click Admin Options Admin options icon on the PROIV Assure toolbar. Alternatively, select the Admin option from the PROIV Assure menu.

  2. Select the Recording Connectors option.

  3. The Recording Connectors window appears.

Fields on the Recording Connectors window:

Item

Description

Column Headings

 

Connector Name

Displays Recording Connector's name.

System

Displays the Session Type.

Host/IP Address

Displays the host details or IP address used by the Recording Connector.

Mandatory

Port

Displays the port used by the Recording Connector.

Mandatory

Buttons

 

Add

Click Add to create a Recording Connector.

Delete

Click Delete to delete a Recording Connector. You are prompted before the deletion occurs.

Properties

Click Properties to maintain the Recording Connector details. The Recording Connector Details window appears, which shows the information that you can amend as appropriate.

  1. Click Add to create a new Recording Connector. The Add New Connector window appears.

  2. Enter a name for the Recording Connector in the Connector Name field.

  3. Click OK to close the Add New Connector window.
    The Recording Connector Details window appears.

Fields on the Recording Connector Details window:

Item

Description

Session Type

Select a Session Type that determines the connection type you want the service to establish with the PROIV application server. The selection made in the drop-down list determines which fields are enabled on this screen.

Windows

Selecting this option specifies Telnet processing and no auto-login.

UNIX

Selecting this option specifies Telnet processing and auto-login on a UNIX platform.

A32 - Mandatory

Host /IP Address

The IP address or system name of the machine where the PROIV application server is installed.

A32 - Non-Mandatory

Port

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

N4 - Non-Mandatory

PROIV User Name or Unix User Name

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.

A32 - Non-Mandatory

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.

A32 - Non-Mandatory

Success Prompt

The string to search for to indicate that the login has been successful. Applicable for UNIX operating systems. The default value is  '$'.

This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Failure Prompt

The string to search for to indicate that the login has failed. Applicable for UNIX operating systems.  The default value is ' ncorrect'.

This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Login Prompt

Specify the login prompt for the operating system. You can enter 'ogin' for case insensitive logons.

This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Password Prompt

Specify the password prompt for the operating system. You can enter 'assword' for case insensitive passwords.

This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Command

Command to be run on the host machine once logged in. The default command is ./runproiv.sh. This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A250 - Non-Mandatory

Image Paths

By default, Assure picks up the application which is set in the OpenClient; however, the image path mentioned in this box will overwrite the default path.

Xferin

Passes parameters to the PROIV session at start up.

A250 - Non-Mandatory

Template Page

A template page is used to reference Cascading Style Sheets which control the look and feel of the rendered widgets (for example icons, objects, etc.)

You do not have to enter a template page name in the field as Open Client will search the resource paths for the default template page, index.html. If the file is located, it will be used. It references two CSS files; PROIVFixedStyle.css and PROIVDefaultStyle.css which control the look and feel of the rendered application.

Warning: Do not change the contents of the PROIVFixedStyle.css and PROIVDefaultStyle.css as any updates released by PROIV will overwrite your changes.

You can also create your template page which must be called index.html and must be placed in the root of your folder under the appResources folder. The Open Client loads its own CSS files, but properties in these files may be overridden by properties in your CSS files.

A250 - Non-Mandatory

Upload Maximum

Sets 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 appears 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.

N10 - Non-Mandatory

Calendar Control

Check to enable standard Windows Calendar Control for input of dates. This is enabled on a global basis and does not require any application changes. You can select or deselect this option only when disconnected from PROIV.  Once a connection is active, you cannot change the setting; the box and the text are greyed out, but the check is still visible in the box. The default setting for the option is disabled.

Buttons

 

Test Connection

Click Test Connection to test the connection.

OK

Click OK to save the Recording Connector details and to close the Recording Connector Details window.

Cancel

Click Cancel to cancel the process and to close the Recording Connector Details window.

  1. Click OK to save the Recording Connector details and to close the Recording Connector Details window.

  2. Click OK to close the Recording Connectors window.

  3. You can then assign the Recording Connector to a Recording.

Comment on this topic

Topic ID: 780013