Last updated 19 Nov 97
MODFAC will accept any task factor requested and produce a module factor after performing computations utilizing the factor values for the tasks within each module.
Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: N Nogo run, check control cards for errors ssss: The study number TFf: Input Task Factor file MT: Input Module Title file MFf: Output Module Factor file
MODFAC Control Card
MODFAC: cc 01-06 The literal 'MODFAC' study: cc 08-11 The study number for this run title: cc 13-72 The report title (optional). If blank, a standard title will be used.
Module Factor Requests
These cards control the performance of operations on the set of tasks. Tasks may be sorted within module, selected or deleted based on some particular value, or summarized into a value for each module, depending on the specific instruction given. There is no limit on the number of cards this section may contain. It is important to note that different card sequences may cause differing results.
If at any time a new sequence of cards is to be used, the RESET card will reinitialize the list of tasks to the full job inventory. The SELECT and SORT cards can be used in combination to cause the current task set to be reduced. The result of using a SELECT card is cumulative. Once a task has been removed from the current task set it cannot be restored to the task set by any means other than a RESET card.
The COMPUTE card causes a new module factor to be generated and written on the Module Factor file. Many COMPUTE cards may be desired after the task list has been reduced sufficiently to produce module factors based on an identical task list but differing in the computed result or input values used for the computation.
RESET Card
This card reinitializes the task list to include all tasks in the inventory.
RESET: cc 01-03 The literal 'RES'
SORT Card
This card sorts the current task list into sequence based on the values of the specified task factor.
SORT: cc 01-04 The literal 'SORT' factor: cc 06-11 The task factor to be used for sorting type: cc 13-15 The type of factor to be used. seq: cc 17 The sort sequence desired. A = Ascending, D = Descending (default)
SELECT Card
This card causes any tasks which have values that meet the specified condition to remain part of the task set. Values which do not meet the condition cause the corresponding task to be removed from the current task set.
SELECT: cc 01-06 The literal 'SELECT' factor: cc 08-13 The task factor to be used in comparisons type: cc 15-17 The type of factor to be used function: cc 19-21 The function to use to determine the value for each task which will be used in the comparison. VAL - use the task value directly NUM - use the sequence number of the task SUM - use the cumulative sum of the tasks cond: cc 23-24 The logical condition to use for the comparison value: cc 26-37 The value to be compared against
COMPUTE Card
This card causes a new module factor to be added to the output Module Factor file. The new factor will be computed using the current task list and the function specified on the card. The requested function will be performed utilizing the task factor information. If the NUM function is used, a task factor need not be specified. If one is specified it will not be used for the NUM function. Additionally, a minimum and maximum acceptable value for each module factor result may be specified. If the result for a module falls outside of this range, the value for the module will be set to invalid. If this feature is not used, all values computed will be accepted.
COMPUTE: cc 01-07 The literal 'COMPUTE' factor: cc 09-14 The task factor to be used in computations (e.g. GP0001). Leave blank when using the NUM function. type: cc 16-18 The type of factor to be used. function: cc 20-22 The function to be used to determine the resulting value for each module: NUM- number of tasks within the module SUM- sum of the task values within each module AVG- mean value of the tasks within each module RMS- standard deviation of the task values within each module (root mean squared) MIN- the minimum task value for each module MAX- the maximum task value for each module min: cc 24-35 The minimum acceptable value for output max: cc 37-48 The maximum acceptable value for output
TITLE Card
This card gives a title to the output module factor.
TITLE: cc 01-05 The literal 'TITLE' title: cc 07-66 The title for the output module factor
These cards are terminated by an end-of-file or an '@eof' image.
@codap modfac - ssss tf100 mt000 mf000 MODFAC ssss This is the title for the very first module summarization COMPUTE TF0001/RMN NUM TITLE This vector is the number of tasks in each module COMPUTE TF0001/RMN SUM TITLE This vector is the sum of the task values COMPUTE TF0001/RMN MIN TITLE This vector is the minimum of the task values COMPUTE TF0001/RMN MAX TITLE This vector is the maximum of the task values COMPUTE TF0001/RMN AVG TITLE This vector is the mean of the task values COMPUTE TF0001/RMN RMS TITLE This vector is the S.D. of the task values @eof
The six standard module factors will be created on output Module Factor file mf000.