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 features 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\SHORTCF subdirectory.

package="IBM Multimedia Presentation Manager Toolkit/2"codepage=437
filelist="filelist.tk2"
groupcount=2
munitcount=1
medianame="IBM Multimedia Presentation Manager Toolkit/2 Installation
          Diskette 1"

sourcedir = "\\"                               = 4
sourcedir = "\\MCISTRNG\\"                     = 11

destindir = "\\MMOS2\\"                                = 0
destindir = "\\MMOS2\\INSTALL\\"                       = 4
destindir = "\\MMOS2\\MMTOOLKT\\SAMPLES\\MCISTRNG\\"   = 11

A larger and more complex example of installing multiple items using MINSTALL is located in the \TOOLKIT\SAMPLES\MM\CF subdirectory.

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 subsystem, 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.TK2"                   Г
УФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г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 = 2                              Г
УФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMUNITCOUNT      ГThis required keyword specifies the number  Г
Г                Гof media units (diskettes, CDs) that will beГ
Г                Гused if all features 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 = 1                              Г
УФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г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         Г
Г                Гdestination directory and its encodings.    Г
Г                ГThis keyword can be repeated and can be     Г
Г                ГNULL, in which case the default is the      Г
Г                Г\MMOS2 subdirectory.  The path must be      Г
Г                Гsurrounded by path separators and any       Г
Г                Гdirectory that does not exist will be       Г
Г                Гcreated. 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.
The 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.
A subsystem 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) might 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]