Additional myAccess Links Properties

All changes in the appearance of the myAccess Links page are controlled by the camconfig.properties file, which is located in the following directory:

MCS_install_root/components/PresentationBuilder/camconfig/
Note Before editing the properties file, we recommend that you make a back-up copy for safekeeping.
This variable
Does this
layoutType Controls the way the program reads the camconfig.properties file. layoutType must be one of three values: default, enhanced, or custom. For details on each of these values, refer to the topic Customizing the myAccess Links Page.
openChannelAutoLoginEnabled Default is false. Direct, pre-authenticated access to a presentation (open channel auto-login functionality) can be enabled or disabled. If true, you can deploy pre-authenticated presentations directly to end users by using the procedure in the topic Deploying Presentations.
htmlOutputExt Specifies an identifier that appends to the name of the links for each presentation that can be viewed in HTML format.
showInSeparateBrowser If true, opens the presentation in a separate browser window. Options are true or false. Valid only when layoutType=enhanced.
showInSeparateFrame Used only for pop-ups. Launches the presentation from a special invisible frame. The default setting is true. Valid only when layoutType=enhanced.
enableEmbeddedResizing Default is false. If true, forces the use of framesets when displaying the presentation, causing the views to be resizable. The only way to turn this on is in Enhanced mode, otherwise, default behavior is false, and the embedded views will not be resizable. If the value is true, but the browser does not support frames, the value is overridden to false. Setting is not valid when layoutType=custom.
Note This setting is applicable only when two or more views are embedded in a presentation.
putExternalHeaderFooterInTable This is only applicable when a presentation is loaded which uses external files for its header and footer. By default, the header and footer are put into html tables. However, if the user uses HTML snippets with advanced scripting code to control the components within the presentation, then set this property to false. This will broaden the scope of the scripting code to access the rest of the presentation(s). The default is true. Valid only when layoutType=enhanced.
showLogo If true, displays the .GIF files identified for each page (Links, logon, and logoff). When false, no graphics appear, and the background color is displayed. The default is true. Valid only when layoutType=enhanced.
showLogoFade If true, affects the quality of the graphics file specified by the variable enhancedLogo, by creating a transparent effect near the bottom. When false, the logo background color will be Attachmate blue (RGB [5,64,164] HEX 0540A4) in default mode, or the value of BGCOLOR in enhanced mode.
showWaterMark If true, causes a globe image to be shown behind the links. When false, the BGCOLOR shows beneath the links. Valid only when layoutType=enhanced.
enhancedLogo Identifies the graphics file used on the myAccess Links page. Valid only when layoutType=enhanced and showLogo=true. The graphics file must be placed in the directory:
MCS_ install_root/components/PresentationBuilder/camconfig/enhanced/locale
loginLogo Identifies the graphics file used on the login screen that takes the user to the myAccess Links page. Valid only when layoutType=enhanced and showLogo=true. The graphics file must be placed in the directory:
MCS_ install_root/components/PresentationBuilder/camconfig/enhanced/locale
logoffLogo Identifies the graphics file used on the logoff screen displayed when closing the myAccess Links page. Valid only when layoutType=enhanced and showLogo=true. The graphics file must be placed in the directory:
MCS_ install_root/components/PresentationBuilder/camconfig/enhanced/locale
leftFrameWidth Sets the column width of the left pane. The default is 200. Valid only when layoutType=enhanced.
BGCOLOR Sets the background color. Use only hexadecimal color values. Valid only when layoutType=enhanced. For samples of hexadecimal color values, see Changing the Basic Colors.
LINK Specifies the color of links that are not currently active, or that have never been visited from the local host. Use only hexadecimal color values. Valid only when layoutType=enhanced.
VLINK Specifies the color to use for visited links. Use only hexadecimal color values. Valid only when layoutType=enhanced.
ALINK Specifies the color of an active link; the one currently in use. Use only hexadecimal color values. Valid only when layoutType=enhanced.
fontweight Sets the font style within the body tags. Options are normal and bold. The default setting is fontweight=normal. Valid only when layoutType=enhanced.
fontsize Sets the font size within the body tags. The default settings is fontsize=10pt. Check with each specific font to determine available sizes. Valid only when layoutType=enhanced.
fontfamily Sets the preferred font within the body tags. The default settings is fontfamily=Arial. The client's browser and operating system determine which fonts are available. Valid only when layoutType=enhanced.
doSort When true, arranges the order of the displayed links to presentations according to the value of the sortingOrder variable. Valid only when layoutType=enhanced.
showGroupLabels When true, combines links on the myAccess Links page into defined groups, each with a specified title, and works intricately with the sortingOrder variable. Shared group names are combined when their categories are adjacent in the sortingOrder. If not adjacent, the group name is repeated. Valid only when layoutType=enhanced.
enableMixedViewers If true, permits use of a special category of presentations, Mixed Viewers, for presentations that contain two or more viewers. When false, the Mixed Viewers category is not recognized, and all presentations that contain two or more viewers are categorized as Applications.
sortingOrder Creates a comma-delimited list that consists of all available types of categories. When doSort=true, the links on the myAccess Links page pare presented in the same order as presented in the list in sortingOrder. When showGroupLabels=true, the links are still presented in this order, but can be arranged into titled groups. All categories should remain listed, regardless of usage. However, their order can be changed into any arrangement. Valid only when layoutType=enhanced.

