Software Products for Collaborative Staging Version 2 (CSv2)

Software Archives
Software Products for Collaborative Staging
Version 1 (CSv1)

The second production version of CSv2 was released on 02/10/2010 (Build/Version Number: 02.01.00). This is the version that should be used for current software installations to calculate Collaborative Stage V2. The documentation and sample programs have been revised to account for some minor updates to the API. A change log is also included in the download to account for changes from build 02.00.01 to 02.01.00.

The first production version of CSv2 was released on 01/13/2010 (Build/Version Number: 02.00.01) for the second Vendor CSv2 NAACCR Town hall meeting. This presentation was specifically given to help vendors implement the production version of CSv2 in their software products. The presentations given on 11/04/2009 and 01/13/2010 should be used in conjunction with the software to develop a full understanding of CSv2.

The MS PowerPoint slides (converted to PDFs) should be reviewed before downloading the ZIP file with the software. Links to the Town Hall MS PowerPoint slides and the CSv2 production version of the software are included below:

CSv2_Vendor Meeting_2009_11_04.pdf - Converted to a PDF from the MS PowerPoint slides
CSv2_Vendor Meeting_2010_01_13.pdf - Converted to a PDF from the MS PowerPoint slides
CSv2_Producton_Release_2010_02_10.zip - The contents of the zip file include the following in separate folders:

  • Documentation (API Documentation)
  • CSAPI (DLL, LIB, and H files – CSv2 Staging Library)
    • cstage.dll -- For the build/version number, either right-click on the file in Windows Explorer and check the version properties tab or call the API function CStage_get_version()
    • Include files: csapi.h and collab.h
    • Cstage.lib
  • VB CSAPI (Wrapper DLLs used for VB.Net)
  • Source Code (API Source Code)
  • HTML.zip (HTML tables formatted for the web)
  • XML.zip (XML tables used in the build)
  • CStageSamples (API sample programs)
    • CSamples (C & C++ sample programs)
    • CSharpSamples (C# sample programs)
    • JavaSamples (Java sample programs)
    • VBSample (Visual Basic .NET programs)
  • Testomatic.zip (Test-o-Matic standalone interface for the API)

CSv2 Valid, Invalid, and Obsolete Codes Tables (130K ZIP) Valid, Invalid, and Obsolete Codes Tables: Excel Spreadsheets are provided which show schema-specific valid and invalid values for each field for CS version 02.01.00. An Excel spreadsheet is also included which contains the obsolete codes for version 02.01.00. Please note that the obsolete spreadsheet has a table for each obsolete code type and one of all obsolete codes combined. These three spreadsheets are not mutually exclusive since the obsolete codes are also contained in the valid code list.

NAACCRv12 Valid and Invalid (2095K ZIP) Test Cases for the Algorithm: Vendors have expressed an interest in obtaining test records which have a known behavior when the CS algorithm is run on them. Two sets of random test cases, one for valid CS codes (valid.NAACCRv12.in.v020100.txt) and one set with one and only one CS invalid code (invalid.NAACCRv12.in.v020100.txt) in each record were generated from the XML files. These input files (.in.) are in NAACCR v12 format (LRECL = 3339) and only contain the CS input fields and other fields necessary for the DLL to successfully run. On the input file, the record is un-staged, i.e., all derived CS fields are blank. These files can be used as input to the corresponding version of the CS algorithm (v020100). The output files (.out.) contain the staging results generated by the CSv2 algorithm. When staging the Valid “in” file, no errors should be generated by the algorithm. When staging the Invalid “in” file, one specific error message should be generated per data record. Please note that each record of the invalid “out” file contains the first 200 characters of the error message generated by the CSv2 algorithm. The error message has been written to column 1236 (Reserved 05).

Please Note: 
This release of CSv2 is a production version; however, additional testing and field use may uncover errors that require additional releases during the first or second quarter of 2010. Vendors will be notified via e-mail of production version updates during 2010. These releases will be posted on this web page.

For Questions:
As the CSv2 algorithm is implemented and employed with real case scenarios, questions regarding the CS site-specific schemas should be sent to Donna Gress, AJCC Technical Specialist at csv2@facs.org.

For questions and comments on CSv2 production version software, please e-mail Joseph Rogers at JRogers@cdc.gov.

Software Archives
Software Products for Collaborative Staging Version 1 (CSv1)

 

Revised February 12, 2010

 

Collaborative Staging Home Page