Administration Kit Guide - Connection Manager

Archived content. No warranty is made as to technical accuracy. Content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Version 1.0 

Welcome

Welcome to Connection Manager Administration Kit Guide. The Connection Manager Administration Kit includes a wizard that you as a network administrator can use to create customized versions of Microsoft® Connection Manager for Microsoft® Windows NT® version 4.0 and Microsoft® Windows® 95.

After you answer the wizard's questions, the wizard builds a hands-free installation program that your users run to install Connection Manager and your service profile. You can distribute this by disk, download, or compact disc.

How to Use This Document

The following topics are covered:

Overview of Connection Manager and the Wizard

Describes how the wizard works, including how it coordinates with Connection Point Services components

Choosing Customization Options

Describes what you can customize in Connection Manager service profiles

Preparing for Customization

Describes how to prepare the custom elements you want and how to install the Connection Manager Administration Kit software

Creating a Service Profile

Describes how to use the wizard to build the service profile

Testing and Distributing Connection Manager

Briefly describes how you can test your service profile

Advanced Customization

Explains how to customize features other than those controlled through the wizard

Creating Custom Windows Help

Explains how to create custom Windows Help for service profiles

Overview of Connection Manager and the Wizard

This section describes the following:

  • Connection Manager: what it consists of and what you can customize 

  • The Connection Manager Administration Kit wizard: how the wizard works 

What Is Connection Manager?

Microsoft® Connection Manager is a versatile client dialer you customize to include the features and appearance you want to present to your users when they are connecting to your service.

As your service expands and your online features become more sophisticated, it becomes a challenge to make it easy for new users to get online and also keep current users aware of changing Points of Presence (POPs) and configuration.

Connection Manager helps you meet these challenges. Using the Connection Manager Administration Kit wizard, you can build custom Connection Manager service profiles with the look and features you want.

Connection Manager consists of the following:

  • Microsoft Connection Manager version 1.0 software 

  • At least one service profile (containing custom files and the service-provider profile file) 

Basic Connection Manager Software

Connection Manager service profiles require that Connection Manager is installed. Connection Manager, in turn, requires several supporting files from Microsoft Internet Explorer version 3.0 or later. You can include the basic Microsoft Connection Manager version 1.0 software and the supporting Internet Explorer files with the service profile.

If a user installs more than one service profile, each service profile is installed in a separate folder. The service profiles share the same copy of the Connection Manager software.

Connection Manager 1.0 automatically configures the user's computer to use TCP/IP (Transport Control Protocol/Internet Protocol), Dial-Up Networking, Dial-Up Scripting, and a modem if any of these are not already set up.

Note Including the Connection Manager 1.0 software increases the size of your service profile. For more information, see "Considering the Service-Profile File Size."

Connection Manager Service Profiles

You use the Connection Manager Administration Kit wizard to create a Connection Manager service profile with the look and features you want. You can use the wizard to incorporate a variety of brandable elements, such as custom bitmap images with a company logo.

A service profile can contain ready-to-use features that let users connect seamlessly to your service. Building such features into a Connection Manager service profile means you spend less support time helping with configuration issues, and your users have a better Internet experience from the moment they connect.

The service profile you create is a complete, easy-to-install package you distribute to your users. The profile is a self-installing file. Users must have the basic Microsoft Connection Manager software, which you can include in your installation package. The basic Connection Manager program files are installed in a subdirectory of the Microsoft Internet Explorer folder. A service profile is installed to its own folder (for example, \Connection Manager\ServiceProfileFileName). If a user installs more than one service profile, each version is installed in a separate folder. Multiple service profiles share the basic Microsoft Connection Manager version 1.0 software.

Minimum Requirements

Connection Manager requires 2 megabytes (MB) free disk space and one of the following:

  • Microsoft® Windows® 95 operating system running on a personal computer with a 486/25 processor and 8 MB memory. 

  • Microsoft® Windows NT Workstation version 4.0 or Windows NT Server version 4.0 operating system on a personal computer with a 486/25 processor and 12 MB memory (16 MB recommended). If the computer uses multiple modems, Service Pack 2 or later is required. 

What Is the Connection Manager Administration Kit Wizard?

The Connection Manager Administration Kit wizard is distributed to you along with Microsoft Connection Manager so that you can build custom versions of Connection Manager for your users.

Through Connection Point Services, Connection Manager automatically obtains custom phone books. Phone books provide users with complete POP information, so users can roam and connect to different Internet access points without being restricted to a single POP.

Without the ability to update phone books—a task handled automatically by Connection Point Services—users would have to contact technical support to be informed of changes in POP information and to reconfigure their client dialer software.

Connection Point Services has two components:

  • Phone Book Administration. A tool used to create and maintain the phone book database and to publish new phone book information to the Phone Book Service. 

  • Phone Book Service. An Internet Information Server extension that runs on Microsoft Windows NT Server version 4.0 or later. Phone Book Service automatically checks subscribers' or corporate employees' current phone books and, if necessary, downloads a phone book update. 

Connection Manager also integrates with:

  • Internet Authentication Services. A Windows NT service that performs remote authentication, authorization, and accounting of users who are attaching to a network access server (NAS). 

Minimum Requirements

The wizard requires 3 megabytes (MB) free disk space and one of the following:

  • Microsoft Windows 95 operating system on a personal computer with a 486/25 processor and 8 MB memory (32 MB recommended) 

  • Microsoft Windows NT version 4.0 operating system on a personal computer with a 486/25 processor and 12 MB memory (32 MB recommended) 

How Do I Build Service Profiles?

The following is an overview of the steps you take in building a service profile.

1. Prepare Your Custom Elements

Determine what you want to customize and gather what you need, such as phone book and region files, custom bitmaps, and additional files. Install the Connection Manager Administration Kit wizard. For more information, see "Choosing Customization Options." To help you get organized, see "Worksheet and Requirements for Custom Elements."

2. Use the Connection Manager Administration Kit Wizard

Once you have determined what custom elements you want to include in your profile, start the wizard. It prompts you to set up the service profile features you want. After you have finished running the wizard, the wizard builds the service profile. For more information, see "Creating a Service Profile."

Process Relationships

The following summarizes how Connection Manager works with other components of Internet Connection Services for Microsoft® Remote Access Service (RAS). It also summarizes setup steps.

Overview of Setup Steps

The following diagram shows the basic steps in using the wizard to build a service profile. In the diagram, the letters S and C correspond to the setup and connection steps.

Cc767160.cmak1(en-us,TechNet.10).gif

Network Administrator's Setup Steps

These are the steps that you as a network administrator will follow to build a service profile for your service.

Setup Step

Description

S1

Contact the Connection Point Services administrator to get copies of the phone books you want.

S2

Prepare the custom elements you want.

S3

Run the wizard and specify your custom elements. The wizard builds the service profile.

S4

Set up the distribution method you want for your users: Copy your service profile to disk, compact disc, a Web site for downloading, or to a network location.

User's Connection Steps

These are the steps your user typically follows in connecting to your service using the service profile.

Connection Step

Description

C1

User installs and starts the service profile.

C2

A connection is established with the ISP or private network server.

C3

Connection Point Services checks the user's current phone book. If phone book information has been updated, the Phone Book Service downloads it to the user's computer.

Choosing Customization Options

This section describes Microsoft® Connection Manager features and what you can customize in service profiles you build. It describes which options are set up by the wizard and which are set up through advanced customization.

The following topics are covered:

  • Customizing Graphics and Text 

  • Setting Up the Phone Book in the Service Profile 

  • Automating System Configuration 

  • Providing Secure Connection Over the Internet 

  • Merging Service Profiles 

  • Setting Up Connect Actions and Auto-Applications

  • Setting Up Sign-In and Other Customization Options 

As you choose customization options, consider using the worksheet provided—see "Worksheet and Requirements for Custom Elements." Both the worksheet and the section, "Creating a Service Profile," cover options in the order you'll see them when you run the wizard to build service profiles.

Customizing Graphics and Text

Users see identifying graphics and text in Connection Manager dialog boxes. Graphics include the icons used to start the program at the desktop and identify the program as it runs, as well as the bitmaps displayed in several dialog boxes. Text includes support statements, online Help, and the name Connection Manager itself. The wizard provides default graphics files and text.

Connection Manager's appearance is brandable, meaning you can build a service profile that reflects your organization's identity. For example, you may minimally include your service or organization name. Or you may want to thoroughly customize Connection Manager to include custom corporate logos, an animated Sign-In dialog box, icons, and online Help. The following sections describe what you can customize.

The Sign-In Dialog Box

Users see the Sign-In dialog box when they start Connection Manager. The dialog box includes identifying elements—such as the service name and Sign-In dialog box bitmap—and text.

Cc767160.cmak2(en-us,TechNet.10).gif

What You Can Customize in the Sign-In Dialog Box

With the wizard you can:

  • Include your service's name (for example, ByteComp, Inc. Internet Access). 

    For more information, see "Setting Up the Service Name and File Names." 

  • Use your own bitmap. 

    For more information on setting up a bitmap, see "Customizing the Sign-In Dialog Box Bitmap." 

  • Use your own animation. 

    You can use a Sign-In dialog box animation to display an animated logo, advertising banner, a cartoon, and so on. If you want to replace the static bitmap with a custom animation, you can create your animation with Macromedia Shockwave Flash. Vector-based animation scales dynamically to the size of the player window and the computer's color palette. You can use the wizard to set up the animation to play continuously or to play animation segments based on connection state. 

    For more information on setting up an animation, see "Using an Animation in the Sign-In Dialog Box." 

  • Add support information (for example, "Call 1-800-xxx-xxxx for customer service"). 

    For more information, see "Customizing Support Information." 

The Phone Book Dialog Box Bitmap

Users see the Phone Book dialog box when selecting a POP. The dialog box includes the Phone Book dialog box bitmap.

Cc767160.cmak3(en-us,TechNet.10).gif

What You Can Customize in the Phone Book Dialog Box

With the wizard you can:

  • Use your own bitmap. 

    For more information, see "Customizing the Phone Book Dialog Box Bitmap." 

Service Profile Icons

Users see several service profile icons. For example, users click the service profile icon on the Windows desktop to start the program. After right-clicking the service profile status-area icon, users can also use a custom shortcut menu. Consider creating icons that are similar to one another to unify the service profile's appearance.

What You Can Customize in Service Profile Icons

With the wizard you can:

  • Create a status-area icon menu.

    For more information, see "Setting Up a Status-Area Icon Menu." 

Other Message Boxes

Users see several other dialog boxes displaying messages that include the name Connection Manager and related text. If you want, you can use your service's name in place of Connection Manager. You can also change the text used in these dialog boxes. Use similar wording appropriate to the situation. For example, one dialog box lets users confirm whether they want to update the service profile. Other dialog boxes appear in response to Connection Manager errors.

What You Can Customize in Message Boxes

Through advanced customization, you can:

  • Change the name Connection Manager and related text. 

    To do this, edit parameters in the [Strings] section of the .inf file. For more information, see "Advanced Customization." 

Online Help

Users see two types of online Help: context-sensitive and troubleshooting. Context-sensitive Help provides users with a brief descriptive definition of each interface item. Troubleshooting Help provides your users with steps to solve common connection problems.

What You Can Customize in Help

Using the Microsoft Help Workshop, you can:

  • Customize Windows Help text and build it into a service profile. 

    For more information on customizing the source Connection Manager Help files included on the installation compact disc, see "Creating Custom Windows Help". For more information on adding your customized Help to a service profile, see "Setting Up Windows Help." 

Setting Up the Phone Book in the Service Profile

Users select a POP and the service type from phone books. You can customize service profiles to use phone books created with Connection Point Services. When you build a service profile, you can add a phone book or specify which server the profile uses to obtain a phone book the first time users establish a connection.

The following sections describe what you can customize.

The Phone Book Dialog Box

Users select a POP and the service type from the Phone Book dialog box.

Cc767160.cmak4(en-us,TechNet.10).gif

What You Can Customize in the Phone Book Dialog Box

With the wizard you can:

  • Specify which phone book to use.

    For more information, see "Setting Up the Phone Book." 

  • Automate phone book updates. 

    For more information, see "Setting Up Phone Book Updates." 

  • Set up support for multiple phone books. 

    For more information, see "Merging Features from Other Service Profiles." 

Through advanced customization, you can:

  • Control which service types — for example, Modem, ISDN (Integrated Services Digital Network), or Multicast — appear in the Phone Book dialog box. 

    To do this, edit parameters in the [Service Types] section of the .cms file. 

  • Change the message displayed during phone book updates (for example, "Downloading new ByteComp phone book"). 

  • Control the delay before downloading phone book updates. 

    To do this, edit the DownloadDelay parameter in the .cms file. 

For more information, see "Advanced Customization."

The More Access Numbers Dialog Box

Users access the More Access Numbers dialog box by clicking the More button in the Phone Book dialog box to select additional access numbers. This dialog box appears only if the phone book has also been configured to separate phone numbers into two lists. If the phone book has not been set up with additional access numbers, the More button is unavailable.

Cc767160.cmak5(en-us,TechNet.10).gif

What You Can Customize in the More Access Numbers Dialog Box

With the wizard you can:

  • Set up a custom message identifying the additional phone numbers (for example, "The phone numbers in the More Access Numbers list carry additional surcharges").

    For more information, see "Setting Up the Phone Book." The section describes how to include phone books and set up the custom message. 

Note Using Phone Book Administrator, you can set up phone books to display certain POPs in the Access numbers list and other POPs in the More access numbers list. You can separate access numbers in different ways, such as differentiating between standard access numbers and 800 (toll-free) numbers. To separate phone numbers into these lists, the phone book must be configured for this purpose before using it in a service profile. For more information, see the Connection Point Services Administration Guide.

Automating System Configuration

Users establish network and Internet connections through Dial-Up Networking and TCP/IP (Transport Control Protocol/Internet Protocol). Dial-Up Networking is used to connect to a remote computer or network, and TCP/IP is used to connect dissimilar systems in a network. TCP/IP is the protocol of the Internet.

You can set up service profiles to automatically install and configure users' computers with Dial-Up Networking and TCP/IP, if they are not already present. Typically, installation and configuration of these components on users' computers requires a good deal of support time from your service. Automating system configuration makes it easier for users to install the software and access your service without having to call for detailed instructions.

TCP/IP Setup

Users' computers must be configured to use TCP/IP, the communications protocol of the Internet.

What You Can Customize in TCP/IP Setup

With the wizard you can:

  • Set up automatic TCP/IP configuration. 

    When you include the basic Microsoft Connection Manager version 1.0 software in your service profile, the profile automatically configures users' computers to use TCP/IP if it is not already set up. 

    For more information, see "Adding the Basic Connection Manager Software to the Profile." 

Dial-Up Networking Setup

Users may be required to have custom Dial-Up Networking settings for a particular POP.

What You Can Customize in Dial-Up Networking Setup

With the wizard you can:

  • Build service profiles to associate Dial-Up Networking entries set up in the phone book with Dial-Up Networking entries set up in your service profile. 

To set up Dial-Up Networking
  1. Using the wizard, build a service profile and set up Dial-Up Networking.

  2. At the Phone book Dial-Up Networking entry field, type the same phone book Dial-Up Networking entry as the one you entered in the phone book file. These must match exactly. 

To use phone book Dial-Up Networking entries
  1. The user installs the profile and starts Connection Manager.

    If Dial-Up Networking is not already set up on the user's computer, the profile automatically sets it up at run time. 

  2. The user dials a POP configured with a phone book Dial-Up Networking entry. 

    The profile detects the phone book Dial-Up Networking entry associated with the phone number and uses the custom Dial-Up Networking settings specified in the wizard (for example, Domain Name System server and Dial-Up Networking script) to establish a connection. 

    If the profile does not detect phone book Dial-Up Networking settings, it then tries to find the Dial-Up Networking entry for the service profile. If none is available, the Connection Manager defaults are used. If a Dial-Up connection is deleted from your user's computer, the profile automatically adds one to use. 

Note It is possible to establish Dial-Up Networking defaults for all phone book entries that do not have an associated Dial-Up Networking entry by creating a Dial-Up Networking entry with the same name as the service profile.

For more information, see "Setting Up Custom Dial-Up Networking."

Providing Secure Connection Over the Internet

Secure connection over the Internet gives users remote access to private networks. Private networks include TCP/IP–based intranets, as well as local area networks (LANs) using TCP/IP, IPX (Novell Netware Internetwork Packet Exchange), or NetBEUI (NetBIOS extended user interface). Through a secure connection, users can dial into a local Internet service provider (ISP) or connect directly to the Internet.

Roaming users can connect using Internet access points worldwide to access firewall-protected servers just as easily as if they were at their desks. For corporations, secure connection gives employees remote access over the Internet to corporate private networks. Because connecting usually involves a local phone call to connect rather than a toll call, your users save money.

Secure connection uses the Point-to-Point Tunneling Protocol (PPTP), with Microsoft Point-to-Point Compression (MPPC) and Microsoft Point-to-Point Encryption (MPPE).

Important PPTP supports multiple network protocols: TCP/IP, IPX, and NetBEUI. The user's computer must be configured to use the same network protocol that the private network uses at the end-point server in order to establish secure connection. For example, if the private network uses the NetBEUI protocol, the user's computer must already be configured to use NetBEUI.

Cc767160.cmak6(en-us,TechNet.10).gif

What You Can Customize for Secure Connection

With the wizard you can:

  • Set up the profile to use secure connection over the Internet.

    If a user is running Windows 95 and the computer is not already set up to use Dial-Up Networking, the service profile will automatically install Dial-Up Networking version 1.2, an upgrade that provides client support for a single PPTP connection on the user's computer. If a user is running Windows NT, PPTP must be manually installed. For more information, see "Instructions for Installing PPTP on Windows NT," later in this section. 

    Setting up the profile to use secure connection adds an Internet Sign-In tab to the Connection Settings dialog box. On this tab, users type the user name and password for the Internet service provider. In the Sign-In dialog box, users type a private network user name and password. 

    For more information, see "Setting Up Secure Connection Over the Internet." 

Instructions for Installing PPTP on Windows NT

Users must manually install the Point-to-Point Tunneling Protocol (PPTP) on computers using Windows NT. PPTP is integrated with Internet Connection Services for RAS), which the service profile automatically installs on Windows NT. Print out the following instructions for users who need to install PPTP.

To install PPTP on a computer running Windows NT
  1. Make sure you have your Windows NT distribution disks on hand during installation to obtain system files. 

  2. Open the Control Panel and double-click the Network icon. Click the Protocols tab, and then click Add

  3. In the Network Protocol list box, click Point-To-Point Tunneling Protocol.

  4. Click OK. If Setup needs to copy files, click Continue.

  5. Click OK to set the number of virtual private networks to one (1).

  6. In the Remote Access Setup dialog box, click Add and select the VPN1 - RASPPTM device. Click OK

  7. Click Configure and make sure Dial out only is selected.

  8. In the Remote Access Setup dialog box, click Network and make sure TCP/IP is the only protocol selected. 

  9. In the Remote Access Setup dialog box, click Continue. Click Close to exit the Network utility, and then click Yes to restart the computer. 

Merging Service Profiles

Users may benefit from having phone books and other features merged from existing service profiles. Users may need different Internet access points that are, in turn, covered by more than one of your phone books.

