CONTROL.SCR Subsystem Definition

The subsystem definition section of the CONTROL.SCR file follows the header section and contains the definitions for all the installable items in the installation package. A block of information must be included for each subsystem.

The subsystem definition section contains the following information:

The group or item number
The item name
The version of the item
The size of all the files for the item installation
The names of the control files that change the MMPM2.INI and CONFIG.SYS files
The names of installation DLL files and entry points

The following is an example of a CONTROL.SCR subsystem definition.

ssgroup=0              /*  base group */sssize=41
ssname="mmbase"
ssversion="1.0.9"
ssinich="TLKBASE.SCR"

/*           - 11 = mcistrng */
ssgroup=11
ssname="Media Control Interface String Test"
ssversion="1.0.9"
sssize=200
ssinich="TLKSTRN.SCR"
ssicon="mcistrng.ico"

The CONTROL.SCR subsystem definition consists of the following keywords.

кФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
ГKeyword             ГDescription                             Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSGROUP             ГThis required keyword specifies the     Г
Г                    Гgroup or item number.  This marks the   Г
Г                    Гbeginning of a group for this item and  Г
Г                    Гassigns it a number. Each item must haveГ
Г                    Гa unique number from 0-49 within the    Г
Г                    Гpackage; however, the same number can beГ
Г                    Гused with different installation        Г
Г                    Гpackages.  The groups are displayed in  Г
Г                    Гthe installation main selection window  Г
Г                    Гin ascending order by group number.  ForГ
Г                    Гexample:                                Г
Г                    ГSSGROUP = 11                            Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSNAME              ГThis required keyword specifies the itemГ
Г                    Гname, which names the current group as  Г
Г                    Гan ASCII string.  This keyword is case  Г
Г                    Гsensitive and takes the form of a quotedГ
Г                    Гstring.  The name may include special   Г
Г                    Гcharacters and may be translated.  The  Г
Г                    Гname is displayed in the main           Г
Г                    Гinstallation selection window.  For     Г
Г                    Гexample:                                Г
Г                    ГSSNAME = "CD Audio"                     Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSVERSION           ГThis required keyword specifies the     Г
Г                    Гversion of the component in the form of Г
Г                    Гa quoted string.  This string must be inГ
Г                    Гthe format "dd.dd.dd" (where dd         Г
Г                    Гrepresents digits).  Any version not    Г
Г                    Гspecified in this format will be        Г
Г                    Гconverted to that format.  All string   Г
Г                    Гitems that are not digits or periods    Г
Г                    Гwill be converted to zeros. Any periods Г
Г                    Гafter the second period will be         Г
Г                    Гconverted to zeros.  For example:       Г
Г                    ГSSVERSION = "1.1.0"                     Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSSIZE              ГThis required keyword specifies the     Г
Г                    Гtotal size of all the files in the item.Г
Г                    ГThe size denotes the number of bytes in Г
Г                    Гthousands (500 = 500KB).  This number isГ
Г                    Гused to help determine if there is      Г
Г                    Гenough disk space to support the        Г
Г                    Гinstallation.  If you do not know the   Г
Г                    Гcorrect size of a item, overstate its   Г
Г                    Гsize.  For example:                     Г
Г                    ГSSSIZE = 1024                           Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSINICH             ГThis optional keyword specifies the nameГ
Г                    Гof the file that contains the changes toГ
Г                    Гthe MMPM2.INI file.  If this statement  Г
Г                    Гis missing, there are no changes to the Г
Г                    ГMMPM2.INI file.  For example:           Г
Г                    ГSSINICH = "ACPAINI.CH"                  Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSCONFIGCH          ГThis optional keyword specifies the nameГ
Г                    Гof the file that contains the changes toГ
Г                    Гthe CONFIG.SYS file.  If this statement Г
Г                    Гis missing, there are no changes to the Г
Г                    ГCONFIG.SYS file.  For example:          Г
Г                    ГSSCONFIGCH = "ACPACON.CH"               Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSCOREQS            ГThis optional keyword specifies a list  Г
Г                    Гof corequisites needed for this item to Г
Г                    Гrun.  It also specifies what other      Г
Г                    Гcomponents the current components dependГ
Г                    Гon.  These other components must be     Г
Г                    Гinstalled for the current component to  Г
Г                    Гfunction.  (If this statement is        Г
Г                    Гmissing, there are no corequisites.)    Г
Г                    ГThe corequisite is identified by its    Г
Г                    Гgroup number. Corequisite groups should Г
Г                    Гpoint to each other only if they requireГ
Г                    Гeach other.  It is possible to have     Г
Г                    Гsubsystem A list subsystem B as a       Г
Г                    Гcorequisite and subsystem B have no     Г
Г                    Гcorequisites.  If the user selects a    Г
Г                    Гsubsystem with a corequisite, but does  Г
Г                    Гnot select all corequisites, the user isГ
Г                    Гnotified before the installation starts.Г
Г                    ГThis entry can be repeated as necessary.Г
Г                    ГFor example:                            Г
Г                    ГSSCOREQS = 1                            Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSICON              ГThis optional keyword names the icon    Г
Г                    Гfile for this component that is to be   Г
Г                    Гdisplayed in the main installation      Г
Г                    Гselection window.  The icon file to be  Г
Г                    Гdisplayed in the selection window must  Г
Г                    Гreside on the first installation media  Г
Г                    Гunit.  If this statement is missing, a  Г
Г                    Гdefault icon is used.  For example:     Г
Г                    ГSSICON = "ACPA.ICO"                     Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSDLL               ГThis optional keyword names a DLL file  Г
Г                    Гthat is to be run during the            Г
Г                    Гinstallation process.  The DLL          Г
Г                    Гreferenced will be run after all files  Г
Г                    Гare copied to the destination, but      Г
Г                    Гbefore any script processing is         Г
Г                    Гperformed. If this keyword is present,  Г
Г                    Гthe SSDLLENTRY keyword must also be     Г
Г                    Гpresent.  For example:                  Г
Г                    ГSSDLL="MY.DLL"                          Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSDLLENTRY          ГThis optional keyword specifies the nameГ
Г                    Гof the entry point into SSDLL in the    Г
Г                    Гform of a quoted string.  If this       Г
Г                    Гkeyword is present, the SSDLL keyword   Г
Г                    Гmust also be present.  For example:     Г
Г                    ГSSDLLENTRY="MyEntry"                    Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSTERMDLL           ГThis optional keyword names a DLL file  Г
Г                    Гthat is to be run during the            Г
Г                    Гinstallation process.  The DLL          Г
Г                    Гreferenced will be run after all files  Г
Г                    Гare copied to the destination and after Г
Г                    Гall script processing is done. The      Г
Г                    Гpurpose of this keyword is to allow for Г
Г                    Гprocessing to occur on a fully          Г
Г                    Гconfigured multimedia system.  If this  Г
Г                    Гkeyword is present, the SSTERMDLLENTRY  Г
Г                    Гkeyword must also be present.  For      Г
Г                    Гexample:                                Г
Г                    ГSSTERMDLL="MYTERM.DLL"                  Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSTERMDLLENTRY      ГThis optional keyword specifies the nameГ
Г                    Гof the entry point into SSTERMDLL in theГ
Г                    Гform of a quoted string.  If this       Г
Г                    Гkeyword is present, the SSTERMDLL       Г
Г                    Гkeyword must also be present.  For      Г
Г                    Гexample:                                Г
Г                    ГSSTERMDLLENTRY="MyTermEntry"            Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSSSELECT            ГThis optional keyword determines the    Г
Г                    Гpreselection of items for installation. Г
Г                    ГFive values are supported:              Г
Г                    Г"ALWAYS" - This value specifies that theГ
Г                    Гgroup will always be installed.  It is  Г
Г                    Гthe only valid value for Group 0.       Г
Г                    ГGroups with this value will not be      Г
Г                    Гdisplayed in the installation selection Г
Г                    Гwindow.  This is the default.           Г
Г                    Г"REQUIRED" - This value specifies that  Г
Г                    Гthe group will be preselected for       Г
Г                    Гinstallation.  If the group had been    Г
Г                    Гpreviously installed, it cannot be      Г
Г                    Гunselected by the user if this          Г
Г                    Гinstallation package is newer than the  Г
Г                    Гinstalled version.  If the group has notГ
Г                    Гbeen previously installed, it can be    Г
Г                    Гunselected by the user.                 Г
Г                    Г"VERSION" - This value specifies that   Г
Г                    Гthe group will be preselected only if itГ
Г                    Гwas previously installed and this       Г
Г                    Гinstallation package is newer than the  Г
Г                    Гinstalled version.  However, it can be  Г
Г                    Гunselected by the user.                 Г
Г                    Г"YES" - This value specifies that the   Г
Г                    Гgroup will be preselected whether or notГ
Г                    Гit was previously installed.  It can be Г
Г                    Гunselected by the user.                 Г
Г                    Г"NO" - This value specifies that the    Г
Г                    Гgroup is never preselected but can be   Г
Г                    Гselected by the user.                   Г
Г                    Г"BASENEWER" - This value specifies that Г
Г                    Гfiles belonging to this group will only Г
Г                    Гbe copied if the user's machine has no  Г
Г                    Гpackage installed or if the package     Г
Г                    Гinstalled is older than the current     Г
Г                    Гpackage.                                Г
Г                    Г"ONLYNEWER" - This value specifies that Г
Г                    Гa user will not be able to to install anГ
Г                    Гolder version of a package on top of a  Г
Г                    Гnewer version. Files belonging to this  Г
Г                    Гgroup will only be copied if the user   Г
Г                    Гhas an older version (or the same       Г
Г                    Гversion) installed.  If no version is   Г
Г                    Гinstalled or if the version installed isГ
Г                    Гhigher than the one in the package, no  Г
Г                    Гfiles will be copied.                   Г
РФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Observe the following guidelines when you create or change a CONTROL.SCR subsystem definition:

The SSGROUP keyword must be the first statement in the information block.
An item may reside on different media.
Each statement in the information block must have a value.
You may use comments in the header section in the form of blank lines or text enclosed with "/* and */". You may not use nested comments.
You may use blank spaces around the equal sign; blank spaces are ignored.
If you want to use a double quotation mark or a backslash in a string, you must precede it with the escape character (\).
You may use the escape sequence \n (new line).

[Back] [Next]