2009-08-03
QPL Reference Manual

Warning! This page is in the process of being rewritten for QPL Version 6. It may still have references to QPL Version 5.

The QPL converter program, qpl_convert.exe, may be run from the console window or from one of the QPL tool bar buttons in HomeSite. You must use command line options to tell it what to do. These options are listed below.

Usage

QPL_CONVERT filename[.QPL] [filename2.[QPL|DAT]] [modifying option...]
           [data file option...] [program option...] [report option...]

Data File Options

  /atx  askSam import file
  /dat  Translate .dat file to filename2.qpl layout
  /dat0 Copy .dat file records to filename2.dat
  /prn  Tab delimited file
  /prn0 Comma delimited file

Program Options

  /htm  HTML files for local testing
  /php  PHP files for server deployment
  /sas  SAS system file
  /spc  SPSS/PC+ system file
  /sps  SPSS for Windows system file
  /spx  SPSS-x system file

Report Options

  /txt  Text version of questionnaire
  /xrf  Cross-reference listing

Modifying Options

                               ------------ Modifies -------------
                               atx dat inc htm prn sas sp? txt xrf
 /a Define date formats                 x           x   x
 /c # Content analysis tags (def. 256)      x
 /d Descriptive statistics              x           x   x
 /dre "equation"   Drop recs    x   x           x
 /drs var "string" Drop recs    x   x           x
 /dv var [var...]  Drop cols    x       x       x   x   x
 /e [url]  Email job.htm                    x
 /f Frequency statistics                x           x   x
 /g # Left margin (default 5 chars)                         x
 /h # Page height (default 60 rows)                         x
 /kre "equation"   Keep recs    x   x           x
 /krs var "string" Keep recs    x   x           x
 /kv var [var...]  Keep cols    x       x       x   x   x
 /l List long strings                   x           x   x
 /m Set missing to -1                           x
 /menu No menu frame                        x 
 /n Number variable labels                          x   x
 /nav No navigation frame                   x
 /p No page break                                           x
 /r No record location info                                 x
 /s Truncate long strings                           x   x
 /sv Include system variables                       x   x
 /u Include user name with comments     x
 /v Include variable names              x   x   x           x
 /vt List VOid question text            x 
 /w # Page width (default 65 chars)                         x
 /132 Produce wide reports                          x   x       x
 /? Help (this screen)

Notes: Type the options in the order indicated (all options are implemented from left to right). Do not type the brackets. They only indicate optional information. The '#' indicates where a number should be used. The word 'var' indicates where a variable name should be typed. You must put at least one space between each option.

The number of content analysis tags must be a multiple of 32. A maximum of 3,200 tags may be specified when building a project (ex., /c 3200). A default of 256 tags will be used if no option is used.

Using Modifying Options in HomeSite

If you are using HomeSite to build your questionnaire, the tool bar buttons already specify the Program or Report options. But you may add Modifying options to the "CONVERT Options:," comment line. This comment line will be located near the top of your if you used the the "Create new project" to start your program.

** CONVERT Options: /d /f /l /v /u

This example shows the standard conversion options that are inserted when you first create a new program. The first three options affect how the converter will create the on-line tabulation report and SPSS and SAS programs. The /d option tells it to include descriptive statistics for NUMBER questions, the /f option tells it to include frequency statistics for MULT and CHECK questions, and the /l option tells it to list the responses to STRING and OPENEND question.

The /v option tells it to include the question variable names on the local test version of the questionnaire HTML file.

The /u option tells it to include each respondent's user name with their responses to STRING and OPENEND questions in the on-line tabulation report.

You may also use the CONVERT Options button to create a new CONVERT Options line. It opens a dialog box that lists the more commonly used options. Check the options you want on this dialog and then click on the OK button to insert a new CONVERT Options line into your program. You should only have one CONVERT Options line in your program and it should be placed with the comment lines at the top your program.