FACSET: Create Task Factor Set File

Last updated 18 Nov 97

FACSET creates a FACSET file containing up to 400 factors from up to five input files. These input files can be both Task Factor files and/or FACSET files.

Automatic Process Generation

FACSET 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 facset <opt> <ssss> <FS0> <FS1/TF1> [<FS2/TF2> ... [< FS5/TF5>]

opt: X    Do NOT print index of factors
ssss:     The study number 
FS0:      Output FACSET file
FS1/TF1:  Input FACSET or Task Factor file
FS2/TF2:  Input FACSET or Task Factor file
FS3/TF3:  Input FACSET or Task Factor file
FS4/TF4:  Input FACSET or Task Factor file
FS5/TF5:  Input FACSET or Task Factor file

FACSET Control Card


FACSET <study> <title>

FACSET:   cc 01-06  The literal 'FACSET'
study:    cc 08-11  The study number for this run
title:    cc 13-72  The title of the output FACSET file

Request Cards

There are two types of request cards, based on the type of input file specified. 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.

A. Task Factor File Input


<filref> <factor> <type> <title>

filref:   cc 01     The input file reference number (1-5)
factor:   cc 03-08  The input factor name
type:     cc 10-12  The input factor type (cannot be MBR)
title:    cc 14-73  Optional new title for this factor

B. FACSET 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 letter F).
-:        cc 07     The literal '-'
fac2:     cc 08-11  The ending factor ID (must begin with letter F).

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 facset - ssss fs003 tf200 tf500 fs000
FACSET ssss Title for new FACSET File
2 TF0001 SMN
3 TF0001 RMN
3 F002-F005
3 F008
@EOF

FACSET file fs003 will be created, using the factors 002-005 and 008 from FACSET file fs000. Factor TF0001/SMN on Task Factor file tf200 and factor TF0001/RMN on Task Factor file tf500 will also be added. The factors will be numbered based on the order encountered on the request cards. Upon completion of this run, a SETSXX run will be added using fs001 as its input file.

Back to document index