Customizing Additional Features

Customizing additional features other than those controlled through the wizard requires manually editing information files.

Important

Be careful when making modifications to information files. Troubleshooting changes made to these files is difficult. Never modify the original file, and always make backup copies.

To customize additional features

Start the wizard. Build a service profile with the features you want.
Locate the features you want to change in the section “Settings Controlled through the Wizard and Advanced Customization” in “Advanced Customization.” Check the .inf, .cms, and .cmp columns to determine which of your service-profile files you must edit.
Locate the files in the \Cmak\ServiceName folder. Make backup copies of the files you must edit.
Use a text editor such as Notepad to edit the files.
Start the wizard again. Click Next as needed to proceed through the wizard. Do not change any settings. Click Finish to rebuild your service profile. Rebuilding applies your advanced customization to the service profile.

Settings Controlled through the Wizard and Advanced Customization

Note the following about the table that follows:

The Section column lists the sections of the .inf (information), .cms (service provider profile), and .cmp (connection profile) files.
The Entry column lists file parameters.
The wizard column identifies features controlled through the wizard. When you use the wizard to build a service profile, the wizard saves settings in the .inf, .cms, and .cmp files. Do not manually edit files for these features.
The .inf and .cms columns identify features controlled through the Connection Manager .inf and .cms files. The .cms file is referenced by .cmp files. If the table indicates a feature is controlled by the wizard and an .inf or .cms file, use the wizard to set up the feature. Otherwise, edit the .inf or .cms file.
The .cmp column identifies features controlled through connection profile (.cmp) files.

Note

The connection profile (.cmp) file settings take precedence over the service provider profile (.cms) file settings.

[Section], Entry	Description	Wizard	.inf	.cms	.cmp	Notes

