DF_ICcenters

DF_ICcenters — Verify consistency of the sites database

Synopsis

DF_ICcenters {study} [-e|-w]

Description

DF_ICcenters checks the sites database for common errors and inconsistencies, reporting both errors (problems which will definitely impact the ability to communicate with the sites via DFdiscover) and warnings (problems which may impact communication).

DF_ICcenters should be used to detect errors after DFcenters has been defined but before study setup testing is complete. Ideally, DF_ICcenters will list no errors or warnings at the time data collection begins and thereafter.

If DFcenters is defined using the Sites view dialog in DFsetup, there are already some syntax checks in place that will detect inconsistencies such as out of range values. DF_ICcenters applies additional checks to the sites database that are not applied (or not known) in the Sites view editor. All site definitions that fail these checks are listed as the report output. Each failed check is categorized as either ERROR or WARNING. The ERROR categorization indicates a site definition that will definitely lead to problems in communication. A WARNING categorization indicates a site definition that may or may not lead to problems in communication, and hence should be investigated further.

When inconsistencies are detected by DF_ICcenters, each problem is identified with the beginning of the offending record in DFcenters followed by the ERROR or WARNING tag and a brief description of the problem. If multiple problems are detected within the same record, the offending record is only displayed once followed by a list of ERROR and/or WARNING problems. The exception to this is if problems are detected with the Subject ID entry. DF_ICcenters checks the Subject ID field separately from other fields in DFcenters. Hence it is possible for the offending record to appear more than once in the output if it has problems with both the Subject ID and other fields.

DF_ICcenters can be executed from the DFexplore Reports View, by using Verify available in the Sites view dialog in DFsetup, or by using File > Verify All also from DFsetup.

Errors

DF_ICcenters currently detects the following ERROR conditions:

  • Site ID which is not unique and appears in two or more records,
  • Records which have fewer than the required minimum of 11 fields,
  • Records in which the site ID is missing or blank,
  • The site ID is outside the legal range of 0 to 21460 inclusive,
  • Records in which the Contact Person is missing or blank, or is composed entirely of space/tab characters,
  • Records in which the Affiliation is missing or blank, or composed entirely of space/tab characters,
  • Records in which the Primary Fax field contains invalid characters, comma-delimited fax and/or email entries, and is composed entirely of space/tab characters,
  • A subject ID range in which the minimum endpoint is greater than the maximum endpoint,
  • A subject ID range which overlaps another subject ID range,
  • A subject ID range which includes out of range endpoints,
  • The Error Monitor is defined more than once,
  • The Error Monitor is not defined at all.

Warnings

DF_ICcenters currently checks for the following Warning conditions:

  • The Primary Fax field includes one or more email addresses but the Reply To field does not contain an email address.
  • Records which have no subject ID range(s) defined.

Options

-e

Report errors

-w

Report warnings