REFFAC: Create Number of References Task Factors

Last updated 19 Nov 97

REFFAC will create a task factor based on the number of times a task is referenced by the modules in a specified MFILE. The tasks-not-referenced modules are not included in this count. The output REFFAC factor will be called TFxxxx/REF where xxxx is the next available task factor sequence number. Optionally, REFFAC will create factors containing the module references for each task. The maximum number of times a task is referenced determines how many factors will be created. For example, if the /REF factor has a maximum value of 11, 11 module reference factors will be created. Also, if a module factor is specified to sort on, the order of the module references will be determined by the values in this factor. Otherwise, the modules are output on a first reference basis. These factors will be called TFxxxx/MOD.

Program Invocation

The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.


@codap reffac <opt> <ssss> <MT> <TFf> [<MFf>]

opt:  E   Explode the task references into actual modules.
      P   Print task-to-module references report. If the module titles
	  contain outline paragraph references, REFFAC will print these
	  for each module.  Otherwise only module numbers will be printed.
	  Only valid when used with the 'E' option.
      X   Exclude all tasks not referenced in the task-to-module references
	  report.  Only valid when used with the 'E' and 'P' options.
ssss:     The study number
MT:       Input Module Title file
TFf:      Output Task Factor file
MFf:      Input Module Factor file, only needed for sorting

REFFAC Control Card


REFFAC <study> <title>

REFFAC:  cc 01-06  The literal 'REFFAC'
study:   cc 08-11  The study number for this run
title:   cc 13-72  The report title for this run.

SORT Control Card (optional)

This card is used only if the 'E' option is used and the order of the module references are to be determined by the values in a module factor.


SORT <mfac>/<type> <seq>

SORT:    cc 01-04  The literal 'SORT'.
mfac:    cc 06-11  The name of the input module factor.
type:    cc 13-15  The type of the module factor.
seq:     cc 17-17  The sort sequence. A=Ascending, D=Descending(default)

Examples

@codap reffac - ssss mt000 tf100
REFFAC ssss Title for the REFFAC report

A number of references task factor will be created based on the pointers in the input Module Title file.

@codap reffac - ssss mt000 tf100 mf100
REFFAC ssss Title for the REFFAC report
SORT MF0001/FAC A

A number of references task factor will be created based on the pointers in the input Module Title file. Also, all modules for each task will be created in output factors. A task to module references report will also be created.

Back to document index