You can merge service profiles to add existing customizations to the profile you're building. When you use the wizard to merge features, the resulting service profile includes references to the existing service profiles.

For example, if users select a POP from a service profile that merges phone books from two other service profiles, the users see a single phone book rather than three. When you use the wizard to merge phone books, the resulting service profile installs multiple files in Connection Manager's folder rather than combining the phone books into a single file.

Each time the user establishes a connection, Connection Manager automatically checks with each server running Phone Book Service for each phone book. The Phone Book Service software checks the user's phone book version and, if necessary, downloads phone book updates.

Note If duplicate regions and service types exist among service profiles, Connection Manager removes duplicates when running the resulting service profile. You cannot merge connect actions from another service profile. Nor can you merge features among service profiles that, in turn, merge features from other existing service profiles. The resulting service profile omits any such references.

What You Can Customize in Merging Service Profiles

With the wizard you can:

  • Merge information from phone books. 

    You can merge service types, POP names, and access numbers. 

  • Merge Connection Manager features. 

    You can merge phone book updates, Dial-Up Networking settings, and realm names. 

For more information on how the wizard merges features into the resulting service profile, see the table that follows. For more information on using the wizard to merge features, see "Merging Service Profiles."

Example of how features are merged if service profile 2 is merged into service profile 1 

 

Service profile 1

Service profile 2

 

Resulting service profile

Phone books

 

 

 

 

Service type (for example, Modem and ISDN)

Service type a
Service type b
Service type c
Service type z

Service type x
Service type y
Service type z

 

Service type a
Service type b
Service type c 
Service type x
Service type y
Service type z

POP names (for example, states and regions)

POP a
POP b
POP c
POP z

POP x
POP y
POP z

 

POP a
POP b
POP c
POP x
POP y
POP z

Access numbers

Access number a
Access number b
Access number c

Access number x
Access number y
Access number z

 

Access number a
Access number b
Access number c
Access number x
Access number y
Access number z

Features

 

 

 

 

Dial-Up Networking settings

Settings a

Settings x

 

For POP a in service profile 1, settings a are used. For POP x in service profile 2, settings x are used.
If there are no Dial-Up Networking settings for service profile 1, its POPs use the default Dial-Up connection settings. If there are no Dial-Up Networking settings for service profile 2, its POPs use the default Dial-Up connection settings.
If there are no Dial-Up Networking settings for either service profile, the resulting service profile uses settings for the last Dial-Up connection added.

Phone book updates

Automatic downloading of phone book updates

Automatic downloading of phone book updates

 

Automatic downloading of phone book updates.

Connection Point servers

Connection Point server \\SERVER1

Connection Point server \\SERVER2

 

\\SERVER1 and \\SERVER2
If a Connection Point server name is specified when building the resulting service profile, that server name is used in addition.

Realm name

Realm name a

Realm name x

 

If a realm name is specified for the resulting service profile, only that realm name is used.
If a realm name is not specified for the resulting service profile, for POP a, realm name a is used. For POP x, realm name x is used.

Secure connection settings

Settings a

Settings x

 

If settings are specified for the resulting service profile, only those settings are used.

 

POP a requiring secure connection 

POP x requiring secure connection

 

Secure connection for POP a and POP x is allowed. 

Setting Up Connect Actions and Auto-Applications

Users may have a better Internet experience through the use of additional programs that start seamlessly during the connection to your service. You can include connect actions and auto-applications in service profiles.

Connect Actions

A connect action runs a program on your users' computers immediately after connecting to or disconnecting from your service. Add connect actions to perform tasks such as system maintenance. Use connect actions for smaller programs with minimal or no user interface. If you want to run programs that are larger or require user interaction, set them up as auto-applications.

What You Can Customize in Connect Actions

With the wizard you can:

  • Add connect actions based on standard Windows 95 and Windows NT operating system programs (for example, Notepad). 

  • Add connect actions based on programs that are not part of the standard Windows operating system. You can include the program in the service profile. 

For more information, see "Setting Up Connect Actions and Auto-Applications."

Auto-Applications

Auto-applications are similar to connect actions, but they have the added capability of automatically ending the connection when the final auto-application is closed. For example, a service profile is set up to use a browser and an e-mail program as auto-applications. If the user first quits the e-mail program and then quits the browser, the connection automatically ends when the user quits the browser.

What You Can Customize in Auto-Applications

With the wizard you can:

  • Add auto-applications based on standard Windows 95 and Windows NT operating system programs (for example, Notepad). 

  • Add auto-applications based on programs that are not part of the standard Windows operating system. You can include the program in the service profile. 

For more information, see "Setting Up Connect Actions and Auto-Applications."

Setting Up Sign-In and Other Customization Options

Users may need other features included in their service profiles in order to use your service.

Setting Up User Sign-In

Users may need special options for establishing a connection. For example, a user may need to provide a user name and password information in a particular format.

What You Can Customize in User Sign-In

With the wizard you can:

  • Specify a realm name prefix (for example, BYTECOMP/) or suffix (for example, @bytecomp.com) for the user name that a user types when signing in to your service.

    Internet Authentication Services (IAS) supports the use of realm names for remote authentication. You can use the realm name as authentication-routing information for roaming users who connect through different Internet access points. When the user attaches through a network access server (NAS), the NAS contacts an IAS proxy and sends to the authentication server the realm name you specify with the wizard, along with the user name and password. For more information, see "Adding a Realm Name." 

Through advanced customization, you can:

  • Control the number of redials to attempt or the delay between dials.

    To do this, edit the RedialCount or RedialDelay parameter in the .cms file. 

  • Control the time in seconds the connection must be idle before disconnecting. 

    To do this, edit the IdleTimeout parameter in the .cms file. 

  • Control whether the Dial automatically check box appears. 

    You can give users the option of automatically dialing when starting Connection Manager.

    To give users the option of automatically dialing when starting Connection Manager, edit the HideDialAutomatically parameter in the .cms file. 

  • Control whether a Reset password button appears. 

    Use this button to set up a custom password option. You must provide an executable program for this option. For example, you may link a program so users can delete an existing password and type a new one. To set up this option, edit the ResetPassword parameter in the .cms file. 

  • Control whether the Remember password check box appears on the Connection Manager Sign-In dialog box and the Internet Sign-In tab. 

    You can give users the option of saving passwords. The Remember password check box appears on the Internet Sign-In tab, which is added to profiles set up to use secure connection. Choosing this option also displays the Remember password check box in the Sign-In dialog box. This check box gives users the option of automatically dialing and having their password saved when starting the service profile. To set up this option, edit the HideRememberPassword parameter in the .cms file. 

    Note If HideRememberPassword is set to hide the Remember Password check box, the Dial Automatically check box on the Sign-In will also be hidden, even if you have not set HideDialAutomatically to do so. 

  • Control whether the Domain field appears. 

    You can provide a field for users to type a corporate realm with their user name and password. To do this, edit the HideDomain parameter in the .cms file. 

  • Specify case sensitivity for passwords.

    To do this, edit the PasswordHandling parameter in the .cms file. 

For more information, see "Advanced Customization."

Other Customization Options

Users may need to utilize other features during connection. You can build service profiles with a variety of additional customizations.

What You Can Customize in Other Features

With the wizard you can:

  • Build language-specific versions.

    For more information, see "Selecting a Language." 

  • Include your own license-agreement text file. 

    This is displayed when the user installs the service profile for the first time. After the user clicks OK to begin installation, the license-agreement text is displayed. Create the file with an editor such as Notepad. For more information, see "Adding the Basic Connection Manager Software to the Profile." 

  • Add files you want users to have in the service profile, such as programs in self-extracting executables (.exe) files.

    Although you can build such programs into a service profile, the program is not automatically installed when users install the service profile. For more information, see "Adding Files to the Service Profile." 

Through advanced customization, you can:

  • Automate dialing the service on clicking the service profile's desktop icon. 

    To do this, edit the DialAutomatically parameter in the service provider profile file (.cmp) file. For more information, see "Advanced Customization." 

Preparing for Customization

This section describes how to prepare your custom elements and install the Connection Manager Administration Kit wizard. Before continuing, be sure you have read "Choosing Customization Options," to determine what you want to customize.

The following topics are covered:

  • Preparing Custom Elements 

  • Setting Up the Wizard 

Preparing Custom Elements

Your custom elements must be ready before you run the wizard to build a service profile. Get organized before you start the wizard. Depending on what you're customizing, you may need additional resources to prepare your elements.

For example, if you want to include a phone book in your service profile, you must get copies of the phone book and region files. Or, if you want to include custom icons and bitmaps, you may need additional applications or graphics specialists to prepare them.

Considering the Service-Profile File Size

Make sure the overall size of the service profile you build is compatible with your distribution method. Consider the features you want and how you plan to distribute the service profile: by compact disc, floppy disk, or download. For example, if you are distributing by download, consider how additional download time will affect users. In some cases, you may find that you want to change your planned distribution method or include an alternate distribution method.

When you distribute a service profile by floppy disk, build a profile that fits on a single floppy disk. The wizard does not support building service profiles to fit on multiple floppy disks. It does not prompt you if the service profile does not fit on one disk.

The following are estimated file sizes (in kilobytes) of a service profile and an upgrade-only service profile for users who already have Microsoft® Connection Manager installed:

  • Service profile with basic Microsoft Connection Manager 1.0 software: 640K 

  • Basic upgrade: 140K 

The following table includes an estimate (in kilobytes) of how many kilobytes each feature adds to the overall service profile size.

Feature

Adds to service profile

Basic Microsoft Connection Manager 1.0 software

500K

Support for browsers other than Microsoft® Internet Explorer 3.0 or later

900K

Secure connection

1000K

Animation for the Sign-In dialog box

400K

Optional programs for connect actions and auto-applications; additional files

Varies

For more information, see "Basic Connection Manager Software" and "Adding the Basic Connection Manager Software to the Profile" and "Specifying Browser Requirements."

