Templates and service profile files

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Templates and service profile files

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

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

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

Service profile files consist of the following file types:

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

  • Connection profile (.cmp) files. The .cmp files contain information specified by the user. Because users can overwrite this information, any changes you make to this file will be available only the first time the service profile is used. Editing this file allows you to provide a first-time-only population of user information. For example, you can fill in the user name, the password, and the phone number fields for the first user to install and open your service profile.

  • Information (.inf) files. The .inf files specify the installation information for your service profiles. Although you can edit some setup and uninstall information in an .inf file, you should test the installation after you make the changes. Information files cannot be edited from the CMAK wizard Advanced Customization pane. To edit them, you must use a text editor.

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

Important

  • You should not edit these files without a basic understanding of system configuration files. Troubleshooting changes to service-profile files is difficult, so you should be careful if you modify them. Read section and key descriptions carefully. It is advisable to make a backup of these files before you edit them.

  • Do not save template files in Unicode.

Editing template files

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

Template files

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

  • Template.cms

  • Template.cmp

  • Template.inf

  • Template.sed

These files contain the default settings that the CMAK wizard uses to build service profiles. If you want to incorporate the same custom functions in all service profiles that you build, edit the template files before building the service profiles. You must edit the template files with a plain-text editor, such as Notepad. You cannot edit template files with the CMAK wizard.

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

Note

  • Changes you make to the template files apply only to subsequent new service profiles you build using the CMAK wizard.

Built files

When you use the CMAK wizard to build a service profile, the wizard creates a self-extracting executable (.exe) file and several other files containing the settings that you specify. The service profile files are saved in the \Program Files\CMAK\Profiles\ServiceProfileFileName folder. All service profile files have the name ServiceProfileFileName, which you specify in the CMAK wizard. In addition to the .exe file, the wizard creates the following files for each service profile:

  • ServiceProfileFileName.cms

  • ServiceProfileFileName.cmp

  • ServiceProfileFileName.inf

  • ServiceProfileFileName.sed

Changes to template files are reflected only in profiles built after you make the change. If you want profiles built before you make the change to match the template, you must update the profile. To incorporate template changes into a built file, you must run the CMAK wizard again.

For more information, see Deciding what to customize, Uses for advanced customization, and Finishing customization after running the CMAK wizard.