ISP and Service Type Keys

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

You can change how Connection Manager defines ISPs and service types. To do this, you need to edit the service (.cms) file. The table in this topic covers the key names and values that are contained in the [ISP] and [Service Type] sections of the .cms file. This topic also describes the formats and conventions you should use in the .cms file.

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 non-integer 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 the valid keys for the [ISP] and [Service Type] sections of the .cms file, the function and use of each key, and where you must set each key. 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 pages 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 page of the CMAK wizard are identified as .cms or .cmp, as appropriate.

noteNote
Specify file locations either with the full path or the relative path from the .cmp file directory, as appropriate to the key.

 

[Section] or key Definition and values Set in

[ISP]

Connection types (such as modem or ISDN) that you want to list in the Phone Book dialog box and how you want phone numbers to appear for each connection type. The Mask and Match keys specify whether the number is listed under Access numbers or under More access numbers. Each Mask and Match key has a corresponding option in Phone Book Administrator.

CMAK

.cms

PBFile

Location of the phone book (.pbk) file used by the connection profile.

CMAK

RegionFile

Location of the region (.pbr) file used by the connection profile.

CMAK

PBURL

Uniform Resource Locator (URL) for the phone book update.

CMAK

Mask&FilterName

Mask value for FilterName.

.cms

Match&FilterName

Match value for FilterName.

.cms

FilterA&ServiceProfile

List of filter names to be applied to the access numbers phone-book settings field, for example:

FilterA& = NoSurchargeSignon

The selected phone numbers are listed in the Connection Manager Phone Book dialog box, in Access numbers.

Default = NoSurchargeSignon

.cms

FilterB&ServiceProfile

List of filter names to be applied to the referenced phone book options field, for example:

FilterB& = SurchargeSignon

The selected phone numbers are listed in the Connection Manager Phone Book dialog box, in More access numbers.

Default = SurchargeSignon.

.cms

References

Connection profiles merged through the CMAK wizard. Profile names are separated by commas, tabs, or spaces. Each name is used as a reference to that profile.

CMAK

CMSFile&MergedProfile

Location of a component connection profile .cms file for a merged connection profile. The format is CMSFile&MergedProfile = Location, where MergedProfile is the name of the top-level connection profile and Location is the location of the .cms file for the component connection profile, for example:

CMSFile&Awesome1 = Awesome1\AwesomeE.cms

CMAK

FilterA&MergedProfile

List of filter names to be applied to the component profile's phone book options field. The format is FilterA&MergedProfile = FilterName, where MergedProfile is the name of the merged connection profile, as specified in the CMSFileMergedProfile key, and FilterName is the name of the filter to be applied, for example:

FilterA&AwesomeE = NoSurchargeSignon

The selected phone numbers are merged into the list in the Connection Manager Phone Book dialog box, in Access numbers.

CMAK

FilterB&MergedProfile

List of filter names to be applied to the component profile's phone book options field. The format is FilterB&MergedProfile = FilterName, where MergedProfile is the name of the merged connection profile, as specified in the .cms file References key, and FilterName is the name of the filter to be applied, for example:

FilterB&AwesomeE = SurchargeSignon

The selected phone numbers are merged into the list in the Connection Manager Phone Book dialog box, in More access numbers.

CMAK

[Service Types]

Items that are listed in the Phone Book dialog box, under Service type. By default, this section contains two service types. At least two service types must be defined in order for phone numbers to appear in the Properties dialog box of the Connection Manager client.

CMAK

.cms

ServiceType

A service type as a filter name to be applied to the referenced phone book options field. The format of the entry is ServiceType = FilterName, where ServiceType is the name as it appears in the Phone Book dialog box, in the Service type list, and FilterName is the name of the filter to be associated with the entry, for example:

ISDN Multicast = MulticastISDN

A service type name should include no more than 25 characters. You can concatenate service type names by inserting a space between each name. At least two service types must be defined in order for phone numbers to appear in the Properties dialog box of the Connection Manager client.

.cms

Community Additions

ADD
Show: