Utilizing the CanQues Hosting Service
[Small SEER Logo] [CanQues Title]

Utilizing the CanQues Hosting Service

Questions or comments to: canques@imsweb.com

      Name                    Last modified       Size  Description

[DIR] Parent Directory 28-Aug-2004 09:56 - [DIR] CSS/ 30-Aug-2004 05:04 - [DIR] Chart/ 13-Jan-2009 19:52 - [DIR] Help/ 30-Aug-2004 05:04 - [DIR] Images/ 13-Jul-2006 08:05 - [DIR] PopUp/ 30-Aug-2004 05:04 - [DIR] delay2002/ 12-Apr-2005 10:24 - [DIR] delay2005/ 15-Apr-2008 12:36 - [DIR] devcan2001/ 30-Aug-2004 05:04 - [DIR] devcan2002/ 12-Apr-2005 10:43 - [DIR] devcan2005/ 15-Apr-2008 12:33 - [DIR] example/ 30-Aug-2004 05:04 - [DIR] mpmono/ 30-Aug-2004 05:04 - [DIR] npcr/ 30-Aug-2004 05:04 - [DIR] ontario/ 02-May-2005 14:12 - [DIR] oup/ 30-Aug-2004 05:04 - [DIR] oup2/ 17-Sep-2004 04:36 - [DIR] prev2001/ 30-Aug-2004 05:04 - [DIR] prev2002/ 12-Apr-2005 07:02 - [DIR] prev2003_nci/ 14-Jul-2006 09:25 - [DIR] prev2004/ 18-May-2007 13:02 - [DIR] prev2004_nci/ 19-Apr-2007 13:54 - [DIR] prev2005/ 15-Apr-2008 12:34 - [DIR] prev2005_nci/ 15-Apr-2008 12:36 - [DIR] seer2004/ 18-May-2007 08:49 - [DIR] seer2005/ 25-Aug-2008 11:22 - [DIR] surv2004/ 18-May-2007 07:54 - [DIR] surv2005/ 25-Aug-2008 10:46 - [DIR] usmort2004/ 18-May-2007 08:50 - [DIR] usmort2005/ 25-Aug-2008 10:59 - [TXT] Example.html 09-Feb-2004 14:57 2k [TXT] Protocol.html 09-Jan-2007 15:37 10k [TXT] ReadMe.html 12-Jul-2006 16:12 1k [TXT] Template.html 12-Jul-2006 16:12 9k [   ] canques.jar 01-Jul-2008 16:30 68k [TXT] template_html.html 26-Jan-2006 13:26 1k [   ] templates.cfg 11-Aug-2006 13:34 3k

Last updated: August 25, 2008

In order to make use of the CanQues hosting service, you first need permission from the SEER Program. Carol Kosary (kosaryc@mail.nih.gov) is the point of contact.

With that permission, a username and password will be supplied so you can ftp files to the CanQues server. You'll need to place a single configuration file, and a data file and dictionary per database on the CanQues server.

You'll also be provided with the name of your CanQues hosting service directory which you'll need to generate the necessary HTML on your Web server.

The materials needed to present databases in your own instance of CanQues are discussed below. Examples can be found in the CanQues hosting service directory http://canques.seer.cancer.gov/example/. When you connect to the CanQues server (canques.seer.cancer.gov) with ftp and log on with your username and password, your current working directory will automatically be your CanQues hosting service directory. This is where you place your configuration, data, and dictionary files.

Once your content is set up on the CanQues server, you can generate reports either through a Java applet or by creating a URL link to be displayed in a Web browser. The following CanQues 2.0 CGI Protocol/API fully describes the report options and features available in both applet and URL-based invocation. The features allow:

If using the CanQues applet, create an HTML page on your Web server referencing the CanQues applet. It will parse the report dictionary (*.dic) and configuration (Canques.cfg) data and provides parameters to generate a request report URL. An example of a CanQues applet used can be found here: Example.html. You'll want to review the source of this page and place the <APPLET >...</APPLET> tag's contents on your Web server. You'll need to change the DirectoryName parameter to your CanQues hosting service directory. The coloring of the applet is handled through six optional parameters.

More on the Binary Data Files

The data files containing statistics are binary with no line terminating characters. Each "record" is fixed length starting with one or more single byte identifying variables and ending with the four byte statistic. The structure of Canques.cfg supports identifying variables of more than one byte and statistics of other than four bytes but neither has been tested. Each identifying variable takes on positive integer values between 0 and 255. The statistic is a signed integer that will be presented with decimal places depending on the StatisticDivisor specified Canques.cfg. The four byte (32-bit) statistic starts with the sign bit at the far left. Moving right, that is followed by the 230th bit, the 229th bit, the 228th bit, and so on down to the 20th bit at the far right.

"Records" of the data file must be sorted ascending by all the identifying variables.

The statistics and data files can be generated with any package or language of your choice and this work is done on your computer systems.