Other Sections, Keys, and Values

Applies To: Windows 7, Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2, Windows Server 2008, Windows Server 2008 Foundation, Windows Server 2008 R2, Windows Server 2012, Windows Vista

This topic covers sections, keys, and values that might appear in service (.cms) files, particularly those created with older versions of the Connection Manager Administration Kit (CMAK) wizard.

Formats and conventions

Connection Manager creates service (.cms) files, which use the same format as Windows initialization (.ini) files and information (.inf) files. These files have several things in common:

• Each file is divided into sections, with specific entries, called keys, assigned to the sections. A section heading is enclosed within brackets ([ ]). For example, [Strings] is a section containing text strings for messages. The keys for a section are not enclosed within brackets.

• Each value specified for a numeric key must be an integer. Any noninteger value is truncated to an integer or ignored as invalid data. For example, 1.1 is truncated to 1 or ignored.

• The order in which sections appear is not important; a particular section can be placed anywhere in the file.

• Each comment in the file begins with a semicolon (;).

Table of other sections, keys, and values

The following table shows valid sections, keys, and values in the .cms file, the function and use of each key, and where each key can be set. You can set different keys in the CMAK wizard or the .cms file. If you change the .cms file with a text editor, rather than by using the Advanced Customization page of the CMAK wizard, you must rebuild the profile afterward with the CMAK wizard.

[Section] or key	Value	Set in
[Logging]	Section header for logging keys.	.cms
FileDirectory	Location of the log file. If the value is blank, the log file is created in the temp folder.	.cms
MaxFileSize	The maximum file size (in kilobytes) before the log is cleared. The file size is checked at initialization to prevent data loss during a connection. The default is 100.	.cms
[Menu Options]	Shortcut menu that appears when a user right-clicks the notification area shortcut for your service. Note This section and its options are only valid on computers that are running Windows XP or Windows Server 2003. They are ignored on all later versions of Windows.	CMAK .cms
MenuItemName	Command to be run from the shortcut menu. Shortcut menu commands use the format MenuItemName = Program, where MenuItemName is the descriptive name that appears on the shortcut menu and Program is the name of the executable file (.exe or other shell executable), including any parameters required for the program. For example, if you wanted to add Notepad to the menu with the command name "Editor," the line would be Editor = Notepad.exe. Default commands = Status and Disconnect. These programs are available in a shortcut menu that appears when a user right-clicks the notification area shortcut. Applications are listed in the menu in the same sequence as they are listed in the .cms file.	CMAK
[Animated Logo]	Animation for the Connection Manager logon dialog box. The [Animated Logo] section specifies the location of the animation (.spl or .swf) file. This function is provided for compatibility with Connection Manager 1.0, which supports Macromedia Flash animation files. AnimatedLogo in the [Connection Manager] section determines whether an animation is used.	.cms
Movie	Location of the animation file displayed in place of the static bitmap in the logon dialog box. Settings in the [Animated Actions] section control how the animation plays based on the connection state.	.cms
Parameter	Other animation parameters passed from software used to create the animation, such as Quality = 3.	.cms
[Animated Actions]	When to play segments of the animation.	CMAK .cms
Initial	Starting frame number; plays when Connection Manager starts.	.cms
Dialing0	Starting frame number; plays while the primary phone number is dialed.	.cms
Pausing	Starting frame number; plays during pauses between dials.	.cms
Dialing1	Starting frame number; plays while the backup phone number is dialed.	.cms
Authenticating	Starting frame number; plays during user authentication.	.cms
Tunneling	Starting frame number; plays while establishing a VPN connection.	.cms
Connected	Starting frame number; plays when a connection is established.	.cms
Error	Starting frame number; plays at any connection error.	.cms
[CustomButton Actions]	Controls what programs start when the custom button is clicked. The format of the value is # = Program, where # is an ID number from 0 to n and Program is the complete name of the program, including the extension and the path to the program. Programs start in sequence: 0 first, 1 next, and so on. Custom button programs cannot be DLL files.	CMAK .cms
[Profile Format]	Connection profile version.	CMAK .cms .cmp
Version	Format version of the profile or service file.	.cms .cmp

Additional references

• Tables of Key Names and Values