FACEXT: Create Text File from FACSET File Factors

Last updated 18 Nov 97

FACEXT takes requested factors from a FACSET or MODSET file and creates a text file and a symbolic layout. Factors are extracted and placed on the file in the order requested so that factors can be rearranged from their original format.

Program Invocation

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


@codap facext <opt> <ssss> <FS> <FE> <CI(layout)>

opt:      Program Options (none currently supported)
ssss:     The study number 
FS:       Input FACSET/MODSET file
FE:       Output Factor Extract file
CI:       Output layout file

FACEXT Control Card


FACEXT <study> <title>

literal:  cc 01-06  "FACEXT" required.
study:    cc 08-11  The study number for this run
title:    cc 13-72  Title for this run.  This will appear on the title
                    card in the generated layout.

Factor Request Cards


FAC <fac1> <d1> <fac2>...<fac14> <d14> <fac15>

FAC:      cc 01-03  The literal 'FAC'
fac1:     cc 05-08  The next factor to extract
d1:       cc 09     The literal '-' or blank
fac2:     cc 10-13  The next factor to extract
d2:       cc 14     The literal '-' or blank
fac3:     cc 15-18  The next factor to extract
d3:       cc 19     The literal '-' or blank
fac4:     cc 20-23  The next factor to extract
d4:       cc 24     The literal '-' or blank
fac5:     cc 25-28  The next factor to extract
d5:       cc 29     The literal '-' or blank
fac6:     cc 30-33  The next factor to extract
d6:       cc 34     The literal '-' or blank
fac7:     cc 35-38  The next factor to extract
d7:       cc 39     The literal '-' or blank
fac8:     cc 40-43  The next factor to extract
d8:       cc 44     The literal '-' or blank
fac9:     cc 45-48  The next factor to extract
d9:       cc 49     The literal '-' or blank
fac10:    cc 50-53  The next factor to extract
d10:      cc 54     The literal '-' or blank
fac11:    cc 55-58  The next factor to extract
d11:      cc 59     The literal '-' or blank
fac12:    cc 60-63  The next factor to extract
d12:      cc 64     The literal '-' or blank
fac13:    cc 65-68  The next factor to extract
d13:      cc 69     The literal '-' or blank
fac14:    cc 70-73  The next factor to extract
d14:      cc 74     The literal '-' or blank
fac15:    cc 75-78  The next factor to extract

FACEXT will use these request cards in the order specified. When a range of factors is requested, fac1 may be greater than fac2 in which case FACEXT will process the factors reversed. FACEXT will compute the number of characters needed to represent this factor and create the proper layout field. The highest factor number allowed is 400 and this is also the limit on the number of factor requests.

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

Example

@codap facext - ssss fs000 fe000 fe000.layout
FACEXT ssss Layout for factors extracted from FS000.
FAC 0001-0008 0013-0011 0015
@EOF

This will create the text file 'fe000' and the layout 'fe000.layout' using factors 1-8, 13, 12, 11, and 15.

Back to document index