DFcompiler

DFcompiler — Compile study-level edit check programs and output any warnings and/or errors encountered in the syntax.

Synopsis

DFcompiler [-o compiled_outputfilename] {-s #} {filename}

Description

DFcompiler is used for syntax checking of edit check files. It can be run in the study DFsetup tool or from the command-line.

In DFsetup, selecting Edit checks from Study and selecting the Check Syntax, button in the edit checks window, runs DFcompiler. Results are output to the bottom Outputs section of the edit checks window. A user requires permission to use DFsetup in order to run DFcompiler in this way.

DFcompiler may also be run from the command-line using the options described below. The study number and edit checks file name (with a correct pathname) are both required arguments.

DFexplore has the ability to compile and run edit checks. Edit checks can be compiled (to DFedits.bin) by selecting Publish in DFsetup or from the command line using DFcompiler as follows:

% DFcompiler -s study# -o DFedits.bin DFedits

Edit checks are loaded automatically when DFexplore starts but can be reloaded following a new compile from the File > Reload - Edit checks option.

Options

-s #

DFdiscover study number

-o DFedits.bin

the output executable file used to run production edit checks in DFexplore and DFbatch. If no output file name is specified, syntax checking is performed but no output file is created.

filename

the source file in which the edit check programs reside. Typically this will be $STUDY_DIR/ecsrc/DFedits containing the edit checks used by DFexplore and DFbatch

Exit Status

DFcompiler exits with one of the following statuses:

0

The command was successful.

1

The command is not supported by the user's current DFdiscover release.

2

The command failed because the database server could not be contacted, the study is not defined, the input file could not be located, or the server is out of memory.

Examples

Example 3.11.  Compile and check the syntax for edit checks defined in DFedits for study 254

% DFcompiler -s 254 /opt/studies/254/ecsrc/DFedits