Session Documents

Terminal session settings are saved to session documents. Session documents are specific to each terminal type (*.ialc, *.iuts, *.it27, *.rd3x, *.rd5x, or *.rdox). (The options available depend on your InfoConnect Desktop product.)

For ALC, UTS, and T27 sessions, session documents include a link to a path that includes required connection information. Path definitions are saved in the InfoConnect database.

For 3270, 5250, and VT sessions, the session documents include all host connection information.

In addition to basic connection information, a number of session customization options are available. These include themes (to change display options such as font and color), keyboard maps, mouse maps, hotspots, quickpads, and ribbon (or menu) customization. By default these customizations are saved to separate files and a pointer to the customization file is saved to the session document. It is also possible to save sessions as compound documents that include these customizations.

Document Settings

Document settings are specific to each terminal type and can be configured from the Document Settings dialog box.

To open the Document Settings dialog box

  1. Start a terminal session.

  2. Open the Document Settings dialog box.

    The steps depend on your user interface mode:

    Ribbon or InfoConnect Browser

    With a session open, from the Quick Access Toolbar, click .

    TouchUX

    With a session open, tap the Gear icon and then select Document Settings.

    Classic MDI

    With a session open, go to Options > Settings

The Document Settings options available depend on your session type.

Changes you make to the following are always saved in the session document: Host Connection, Terminal Configuration, File Transfer, Productivity, Printer Settings.

Changes you make to the following are saved by default to separate customization files: Themes, QuickPads, Hotspots, Ribbon, Keyboard Map, Mouse Map. These settings are included in the session document if you save it as a compound document.

Session documents are saved to the InfoConnect user data folder This folder location is configurable using the Data Location tab during installation. The default is C:\Users\username\Documents\Micro Focus\InfoConnect. . Associated customization files are saved to subfolders in the user data folder.

Deploying session settings

To ensure that users can find their sessions and that these sessions include all customizations, save your sessions as compound documents and install them to the InfoConnect user data folder This folder location is configurable using the Data Location tab during installation. The default is C:\Users\username\Documents\Micro Focus\InfoConnect. . When you deploy session documents to this folder, users will see the sessions listed when they open documents from the Workspace without having to browse their file system.

  • If you deploy session documents to a non-default location, ensure that you have configured it as a trusted location. You can provide easy access to these files by configuring shortcuts to launch the sessions directly.

  • If you do not save session settings in compound documents, all required customization files must be deployed along with your session files to the correct folder location(s).

Deploying sessions using the Installation Customization Tool

You can use the Installation Customization Tool to create a companion package that installs your session documents and optionally creates shortcuts to launch the sessions. See Create a Companion Package to Install Customized Settings Files.

An advantage of deploying settings using the Installation Customization Tool is the ability to modify the Setup program to include your customizations. See Customize the Setup installation.

Deploying sessions using the Management and Security Server

If you have installed the Micro Focus Host Access Management and Security Server, you can use it to manage and deploy session documents. Deploying this way provides several advantages:

  • Manage sessions centrally and update session settings as needed.

  • Limit session access to specific users or groups using a directory server (LDAP/Active Directory).

  • Use the Security Proxy to encrypt session data and enforce access control.

See Manage Sessions using the Management and Security Server.

Compound Documents

When you save a session as a compound document all customizations are included in a single file. This means that your compound file will include all the settings in any associated theme, keyboard map, mouse map, hotspot, ribbon, or QuickPad file. This option enables administrators to deploy session files with all required customizations included in a single file.

NOTE:If you do not save session settings in compound documents, all required customization files must be deployed along with your session files to the correct folder location(s).

To save an individual session as a compound document

  1. Open a terminal session and make the modifications you want to include with this session.

  2. Open the Save As dialog box.

    The steps depend on your user interface mode.

    User Interface Mode

    Steps

    Ribbon

    From the File menu, select Save As.

    InfoConnect Browser

    From the InfoConnect menu, select Save As.

    TouchUX

    Under FILE, tap Save As.

    Classic MDI

    From the File menu, select Save As.

  3. For Save as type, select the compound option for your session type, then click Save.

To save all sessions as compound documents

  1. Open the Workspace Settings dialog box.

  2. Click Configure Workspace Defaults.

  3. Under Workspace, select Save session as compound document.

Session Templates

After you configure a session document, you can share and reuse your settings by saving the document as a template. Templates provide an untitled copy of the original, giving you a quick and easy way to create pre-configured documents, while ensuring that your original file remains unchanged.

To create a session template

  1. Open the session document that you've configured.

  2. Name the template file with an .rsft extension.

To make changes to the template, you must replace the template file — save the file that contains your changes using the same filename and extension as the template.

Deploying templates

Deploy templates in the same way you deploy session documents. (See Deploying session settings.) Install these files to the Templates folder:

InfoConnect user application data folder The default is \Users\username\AppData\Roaming\Micro Focus\InfoConnect\Desktop\version. \Templates\

Templates saved to this location appear in the Create New Document dialog box, under User-defined.