Setting Up a Folder for Custom Elements

Create a folder and place your custom files there as you prepare them. Using a single location for custom elements makes it easier to build profiles when you run the wizard. In some cases, other people may help you prepare custom elements. You may want to set up a folder at a network location that others can access.

Using the Worksheet

Use the worksheet in the following section, "Worksheet and Requirements for Custom Elements," to get organized before you run the wizard. You may want to print the worksheet to help you collect your custom elements, or use it as the basis of your own worksheet. Check the elements you want to customize and make sure your prepared elements meet any requirements listed.

Worksheet and Requirements for Custom Elements

Select the custom elements you want to set up in your service profile. Follow any requirements. Write down file names, text, and so on. When you run the wizard, refer to this worksheet.

Cc767160.cmakbox(en-us,TechNet.10).gif

Language. Other files you want to add (for example, phone books or bitmaps with text) must already be localized into the language you want to use. You can download a version of Connection Manager in the language you want from www.microsoft.com..
Languages: ___________________________________________________________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Service name. Up to 35 characters, including spaces ( for example, ByteComp, Inc. Internet Access).
Service name:___________________________________________________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

File-naming convention. Up to 8 alphanumeric characters ( for example, Bcomp). Do not use the following: ! , ; <space> * = \ / : ? ' " < >
Naming convention: ________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Merge features from other service profiles. Optional. Incorporate phone books and other features from existing service profiles.

 

Service profile (.exe) file: ____________________

Service profile (.exe) file: ____________________

 

Service profile (.exe) file: ____________________

Service profile (.exe) file: ____________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Support information. Optional. For example, Call 1-800-xxx-xxxx for customer service.
Text: __________________________________________________________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Realm name. Optional. Prefix (for example, BYTECOMP/) or suffix (for example, @bytecomp.com) to user name used at sign-in.
Realm prefix or suffix: ____________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Custom Dial-Up Networking. Optional. Custom settings for particular POPs. Each phone book Dial-Up Networking entry needs its own settings. Select whether you want to use server-assigned addresses or addresses you specify.

 

Dial-Up Networking entry: ___________________
Dial-Up Networking script (.scp) file: ___________
 

Cc767160.cmakbox(en-us,TechNet.10).gif Server-assigned address
Cc767160.cmakbox(en-us,TechNet.10).gif Specify addresses:
Primary DNS: ____ _____ _____ _____
Secondary DNS: ____ _____ _____ _____
Primary WINS: ____ _____ _____ _____
Secondary WINS: ____ _____ _____ _____
 

Cc767160.cmakbox(en-us,TechNet.10).gif

Secure connection. Optional. Connection over the Internet to private networks. Select whether you want to use server-assigned addresses or addresses you specify.

 

End-point server address: ____________________
Cc767160.cmakbox(en-us,TechNet.10).gif Use one user name and password
 

Cc767160.cmakbox(en-us,TechNet.10).gif Server-assigned address
Cc767160.cmakbox(en-us,TechNet.10).gif Specify addresses:
Primary DNS: ____ _____ _____ _____
Secondary DNS: ____ _____ _____ _____
Primary WINS: ____ _____ _____ _____
Secondary WINS: ____ _____ _____ _____

Cc767160.cmakbox(en-us,TechNet.10).gif

Connect actions. Programs to start on the user's computer after connection. Command-line parameter is optional. Use standard connect actions for phone book downloads and user MCIS Membership authentication. Select which standard connect actions you want. Custom connect actions are optional.

 

Use these standard connect actions:
Cc767160.cmakbox(en-us,TechNet.10).gif Automatic phone book download Cc767160.cmakbox(en-us,TechNet.10).gif Use existing logon information

 

Use these optional custom connect actions:

 

File name (.exe or .dll): _________________ Parameters: ____________ 

 

Run when: Cc767160.cmakbox(en-us,TechNet.10).gif Connecting or Cc767160.cmakbox(en-us,TechNet.10).gif Disconnecting

Cc767160.cmakbox(en-us,TechNet.10).gif Include file in service profile

 

File name (.exe or .dll): _________________ Parameters: ____________ 

 

Run when: Cc767160.cmakbox(en-us,TechNet.10).gif Connecting or Cc767160.cmakbox(en-us,TechNet.10).gif Disconnecting

Cc767160.cmakbox(en-us,TechNet.10).gif Include file in service profile

 

File name (.exe or .dll): _________________ Parameters: ____________ 

 

Run when: Cc767160.cmakbox(en-us,TechNet.10).gif Connecting or Cc767160.cmakbox(en-us,TechNet.10).gif Disconnecting

Cc767160.cmakbox(en-us,TechNet.10).gif Include file in service profile

 

File name (.exe or .dll): _________________ Parameters: ____________ 

 

Run when: Cc767160.cmakbox(en-us,TechNet.10).gif Connecting or Cc767160.cmakbox(en-us,TechNet.10).gif Disconnecting

Cc767160.cmakbox(en-us,TechNet.10).gif Include file in service profile

Cc767160.cmakbox(en-us,TechNet.10).gif

Auto-applications. Optional. Programs to start on the user's computer after connection. Command-line parameter is optional.

 

File name (.exe or .dll): _________________ Parameters: ____________ Cc767160.cmakbox(en-us,TechNet.10).gif Include in service profile

 

File name (.exe or .dll): _________________ Parameters: ____________ Cc767160.cmakbox(en-us,TechNet.10).gif Include in service profile

 

File name (.exe or .dll): _________________ Parameters: ____________ Cc767160.cmakbox(en-us,TechNet.10).gif Include in service profile

 

File name (.exe or .dll): _________________ Parameters: ____________ Cc767160.cmakbox(en-us,TechNet.10).gif Include in service profile

Cc767160.cmakbox(en-us,TechNet.10).gif

Sign-In dialog box bitmap or animation. Optional. Bitmap should use the Microsoft Internet Explorer 256-color palette. If you use an animation, keep the file below 50 KB for good performance. Vector-based graphics adjust well for size and color. Select one:

 

Cc767160.cmakbox(en-us,TechNet.10).gif 330 * 141 pixel bitmap (.bmp) file: _______________________________

 

Cc767160.cmakbox(en-us,TechNet.10).gif 330 * 141 aspect ratio animation (.bmp) file: _______________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Phone Book dialog box bitmap. Optional. Bitmap should use the Microsoft Internet Explorer 256-color palette.
114 * 304 pixel bitmap (.bmp) file: _______________________

Cc767160.cmakbox(en-us,TechNet.10).gif

"More phone numbers" message. Optional. For phone books with alternate access numbers displayed by clicking More in the Phone Book dialog box.
Text: __________________________________________________________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Phone book. Phone book and region files to include. Specify one of each:

 

Phone book (.pbk) file: ____________________

Region (.pbr) file: ________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Phone book updates. Phone book automatically updated by the Phone Book Service.

 

Phone Book name: _______________________________________________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Phone Book Service URL: _________________________________________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Icons. Optional. Must be 16-color. For the Windows desktop icon, the service profile uses the large icon. Select which icons you want to customize, then write the icon (.ico) file name:

 

Cc767160.cmakbox(en-us,TechNet.10).gif Status area (16 * 16) pixel icon: ________________________________

 

Cc767160.cmakbox(en-us,TechNet.10).gif Small (16 * 16) pixel icon: ____________________________

 

Cc767160.cmakbox(en-us,TechNet.10).gif Large (32 * 32) pixel icon: ____________________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Status area icon menu. Optional. Shortcut menu that appears after you right-click the status area icon. Specify the command name you want in the menu. Specify the program's file name. Command-line parameters are optional.

 

Command name: ______________ File name (.exe or .dll): _____________ Parameters: _____________

 

Command name: ______________ File name (.exe or .dll): _____________ Parameters: _____________

 

Command name: ______________ File name (.exe or .dll): _____________ Parameters: _____________

 

Command name: _____________ File name (.exe or .dll): _____________ Parameters: ____________

Cc767160.cmakbox(en-us,TechNet.10).gif

Windows Help. Optional. Customized online Help.
Windows Help (.hlp) file: ____________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Microsoft Connection Manager version 1.0 software. Optional. Include with the service profile and set up TCP/IP.

Cc767160.cmakbox(en-us,TechNet.10).gif

Browser requirement. Optional. Include Internet Explorer files with the service profile. Select one:

 

Cc767160.cmakbox(en-us,TechNet.10).gif Require Internet Explorer

Cc767160.cmakbox(en-us,TechNet.10).gif No browser requirements

Cc767160.cmakbox(en-us,TechNet.10).gif

License agreement. Optional. Include a file displayed during first-time installation.
License agreement (.txt) file: ____________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Additional files. Optional. Include other files in the service profile.
File names: _________________ _________________ _________________ ________________

Cc767160.cmakbox(en-us,TechNet.10).gif

Service profile location. Folder and file name the wizard uses to save the service profile.
Folder name and file (.exe) name: _________________ \ _________________

Setting Up the Wizard

Before running Setup, you must close any Windows programs that are running. Also, check information in the wizard's readme file. You can install the wizard on a standalone computer or on a network computer.

To set up the wizard
  1. Start the Setup program for Microsoft Windows NT 4.0 Option Pack Master Setup compact disc. Read the license agreement, and if you accept it, click Accept

  2. When prompted, click Custom. (If you have already installed any part of the Windows NT 4.0 Option Pack, click Add/Remove) 

  3. In the Select Components dialog box, click Internet Connection Services for RAS in the list of components. 

  4. Click Show Subcomponents, make sure that Connection Manager Administration Kit is selected, and then click OK

  5. When Setup is finished, click OK to restart your computer. 

During installation, Setup installs the application files in the \Program Files\Cmak folder. Setup creates a Start menu item.

Creating a Service Profile