[Strings]	This section defines customizable text strings that appear in various dialog boxes.
DirPrompt	Text appearing in a dialog box displayed during service profile installation.		X			The default is, “Where do you want to install Connection Manager?”
UpdatePrompt	Text appearing in a dialog box displayed when updating an installation.		X			The default is, “Do you want to update Connection Manager in this directory?”
FailNoIEMessage	Text appearing in a dialog box displayed during installation if supporting Microsoft Internet Explorer files have not been installed.		X			The default is, “Cannot install Connection Manager. You must install Microsoft Internet Explorer 3.0 or later on your computer before installing Connection Manager.”
FailMessage	Text appearing in a dialog box displayed during installation if supporting Connection Manager software has not been installed.		X			The default is, “You must install the Connection Manager program first.”
[Connection Manager]	This section defines miscellaneous service profile settings.
PBMessage	Text appearing in the expanded Phone Book dialog box when the phone book is displayed.	X		X
CMSFile	Name of the service-provider profile file (filename.cms).	X			X
ServiceName	Text appearing as the service name in the Sign-In dialog box (configured during sign-in).	X			X
UserName	User name typed by the user.				X
MaxUserName	Maximum length of the user name that can be typed by the user. UserNamePrefix and UserNameSuffix are not included.			X		The default is 256 bytes.
UserNameOptional	Controls whether the user must type a user name at the Sign-In dialog box. 0=User name required. 1=User name not required.			X		The default is 0.
Password	Password typed by the user.				X
MaxPassword	Maximum length of the password that can be typed by the user.			X		The default is 256 bytes.
PasswordHandling	Method of handling the password during sign-in: 0=Normal (case sensitive). 1=Lowercase password. 2=Uppercase password.			X		The default is 0.
HideRememberPassword	Controls whether to display the Remember password check box in the Sign-In dialog box of Connection Manager and on the Internet Sign-In tab. Service profiles built to use secure connection contain this additional tab. 1=Do not display the check box. 0=Display the check box. If HideRememberPassword is set to 1, it overrides the HideDialAutomatically setting, even if HideDialAutomatically is set to 0.				X	The default is 0.
PasswordOptional	Controls whether the user must type a password at the Sign-In dialog box. 0= Password required. 1=Password not required.			X
Domain	Domain typed by the user.				X
MaxDomain	Maximum length of the domain that can be typed by the user.			X		The default is 15 bytes.
HideDomain	Controls whether to display the Domain field in the Sign-In dialog box when using Dial-Up connections. 1=Do not display the field. 0=Display the field.	X		X		The default is 1.
DialAutomatically	Indicates whether the user selected the Dial automaticallycheck box in the Sign-In dialog box. 1=The user selected the check box. 0=The user did not select the check box.				X	The default is 0.
HideDialAutomatically	Controls whether the Dial automatically check box appears in the Sign-In dialog box. With this check box, users have the option of automatically dialing and having their password saved when starting the service profile. 1=Do not display the check box. 0=Display the check box.			X		The default is 0.
InternetUserName	User name typed by the user for secure connection.				X
InternetPassword	Password typed by the user for secure connection.				X
RememberInternetPassword	Indicates whether the user selected the Remember password check box in the Internet Sign-In dialog box. 1=The user selected the check box. 0=The user has not selected the check box.				X
Phone0	Primary phone number typed or selected by the user.				X
PhoneCountry0	Telephony Application Programming Interface (TAPI) country code for the primary phone number.				X
DialAsLongDistance0	Controls whether the primary phone number should be dialed as long distance. 1=Dial as long distance. 0=Dial as local.				X
PhoneSource0	Service profile for the primary phone number.				X
Description0	Description of the primary phone number. Appears in the Phone Book dialog box as a Point of Presence (POP) name.				X
DUN0	Dial-Up Networking settings used for the primary phone number.				X
Phone1	Backup phone number typed or selected by the user.				X
PhoneCountry1	TAPI country code for the backup phone number.				X
DialAsLongDistance1	Controls whether the backup phone number should be dialed as long distance. 1=Dial as long distance. 0=Dial as local.				X
PhoneSource1	Service profile for the backup phone number.				X
Description1	Description of the backup phone number. Appears in the Phone Book dialog box as a Point of Presence (POP) name.				X
DUN1	Dial-Up Networking settings used for the backup phone number.				X
Modem	Name of the modem device to use.				X
NoPromptReconnect	Controls whether the user should be prompted for reconnection. 1=Do not prompt the user. 0=Prompt the user.			X		The default is 0.
ServiceType	Service type most recently selected from the phone book by the user.				X
Country	TAPI country code for the country most recently selected from the phone book by the user.				X
Region	Region most recently selected from the phone book by the user.				X
Version	Version of the phone book.			X
DUN	Dial-Up Networking settings used when the Dial-Up Networking field in the phone book is blank.			X		The default is ServiceName.
Redial	Indicates whether the user selected the redial option on the Options tab. 1=The user selected the option. 0=The user has not selected the option.			X	X	The default is 1.
RedialCount	Number of redials to attempt.			X	X	The default is 3.
RedialDelay	Delay in seconds between dials. The delay is the period between dialing one phone number’s first digit and dialing the next phone number’s first digit.			X		The default is 5 seconds.
Idle	Indicates whether the user selected the disconnect option on the Options tab. 1=The user selected the option. 0=The user has not selected the option.			X	X	The default is 1.
IdleTimeout	Time in minutes the connection must be idle before disconnecting.			X	X	The default is 20 minutes.
IdleThreshold	Maximum bytes per minute that can be received if an idle state is detected for the connection.			X		The default is 0.
Logo	Name of the logo bitmap file displayed in the Sign-In dialog box.	X		X		The default bitmap is the standard Sign-In bitmap.
PBLogo	Location of the bitmap image file for the Phone Book dialog box (for example, “PBLogo=Bcomp\Bcompp.bmp”).	X		X		The default bitmap is the standard Phone Book bitmap.
Icon	Name of the icon (.ico) file for the desktop icon displayed on the user's desktop (for example, “Icon=Bcomp\Bcompl.ico”).	X		X		The default icon is the standard Connection Manager icon. .
SmallIcon	Location of the small icon file.	X		X		The default icon is the standard Connection Manager icon.
TrayIcon	Name of the status-area (tray) icon file.	X		X		The default icon is the standard Connection Manager icon.
HideTrayIcon	Controls whether to display the status area (tray) icon in the Windows taskbar. 1=Do not display the icon. 0=Display the icon.			X		The default is 0. Note: If you choose not to display a status area icon, you might want to edit the help file to remove references to it.
HelpFile	Name of the Windows Help file.	X		X		The default Help file is the standard service-profile Help file.
DownloadDelay	Time in seconds to wait before downloading phone book updates.			X		The default is 120 seconds when a profile (%Profile%) is passed to the download connect action. Otherwise, this is set to 0 seconds.
PBUpdateMessage	Text that is displayed during phone book update.			X		The default is “Downloading new phone book.”
HideDelay	Controls the time in seconds to delay before displaying phone book update message.			X		The default is not to display the message.
Tunnel	Controls whether secure connection is enabled for the service profile. 1=Enabled. 0=Not enabled.	X		X		The default is 0.
TunnelDUN	Dial-Up Networking settings used for secure connection.			X		The default is “ServiceName Tunnel”.
TunnelAddress	Internet Protocol (IP) address or domain name for the end-point server.	X		X
TunnelReferences	Controls use of phone numbers from merged service profiles with secure connection. 1=Use phone numbers. 0=Do not use phone numbers.	X		X		The default is 0.
UseSameUserName	Use the settings for UserName and Password for authentication when using a secure connection to connect.	X		X	X
ResetPassword	Controls whether the Reset password button appears in the Sign-In dialog box. Use this button to set up a custom password option. Type your executable program’s name.			X		You must provide an executable program for this option.
AnimatedLogo	Controls whether an animation is used in the Sign-In dialog box instead of a static bitmap. 1=Use animated logo. 0=Do not use animated logo.	X		X		The default is 0. The [Animated Logo] section specifies the animation’s location.
AlwaysCheckOSComponents	Controls whether Connection Manager checks the OS Components. 0=Only check the OS components on startup when the ComponentsCheck reg key is clear. 1=Always check the OS components on startup.	X				The default is 0.
[Profile Format]	This section defines the service profile version.
Version	Format version of the profile or service file.			X	X
[ISP]	This section defines the service types (for example, Modem or ISDN) you want to list at 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 may specify that the number appear in the Access numbers list or the More access numbers list of additional numbers that appears after clicking the More button.					Each Mask and Match line has a corresponding service flag in Phone Book Administrator. For more information on this section, see the Microsoft Knowledge Base at http://www.microsoft.com/kb/.
PBFile	Location of the phone book (.pbk) file for used by the service profile (for example, “PBFile=Bcomp\Bcomp.pbk”).	X		X
RegionFile	Location of the region (.pbr) file used by the service profile (for example, “RegionFile= Bcomp\Bcomp.pbr”).	X		X
PBURL	Uniform Resource Locator (URL) for the phone book update.	X		X
Mask FilterName	Mask value for FilterName.			X		The default is 0x00000000.
Match FilterName	Match value for FilterName.			X		The default is 0xFFFFFFFF.
FilterA	Comma- or space-delimited list of filter names to be applied to the phone book flags field. The selected phone numbers are displayed in the Access numbers list in the More Access Numbers dialog box.			X
FilterB	Comma- or space-delimited list of filter names to be applied to the phone book flags field. The selected phone numbers are displayed in the More access numbers list in the More Access Numbers dialog box.			X
References	Service profiles merged through the wizard. Profile names are separated by commas or spaces. Each name is used as a reference to that profile.	X		X
CMSFile Reference	Name of the service file (.cms file) for Reference.	X		X
FilterA Reference	Comma- or space-delimited list of filter names to be applied to the referenced phone book flags field. The selected phone numbers are displayed in the Access numbers list in the More Access Numbers dialog box.	X		X
FilterB Reference	Comma- or space-delimited list of filter names to be applied to the referenced phone book flags field. The selected phone numbers are displayed in the More access numbers list in the More Access Numbers dialog box.	X		X
[Service Types]	This section defines items that appear in the Service type list box in the Phone Book dialog box.
ServiceType	Set up service types as a comma- or space-delimited list of filter names to be applied to the referenced phone book flags field for the service type ServiceType. The Service type list box lists service types in the order used in this file.			X		It is recommended that you use service type names of up to 25 characters. If you need to add a new service type, copy and edit a [Service Types] line.
Modem	Set up like ServiceType above.			X		Default is Modem.
ISDN	Set up like ServiceType above.			X		Default is ISDN (Integrated Services Digital Network).
Modem MultiCast	Set up like ServiceType above.			X		Default is MultiCastModem.
ISDN MultiCast	Set up like ServiceType above.			X		Default is MultiCastISDN.
Custom1	Set up like ServiceType above.			X		Default is Custom1.
Custom2	Set up like ServiceType above.			X		Default is Custom2.
[Connect Actions]	This section defines optional connect actions.
0	First connect action (.exe or .dll file). Connect actions use the format Number=Program, where Number is a number from 0 – X and Program is the application. For example, if you wanted to set up Program.exe as the first connect action, the [Connect Actions] line is “0=Program.exe”.	X		X		Applications start in sequence: 0 first, 1 next, and so on.
1	Second connect action.	X		X
Number	Last connect action.	X		X
[Auto Applications]	This section defines optional auto-applications.
0	First auto-application (.exe or .dll file). Auto-applications use the format Number=Program, where Number is a number from 0 – X and Program is the application. For example, if you wanted to set up Program.exe as the first auto-application, the [Auto applications] line is “0=Program.exe”.	X		X		Applications start in sequence: 0 first, 1 next, and so on.
1	Second auto-application.	X		X
Number	Last auto-application.	X		X
[Disconnect actions]	This section defines optional auto-applications.
0	First disconnect action (.exe or .dll). Disconnect actions use the format Number=Program, where Number is a number from 0 – X and Program is the application. For example, if you wanted to set up Program.exe as the first disconnect action, the [Disconnect actions] line is “0=Program.exe”.	X		X		Applications start in sequence: 0 first, 1 next, and so on.
1	Second disconnect action.	X		X
Number	Last disconnect action.	X		X
[Menu Options]	This section defines an optional shortcut menu that appears after a user right-clicks the service profile’s status area icon.
MenuOptionName	Command (.exe or .dll file). Shortcut menu commands use the format Command=Program, where Command is the command name you type in the wizard and Program is the program. For example, if you wanted to add Notepad to the menu with the command name “Editor,” the [Menu Options] line is “Editor=Notepad.exe”.	X		X		These applications are available in a shortcut menu that appears after a user right-clicks the task bar icon. Applications are listed in the menu in sequence: 0 first, 1 next, and so on.
[Animated Logo]	This section defines an optional animation for the Sign-In dialog box.					The AnimatedLogo line in the [Connection Manager] section controls whether an animation is used.
Movie	Location of the optional animation file (for example, “Movie=Bcomp\Bcomp.spl”). Displayed in place of the static bitmap in the Sign-In dialog box.	X		X		Settings in the [Animated Actions] section control how the optional animation plays based on the connection state.
Parameter	Other animation parameters.			X
[Animated Actions]	This section defines when to play segments of the animation.
Initial	Starting frame number to play when Connection Manager starts.	X		X
Dialing0	Starting frame number to play when dialing the primary phone number.	X		X
Pausing	Starting frame number to play when pausing between dials.	X		X
Dialing1	Starting frame number to play when dialing the backup phone number.	X		X
Authenticating	Starting frame number to play during user authentication.	X		X
Tunneling	Starting frame number to play when connecting through secure connection.	X		X
Connected	Starting frame number to play when a connection is established.	X		X
Error	Starting frame number to play for any connection error.	X		X
*[Server&FileName]*	This is one of several sections used to configure Dial-Up Networking.					In order to store multiple sets of Dial-Up Networking settings, the file naming convention for the service profile is appended to each section header (for example, [Server& Bcomp]).
Type	Always Point-to-Point Protocol (PPP).			X
NetworkLogon	Controls whether to logon to the network. 1=Logon. 0=Do not logon.			X		The default is 0.
SW_Compress	Controls whether to negotiate PPP software compression of data. 1=Negotiate. 0=Do not negotiate.			X		The default is 1.
Disable_LCP	Controls whether to enable Link Control Protocol (LCP) extensions. 1=Disable. 0=Enable.			X		The default is 1.
PW_Encrypt	Controls whether to encrypt password when authenticating. 1=Encrypt. 0=Do not encrypt.			X		The default is 0.
Negotiate_TCP/IP	Controls whether to negotiate TCP/IP protocol. 1=Negotiate. 0=Do not negotiate.			X
Negotiate_IPX	Controls whether to negotiate IPX protocol. 1=Negotiate. 0=Do not negotiate.			X		The default is 1.
Negotiate_Netbeui	Controls whether to negotiate NetBEUI protocol. 1=Negotiate. 0=Do not negotiate.			X		The default is 0.
*[TCP/IP&FileName]*	This is one of several sections used to configure Dial-Up Networking.					The file naming convention for the service profile is appended to each section header (for example, [TCP/IP& Bcomp]).
Specify_IP_Address	Controls whether to specify a static Internet Protocol (IP) address. 1=Specify. 0=Do not specify.			X		The default is 0.
IP_Address	Static IP address			X
Specify_Server_ Address	Controls whether to specify static Domain Name System (DNS) and Windows Internet Naming Service (WINS) addresses. 1=Specify. 0=Do not specify.	X		X		The default is 0.
DNS_Address	DNS address.	X		X
DNS_Alt_Address	Alternate DNS address.	X		X
WINS_Address	WINS address.	X		X
WINS_Alt_Address	Alternate WINS address.	X		X
IP_Header_Compress	Controls whether to enable IP header compression. 1=Enable. 0=Not enabled.			X		The default is 1.
Gateway_On_Remote	Controls whether to use default gateway on the remote private network. 1=Use. 0=Do not use.			X		The default is 1.
*[Scripting&FileName]*	This is one of several sections used to configure Dial-Up Networking.					The file naming convention for the service profile is appended to each section header (for example, [Scripting& Bcomp]).
Name	Name of the Dial-Up Networking scripting file.	X		X