To run a production frequency, you will need to customize its behavior by creating a PFF file. You can then use the PFF file as a command line parameter in DOS or in a Windows icon for CSFreq.exe (the associated filename of this utility). For example, if you name your PFF MyFreq.pff, then you can run the Tabulate Frequencies program by invoking:
"C:\Program Files (x86)\CSPro 8.0\CSFreq.exe" MyFreq.pff
This assumes that CSPro was installed in the default directory. Your PFF file must have a .pff extension.
You can create a PFF file in one of two ways: either [1] create it yourself using a text editor (such as Notepad or Wordpad), or [2] have it generated automatically for you by launching CSFreq, making universe and field selections to your chosen dictionary,
saving your selections to a frequencies specification file, then running CSFreq. You can also manipulate PFF files in logic by using the
Pff object.
Please note that if you opt to let CSFreq generate the PFF for you automatically, the file shown in the example above will be named MyFreq.fqf.pff; in other words, .pff will be appended to the name of the frequencies specification file.
The following section shows the options available to you in a frequency PFF file. A PFF file is not case sensitive, so you can use any combination of upper and lower case text.
[Run Information]
Version=CSPro 8.0
AppType=Frequencies
[Files]
Application=.\MyFreq.fqf
InputData=.\Popstan Census.dat
Listing=.\MyFreq.lst
Freqs=.\MyFreq.tbw
[Parameters]
ViewListing=Always
ViewResults=Yes
Language=LN
The [Run Information] block is required and must appear exactly as shown in the example above.
The [Files] block is also required, and defines all files used in the frequency run. InputData is the data file on which the frequency will be performed. Listing indicates the name of the listing file that will be created. Freqs is the name of the tabulated frequencies file.
The [Parameters] block is optional. ViewListing determines whether the listing file is viewed. There are three options:
- ViewListing=Always means you will always see the generated listing file.
- ViewListing=Never means you will never see the generated listing file.
- ViewListing=OnError means you will see the generated listing file only if an error(s) occurred during the run.
If the ViewListing entry is missing, the default action will be OnError.
ViewResults determines whether the tabulated frequencies are displayed at the end of the run. The available choices are Yes or No. If the ViewResults entry is missing, the frequencies will be displayed by default.
Language specifies the language that is used when creating frequency tables.