Run the Connection Manager Administration Kit wizard to create your service profile. As you step through the wizard, you will be prompted to select customizable options and type the location of customizable elements you've prepared.

Important Your custom elements must be prepared before you start the wizard. For more information and for requirements (for example, size of custom bitmaps), see "Preparing for Customization."

Creating Multiple Customized Versions

If you want to build multiple customized versions of Microsoft® Connection Manager, note the following:

  • Languages. You can build language-specific versions, but you must run the wizard again for each language you want to build. 

  • Existing service profiles. You can edit an existing version and save the new version to a new file name.

Starting the Wizard

Once you have prepared any custom elements you want to use, start the wizard.

Important If you want to add service-profile features in addition to those set up with the wizard, you must first build a service profile, and then edit one or more of its files before you rerun the wizard. For more information, see "Advanced Customization."

To start the wizard
  1. Click Start, point to Programs, then point to Windows NT 4.0 Option Pack, then point to Internet Connection Services for RAS, and then click Connection Manager Administration Kit

  2. Follow the prompts to select features or type the location of custom files. 

Using the Wizard

The sections that follow provide details how to build a service profile, based on the order in which dialog boxes appear when you run the wizard.

Use the following as a guide for specifying file-location information and additional data:

  • When prompted to enter the location of your custom elements—such as your phone book, bitmaps and icons, and so on— type or browse to the files you want. 

  • When prompted to enter the file name of the service profile and where you want to save it, type or browse to the folder you want. 

To continue, click Next. To change information you entered in previous dialog boxes, click Back. After you have finished running the wizard, the wizard builds the service profile and saves it in the folder you specified with the file name you specified.

Adding or Editing a Service Profile

You can select whether you want to add a new service profile or edit an existing one. The service profile will run on either Microsoft Windows 95 or the Windows NT version 4.0 operating system.

The following options are available:

  • Build a new service profile. Select this to add a new service profile. 

  • Edit this service profile. Select this to edit an existing service profile, then click the name of the service profile you want in the drop-down list. 

Selecting a Language

With the wizard you can build language-specific service profiles. If you want to build service profiles for more than one language, you must run the wizard again for each service profile.

You can also build localized service profiles that use the same settings except for the language. First, build a template version with the settings you want. Then rerun the wizard and edit the template version. Change only the language used. When you save the service profile, type a different file name to avoid replacing the template version with the language-specific version.

Note Localized versions of Connection Manager will be available from www.microsoft.com for you to download and install in a subdirectory within your CMAK directory. .

The following option is available:

  • Language. Select the language you want from the drop-down list. 

Setting Up the Service Name and File Names

You can specify your service's name and the naming convention used for the service profile files. The wizard applies the naming convention to the profile's folder and file names.

The following options are available:

  • Service name. Type the name that you want to appear in the title bar text for the Sign-In dialog box, in dialog boxes displayed during installation, and as the desktop icon name.

  • File name. Type the naming convention to use for certain service profile files. For example, with Bcomp as the file name, the service profile names the folder \Bcomp and creates file names such as Bcomp.cms (service provider profile) and Bcomp.inf (information file). 

Note Make sure the file name is different from other file names you have uploaded to your customers. If two service profiles on the same computer are given the same name, the associated connection icons will not work correctly.

If you need to make changes to an existing profile, use the Connection Manager Administration Kit wizard to edit the profile instead of creating a new file with the same name.

Merging Features from Other Service Profiles

You can use the wizard to merge features from other existing service profiles into your service profile.

The following options are available:

  • Profile. Select the service profile you want, and then click Add

  • Merge. Lists the service profiles from which features have already been merged. 

  • Delete. Click this to remove a selected service profile from the Merge list. 

Customizing Support Information

You can include a line of custom support information in the Sign-In dialog box.

The following option is available:

  • Support information. Type your line of text. Use text that fits in the Support information box, as longer text may be truncated.

Adding a Realm Name

Either a realm-name prefix or suffix can be added to the user name that a user types when signing in to your service. For example, the realm name could be a prefix based on an ISP name (for example, BYTECOMP/).

The following options are available:

  • Do not add a realm name. Select this if you do not want to add a prefix or suffix to the user name. 

  • Add a realm prefix. Select this, then type the prefix to add to the user name at sign-in. You may want to prepend a realm name and a separator character (for example, BYTECOMP/). 

  • Add a realm suffix. Select this, then type the suffix to add to the user name at sign in. You may want to append a separator character and realm name (for example, @bytecomp.com). 

  • Realm name. Type the complete prefix or suffix, including the separator character (for example, / or @) you want to use. 

Setting Up Custom Dial-Up Networking

From this dialog box you can set up custom Dial-Up Networking settings for a particular POP. Do this by associating Dial-Up Networking entries set up in the phone book (.pbk) file with Dial-Up Networking entries you set up in your service profile.

The following options are available:

  • Phone book Dial-Up Networking entries. View phone book Dial-Up Networking entries already added. 

  • Add. Click this to add a new phone book Dial-Up Networking entry to your service profile. 

  • Edit. Click this to edit a phone book Dial-Up Networking entry that's selected in the Dial-Up Networking entries list. 

  • Delete.Click this to remove a phone book Dial-Up Networking entry that's selected in the Dial-Up Networking entries list. 

The phone book Dial-Up Networking entry set up in the phone book must match the entry you set up in your service profile. In the example that follows, the POP uses the phone book Dial-Up Networking entry Bcomp1.

Cc767160.cmak8a(en-us,TechNet.10).gif

Setting Up Phone Book Dial-Up Networking Entries

You can use the wizard to specify which options to use for a particular Dial-Up Networking entry.

The following options are available:

  • Phone book Dial-Up Networking entry. Type the name of the phone book Dial-Up Networking entry you want. This entry must match the phone book Dial-Up Networking entry from the phone book. 

  • Server assigned address. Select this to automatically assign name servers. 

    Note To use server-assigned addresses, end-point Windows NT servers must be configured to use the Dynamic Host Configuration Protocol (DHCP) to automatically assign remote TCP/IP client IP addresses. 

  • Specify addresses. Select this to specify name servers. 

  • Primary DNS address. Type the primary Domain Name System (DNS) Internet Protocol (IP) address for the phone book Dial-Up Networking entry. 

  • Secondary DNS address. Type the secondary DNS IP address for the phone book Dial-Up Networking entry. 

  • Primary WINS address. Type the primary Windows Internet Naming Service (WINS) IP address for the phone book Dial-Up Networking entry. 

  • Secondary WINS address. Type the secondary WINS IP address for the phone book Dial-Up Networking entry. 

  • Dial-Up Networking scripts. Type or browse to the script file (.scp) you want, if your service requires it. 

Setting Up Secure Connection Over the Internet

You can set up secure connection over the Internet for your service profile. With secure connection, your users access private networks using local Internet Points of Presence (POPs) provided by Internet Service Providers (ISPs).

The following options are available:

  • Use a Secure Connection for this service profile. Select this to set up the profile for secure connection using the Point-to-Point Tunneling Protocol (PPTP). If the user's computer is not already set up to use Dial-Up Networking, the service profile will automatically set it up the first time it is run. A Dial-Up connection called ServiceProfileFileName Tunnel is added.

    If a user's computer is running Microsoft Windows 95, Dial-Up Networking version 1.2 must be installed for PPTP connections to work. If your users run Windows 95, select the check box to set up the service profile to automatically upgrade their Dial-Up Networking software to version 1.2. If the user's computer is running Windows NT, they do not need to upgrade to Dial-Up Networking 1.2. 

    Note If you include the upgrade to Dial-Up Networking version 1.2 in your service profile, its size increases substantially. If your service requires PPTP connections, you may want to create a separate profile for your customers who run Windows NT that does not contain the Dial-Up Networking upgrade. 

  • Use Secure Connection for merged service profiles. Select this to use secure connection for all phone numbers from phone books you have merged from other service profiles. 

Note When you select an option, make sure the phone books are correctly set up. When you select secure connection for a service profile, make sure the profile's phone books have been configured with phone numbers you want to use for secure connection. For profiles that do not use secure connection, make sure the profiles' phone books have been configured with direct-dial phone numbers.

Specifying the End-point Server and How the Service Profile Handles Authentication

You can specify the end-point server and how your service profile handles user authentication.

The following options are available:

  • PPTP server address. Type either the named address or a TCP/IP address for the end-point server. 

  • Server assigned address. Select this to automatically assign name servers. 

    Note To use server-assigned addresses, end-point Windows NT servers must be configured to use the Dynamic Host Configuration Protocol (DHCP) to automatically assign remote TCP/IP client IP addresses. 

  • Specify DNS and WINS addresses. Select this to specify name servers. 

  • Primary DNS address. Type the primary Domain Name System (DNS) Internet Protocol (IP) address for the end-point server. 

  • Secondary DNS address. Type the secondary DNS IP address for the end-point server. 

  • Primary WINS address. Type the primary Windows Internet Naming Service (WINS) IP address for name resolution on the end-point server's network. 

  • Secondary WINS address. Type the secondary WINS IP address for name resolution on the end-point server's network. 

  • Use the Sign-In user name and password for the Internet. Select this to set up your service profile to use the same user name and password for Internet sign-in and private network server sign-in using a secure connection. Once the second connection is established, the user's computer can function as if it were directly attached to the private network. 

    If this option is cleared, two sets of user names and passwords are required:

    • Internet sign-in user name and password typed by the user 

    • Private network server sign-in user name, password, and realm set up on the Internet Sign-In tab 

Setting Up Connect Actions

Your service profile can be set up to automatically start programs or install software on the user's computer after the user establishes a connection. You can also specify when during the connection each program will run (either when a connection is established or after connecting).

