Modifying Scw.ini

[This is preliminary documentation and subject to change.]

Before your preinstallation application can modify the Scw.ini file, it must determine the available application number.

The available application number is identified under the [SCW_OptionalApplications] with the SCW_NumberOfApps entry. For example, if, before you modify it, the Scw.ini file contains the following lines

[SCW_OptionalApplications] 
SCW_NumberOfApps=6

then the identification number for your application will be 6. Your preinstallation program must increment this to the next greatest number (in this case, to 7) before it adds the information about your application.

Once it determines the available application number, your preinstallation program needs to add the following information to the [SCW_OptionalApplications] section of the Scw.ini file. Note you must append the number of your application to each key name (represented in the example below by x).

SCW_AppNamex=<application symbol name>

Internal name SCW uses to identify your application. Do not use spaces in the application symbol name. This value is required.

SCW_AppDisplayStringx=<message display name>

This is the string SCW displays in message boxes and log files. You can use spaces in the message display name. This value is required.

SCW_AppSelectedByDefaultx=[NO|YES]

If Yes, SCW will enable the check box to set up your application. If No, SCW will clear the check box. Either Yes or No is required.

SCW_AppRequiresUnattendedTextFilex=[NO|YES]

If Yes, your application requires a response file for unattended mode. (You must also provide the response file). If No, your application requires no response file. Either Yes or No is required.

SCW_AppTemplatePathx=<appTemplatePath>

Path and name of application's .inf file. This path must be relative to the %SBSServer%\SmallBusiness directory. The Template directory is the preferred location.

SCW_AppTemplateSourceNamex=<appTemplateSourceName>

Initial name of the unattend/response file template at the location specified in SCW_AppTemplatePathx.

SCW_AppTemplateDestNamex=<appTemplateDestName>

The name to which the SCW_AppTemplateSourceNamex file must be changed after it is installed.

SCW_AppSetupInfPathx=Template

Path to the .inf file that describes how to install your application (that is, the .inf file you created for preinstallation). This path must be relative to the %SBSServer%\SmallBusiness directory. The Template directory is the preferred location.

SCW_AppSetupInfSourceNamex=<appSetupInfSource>

This is the name of the INF file you created for preinstallation (not the INF file used by your application Setup program).

SCW_AppSetupInfDestNamex=<appSetupInfDest>

The name to which the SCW_AppSetupInfSourceNamex file must be changed after it is installed.

SCW_ArchitectureListx=[win95|i386]

If your application runs on Microsoft® Windows® 95 only, specify win95. If your application runs on both Windows 95 and Microsoft® Windows NT®, specify i386.

Example Scw.ini Modification

The following excerpt details how "Bob's Time Card Application" would be defined in the Scw.ini file [SCW_OptionalApplications] section.

[SCW_OptionalApplications]

; The value for SCW_NumberOfApps is available for the *next* application
SCW_NumberOfApps=6
;
;The following lines reflect the new fields that need to be created when
; adding an application to SCW. 

SCW_AppName5=BOB_TIMECARD
SCW_AppDisplayString5=Bob's Time Card Application
SCW_AppSelectedByDefault5=NO
SCW_AppRequiresUnattendedTextFile5=NO
;
;three unused options follow
SCW_AppTemplatePath5=
SCW_AppTemplateSourceName5=
SCW_AppTemplateDestName5=
;
SCW_AppSetupInfPath5=Template
SCW_AppSetupInfSourceName5=timecard.inf
SCW_AppSetupInfDestName5=timecard.inf
SCW_AppArchitectureList5=win95

SCW detects the end of your entry when it encounters the next SCW_AppNamex= entry.