Variables in the camconfig.properties File

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/

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. Details on each of these values are listed on the Customizing the myAccess Links page.

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.

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 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 RGB hexadecimal color values. Valid only when layoutType=enhanced. For samples of RGB hexadecimal color values, see Hex Color Values.

LINK Specifies the color of links that are not currently active, or that have never been visited from the local host. Use only RGB hexadecimal color values. Valid only when layoutType=enhanced.

VLINK Specifies the color to use for visited links. Use only RGB hexadecimal color values. Valid only when layoutType=enhanced.

ALINK Specifies the color of an active link; the one currently in use. Use only RGB 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.

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

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.

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.

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.property 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.

Do not change the order of the variables in the camconfig.property 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


	The myAccess Links Page
	Hex Color Values
	Customizing the myAccess Links Page

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