The following options are available:

  • Automatically download phone book updates. Select this to set up your service profile so that users automatically receive any phone book updates. Connection Manager sends query variables to the server running Phone Book Service so that the server can compare the user's phone book version with the most recent files available and then download the appropriate phone book updates. Downloading occurs while the user is connected. The update is installed after the connection is closed. The next time Connection Manager is used, the updated access numbers and connection configurations are available. 

  • Use subscribers' existing log on information. Select this to set up your service profile to use MCIS Membership authentication. If this option is selected, the user name and password are automatically used at Web pages that require them. If this option is not selected, the user will be prompted to type a user name and password at Web pages that require them. 

  • Custom connect actions. Lists the connect-action programs already set up. Following each program is the connect action type: (Connect) identifies a connect action run when connecting, and (Disconnect) identifies a connect action run after disconnecting.

  • Move Up. Click this to move a connect action up in the list. Programs start in the order listed. 

  • Move Down. Click this to move a connect action down in the list. 

  • Add. Click this to add a new connect action. 

  • Edit. Click this to edit a selected connect action in the Custom connect actions list. 

  • Delete. Click this to delete a selected connect action in the Custom connect actions list. 

Adding or Editing Connect Actions

You can specify the connect-action program you want to run on the user's computer and when it will run during the user's connection to your service.

Note When you set up connect actions, consider your users' time and their computers' performance. Set up connect actions that provide users with a smooth experience when they are using your service. Test your service profile prior to distribution.

The following options are available:

  • Program to run. Type or browse to the program file name you want to run. 

  • Parameters. Type any command-line parameters you want executed with the program. The following special command-line parameter macros are supported:

    Macro

    Replaced with

    %UserPrefix% 

    The realm user-name prefix you have specified 

    %UserSuffix% 

    The realm user-name suffix you have specified 

    %UserName% 

    The user name, without any realm user-name prefix or suffix specified 

    %Profile% 

    The location and file name of the active connection profile (.cmp) file 

    Connection type. 

    • Run when connecting. Select this to start the program on the user's computer after a connection is established. 

    • Run when disconnecting. Select this to start the program on the user's computer before the connection is ended. 

    Note If you are setting up a service profile to use secure connection, connect actions that are specified as run when connecting execute after the secure connection has been established. Connect actions that are configured as run when disconnecting execute after disconnection. 

  • Include the connect action program in this service profile. If the program you want to run is not part of the standard Windows operating system, you can include the program in your service profile. When the user installs the service profile, the profile's Setup program checks the user's available disk space before installing. The service profile installs the connect-action program in the service profile's folder. 

Tip Consider the overall size of your service profile in relation to your distribution method. For example, if you are distributing by download, consider the additional download time for users.

Using a wizard dialog box that appears later, you can include additional optional files in your service profile. For more information, see "Adding Files to the Service Profile."

Important Specify only programs that are complete program files. You can include one program file per connect-action program. Do not specify a connect-action program that requires other files or is a self-extracting executable (.exe) file.

Setting Up Auto-Applications

You can use the wizard to set up your service profile to use auto-applications.

The following options are available:

  • Auto-applications. Lists the programs already set up that automatically start after a connection is established. 

  • Move Up. Click this to move an application up in the Auto-applications list. Programs start in the order listed. 

  • Move Down. Click this to move an application down in the Auto-applications list. 

  • Add. Click this to add a new auto-application. 

  • Edit. Click this to edit an auto-application that's selected in the Auto-applications list. 

  • Delete. Click this to remove an auto-application that's selected in the Auto-applications list. 

Adding or Editing Auto-Applications

You can specify the auto-application program you want to run on the user's computer and when it will run during the user's connection to your service.

The following options are available:

  • Program to run. Type or browse to the program file name you want. 

  • Parameters. Type any command-line parameters you want executed with the program. The following special command-line parameter macros are supported:

    Macro

    Replaced with

    %UserPrefix% 

    The realm user-name prefix you have specified 

    %UserSuffix% 

    The realm user-name suffix you have specified 

    %UserName% 

    The user name, without any realm user-name prefix or suffix specified 

    %Profile% 

    The location and file name of the active connection-profile (.cmp) file 

    Note If you are customizing a service profile to use secure connection, auto-applications execute after the secure connection is established. 

  • Include the auto-application in this service profile. If the program you want to run is not part of the standard Windows operating system, you can include the program in your service profile. When the user installs the service profile, the user's available disk space is checked before installing the program. The service profile installs the auto-application program in Connection Manager's folder.

  • Consider the overall size of your service profile in relation to your distribution method. For example, if you are distributing by download, consider the additional download time for users. 

Important Specify only programs that are complete program files. You can include one program file per auto-application program. Do not specify a auto-application program that requires other files or is a self-extracting executable (.exe) file.

Customizing the Sign-In Dialog Box Bitmap

The Sign-In dialog box can be customized to include a custom bitmap image. Your custom bitmap may be a company logo or another image that identifies your organization. If you want to replace the default bitmap, use an application such as Microsoft® Paint to create it. Your custom bitmap will display best if it has the same proportions as the default bitmap. If the proportions of your custom bitmap are different from those of the default bitmap, the custom bitmap will be automatically scaled when displayed. If you do not use a custom bitmap, the default Sign-In dialog box bitmap is used — the dialog box is not left blank.

You also have the option of replacing the static Sign-In dialog box bitmap with a custom animation. For more information, see "Using an Animation in the Sign-In Dialog Box."

The following options are available:

  • Use the default bitmap. Select this to use the default Sign-In dialog box bitmap. 

  • Use this bitmap. Select this to use a custom Sign-In dialog box bitmap, and then type or browse to your bitmap file.

Note The bitmap must use the Microsoft Internet Explorer 256-color palette.

Using an Animation in the Sign-In Dialog Box

From this dialog box, you can replace the static Sign-In dialog box bitmap with a custom animation. The animation can be played as a single, continuous animation, or you can play specific animation segments based on the connection state. For example, you can play one animation segment when the service profile is ready to dial, play another animation segment while dialing the primary POP phone number, and so on.

Note If for some reason the animation fails (for example, the animation file is missing), the Sign-In dialog box is not left blank. If the profile is also set up to use a custom bitmap, the custom bitmap appears. If the profile is not set up to use a custom bitmap, the default Sign-In dialog box bitmap appears.

The following options are available:

  • No animation. Select this to use a bitmap in the Sign-In dialog box rather than an animation. 

  • Play a single animation. Select this to play the animation file continuously. 

  • Play different frames depending on connection state. Select this to play specific animation segments based on the connection state. Then go to the next wizard dialog box and specify the frames to play for each state. 

  • Animation file. Type or browse to the name of the animation file (.spl) you want to use. 

Specifying When to Play Animation Segments

You can specify which animation segments to play based on the connection state.

Note Test animation playback with your service profile prior to distributing it to users. Try each connection state you want to use during animation playback. Check the animation's appearance and timing.

The following options are available:

  • Ready to dial. Type the first animation-frame number to play when ready to dial. 

  • Dialing primary number. Type the first animation-frame number to play when dialing the primary phone number for a POP. 

  • Pausing between dialing. Type the first animation-frame number to play when pausing between redialing. 

  • Dialing backup number. Type the first animation-frame number to play when dialing the backup phone number for a POP. 

  • Verifying user name and password. Type the first animation-frame number to play when authenticating the user name and password. 

  • Opening a Secure Connection. If you have set up the profile to use a secure connection, type the first animation-frame number to play when the profile establishes a connection. 

  • Connection established. Type the first animation-frame number to play when the profile establishes a connection. 

  • Connection error. Type the first animation-frame number to play if an error occurs when attempting to establish a connection. 

Customizing the Phone Book Dialog Box Bitmap

You can customize the Phone Book dialog box to include a custom bitmap image. Your custom bitmap may be a company logo or another image that identifies your organization. If you want to replace the default bitmap, use an application such as Microsoft® Paint to create it. Your custom bitmap will display best if it has the same proportions as the default bitmap. If the proportions of your custom bitmap are different from those of the default bitmap, the custom bitmap will be automatically scaled when displayed. If you do not use a custom bitmap, the default Phone Book dialog box bitmap is used — the dialog box is not left blank.

The following options are available:

  • Use the default bitmap. Select this to use the default Phone Book dialog box bitmap. 

  • Use this bitmap. Select this to use a custom Phone Book dialog box bitmap, then type or browse to your bitmap file.

Note The bitmap must use the Microsoft Internet Explorer 256-color palette.

Setting Up the Phone Book

You can use the wizard to set up your service profile to use the phone book and region files you want. Using custom phone book and region files provides users with complete Point of Presence (POP) information. Users can roam and connect to different Internet access points by using POPs listed in the phone book. The service profile can also automatically obtain updated files for the user's local phone book through Connection Point Services. If another network administrator maintains phone books, contact him or her to get copies of the correct phone book and region files. To set up automatic phone book updates, you will need the name of the Connection Point server.

Note If you are setting up automatic phone book updates, include as much POP information as possible in your service profile. The more information you include, the faster subsequent additions or updates to phone book information will download to your users' phone books.

The following options are available:

  • Phone book file. Type or browse to the (.pbk) file name. 

  • "More phone numbers" message. If your phone book contains alternate phone numbers that are displayed by clicking the More button in the Phone Book dialog box, you can set up a custom message indicating that there are more phone numbers. Type your line of text. 

Notes 

Make sure the region file has the same name as the phone book file (for example, if your phone book file is Phone.pbk, the region file should be Phone.pbr) and is in the same directory as the phone book file.

The context-sensitive help for the list of alternate phone numbers says that the user may be charged extra for using alternate phone numbers. If this is not true for your alternate phone numbers, you may want to edit the help topic.

Setting Up Phone Book Updates

You can set up automatic updates for the user's local phone book.

Note This dialog box will only be displayed if you select the phone book update connect action. If you specified a phone book name in a previous wizard dialog box, the phone book name is shaded.