The categories are: 3270 Terminal, 3270 ActiveX Terminal, 3270 Express Terminal, 3270 HotGUI, 3270 Printer, 3270 ActiveX Printer, 5250 Terminal, 5250 ActiveX Terminal, 5250 Express Terminal, 5250 HotGUI, 5250 Printer, 5250 ActiveX Printer, 5250 File Transfer, 3179 Host Graphics Option, VT ActiveX Terminal, VT Terminal, VT Express Terminal, Mixed Viewers, Custom Application, WebDoc, Applications, EXTRA! X-treme, and FTP Client.
Note When these categories are presented on separate lines in the camconfig.properties file, each line should terminate with a backslash (\).
TARGET Globally changes the behavior of anchor elements. Acceptable values are: _blank, _self, _parent, _top, or a valid frame name. Valid only when layoutType=custom.
customDir Identifies the directory where custom files are stored. Valid only when layoutType=custom. The required syntax for customDir is:
MCS_install_root/components/PresentationBuilder/camconfig/customDir/locale
Note A common error when creating custom directories is to exclude the locale directory, such as en for English. If a client attempts to access a custom myAccess Links page with an unprovided locale, the default myAccess Links page will be presented.

To comply with browser localization formats, you must adhere to the localized directory structure specified by the java.lang.object java.util.locale class.

Customizing Event and Error Messages

Using the following property settings, you can customize the messages displayed by presentations that encounter certain events or errors. These messages will consist of HTML pages that you create. The values of these properties must be valid filenames. If these values are missing or incorrect, default HTML pages will be displayed for each event or error condition.

This property
Specifies the filename of the HTML page you want to display
loginHtml When the myAccess Links page is first accessed. Valid only when layoutType=custom.
loggedOutHtml When the myAccess Links page is closed. Afterwards, user must log in again. Valid only when layoutType=custom.
loginRequiredHtml If the user enters invalid login credentials.
noPluginLocationHtml If the myAccess Links page cannot find the Java plugin.
accessDeniedHtml If the user has been denied access to this resource.
notActivatedHtml If the requested presentation has been deactivated.
noResourceHtml If the requested resources are not available.
noHasClientServiceHtml If the requested Terminal Viewer is not available.
hasServerNotAvailableHtml If the Terminal Viewers manager was configured with invalid settings.
authErrorHTML If an error occurs during authentication.

Group Name Variables

The following variables are group names for specific categories. Each of these variables must remain in the camconfig.properties file, even if it is not used. The value for each is a group name, which appears on the myAccess Links page above the links for that category. If the user can access no presentations of a particular category, no group name will be displayed, nor will the group name appear on the myAccess Links page.

Caution Do not change the order of the variables in the camconfig.properties file — the display order is controlled by the value of sortingOrder, which is valid only when layoutType=enhanced and showGroupLabels=true. doSort=true enables the links to appear in the specified sortingOrder.
3270_Terminal 5250_ActiveX_Terminal VT_ActiveX_Terminal EXTRA! X-treme
3270_ActiveX_Terminal 5250_Express_Terminal VT_Terminal FTP Client
3270_Express_Terminal 5250_HotGUI VT_Express_Terminal
3270_HotGUI 5250_Printer Mixed_Viewers
3270_Printer 5250_ActiveX_Printer Custom Application
3270_ActiveX_Printer 5250_File_Transfer WebDoc
5250_Terminal 3179_Host_Graphics Option Applications
Related Topics
Bullet Customizing the myAccess Links Page, Overview
  Attachmate