The master control file, CONTROL.SCR, specifies a FILELIST keyword which identifies the name of a file list control file that lists all the installable files in the installation package. The file list control file also contains the following additional information:
The following is an example of the file list control file (FILELIST.TK2) located in the \TOOLKIT\SAMPLES\MM\SHORTCF subdirectory. The first nonblank, noncomment line is a count of the number of files (or file name lines) in the file.
/***********************************************************************//* This file contains install information. Comments are delimited */
/* as these comments are. Blank lines are ignored. Non-blank lines */
/* will be parsed and extraneous characters will cause errors. First */
/* non-comment line must be the total number of files to be installed. */
/***********************************************************************/
/* all files on the install disk(s) are listed below. Other */
/* information is also given, as follows: */
/* */
/* Disk# - The number of the disk on which the file resides. */
/* (Ignored if installing from CD-ROM). These are sorted */
/* from 0 to the number of disks, ascending. */
/* */
/* Group# - The logical group to which the file belongs. Group */
/* starts at 0. */
/* */
/* Dest# - The destination subdirectory into which the file will be */
/* copied. Dest# starts at 0. */
/* */
/* Source #- The installation disk(s) subdirectory where the file */
/* resides. */
/* */
/* FileName - The base filename. */
/* */
/*sourcedir="\\" = 4 */
/*sourcedir="\\MCISTRNG\\" = 11 */
/* */
/* destindir="\\MMOS2\\" = 0 */
/* destindir="\\MMOS2\\INSTALL\\" = 4 */
/* destindir="\\MMOS2\\MMTOOLKT\\SAMPLES\\MCISTRNG\\" = 11 */
/* */
/* groups */
/* 0 = Base */
/* - 11 = MCI String Test */
/* */
/***********************************************************************/
/* Total number of entries is 20. This must be the first parameter other*/
/*than comments*/
/***********************************************************************/
20
/*It is a good practice to make groups and list the amount of files in
/*them (9 files)*/
/*A comment can not be the last line in a filelist.*/
/* mmtoolkt\samples\cf 9 41K */
0 0 11 4 "CONTROL.SCR"
0 0 11 4 "FILELIST.TK2"
0 0 11 4 "TLKSTRN.SCR"
0 0 11 4 "TLKBASE.SCR"
0 0 4 4 "TLKSTRN.SCR"
0 0 4 4 "TLKBASE.SCR"
0 0 4 4 "MCISTRNG.ICO"
0 0 4 4 "MMTOOLKT.ICO"
0 0 11 4 "TOOLKIT.CH"
/* 11 files */
/* mmtoolkt\samples\mcistrng 11 197K */
0 11 11 11 "mcistrng.c"
0 11 11 11 "mcistrng.h"
0 11 11 11 "mcistrng.rc"
0 11 11 11 "mcistrng.dlg"
0 11 11 11 "mcistrng.def"
0 11 11 11 "makefile"
0 11 11 11 "UMB.DAT"
0 11 11 11 "mcistrng.exe"
0 11 11 11 "mcistrng.hlp"
0 11 11 11 "mcistrng.ipf"
0 11 11 11 "mcistrng.ico"
The following table describes the columns in the file list control file.
旼컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커 쿎olumn 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 쿘edia# 쿞pecifies the number of the media unit (diskette � � 쿽r CD) where the file is stored. The units are � � 쿻umbered starting from 0. This number will be � � 퀅sed for all installation media except for the � � 쿴ard disk. The Media# column must be sorted in � � 쿪scending order. A media unit does not have to be� � 쿯illed (there can be unused space on any numbered � � 퀅nit). � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 쿒roup or subsystem# 쿞pecifies the group to which the file belongs. � � 쿟he group or item number must be a positive � � 쿶nteger, with numbering starting at 0 (the groups � � 쿪re defined in CONTROL.SCR by the SSGROUP � � 쿸eyword). This number is used to determine which � � 쿯iles belong to a item selected for installation. � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 쿏estination# 쿞pecifies the destination subdirectory where the � � 쿯ile will be copied. The destination number is � � 쿭efined in the CONTROL.SCR file by the DESTINDIR � � 쿸eyword. This field must always be a defined � � 쿻umber (for example, 14 for the \MMOS2\DLL path). � � 쿔f you specify a DESTINDIR statement in the master� � 쿬ontrol file, you only have to specify the � � 쿬orresponding group number (for example, 1). � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 쿞ource# 쿞pecifies the path name of the source file. The � � 퀂ource number is defined in the CONTROL.SCR file � � 쿫y the SOURCEDIR keyword. This field must always � � 쿫e defined with a number (for example, 1 for the � � �\LIB path). � 쳐컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 쿑ile name 쿞pecifies the base file name, which must be in � � 쿭ouble quotes. For example, "MINSTALL.EXE". � 읕컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