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).