Chat now with support
Chat with Support

Coexistence Manager for GroupWise 1.7 - Program Parameters Reference Guide

About the CMG documentation suite

The documentation for Quest Quest Coexistence Manager for GroupWise (CMG) includes:

Release Notes (printable PDF): Describes the current CMG release—any new and enhanced features, resolved issues, and known issues. Also documents minimum and recommended installation requirements, and provides Quest contact information.
Quick-Start Guide (printable PDF): An orientation to the product's basic purposes, features and capabilities, with brief case studies showing how its primary components are most commonly used within a typical coexistence scenario. Also summarizes deployment considerations, and explains how to download and install the software.
CMG User Guide (printable PDF): Overview of features and general deployment guidelines for CMG's Directory Connector, Mail Connector and Free/Busy Connector, with screen-by-screen field notes for the Management Console application used to configure all three components. The User Guide also povides process instructions for installing and configuring the Directory Connector and Mail Connector, and for configuring the GroupWise and Exchange/AD environments to work with these components. (The same information for the F/B Connector is deferred to a separate FBC Configuration Guide.)
CMG FBC Configuration Guide (printable PDF): Process instructions and application notes for installing and configuring CMG’s Free/Busy Connector (FBC). An introductory chapter is followed by 12 chapters that each describe the complete process for installing and configuring the FBC for a particular combination of GroupWise environment and Exchange environment, for either a single- or multi-namespace environment.
CMG FBC Configuration Guide (printable PDF): Process instructions and application notes for installing and configuring CMG’s Free/Busy Connector (FBC). An introductory chapter is followed by 12 chapters that each describe the complete process for installing and configuring the FBC for a particular combination of GroupWise environment and Exchange environment, for either a single- or multi-namespace environment.
CMG Program Parameters Reference (printable PDF): Listing of all CMG program parameters that can be used to configure CMG component behavior to best suit a particular environment and facilitate local preferences.
Management Console Online Help (three compiled Windows Help files, one for each CMG component): Instructions and application notes for the various screens and features of CMG’s Management Console utility.

This table shows where you can find particular types of information about particular CMG components:


for Dir Connector & Mail Connector

for Free/Busy Connector

Introduction and orientation:

— — CMG Quick-Start Guide and User Guide — —

Installation instructions:

— — CMG Quick-Start Guide — —

Configuration instructions:

CMG User Guide

CMG FBC Configuration Guide

Operating instructions:

— — CMG User Guide — —

Troubleshooting info:

CMG User Guide

CMG FBC Configuration Guide

The CMG application Help files contain the same information as the User Guide, but make the information available on-screen at the push of a button (from the CMG Management Console).

All CMG documentation is intended for network administrators, consultants, analysts, and any other IT professionals who will install or use the product components, or who may help plan for their use in a coexistence scenario. All of these documents, including the online Help, are bundled and installed with the product, and all except the Help files are also available separately at Quest's Support Portal.


About CMG Program Parameters

Introduction to CMG parameters

CMG's Directory Connector, Mail Connector and Free/Busy Connector are configurable, and most of their feature options are set in CMG's Management Console. The Management Console is a friendly interface between you and a set of configuration files that CMG components read every time they are started.

Configuration settings for CMG’s different components are saved in separate configuration files: a Configuration.xml file for each of the Directory Connector and Mail Connector (two files with the same name, but saved in the different CMG component subfolders), and another set of configuration files for the Free/Busy Connector (in the FBC's component subfolder). The Management Console provides GUI screens with labeled fields to simplify entering and editing the configuration settings in those files.

When you start the Management Console, CMG automatically loads the currently active configuration values for all three CMG components. Once the Management Console is running, however, component configuration data is saved and opened separately, for one component at a time, as shown here:

While the Management Console lets you enter and change most CMG feature options, some options can be set and changed only by manually editing the corresponding Configuration.xml file. This FBC Configuration Guide documents those parameters.

NOTE: All FBC program parameters in the current release are associated with UI fields in the FBC Management Console. As such, these parameters are not documented in this Reference, since they should not be edited manually (in the xml files) except at the direction of Quest Support.

The contents of a configuration XML file can be edited by any XML editor, as described separately below.

Parameter format and structure

CMG parameters are specified and stored in XML Unicode text files that conform to XML markup standards and conventions. Each parameter is specified by an XML element, consisting of a start tag, an end tag, and the parameter value between the two tags. For example:

As with all XML markup tags (and as shown in these examples), the start and end tags are both enclosed within angle brackets, and the end tag is denoted by a slash character (“/”) inside the angle brackets preceding the parameter name.

Within a CMG parameters XML file, related parameters are grouped into sections, which also are named and marked by pairs of tags. For example:

The section tags and parameter elements within an XML file are typically broken into separate lines and indented, as shown here, just for human readability. But the line breaks, indentions and any other white space that occurs between elements are ignored by the programs that read the files.

Spaces that occur within a parameter value, however, are significant. For example, the spacing within a text string such as:

... will be read, interpreted and used by the program in exactly that same form, with spaces intact.

Likewise, upper/lowercase within a parameter value may be significant, but only if case matters in whatever context the program will use the string. For example, if <CityName>baLtImOre</CityName> and the program will copy that parameter value into a program log or report, or into the user interface as a display element, the name will appear there in that same peculiar form: as "baLtImOre." Section and parameter names (tag contents), however, are case-insensitive.

Spelling of parameter names and parameter values is always critical. If a program is looking for a parameter name UserAddress, it will not recognize a parameter name UsreAddress or UserAdress.

The default value of a parameter is the value that will prevail in the program if the parameter is omitted from its Configuration.xml file.

For any given parameter, the parameter value will be meaningful only if it conforms to the parameter’s particular data type. Every parameter value is one of these five data types:

String: An alphanumeric string.
Integer: A non-decimal numeric value.
Boolean: A value of “true” or “false” to specify whether a particular feature or function is to be enabled or disabled, or whether a particular operating condition is true or false.
Date: A date, formed by eight digits with two slash characters, in the form: mm/dd/yyyy.
Keyword: An alphanumeric string that matches one of a finite set of valid keyword strings defined for the particular parameter.

Many parameters that appear in the CMG xml configuration files simply store values that are entered or selected in the fields of various screens in CMG’s Management Console software. These UI-associated parameters are therefore not documented in this Reference, since their values should not be manually edited in the xml files except at the direction of Quest Support.

Self Service Tools
Knowledge Base
Notifications & Alerts
Product Support
Software Downloads
Technical Documentation
User Forums
Video Tutorials
RSS Feed
Contact Us
Licensing Assistance
Technical Support
View All
Related Documents