MODCOL: Collapse and Combine Modules

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.


@codap modcol <opt> <ssss> <MT1> <MT2> <MFf>

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 <study> [<title>]

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.


<imod>,<irng1>[-<irng2>][,<title>]

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.

Examples

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

Back to document index