The
Define File Associations dialog box is presented when an
Entry application is executed. This page explains why certain files are asked of you. To find out more about the allowable
Source Type options and what can be chosen, see
Data Sources.
CSEntry requires a minimum of one file to run (an Input Data File), although the minimum number of files you will be solicited for in the Define File Associations dialog is two (you optionally have the choice of specifying a Paradata Log File). The basic run dialog is shown below:
CSEntry applications will require additional file definitions when one of the following situations occur:
- Lookup files are used.
- write functions or Freq statements functions are used.
- the impute function is used with the stat command, or set impute(on) is included.
- the Array declaration is present with the save option.
If all of these features were used, the expanded CSEntry run dialog would appear as shown below. Note the file associations listed in the Source Type column: those are the default file types expected for each file, though most all files allow more than one option to choose from. Also note that four of the data files provide default filenames, as explained further below.
The following describes the files that will be solicited from you in more detail, in the order (more-or-less) presented in the dialog box (depending on the options chosen), and why each is needed.
This is the file you will be creating, modifying, or verifying.
For each lookup file included in your application, you will be asked to supply the data file to which the lookup dictionary refers. The name displayed within the parenthesis is the unique (internal) dictionary name. For each lookup file attached to your application, a separate line entry will appear for you to specify the associated data file. If the file does not exist, it will be created.
You also have the option to specify
None for your lookup file. This can be useful if you know what lookup files you plan to use in your application, you have defined the dictionaries, but you do not yet have the data files themselves ready to use.
If your program makes one or more
write function calls,
CSEntry will ask you for the file to write them all to. This file will be a text file, regardless of the file extension used. If you fail to name a file, all
write function text will be written to the
listing file (if used).
If your program includes one or more
Freq statements,
CSEntry will ask you for the file to save these frequencies to. If you do not provide a file name, CSEntry will execute, but it will
not generate an error message about the expected file being missing. As seen in the expanded dialog above, the default file extension will be
.txt, though this can be changed by the user. Creating a CSPro table by using the
.tbw source type is a good second choice.
If your program includes one or more
impute function calls,
CSEntry will ask you for the file to save these imputations to. If you do not provide a file name, CSEntry will run on your data, but you will receive an error message about the expected file being missing. As seen in the expanded dialog above, the default file name with extension will be
<AppName>_impute_freq.lst, but both can be changed by the user.
If your program includes one or more
impute functions that use the
stat command, or if you include the
set impute(stat, on); in your program,
CSEntry will ask you for the name of a data file to save these imputation statistics to. As seen in the expanded dialog above, the default file name with extension will be
<AppName>_impute_stat.csdb, but both can be changed by the user.
If your program uses
Array objects, you can choose to save the array values between program runs with the optional keyword
save. When the save option is used,
CSEntry will prompt you for a filename. By default the file has the same name as the application, with an
.sva file extension. The leading portion of the file name can be changed, but the extension cannot.
Paradata log files contain information about
paradata events stored during an application's run. Files created using this type have the extension
.cslog and can be viewed using
Paradata Viewer.