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

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