Other Sections, Keys, and Values

Updated: April 8, 2009

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.

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 (;).

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.

noteNote
In the following table, keys controlled by specific panes of the CMAK wizard are identified in the Set in column as CMAK. Although these keys appear in the .cms file, you should use the CMAK wizard to update these keys. If you change these keys by editing the .cms file, the CMAK wizard might overwrite them if you run it again on the same profile. Keys set in the Advanced Customization pane of the CMAK wizard are identified as .cms or .cmp, as appropriate.

noteNote
Make sure that locations are specified either as the full path or in reference to the location of the .cmp file.

 

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

noteNote
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

Community Additions

ADD
Show: