Export (0) Print
Expand All

Advanced Customization Options for Connection Manager

Cc939869.chap_14(en-us,TechNet.10).gif Cc939869.image(en-us,TechNet.10).gif

The CMAK wizard supports most of the customization features that administrators need to build a custom Connection Manager service profile. However, you can customize additional features by editing the service-profile files and changing the manner in which Connection Manager implements certain functions.

You can edit service-profile files to customize functions and features that are not controlled through the CMAK wizard. To do this advanced customization, you can edit two sets of service-profile files:

  • The template files that are used by the CMAK wizard to build all service profiles

  • The files that are built when you run the CMAK wizard to create a specific service profile

Service-profile files consist of the following file types:

  • Service provider (.cms) files - These files specify the configuration of the phone book and most of the other functions of your service profiles. Most advanced customization for a service profile is done by editing the .cms file for that service profile.

  • Connection profile (.cmp) files - These files contain information specified by the user. You should not edit the .cmp files because any changes you make can be overwritten by the user.

  • Information (.inf) files - These files specify the installation information for your service profiles. Although you can edit some setup and removal information in an .inf file, you must be extremely cautious to avoid installation problems.

  • Connection profile (.sed) files - These files contain the instructions for building a self-extracting executable (.exe) file for your service profiles. You should never edit any .sed file.

Important Be careful when you modify these files. Troubleshooting the changes made to these files is difficult. Never modify the original file, and always make backup copies. A basic understanding of system-configuration files is assumed.

Editing Service-Profile Files

You can edit either the template files or the specific service-profile files, or both, depending on whether you want your customization options applied globally to all service profiles or only to a specific service profile.

Template Files

When you install the CMAK, the following template files are installed in the \Program Files\CMAK\Support folder:

  • Template.cms

  • Template.cmp

  • Template.inf

  • Template.sed

These files contain the default settings that the CMAK wizard uses to build the service profiles. If you want to incorporate custom functions in all service profiles that you build, edit the template files before building the service profiles.

Generally, you should edit only the .cms template file.

Built Files

When you use the CMAK wizard to build a service profile, the wizard creates a self-extracting .exe file and several other files that contain the settings that you specify. The service-profile files are saved in the following folder: \Program Files\CMAK\Profiles\ ServiceProfileFileName

All service-profile files have the name ServiceProfileFileName , which you specify in the CMAK wizard. In addition to the .exe file, the wizard creates the following files for each service profile:

  • ServiceProfileFileName .cms

  • ServiceProfileFileName .cmp

  • ServiceProfileFileName. inf

  • ServiceProfileFileName .sed

For all files except the .cmp files, the built files take precedence over the template files. After editing a service-profile file, you must run the CMAK wizard again to rebuild the service profile with your customized settings.

Formats and Conventions

Connection Manager creates service (.cms) files, which use the same format as Windows .ini files and information (.inf) files. In these files:

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

  • Each value specified for a numeric entry 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.

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

For more information about these formats and conventions, see the Microsoft Platform Software Development Kit.

Customizing Functions

You should customize the entries only in the .cms and .inf files, and only as specified in this chapter.

Information (.inf) File Entries

By editing an .inf file, you can specify commands that run when the user sets up or removes your service profile. For example, you can specify:

  • Setup programs that integrate any custom software that you include

  • Programs that automatically display a readme file

  • Configuration utilities or cleanup programs

To add custom set-up and uninstall commands to your service profile, you must first create the service profile by running the CMAK wizard and incorporate any files needed to run your custom commands by specifying each of them as an additional file. After you have built the service profile, specify the custom commands in the appropriate sections of the .inf file.

The .inf file contains the following four sections that you can edit to incorporate setup and uninstall commands, each of which controls the commands that are run at a specific point in the process. Use only file names of eight characters or less (do not use spaces).

  • RunPreSetupCommands - Commands specified in this section run before installation of your service profile.

  • RunPostSetupCommands - Commands specified in this section run after the setup program finishes the service profile.

  • RunPreUnInstCommands - Commands specified in this section run before the uninstall program begins.

  • RunPostUnInstCommands - Commands specified in this section run after the uninstall program runs.

Each command should include the name of the program to be run and any command-line parameters. Each command specified in the .inf file is run only once during an installation or removal process.

Important Incorrectly specified entries can cause significant installation problems. You should not edit any of the entries in the .inf file except those previously specified. Thoroughly test all service profiles that contain custom .inf entries for version, file, or other conflicts. Be sure that the file location is specified correctly.

When upgrading to a new version of the Connection Manager Administration Kit, the new .inf file replaces the previous .inf file. After the upgrade, you must add your custom entries to the new .inf file if you want to continue using your custom setup and uninstall commands in the service profiles that you build.

Long file names are not supported.

Service Provider (.cms) File Entries

Editing a .cms file can change the implementation of many of the Connection Manager functions. For example, you can do the following:

  • Edit the RedialDelay entry, which controls the delay between redials.

  • Edit the PasswordHandling entry, which specifies case sensitivity for passwords.

  • Edit the HideRememberPassword entry, which controls whether the Save password check box appears.

  • Edit the HideDialAutomatically entry, which controls whether the Connect automatically check box appears.

  • Edit the ResetPassword entry, which controls whether a New button appears in the Connection Manager logon dialog box.

  • Edit the HideDomain entry, which controls whether the Logon domain field appears.

  • Edit settings in the [Server& EntryName ] and [TCP/IP& EntryName ] sections, which enables you to specify additional settings that control the way in which Dial-Up Networking entries are handled in Connection Manager. Many of these settings are controlled through the CMAK wizard; however, some must be edited in the .cms file, such as the IP_Header_Compress setting.

The following table shows the valid entries for each section of the .cms and .cmp files, the function and use of each entry, and where each entry can be set - in the CMAK wizard, .cms file, and/or .cmp file.

Notes

  • Do not edit any entry in the .cms file if it can be set by using the CMAK wizard, because the CMAK wizard may overwrite entries in the .cms file.

  • If an entry is valid in both .cms and .cmp files, edit only the .cms entry.

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

[Section] or entry

Specifies

Set in

[Connection Manager]

Miscellaneous service-profile settings.

.cms .cmp

Dialup

Whether dial-up connections are supported.
0 = No. 1 (default) = Yes.

.cms

Direct

Whether direct connections are supported.
0 = No. 1 (default) = Yes.

.cms

ConnectionType

The connection method used.
0 (default) = Connect by using a dial-up connection - for example, a modem. 1 = Connect by using a direct connection - for example, a LAN.
The first time the service profile is run, the user is prompted to select the appropriate option. The user can change this option on the General tab in the Properties dialog box. The setting in the .cmp file represents the current state.

.cms .cmp

PBMessage

Text in the Phone Book dialog box next to the More access numbers box when the phone book is displayed and alternate access numbers are available for the selected geographic region. Maximum = approximately 100 characters.

CMAK .cms

CMSFile

Name of the service-profile file ( \Path\ServiceProfileFileName . cms ).

CMAK .cmp

ServiceName

Text appearing in the Connection Manager logon dialog box as the service name, and as the name of the connection object. This is the key identifier for the profile.
Maximum = approximately 35 characters.
If the Connection Manager service profile is to be included in a Microsoft Internet Explorer installation package created with the IEAK, this name must be the same as the name specified in the [Entry] section of the Internet Explorer .ins file.

CMAK .cms

ServiceMessage

Connection Manager logon dialog box service message, usually a customer-support number for the service.
Maximum = approximately 50 characters.

CMAK .cms

UserName

User name typed by the user.

.cmp

UserNamePrefix

Prefix appended to the user name. Enables access to a service requiring a realm name as a prefix.

CMAK .cms

UserNameSuffix

Suffix appended to the user name. Enables access to a service requiring a realm name as a suffix.

CMAK .cms

MaxUserName

Maximum length of the user name that can be typed by the user. UserNamePrefix and UserNameSuffix are not included.
Default = 256 bytes.

.cms

UserNameOptional

Whether the user must type a user name at the Connection Manager logon dialog box.
0 (default) = User name required. 1 = User name not required.

.cms

HideUserName

Whether the User name box appears in the Connection Manager logon dialog box when using dial-up connections.
0 (default) = Display the box. 1 = Do not display the box.
If the field is hidden, the data is considered optional.

.cms

Password

Password typed by the user.

.cmp

PasswordHandling

Method of handling the password during the logon process.
0 (default) = Normal (case sensitive). 1 = Lowercase password. 2 = Uppercase password.

.cms

MaxPassword

Maximum length of the password that can be typed by the user.
Default = 256 bytes.

.cms

PasswordOptional

Whether the user must specify a password in the Connection Manager logon dialog box.
0 (default) = Password required. 1 = Password not required.

.cms

RememberPassword

Whether the user selected the Save password check box in the Connection Manager logon dialog box.
0 (default) = User did not select the check box. 1 = User selected the check box.
However, if the Connection Manager service profile is included in an Internet Explorer installation package created with the IEAK, it simplifies user logon if this entry is set to 1.

.cmp

HidePassword

Whether the Password box appears in the Connection Manager logon dialog box when using dial-up connections.
0 (default) = Display the box. 1 = Do not display the box.
If the field is hidden, the data is considered optional.

.cms

HideRememberPassword

Whether to display the Save password check box in the Connection Manager logon dialog box of Connection Manager and on the Internet Logon tab. Service profiles built to support VPN connections contain this additional tab.
0 (default) = Display the check box. 1 = Do not display the check box.
If HideRememberPassword is set to 1 , it overrides the HideDialAutomatically setting, even if HideDialAutomatically is not set to 1 .

.cms

Domain

Logon domain name typed by the user.

.cmp

MaxDomain

Maximum length of the domain name that can be typed by the user.
Default = 15 bytes.

.cms

HideDomain

Whether the Logon Domain box appears in the Connection Manager logon dialog box when using dial-up connections.
0 = Display the box. 1 (default) = Do not display the box.
The default is 1 only if the profile supports VPN connections; otherwise, the default is 0. If the field is hidden, the data is considered optional.

.cms

HideInternetUsername

Whether the Username box appears on the Internet Logon tab in the Properties dialog box.
0 (default) = Display the box. 1 = Do not display the box.
If the field is hidden, the data is considered optional. If HideInternetPassword and HideInternetUsername are both 1, the tab is not displayed.

.cms

HideInternetPassword

Whether the Password box appears on the Internet Logon tab in the Properties dialog box.
0 (default) = Display the box. 1 = Do not display the box.
If the field is hidden, the data is considered optional. If HideInternetPassword and HideInternetUsername are both 1, the tab is not displayed.

.cms

DialAutomatically

Whether the user selected the Connect automatically check box in the Connection Manager logon dialog box.
0 (default) = User did not select the check box. 1 = User selected the check box.

.cmp

HideDialAutomatically

Whether the Connect automatically check box appears in the Connection Manager logon dialog box.
0 (default) = Display the check box. 1 = Do not display the check box.

.cms

InternetUserName

User name for VPN connections, typed by the user.

.cmp

InternetPassword

Password for VPN connections, typed by the user.

.cmp

RememberInternetPassword

Whether the user selected the Save password check box in the Internet Logon dialog box.
0 = (default) User did not the select check box. 1 = User selected the check box.

.cmp

Phone0

Primary phone number typed or selected by the user.

.cmp

PhoneCanonical0

The canonical format of the primary phone number last selected from the phone book or typed in using the canonical format.

.cmp

PhoneCountry0

TAPI country/region code for the primary phone number.

.cmp

UseDialingRules0

How dialing rules are applied to the primary phone number.
0 = Use the form of the number exactly as it appears in the phone book or as it is typed. 1 (default if no values are specified) = Apply dialing rules to the canonical form of the number when displaying and dialing.
The value in the .cmp file, if there is one, takes precedence over the value in the .cms file.

.cms .cmp

PhoneSource0

Service profile for the primary phone number.

.cmp

Description0

Description of the primary phone number. Appears in the Phone Book dialog box as a POP name.

.cmp

DUN0

Dial-Up Networking entries used for the primary phone number.

.cmp

Phone1

Backup phone number, entered by the user.

.cmp

PhoneCanonical1

The canonical format of the backup number last selected from the phone book or typed in using the canonical format.

.cmp

PhoneCountry1

TAPI country/region code for the backup phone number.

.cmp

UseDialingRules1

How dialing rules are applied to the backup number.
0 = Use the form of the number exactly as it appears in the phone book or as it is typed. 1 (default if no values are specified) = Apply dialing rules to the canonical form of the number when displaying and dialing.
The value in the .cmp file, if there is one, takes precedence over the value in the .cms file.

.cms .cmp

PhoneSource1

Service profile for the backup phone number.

.cmp

Description1

Description of the backup phone number. Appears in the Phone Book dialog box as a POP name.

.cmp

DUN1

Dial-Up Networking entries used for the backup phone number.

.cmp

Modem0

Name of the modem device to use for the primary phone number.

.cmp

Modem1

Name of the modem device to use for the backup phone number.

.cmp

NoPromptReconnect

Whether the user is prompted for reconnection.
0 (default) = Prompt the user. 1 = Do not prompt the user.

.cms

ServiceType0

Service type that the user most recently selected from the phone book for the primary phone number.

.cmp

ServiceType1

Service type that the user most recently selected from the phone book for the backup phone number.

.cmp

Region0

State or province that the user most recently selected from the phone book for the primary phone number.

.cmp

Region1

State or province that the user most recently selected from the phone book for the backup phone number.

.cmp

Version

Version of the phone book.

.cms

DUN

Dial-Up Networking entries used when Dial-Up Networking in the phone book is blank.
Default = ServiceProfileServiceName.

.cms

RedialCount

Number of redials to attempt.
Default = 3.

.cms .cmp

RedialDelay

Delay (in seconds) between dials. The delay is the elapsed time between the point of failure of the first call and the dialing of the first digit of the next phone number.
Default = 5 seconds.

.cms

IdleTimeout

Length of time (in minutes) that the connection must be idle before disconnecting.
Default = 10 minutes.
If set to 0, no time out occurs.

.cms .cmp

IdleThreshold

Maximum bytes per minute that can be received if an idle state is to be detected for the connection.
Default = 0.
(This entry is for Windows 95 and Windows 98 operating systems.)

.cms

Logo

Location of the .bmp file displayed in the Connection Manager logon dialog box.
Default = the standard Connection Manager logon bitmap.

CMAK .cms

PBLogo

Location of the .bmp file for the Phone Book dialog box.
Default = the standard Phone Book bitmap.

CMAK .cms

Icon

Location of the icon (.ico) file for the large program icon.
Default = the standard Connection Manager icon.

CMAK .cms

SmallIcon

Location of the .ico file for the small title-bar icon.
Default = the standard Connection Manager icon.

CMAK .cms

TrayIcon

Name of the .ico file for the status-area icon.
Default = the Connection Manager icon.

CMAK .cms

HideTrayIcon

Whether to display the status-area icon in the Windows taskbar.
0 (default) = Display the icon. 1 = Do not display the icon.
If you choose not to display a status-area icon, edit the Help file to remove references to it.

.cms

HelpFile

Location (including name) of the custom Help file.
Default Help file = the standard service-profile Help file.

CMAK .cms

DownloadDelay

Time (in seconds) to delay before downloading phone book updates.
Default = 15 seconds when a profile (%Profile%) is passed to the download connect action.
This entry is valid only when, in the CMAK wizard, in the Setup Post-Connect Actions dialog box, Automatically download phone book updates is selected.

.cms

HideDelay

Time (in seconds) to delay before displaying the Phone-Book Updates dialog box (with progress indicators and message).
Default = Do not display the dialog box.

.cms

PBUpdateMessage

Text that appears in the dialog box during a phone book update.
Default = "Downloading new phone book."

.cms

Tunnel

Whether VPN connections are enabled for the service profile.
0 (default) = Not enabled. 1 = Enabled.

CMAK .cms

TunnelDUN

Dial-Up Networking entries used for VPN connections.
Default =  ServiceProfileServiceName Tunnel.

.cms

TunnelAddress

IP address or domain name for the VPN server.

CMAK .cms

TunnelReferences

Whether VPN connections are enabled for phone numbers taken from referenced phone books.
0 (default) = Do not use phone numbers. 1 = Use phone numbers.

CMAK .cms

UseSameUserName

Whether to use a separate user name and password when connecting to the Internet service provider (for a VPN connection).
0 (default) = Use the separate user name and password as specified by the user on the Internet Logon tab of the Properties dialog box. 1 = Use the same user name and password when connecting to the Internet service provider as the name specified in the Connection Manager logon dialog box for logging on to the private service.

CMAK .cms

ResetPassword

Whether the New button appears in the Connection Manager logon dialog box to enable a user to reset the password. You can use this button to set up a custom password option. Type the location (including name) of the executable program you use to support this process. You must provide an executable program for this option and include it as an additional file when you run the CMAK wizard.

.cms

AnimatedLogo

Whether an animation is used instead of a static bitmap in the Connection Manager logon dialog box.
0 (default) = Do not use animated graphic. 1 = Use animated graphic.
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. If you add this option to the service profile, users will be prompted to restart their computers after installing the service profile.

.cms

CheckOSComponents

Whether Connection Manager checks the operating-system components.
0 (default) = Check the operating-system components only when an error occurs. 1 = Always check the operating-system components on startup.

.cms

DoNotCheckBindings

Whether to include the TCP/IP bindings in the TCP/IP check.
0 (default) = Include the TCP/IP bindings in the TCP/IP check and bind all that are not bound. 1 = Do not include the TCP/IP bindings in the TCP/IP check.
(This entry applies only to Windows 95 and Windows 98.) TCP/IP shims are protected from checking only if this option is set to 1 in all installed service profiles. This option does not prevent bindings from being checked by other service profiles or programs.

.cms

AutoReconnect

Whether Connection Manager attempts to re-establish a connection that is dropped by the network.
0 (default) = Do not attempt to re-establish dropped connections. 1 = Connection Manager automatically attempts to re-establish any connection dropped by the network, unless the connection was torn down - for example, by a timeout.
However, in Windows NT, Connection Manager always attempts to reconnect regardless of the time out settings. If AutoReconnect is set to 1 (attempt reconnection), Connection Manager attempts to re-establish the connection without prompting the user.

.cms

LanaTimeout

The time (in seconds) to wait before attempting connection to a VPN server.
Default = 20 seconds.
Increase this value if the connection consistently fails to find a domain controller.

.cms

[Profile Format]

Service-profile version.

.cms .cmp

Version

Format version of the profile or service file.

.cms .cmp

[ISP]

Service 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 service type. The Mask and Match lines control where a phone number is listed in the Phone Book dialog box. You can specify whether the number is listed under Access Numbers or under More Access Numbers. Each Mask and Match line has a corresponding service option in Phone Book Administrator.

.cms

PBFile

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

CMAK .cms

RegionFile

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

CMAK .cms

PBURL

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

CMAK .cms

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 Access Numbers box in the Connection Manager Phone Book dialog box.
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 More Access Numbers box in the Connection Manager Phone Book dialog box.
Default = SurchargeSignon.

.cms

References

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

CMAK .cms

CMSFile& MergedProfile

Location of the merged service file (.cms file). The format is CMSFile& MergedProfile = Location , where MergedProfile is the name of the merged service profile and Location is the location of the .cms file for the merged service profile - for example:
CMSFile&Awesome1 = Awesome1\ AwesomeE.cms

CMAK .cms

FilterA& MergedProfile

List of filter names to be applied to the referenced phone book options field. The format is FilterA& Reference  =  FilterName , where MergedProfile is the name of the merged service profile, as specified in the CMSFile MergedProfile entry, 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 Access Numbers box in the Connection Manager Phone Book dialog box.

CMAK .cms

FilterB& MergedProfile

List of filter names to be applied to the referenced phone book options field. The format is FilterB& MergedProfile  =  FilterName , where MergedProfile is the name of the merged service profile, as specified in the CMSFile Reference entry, 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 More Access Numbers box in the Connection Manager Phone Book dialog box.

CMAK .cms

[Service Types]

Items that are listed in the Phone Book dialog box under Service Type.

.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 Service Type list in the Phone Book dialog box, and FilterName is the name of the filter to be associated with the entry - for example:
ISDN Multicast = MulticastISDN
It is recommended that a service type name include no more than 25 characters. If you need to add a service type, copy and edit an existing line in the [Service Types] section.

.cms

[Pre-Connect Actions]

Optional pre-connect actions to run before a connection is established. The following environment variables are set in Connection Manager and can be implemented in connect actions as command-line options: Profile, UserName, UserPrefix, UserSuffix, ServiceName, DialRasPhoneBook, TunnelRasPhoneBook, AutoRedial, PopName, RasErrorCode, DialRasEntry, TunnelRasEntry. (Other settings are available through the RAS connection.)

.cms

#

A single pre-connect action. The format of the entry is #  =  Program , where # is a number from 0 to x , and Program is the complete name of the program (including the .exe or .dll file and associated parameters). Programs start in sequence: 0 first, 1 next, and so on.

CMAK .cms

# &Flags

Whether a pre-connect action runs when a specific type of connection is established. The format of the entry is # &options =  x , where # is the number of a defined pre-connect action and x is a value indicating how dial-up and direct connections for that pre-connect action are handled:
If x  = 0, both dial-up and direct connections include this pre-connect action.
If x  = 1, only direct connections include this pre-connect action.
If x  = 2, only dial-up connections include this pre-connect action.
Default = 2.

CMAK .cms

# &Description

A short description of a pre-connect action. The format of the entry is # &Description =  text , where # is the number of a defined pre-connect action and text is the descriptive information for that pre-connect action. This option can provide useful information when a synchronous connect action does not run properly.
Default = name specified using #  =  Program for the pre-connect action.
Default = program name specified using #  =  Program for the pre-connect action.

CMAK .cms

[Pre-Tunnel Actions]