The following options are available:

  • Phone book name for downloading. Type the name of the phone book your server downloads to your users if you do not include a phone book (.pbk) file in your service profile. This phone book name must match the name of the phone book file created by using Connection Point Services. The first time the user connects to your service, the Phone Book Service automatically downloads the phone book named here. In the example that follows, the service profile is set up to download the phone book BcompPB. 

  • Connection Point Service URL. If you want the user to automatically receive a phone book update, type the Uniform Resource Locator (URL) of the Connection Point server. 

The phone book name must match the Phone Book file name shown in Phone Book Administrator.

Customizing Icons

You can specify the custom service profile icons to use in place of the default icons. Use an icon-editing application to create your own icons. Create icons that are the same size and shape as the default icons so they will display properly.

The following options are available:

  • Use the default icons. Select this to use the default icons. 

    Use these icons. Select this to use custom icons, and then type or browse to each icon file you want:

    • Large custom icon

    • Small custom icon

    • Small status area custom icon

Tip To use the same icon for the large icon and small icon, simply specify the large icon's file name for the small icon. The wizard automatically scales down the large icon.

Setting Up a Status-Area Icon Menu

You can use this dialog box to set up a custom shortcut menu that appears after a user right-clicks the service profile's status area icon. Commands in the shortcut menu appear in the same order as you see them in the Shortcut menu commands list.

Note You can control whether a status area icon is displayed. For more information, see "Advanced Customization."

The following options are available:

  • Shortcut menu commands. Lists the commands already added. 

  • Move Up. Click this to move the command up in the shortcut menu. 

  • Move Down. Click this to move the command down in the shortcut menu. 

  • Add. Click this to add a new command to the status-area icon menu. 

  • Edit. Click this to edit a selected command in the Shortcut menu commands list. 

  • Delete. Click this to delete a selected command in the Shortcut menu commands list. 

Setting Up Status-Area Icon Menu Items

You can add or edit commands in a custom shortcut menu that appears after a user right-clicks the status-area icon associated with a service profile.

The following options are available:

  • Shortcut menu item name. Type the name you want the program to have in the shortcut menu. 

Tip You can add keyboard access to a shortcut-menu item. Specify an underlined letter in the menu item name as an access key. To create the access key, type an ampersand (&) immediately preceding the letter you want to use. For example, to add Internet Explorer as a menu item name with I specified as the access key, type &Internet Explorer in the Shortcut menu item name box. To include the ampersand (&) character in the menu item name, type &&. One ampersand will appear in the menu.

  • Program to run. Type or browse to the program file name you want to run. 

  • Parameters. Type any command-line parameters you want executed with the program. You cannot specify parameters for optional files such as connect-action programs. 

  • Include this program in the service profile. If the program you want to run is not part of the standard Windows 95 and Windows NT operating systems, you can include it in your service profile. When the user installs Connection Manager, the service profile copies the program to the Connection Manager folder. 

Setting Up Windows Help

You can specify a customized Windows Help file to use with Connection Manager or choose to use default Windows Help. Generic online Help files are included and can be used as is. However, you may want to provide special instructions for your users, particularly if you think your customization requires it.

If you want to add custom Windows Help, you must prepare your files by using the Windows Help Authoring Kit before running the wizard. The installation compact disc contains the files necessary to customize the Windows Help files supplied with the Connection Manager Administration Kit.

For more information, see "Creating Custom Windows Help".

The following options are available:

  • Use the default Help file. Select this to use the default Windows Help file. 

  • Use this Help file. Select this to use a custom Help file, and then type or browse to the file you want. 

Adding the Basic Connection Manager Software to the Profile

You can specify whether to include the basic Microsoft Connection Manager version 1.0 software along with the service profile. When you choose this option, the Connection Manager version 1.0 software is installed when users install the service profile.

If a user installs more than one service profile, each version is installed in a separate folder. The versions share the Connection Manager software. The options on this dialog box and the next dialog box, "Specifying Browser Requirements," are provided because Connection Manager requires that the following be installed on the user's computer:

  • The Connection Manager version 1.0 software 

  • Microsoft Internet Explorer 3.0 or later 

This option also automatically configures the user's computer to use TCP/IP if it is not already set up.

Note Adding this software increases the size of your service profile. For more information, see "Considering the Service-Profile File Size."

The following options are available:

  • Include the Connection Manager program. Select this to include the Connection Manager version 1.0 software in the service profile. 

Specifying Browser Requirements

You can specify whether to use several supporting Microsoft® Internet Explorer files in the service profile.

Important The service profile requires several dynamic link library (.dll) files from Internet Explorer 3.0. If a user's computer does not have either Internet Explorer 3.0 or later or the supporting files installed from this dialog box, the service profile cannot install Connection Manager.

Note Adding this software increases the size of your service profile. For more information, see "Considering the Service-Profile File Size."

The following options are available:

  • Require Internet Explorer 3.0 or later. Select this to omit the supporting Internet Explorer files from the service profile. 

  • No browser requirements. Select this to include the supporting Internet Explorer files in the service profile. 

Tip If you are not sure whether most users have these files, select the No browser requirements check box. If a user's computer already has Internet Explorer 3.0 or later, the service profile will automatically update the Internet Explorer files.

Adding a License Agreement

From this dialog box you can specify the custom license agreement text file that is displayed when the user installs the service profile for the first time.

The following options are available:

  • License agreement. Type or browse to the text file (.txt) you want. 

Adding Files to the Service Profile

You can add files you want your user to have in your service profile. The service profile copies the files to the Connection Manager folder.

Tip Adding files makes your service profile larger. Consider the overall size of your service profile relative to your distribution method. For example, if you are distributing by download, consider the additional download time for users entailed by increasing the size of your service profile.

The following options are available:

  • Additional files. Lists the optional files already set up. 

  • Add. Click this to add a new optional file. 

  • Delete. Click this to remove from the service profile an optional file selected in the Additional files list. 

Adding or Editing Additional Files

Each additional file you want to add to your service profile can be specified from this dialog box.

The following option is available:

  • File to include. Type or browse to the file you want. 

Specifying the Service Profile Location

You can use the wizard to specify the file name used by the wizard to save your service profile. When you finish customizing, the wizard saves the service profile and any customized elements—custom bitmap images, icons, messages, and so on—as a self-extracting executable (.exe) file. This is the file you provide to your users.

The following option is available:

  • File name and location. Use the default file name and location, or type or browse to the folder and file name you want. 

Finishing the Wizard and Building the Service Profile

If you want to review your settings, click Back. When you are ready for the wizard to create the service profile, click Finish. When the service profile is built, the wizard displays a dialog box indicating the folder and file name used to save the service profile. Click OK to quit.

Note Building the service profile requires a lot of virtual memory, and may take several minutes. Close all other programs that you do not need. Also, if you are running Windows NT, you may need to increase your Virtual Memory settings manually. For more information, see your Windows NT documentation.

Testing and Distributing Connection Manager

Before you distribute the service profile you created with the Connection Manager Administration Kit wizard, you need to test it. This section describes how to install and test service profiles. It also describes considerations if you want to provide users with your own installation program to install service profiles.

This section covers the following topics:

  • Checking Your Service Profile Before Distribution 

  • Using Your Own Installation Program 

  • Distributing Your Service Profile 

  • Providing Instructions for Users 

Checking Your Service Profile Before Distribution

Install and test your service profile. Make sure it has the appearance and features you want. If necessary, edit the profile to add or change features.

Installing Service Profiles

Try installing your service profile just like your users will. For example, if you're distributing the service profile on disk, test installation from disk.

To install a service profile
  1. If you're distributing the service profile on disk or a compact disc, insert it in the appropriate drive. 

  2. Use Windows Explorer and browse to the file name you've assigned the service profile.

  3. Double-click the service profile's file name, ServiceProfileFileName.exe. 

  4. During installation, Setup installs the application files on your hard drive. Setup installs the custom dialer in a subdirectory of Connection Manager and creates an icon on your desktop. 

Testing Service Profiles

The following are basic testing steps. Service profiles can be customized in a variety of ways. Try all the features you set up.

To test your service profile
  1. Install the service profile as described above. 

  2. Click the Connection Manager icon on the desktop. 

  3. Check that all custom bitmaps, icons, and Help dialog boxes appear properly. 

  4. Use Connection Manager.

    Select a POP from the phone book. Establish a connection. 

    Make sure Connection Point Services is functioning properly. For details, see the Connection Point Services Administration Guide

    Check the status area in the Windows taskbar to make sure the status-area icon appears properly. The status-area icon appears only when a connection is established. 

Using Your Own Installation Program

If you are using your own installation program to start installation for your service profile, you may want to use the quiet mode /q command-line parameter. The /q command-line parameter suppresses the two dialog boxes displayed by the service profile. One dialog box requires that the user click OK to begin installation, while the second dialog box requires that the user click OK to continue after installation is complete. Adding the /q command-line parameter can make Connection Manager installation smoother for your users. Here is an example of the syntax:

C:\Program Files\Installer\Bcomp\Bcomp.exe /q 

Distributing Your Service Profile

You can choose to distribute your service profile by disk, CD-ROM, or downloadable file. The following sections describe considerations for various distribution media. However you distribute your service profile, provide users with instructions on how to set up and use it. For more information, see "Providing Instructions for Users."

Floppy Disk or Compact Disc

Users can install your service profile directly from floppy disk or compact disc. Using Windows Explorer or Windows NT Explorer, a user can simply double-click the service profile's file name to install the service profile.

Downloadable Files

The files included in your service profile can be distributed over a private network or the Internet.

Providing Instructions for Users

Make sure the setup and usage instructions you include with your service profile are clear and complete. This will reduce your support effort by helping to ensure that your users are successful in setting up Connection Manager and connecting to your service. Use the following as a basis for the setup and usage instructions you provide to your users.

Setting Up Connection Manager

Have users follow these steps to set up Connection Manager.

To set up Connection Manager
  1. If you've received the service profile on disk or a compact disc, insert it in the appropriate drive. 

  2. Use Windows Explorer and browse to the file name you've assigned the service profile. If you've downloaded Connection Manager from the Internet or a private network, browse to your download folder. 

  3. Double-click the service profile's file name, ServiceProfileFileName.exe. 

During installation, Setup installs the application files on your hard drive. Setup installs the custom dialer in a subdirectory of Connection Manager and creates an icon on your desktop.

Establishing a Connection

Have users follow these steps to connect to your service.

To establish a connection
  1. Double-click the service-profile icon on the desktop. 

  2. Type your user name and password. If you are using a secure connection to connect to a private network, you may be prompted for a second user name and password. If so, type the user name and password you use for the private network server. 

  3. If you are using Connection Manager to connect for the first time, click Settings and select a phone number from the phone book of access numbers. You may need to wait briefly for the phone number to be displayed when opening a large phone book. Alternatively, you may type the service's access phone number. Click OK

  4. Click Connect to establish a connection. 

  5. When you connect, the service may update your phone book if new or changed phone book information is available. 

For help with establishing a connection or with troubleshooting, use Help:

  • To learn about procedures detailed on a tab, click Help

  • For more information about an item in the dialog boxes and tabs, click the question-mark [?] button in the title bar, and then click the item. 

  • For more information about an item in other tabs, right-click the item and then click What's This? in the pop-up window. 

Removing Connection Manager

Have users follow these steps if they want to remove the Connection Manager software used to connect to your service. This requires removing both the service profile, containing any custom files and the service provider profile file (.cms), and the basic Connection Manager software.

To remove Connection Manager
  1. Open Control Panel. 

  2. Click Add/Remove Programs

  3. Click the service profile name. 

  4. Click Add/Remove, then click OK

  5. Click Connection Manager

  6. Click Add/Remove, then click OK

Note If multiple service profiles are installed on the computer, users should not remove Connection Manager.

Advanced Customization

This section describes how a network administrator can customize additional Microsoft® Connection Manager features other than those controlled through the wizard. Advanced customization can help you met the particular needs of your users. This section describes Connection Manager information files. It clarifies which sections of the files are modified through running the wizard and which sections must be manually edited for advanced customization. A basic understanding of system-configuration files is assumed. This section covers the following topics:

  • File Formats 

  • Customizing Additional Features 

  • Setting Up Command-Line Parameters 

When you use the wizard to build a service profile, the wizard creates information files containing the elements you set up, such as the service name and the names of any custom bitmap, icon, or Windows Help files. To provide special features for your users, you can manually edit files to add custom settings beyond those controlled through the wizard.

File Formats

Connection Manager information files are similar to Windows .ini and .inf files:

  • Each file is divided into sections. A section heading is enclosed within square brackets (for example, [Strings] is a section containing text strings). 

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

  • Sections are delimited by one blank line. Each section can contain multiple entries. 

  • Comments in the file start with a semicolon (;). 

For more information on these formats, see Microsoft Windows SDK.

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
  1. Start the wizard. Build a service profile with the features you want. 

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

  3. Locate the files in the \Cmak\ServiceName folder. Make backup copies of the files you must edit. 

  4. Use a text editor such as Notepad to edit the files. 

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

 

 

Setting Up Command-Line Parameters

This section describes valid service profile command-line parameters.

If you are using a special configuration to run a service profile, such as a script file or a setup program, you can add one or more command-line parameters. By adding command-line parameters, you can customize how the service profile runs.

Using service profile command-line parameters requires a special syntaxfor the /settings and /unattended parameters.

Here is an example of the syntax to use if you wanted to use the /settings or /unattended command-line parameter with a service profile:

"C:\Program Files\Internet Explorer\Connection Manager\Cmmgr32.exe" ServiceProfileFileName.cmp /settings

Command-line parameter

Description

/settings

Displays the Settings dialog box on startup, rather than the Sign-In dialog box.

/unattended

Dials automatically, does not display the service profile user interface. Using this command-line parameter has two requirements.
1. The Dial automatically check box must be enabled through advanced customization. Edit the HideDialAutomatically parameter in the .cms file. For more information, see "Advanced Customization."
2. The Dial automatically check box must be selected.

Creating Custom Windows Help

This section contains a list of components and tools supplied with the Connection Manager Administration Kit, as well as information about the online Help system and customization suggestions. A basic understanding of Windows Help systems and user-education concepts is assumed.

Help Components

The following online Help components are included on the installation compact disc in the \Support\Help folder. You will need these files in order to customize and rebuild the online Help system.

  • Cmmgr32.hlp—The compiled Help file 

  • Cmmgr32.hpj—The Help project file 

  • Cmctx32.rtf—The text document source for context-sensitive Help 

  • Cmtrb32.rtf—The text document source for troubleshooting Help 

  • Cmmgr32.h—The header file containing context-sensitive Help IDs. 

These files are discussed individually later in this section.

Note Be careful when making modifications to Help files. Troubleshooting changes made to these files is difficult. Avoid changing Windows Help file footnotes. Never modify the original file. Always make backup copies.

Required Tools

For Help file customization, you can use Microsoft® Help Workshop version 4.01. You will also need a word processing application such as Microsoft® Word that reads and writes .rtf files. For more information about creating Help files, refer to the online Help, supplied with Help Workshop, and the Help Workshop training cards.

Connection Manager Help System

Microsoft® Connection Manager Help consists of two types of Help: context-sensitive and troubleshooting. Users invoke context-sensitive Help by pointing to an interface item and clicking the right mouse button, and then clicking What's This? in the shortcut menu. In the Connections Settings and Phone Book dialog boxes, users can also access context-sensitive Help by clicking the question-mark icon in the title bar and then clicking an interface item. Users invoke the Sign-In Troubleshooter by clicking the Help button in the Sign-In, Connection Settings, or Phone Book dialog boxes.

Context-Sensitive Help

Context-sensitive Help provides users with a brief description of each interface item. This type of Help appears in a small pop-up window when a user right-clicks an interface item, and then clicks What's This? in the shortcut menu. In the Connection Settings and Phone Book dialog boxes, users can also access context-sensitive Help by clicking the question-mark button in the title bar and then clicking the interface item in question. Text for the context-sensitive Help is in the file Cmctx32.rtf. In the following list of customization suggestions, each topic is referred to by its topic ID (# footnote).

Customization Suggestions for Context-Sensitive Help

The following list contains suggestions for customizing Connection Manager's context-sensitive Help. It is recommended that you customize the Help to address the specific needs of your users. All the topics in the Help file can be modified.

  • IDH_SIGNIN_SVCMSG—In the Sign-In dialog box, this topic provides Help for the user-service message area. You can modify the text to provide further service information for your users. 

  • IDH_PHONEBOOK_SERVICETYP—In the Phone Book dialog box, this topic provides Help for the Service Type drop-down list. You may want to customize this topic to reflect the service types you support and provide a brief description of each. 

  • IDH_PHONEBOOK_ACCESSNUMS and IDH_PHONEBOOK_MORE—In the Phone Book dialog box, these topics provide Help for the Access Numbers and More Access Numbers lists. You may want to provide more specific information about the numbers available in this box. For example, one set of numbers may charge a fee, while the others are free. 

  • IDH_PHONEBOOK_SVCMSG—In the Phone Book dialog box, this topic provides Help for the phone book customer-service message area (to the right of Service Type). You can use the Help topic to provide additional customer service information. 

Troubleshooting Help

Troubleshooting Help provides your users with steps to solve common connection problems. This type of Help uses a question-and-answer format to guide users through determining the likely cause of the problem. The troubleshooter then provides possible solutions based on users' feedback. Users access the troubleshooting Help from the Help button in any dialog box. Text for the troubleshooting Help is in the file Cmtrb32.rtf. The following list of customization suggestions includes reference topics by title and by topic ID (# footnote).

Customization Suggestions for Troubleshooting Help

The following list contains suggestions for customizing the Connection Manager troubleshooter. It is recommended that you customize the troubleshooter to address the specific needs of your users. All the topics in the Help file can be modified.

  • ICM_TRB (Sign-In Troubleshooter)—This topic is the first level of the troubleshooter, where users begin identifying possible problems. If you have specific problems you want to address, you can add your own paths to the troubleshooter starting from this, or any, point. You can also add additional topics to other paths to cover as many situations as you want. 

  • ICM_TRB_CUSTSUP_NUMS (Contact Customer Support)—This topic provides users with customer-support information. Add your specific customer-support information, including phone numbers, hours of operation, and any other information that would be useful to your users. This topic is accessed through many other topics that recommend contacting customer support. 

  • ICM_TRB_GIVEUP (Next Steps)—This topic appears at the end of all troubleshooting paths. You can provide additional instructions for users who are still not able to connect to your service after trying all troubleshooting possibilities. 

Information in this document is subject to change without notice. The names of companies, products, people, characters, and/or data mentioned herein are fictitious and are in no way intended to represent any real individual, company, product, or event, unless otherwise noted. Complying with all applicable copyright laws is the responsibility of the user. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Microsoft Corporation. Permission to print one copy for personal use is hereby granted if your only means of access is electronic.

Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.

© 1996-1997 Microsoft Corporation. All rights reserved.

ActiveX, JScript, Microsoft, Microsoft Press, MS, MS-DOS, Visual Basic, Visual C++, Visual J++, Visual InterDev, Windows, Win32, Win32s, and Windows NT are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

Java is a trademark of Sun Microsystems, Inc.

Other product and company names mentioned herein may be the trademarks of their respective owners.

Cc767160.spacer(en-us,TechNet.10).gif

Show: