MODSET: Create Module Factor Set File

Last updated 19 Nov 97

MODSET creates a MODSET file containing up to 400 factors from up to five input files. The input files can be both Module Factor files and/or MODSET files.

Automatic Process Generation

MODSET will generate a SETSXX runstream. This runstream will be added unless the X option is specified on the processor call card.

Program Invocation

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


@codap modset <opt> <ssss> <MS0> <MS1/MFf1> [<MS2/MFf2> ... [<MS5/MFf5>]]

opt:    X  Do NOT print index of factors
ssss:      The study number
MS0:       Output MODSET file
MS1/MFf1:  Input MODSET or Module Factor file
MS2/MFf2:  Input MODSET or Module Factor file
MS3/MFf3:  Input MODSET or Module Factor file
MS4/MFf4:  Input MODSET or Module Factor file
MS5/MFf5:  Input MODSET or Module Factor file

MODSET Control Card


MODSET <study> <mod-id> <title>

MODSET:  cc 01-06  The literal 'MODSET'
study:   cc 08-11  The study number for this run
mod-id:  cc 13-18  The module set ID
title:   cc 20-79  The title for the output MODSET file

Request Cards

There are two types of request cards based on the type of input file. These cards should be submitted in the order in which the factors are desired on the output file. This file is limited to 400 factors. The cards described below may be used in any combination, provided the limit is not exceeded.

Module Factor File Input


<filref> <factor> <type>

filref:  cc 01     The input file reference number (1-5)
factor:  cc 03-08  The input vector name
type:    cc 10-12  The input vector type

MODSET File Input


<filref> <fac1> [- <fac2>]

filref:  cc 01     The input file reference number (1-5)
fac1:    cc 03-06  The starting factor ID (must begin with the letter M)
-:       cc 07     The literal '-'
fac2:    cc 08-11  The ending factor ID (must begin with the letter M)

All factors between the starting and ending factors will be included. If only the starting factor is specified, or the ending factor value is less than the starting factor value, then only the starting factor will be collected.

These cards are terminated by an end-of-file or an '@eof' image.

Example

@codap modset - ssss ms001 mf000 mf001 ms000
MODSET ssss STS001 Title for new MODSET file
1 MF0001 NUM
1 MF0002 SUM
3 M002-M005
2 MF0001 NUM
1 MF0003 MIN
3 M008
@eof

MODSET file ms001 will be created, using the factors 002-005 and 008 from MODSET file ms000. Factors from mf000 will be MF0001/NUM, MF0002/SUM, and MF0003/MIN. The module factor MF0001/NUM will be obtained from Module Factor file mf001. The factors will be numbered based on the order encountered on the request cards. Upon completion of this program, SETSXX will run using ms001 as its input file.

Back to document index