Optional pre-tunnel actions to run after a connection is established but before a VPN connection is established. Pre-tunnel actions use the same format as other connect actions (as shown in the [Pre-Connect Actions] section, the # , # &option, and # &Description entries).

.cms

[Connect Actions]

Optional post-connect actions to run after a connection is established and, if using a VPN connection, after the tunnel is established. Post-connect actions use the same format as other connect actions (as shown in the [Pre-Connect Actions] section, the # , # &option, and # &Description entries).

.cms

[Disconnect Actions]

Optional disconnect actions to run immediately before disconnecting. Disconnect actions use the same format as other connect actions (as shown in the [Pre-Connect Actions] section, the # , # &option, and # &Description entries).

.cms

[Pre-Dial Actions]

Optional pre-dial actions to run immediately before dialing. Pre-dial actions use the same format as other connect actions (as shown in the [Pre-Connect Actions] section, the # , # &option, and # &Description entries), but they cannot be set in the CMAK wizard.

.cms

[On-Cancel Actions]

Optional on-cancel actions to run when the user cancels a session after the connection has been started. On-cancel actions use the same format as other connect actions (as shown in the [Pre-Connect Actions] section, the # , # &option, and # &Description entries), but they cannot be set in the CMAK wizard.

.cms

[On-Error Actions]

Optional on-error actions to run when an error occurs. On-error actions use the same format as other connect actions (as shown in the [Pre-Connect Actions] section, the # , # &option, and # &Description entries), but they cannot be set in the CMAK wizard.

.cms

[Auto-Applications]

Optional auto-applications to run during a connection. Auto-applications are similar to connect actions, but they cause the connection to close as soon as the final auto-application finishes. (Auto-applications use the same format as shown in the [Pre-Connect Actions] section, the # entry). Unlike pre-connect actions, auto-applications do not use the # &option or # &Description entries.

.cms

[Menu Options]

Shortcut menu that appears when a user right-clicks the status-area icon for your service.

.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 .dll), including any parameters required for the program. For example, if you wanted to add Notepad to the menu with the command name "Editor," the [Menu Options] line would be Editor = Notepad.exe .
Default commands = Status and Connect .
These programs are available in a shortcut menu that appears when a user right-clicks the status-area icon. Applications are listed in the menu in sequence: 0 first, 1 next, and so on.

CMAK .cms

[Animated Logo]

Animation for the Connection Manager logon dialog box. AnimatedLogo in the [Connection Manager] section determines whether an animation is used.

.cms

Movie

Location of the optional animation file displayed in place of the static bitmap in the logon dialog box. Settings in the [Animated Actions] section control how the optional 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.

.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

[Server& EntryName ]

Dial-Up Networking configuration. To store settings for multiple Dial-Up Networking entries, the name of the Dial-Up Networking entry is appended to each section header for that entry - for example, Server&Awesome1.

.cms

NetworkLogon

Whether to log on to the network.
0 (default) = Do not log on. 1 = Log on.

.cms

SW_Compress

Whether to negotiate PPP software compression of data.
0 = Do not negotiate. 1 (default) = Negotiate.

.cms

Disable_LCP

Whether to enable Link Control Protocol (LCP) extensions.
0 = Enable. 1 (default) = Disable.

.cms

PW_Encrypt

Whether to encrypt password when authenticating.
0 (default) = Do not encrypt. 1 = Encrypt.

.cms

Negotiate_TCP/IP

Whether to negotiate TCP/IP.
0 = Do not negotiate. 1 = Negotiate. Always set to 1.

.cms

Negotiate_IPX

Whether to negotiate IPX protocol.
0 = Do not negotiate. 1 (default) = Negotiate.

.cms

Negotiate_NetBEUI

Whether to negotiate NetBEUI protocol.
0 (default) = Do not negotiate. 1 = Negotiate.

.cms

[TCP/IP& EntryName ]

Dial-Up Networking configuration. The name of the Dial-Up Networking entry is appended to each section header for that entry - for example, [TCP/IP&Awesome1] .

.cms

Specify_IP_Address

Whether to specify a static IP address.
0 (default) = Do not specify. 1 = Specify.

.cms

IP_Address

Static IP address.

.cms

Specify_Server_Address

Whether to specify static DNS and WINS addresses.
0 (default) = Do not specify. 1 = Specify.

CMAK .cms

DNS_Address

DNS address.

CMAK .cms

DNS_Alt_Address

Alternate DNS address.

CMAK .cms

WINS_Address

WINS address.

CMAK .cms

WINS_Alt_Address

Alternate WINS address.

CMAK .cms

IP_Header_Compress

Whether to enable IP header compression.
0 = Not enabled. 1 (default) = Enabled.

.cms

Gateway_On_Remote

Whether to use the default gateway on the remote private network.
0 = Do not use. 1 (default) = Use.

.cms

[Networking& EntryName ]

Dial-Up Networking configuration. The name of the Dial-Up Networking entry is appended to each section header for that entry - for example, [Networking&Awesome1].

.cms

VpnStrategy

Which tunneling protocol to use when establishing a VPN connection.
0 (default) = Automatically select the primary protocol. 1 = Use PPTP only. 2 = Try PPTP first. 3 = Use L2TP only. 4 = Try L2TP first.
If this value is not specified, the RAS default value of 0 (currently 0) is used.
Note   PPTP is currently the primary protocol.

.cms

[Scripting& EntryName ] Section

Location (path and file name) of the script (.scp) file for the Dial-Up Networking entry. The name of the Dial-Up Networking entry is appended to each section header for that entry - for example, [Scripting&Awesome1].

.cms

Name

Location (including file name) of the script (.scp) file for the Dial-Up Networking entry.

CMAK .cms

.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft