CONTROL.SCR Header

The header section of the CONTROL.SCR file contains the following information:

Name of the installation package
Code page used when creating the file
Name of the file list control file
Number of subsystems in the installation package
Number of media units required for installation
Names of the media units required for installation
Source and destination directory names (optional)

The following is an example of the CONTROL.SCR header located in the \TOOLKIT\SAMPLES\MM\CF subdirectory.

/*  control.scr */
package   ="IBM Multimedia Presentation Manager Toolkit/2"
codepage  =437
filelist  ="filelist.tlk"
groupcount=12
munitcount=6

medianame="IBM Multimedia Presentation Manager Toolkit/2 Installation
Diskette 1"
medianame="IBM Multimedia Presentation Manager Toolkit/2 Installation
Diskette 2"
.
.
.

sourcedir="\\"                     = 0
sourcedir="\\lib\\"                = 1
.
.
.

destindir="\\mmos2\\"                                = 0
destindir="\\mmos2\\mmtoolkt\\lib\\"                 = 1
.
.
.

The following table describes the keywords used in the CONTROL.SCR header.

кФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
ГKeyword        ГDescription                                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГPACKAGE        ГThis required keyword specifies the name of  Г
Г               Гthe installation package in the form of a    Г
Г               Гquoted string.  For example:                 Г
Г               ГPACKAGE="IBM Multimedia Presentation Manager Г
Г               ГToolkit/2"                                   Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГCODEPAGE       ГThis required keyword specifies the code pageГ
Г               Гthat the file was created under.  For        Г
Г               Гexample:                                     Г
Г               ГCODEPAGE = 437                               Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГFILELIST       ГThis required keyword specifies the name of  Г
Г               Гthe file list control file. This control fileГ
Г               Гcontains a list of files that make up each   Г
Г               Гfeature, identifies on which media units theyГ
Г               Гreside in the installation package, and      Г
Г               Гspecifies the destination to which they will Г
Г               Гbe copied.  For example:                     Г
Г               ГFILELIST = "FILELIST.TLK"                    Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГGROUPCOUNT     ГThis required keyword specifies the number ofГ
Г               Гsubsystems in the installation package.  All Г
Г               Гgroups are counted, including group 0 (if    Г
Г               Гpresent).  For example:                      Г
Г               ГGROUPCOUNT = 10                              Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMUNITCOUNT     ГThis required keyword specifies the number ofГ
Г               Гmedia units (diskettes, CDs) that will be    Г
Г               Гused if all subsystems are installed.  This  Г
Г               Гnumber must be greater than 0.  This is the  Г
Г               Гnumber of diskettes or CDs on which the      Г
Г               Гinstallation package resides.  For example:  Г
Г               ГMUNITCOUNT = 6                               Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMEDIANAME      ГThis required keyword specifies a unique     Г
Г               Гmedia name, which is a character string on   Г
Г               Гthe diskette or CD label.  For each media    Г
Г               Гunit, this keyword must be repeated once, in Г
Г               Гthe form of a quoted string.  This           Г
Г               Гinformation is used during installation to   Г
Г               Гprompt the user to insert a diskette or CD   Г
Г               Гwhen needed.  For example:                   Г
Г               ГMEDIANAME = "IBM Multimedia Presentation     Г
Г               ГManager Toolkit/2              Installation  Г
Г               ГDiskette 1"                                  Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГSOURCEDIR      ГThis optional keyword specifies the name of aГ
Г               Гsource directory and its associated number.  Г
Г               ГThis keyword can be repeated and is specifiedГ
Г               Гby a quoted string followed by an equal sign Г
Г               Г(=) and a number.  The number is used to     Г
Г               Гidentify the particular directory in later   Г
Г               Гscripts.  This can be NULL, in which case twoГ
Г               Гdefault backslash characters (\\) are used   Г
Г               Гwith an encoding of 0.  The path must be     Г
Г               Гsurrounded by path separators.  For example: Г
Г               ГSOURCEDIR="\\LIB\\" = 1                      Г
УФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГDESTINDIR      ГThis optional keyword specifies the name of aГ
Г               Гdestination directory and its associated     Г
Г               Гnumber.  This keyword can be repeated and is Г
Г               Гspecified by a quoted string followed by an  Г
Г               Гequal sign (=) and a number.  The number is  Г
Г               Гused to identify the particular directory in Г
Г               Гlater scripts.  This can be NULL, in which   Г
Г               Гcase two default backslash characters (\\)   Г
Г               Гare used with an encoding of 0.  The path    Г
Г               Гmust be surrounded by path separators (\\).  Г
Г               ГFor example: For example:                    Г
Г               ГDESTINDIR = "\\MMOS2\\" = 0                  Г
РФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

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

You must place the keywords MUNITCOUNT and MEDIANAME so that MUNITCOUNT comes directly before MEDIANAME. The order of the other keywords is not significant.
Each destination directory (DESTINDIR) must have a unique number.
A subsystem group can be spread across several media units. It does not have to reside on one media unit.
You can define any directory. MINSTALL will create any subdirectories defined with the DESTINDIR keyword that do not exist.
If you move the installation package files to media of a different size, the number of media units (MEDIACOUNT) may change.
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]