Last updated 19 Nov 97
The MODCOL program provides an automated means of collapsing tasks referenced by one or more modules into a single module. The result of this process is a new Module Title file containing the collapsed set of task pointers. This new file may be used by PRTMOD to report task within module data where tasks have been removed from the modules which were collapsed.
In addition, MODCOL will create a new module factor which identifies the modules which had all tasks removed by MODCOL as empty modules (value = 0), and all other modules (those not affected by MODCOL and those receiving tasks from collapsed modules) as current modules (value = 1). This factor can be used in PRTMOD to suppress reporting of empty modules.
Automatic Process Generation
MODCOL generates and adds a TASKXX runstream for the output Module Title file if the "P" option is specified.

Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: P Print TASKXX listing of output module titles ssss: The study number MT1: Input Module Title file MT2: Output Module Title file MFf: Output Module Factor file receiving the mask vector
MODCOL Control Card
MODCOL: cc 01-06 The literal 'MODCOL' study: cc 08-11 The study number for this run title: cc 13-72 The title for the output Module title file and the output factor.
Collapse Cards
These cards determine which modules are collapsed. Any module number not referenced will not be changed. Invalid cards are ignored. References are cumulative, that is, once a module is collapsed into another, it will contain zero tasks. The receiving module will accumulate additional tasks with each reference.
These cards are not formatted. The commas and the dash are required and identify the location of each field (dash required only if a range of modules is specified).
imod: The module number to receive the collapsed modules irng1: The starting module number to be collapsed irng2: The ending module number to be collapsed title: The optional new title for module <imod>
These cards are terminated by an end-of-file or an '@eof' image.
@codap modcol - ssss mt000 mt001 mf100 modcol ssss Collapsed modules into 12 categories 1,1-11,Career field structure for 553x0 12,12-15,Use of publications 16,16-18,Safety-related functions 19,19-29,Surveying, fundamentals 30,30-39,Surveying, aircraft-related 40,40-50,Surveying, computations 51,51-89,Testing of construction materials 90,90-113,Drafting functions 114,114-117,Master planning 118,118-132,Civil engineering functions 133,133-161,Construction management 162,162-187,General contingency responsibilities @eof
A new Module Title file will be created. All tasks will be contained in the 12 specified modules, plus a tasks-not-referenced module. The unspecified modules will remain, but will have no tasks associated with them. The output membership factor created will have a value of 1.0 for the twelve specified modules plus any additional unreferenced modules. The other values will be 0.0.
@codap modcol p ssss mt000 mt002 mf100 modcol ssss 1,2-4 1,7 @eof
Module 1 will contain the tasks originally contained in modules 1-4 and 7. A TASKXX will be run on the output Module Title file mt002.