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
cachecamconfig If true, the camconfig.properties file is read-only upon startup of the application server. The value should be set to false if you are making repetitive changes to the file and require the changes to take effect upon each request to the Client Access Module.
layoutType Controls the way the program reads the camconfig.properties file. layoutType must be one of three values: default, enhanced, or custom. Details on each of these values are listed on the 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, the user can enable the automatic login 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.
TEXT Sets the color of the text. Valid only when layoutType=enhanced.
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, and Applications.
Note When these categories are presented on separate lines in the camconfig.properties file, each line should terminate with a backslash (\).
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.

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.

Using the following property settings, you can customize the error HTMLs. If these values are missing or incorrect, defaults will override these values for each error condition.

This property
Specifies
loginHtml The name of the first HTML that appears when the myAccess Links page is accessed. Valid only when layoutType=custom.
loggedOutHtml The name of the last HTML that appears when the myAccess Links page is closed. Afterwards, user must log in again. Valid only when layoutType=custom.
loginRequiredHtml Error message HTML: invalid login credentials. Value must be a valid filename.
noPluginLocationHtml Error message HTML: Java plugin not found. Value must be a valid filename.
accessDeniedHtml Error message HTML: User access has been denied. Value must be a valid filename.
notActivatedHtml Error message HTML: Presentation has been deactivated.
noResourceHtml Error message HTML: Resources not available.
noHasClientServiceHtml Error message HTML: Terminal Viewer not available.
hasServerNotAvailableHtml Error message HTML: Invalid HAS server settings.
authErrorHTML Error message HTML: Error 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
3270_ActiveX_Terminal 5250_Express_Terminal VT_Terminal
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
Sharp Client EXTRA! Enterprise FTP Client
Related Topics
Bullet Customizing the myAccess Links Page, Overview
  Attachmate