CSPro 2.5.006 08 Dec 2004 Release Notes ============= This document contains the following sections: [0] Updates Since Initial Release [1] What's New in CSPro 2.5 [2] Migrating Applications from CSPro 2.4 to 2.5 [3] CSPro 2.5 List of Modules [4] Hardware and Software Requirements [5] Example Files and Folders [6] What was New in CSPro 2.4 [7] What was New in CSPro 2.3 [8] What was New in CSPro 2.2 ============================================================================ [0] Updates Since Initial Release CSPro 2.5 Release History ------------------------------ 19 May 2004 - 2.5.001 Initial release 24 Jun 2004 - 2.5.002 Update release 04 Aug 2004 - 2.5.003 Update release 03 Sep 2004 - 2.5.004 Update release 21 Oct 2004 - 2.5.005 Update release 08 Dec 2004 - 2.5.006 Update release Update Notes ============ Installation ============ 24 Jun 2004 - Installation now associates CSExport with .EXF extensions. CSPro ===== 24 Jun 2004 - Area Name files from older versions of CSPro can now be loaded. 04 Aug 2004 - .HPF files are not converted to .QSF files automatically. 21 Oct 2004 - Error message given when CSPro is opened from command line with a bad input file. Dictionary ========== 24 Jun 2004 - When dictionary is saved as a print file, CSPro now puts the print file in the Text Viewer. Form Designer ============= 04 Aug 2004 - Reset button on Change Field Font dialog box now works properly. Joining columns in rosters when there are multiple form files now works correctly. 21 Oct 2004 - Switching to another task and back to CSPro when a reconcile error dialog box is showing no longer crashes CSPro. Deleting multiple items from a vertical roster no longer crashes CSPro. Data Entry ========== 04 Aug 2004 - Extra records are no longer created When Endlevel is executed in operator controlled mode. Selcase dialog box works better now. 03 Sep 2004 - Pressing F10 now shows error messages. Pressing F12 and Ctrl+F12 now works when id items are blank. 21 Oct 2004 - F1 key now works when no case is loaded. Endlevel now correctly saves a case that was loaded as a partial case. 08 Dec 2004 - Subitems are now correctly moved and displayed when insert or sort of occurrences are made. Batch Edit ========== 03 Sep 2004 - When bad record types exist in 2 level or 3 level applications, batch no longer crashes when case is output. Text Viewer =========== 24 Jun 2004 - Text Viewer will now reload files that have been changed while they are open and remove files that have been deleted. 21 Oct 2004 - Text Viewer will now change font size when the control key is held down and the scroll wheel is moved. Table Viewer ============ 24 Jun 2004 - Table Viewer will now reload files that have been changed while they are open and remove files that have been deleted. Export Data =========== 24 Jun 2004 - Export will provide a better error message when the dictionary referenced in an export specification file (.ExF) no longer exists. Export no longer crashes when run from a .PFF file and exporting to SPSS, SAS, or STATA. Export now produces only a .LST and .PFF file when run from a specification file. Compare Data ============ 24 Jun 2004 - Compare will no longer crash when the data files compared are read-only. Reformat ======== 08 Dec 2004 - Reformat inserts new id fields in correct locations. Examples ======== 24 Jun 2004 - The CAPI example has been updated. ============================================================================ [1] What's New in CSPro 2.5 Those of you who are already familiar with CSPro 2.4 should note the following significant changes and new features. Please refer to the CSPro documentation or on-line helps for more information. CSPro (Data Entry Designer) =========================== - CAPI (Computer Assisted Personal Interviewing). In CAPI, the enumerator is presented a question to ask and enters the answers directly into CSPro. CSPro provide a switch to turn on CAPI behavior and a CAPI question editor. - CONTROL ITEM for ROSTER or MULTIPLE FORMS. An data item can now be specified to control the maximum number of occurrences of a roster or multiple form. - ROSTERS WITH FREE MOVEMENT. Roster now can either have their current behavior or can be made to behave as a spreadsheet where there is free movement Behavior in Rosters CSPro (language) ================ - BREAK and NEXT statements. These new statements allow you exit early from a loop and either exit the loop entirely or continue with the next iteration of the loop. - REENTER, SKIP, and ADVANCE statements. The statements have been enhanced to allow the specification of the target field in an alpha variable or data item. - MOVE statement. This new statement allows you to move to a field in data regardless on whether it is before or after the current field in the data entry sequence. - SYSPARM function. This new function allows you to retrieve the system parameter specified in the .PFF file which launched your application. - GETOPERATORID function. This new function allows you to retrieve the operator id entered by the operator or specified in the .PFF file which launched your data entry application. - GETSYMBOL function. This new function allows to retrieve the name of the proc which currently being executed. - GETLABEL function. This new function allows you to retrieve the data dictionary label associated with a dictionary, record, item, valueset or value. - HIGHLIGHTED function. This new function allows you to determine whether a field is on path during data entry in system controlled mode on before the high water mark in operator controlled mode. - SAVEPARTIAL function. This new function allows you save the current case partially under program control and continue with data entry. - ONSTOP global function. This new global function allows you to control events after a stop case is requested or data entry is closed while a case is being entered. - ONKEY global function. This new global funtion allows you capture and process each key press of the operator. - SET BEHAVIOR statement. This new statement allows you switch whether blanks are allowed in numeric fields. - SET ATTRIBUTES statement. This statement has been enhanced to specify whether a responses for a field are to be given for selection. The responses display are from the first value set in the data dictionary. Export Data =========== - SEPARATE RECORD EXPORT IN SPSS, SAS, and STATA. You can now export different records types to different files where multiple records in the indput file produce multiple records in the output files. This was available for text and comma delimited file previously and is now available for SPSS, SAS, and STATA exports. Pack Application ================ - NEW. This new tools allows you to create a zip file containing all the files that belong to an application. This is useful to transfer an application to another computer or to another colleague. ============================================================================ [2] Migrating Applications from CSPro 2.4 to 2.5 If you have an existing CSPro 2.4 application which you plan to run using CSPro 2.5, you must check the following options in the data entry application setup: CAPI MODE If you want to implement a CAPI data entry application you must select "CAPI Mode" in the Data Entry Options dialog box. ============================================================================ [3] CSPro 2.5 List of Modules The following modules are located in the "\Program Files\CSPro 2.5" folder; module names are followed in parentheses by their Windows executable file name: Data Dictionary (CSPro.exe) Data Entry Designer (CSPro.exe) Batch Edit Designer (CSPro.exe) Cross Tabulation (CSPro.exe) Data Entry Run (CSEntry.exe) Batch Edit Run (CSBatch.exe) Text Viewer (TextView.exe) Table Viewer (TblView.exe) Map Viewer (MapView.exe) Table Retrieval (TRSWin.exe) Tabulate Frequencies (CSFreq.exe) Sort Data (CSSort.exe) Export Data (CSExport.exe) Reformat Data (CSRefmt.exe) Compare Data (CSDiff.exe) Concatenate Data (CSConcat.exe) Data Dictionary Converter (DDConvrt.exe) Shape to Map Converter (ShpToMap.exe) Pack Application (CSPack.exe) ============================================================================ [4] Hardware and Software Requirements A minimum configuration 33MHz 486 processor 16MB of RAM VGA monitor Mouse 45 MB of free hard drive Microsoft Windows 95 A recommended configuration Pentium processor 256MB of RAM SVGA monitor Mouse 45 MB of free hard drive space Microsoft Windows 98, Me, NT 4.0, 2000, or XP ============================================================================ [5] Example Files and Folders The "\Program Files\CSPro 2.5\Examples" folder contains the following CSPro example files: Census 2000 Dictionary.dcf -- Census Data Dictionary example Census 2000 Data Entry.ent -- Census Data Entry example application Census 2000 National Tabs.xtb -- Census Tabulations -- National level Census 2000 Prov-Dist Tabs.xtb -- Census Tabulations -- Subnational levels Popstan Census 2000.dat -- Census data file for above applications Popstan Census 2000.anm -- Area Names file (Province/District) Popstan Census 2000.map -- Popstan map polygon file (ASCII) Popstan Census 2000.mpc -- Popstan map polygon file (binary) Popstan Census 2000.mdf -- Map data file for Map Viewer (ASCII) Popstan.trs -- TRS file for Table Retrieval Within the "\Program Files\CSPro 2.5\Examples" folder are the following CSPro example folders, each containing a self-contained CSPro application: Adding Weights (Batch Edit application) CAPI (Data Entry application) Computer Assisted Coding (Data Entry application) Create PFF File (Data Entry application) Current Population Survey (CrossTab application) DateCheck (Data Entry application) HotDeck (Batch Edit application) Impute (Batch Edit application) ItemDrivenDE (Data Entry application) LogFile (Data Dictionary) Lookup (Data Entry application) Selcase (Data Entry applicaiton) Two Level Application (Data Entry application) Write External File (Data Entry application) ============================================================================ [6] What was New in CSPro 2.4 Those of you who are already familiar with CSPro 2.3 should note the following significant changes and new features. Please refer to the CSPro documentation or on-line helps for more information. CSPro (Data Entry Designer) =========================== - DATA ENTRY OPTIONS. You can allow partial saves of cases and show the case tree by selecting these options under the data entry options dialog box (Ctrl+E). CSPro (language) ================ - GETNOTE, PUTNOTE, EDITNOTE functions. These functions allow you to read and write notes to the notes file and force the operator to enter or read a note. They can only be coded in data entry applications. - MAKETEXT function. This function allow you to create a formatted string within your logic. - ONFOCUS and KILLFOCUS procedures. These procedures are only executed in data entry applications. They allow you to define statements which are always executed prior to and following entry of a level, roster, or field. CSEntry (Data Entry Module) =========================== - You can now save notes which are associated with a particular field within a particular case. - A case can now be partially saved in Add, Modify, or Verify mode. When this feature is turned on, you can stop anytime during the entry of a case and come back to it later. You will have the choice of beginning at the position in the case where you left off, or at the first keyable field of the case. - A case tree has been added for navigation within a case. When this feature is turned on, a tree showing the names and values of data items within the case is displayed. It can be used for moving between data items or for examining what has been entered in the case. - The menus and keyboard shortcuts have been changed and augmented. In particular, the Functions menu item has been split into Edit and Navigation menus. Additional items have been added to the View menu. CSPro (all modules) =================== - BACKWARD COMPATIBILITY. You can open any application created in CSPro 2.2 or 2.3 in CSPro 2.4. ============================================================================ [7] What was New in CSPro 2.3 Those of you who are already familiar with CSPro 2.2 should note the following significant changes and new features. Please refer to the CSPro documentation or on-line helps for more information. CSPro (Data Entry Designer) =========================== - COLOR IN FORMS. You now have total control over the colors you use in your data entry applications. Each form can have its own color, and every text item can have its own color. - MORE ALIGNMENT FUNCTIONS FOR FORMS DESIGN. In addition to aligning things left, right, top and bottom, you can now center things and space them evenly. CONCATENATE DATA UTILITY ======================== - This utility allows you to concatenate (join together) as many data files (or text files) as you like. The data files can be from any folder and you can sort them in a variety of ways. You'll find it on CSPro's Tools menu. CSPro (language) ================ - INSERT/DELETE/SORT COMMANDS. These are new commands in the CSPro language, which provide you more power in manipulating your data files. - DECLARING VARIABLES IN YOUR LOGIC. Variables that are not declared in PROC GLOBAL will be flagged as errors to help you avoid unintentional errors in your logic. If you prefer, you can easily set the compiler not to flag these as errors, as in CSPro 2.2. See the CSPro documentation on "Declarations" for more details. - SUBSCRIPT CHECKING. The CSPro compiler now issues warnings for unusual or improper use of subscripts. This will help you find errors in your logic, avoid run-time errors, and help ensure that your applications work the way you want. - REENGINEERED EXECUTION MODULES. We've done a lot of work "under the hood" to improve the way CSPro runs your applications. Several small bugs have been fixed and unusual behaviors corrected. CSPro (all modules) =================== - MORE PRODUCTION SUPPORT. We've standardized the Run Information files (.PFF) and provided more options for you to control the way CSPro data applications run. You can now double click on any .PFF file and CSPro will execute it. - BACKWARD COMPATIBILITY. You can open any application created in CSPro 2.2 and run it in CSPro 2.3. However, there are some differences between 2.2 and 2.3 that might affect the way your applications run. You may need to make some small modifications to your applications to make then run properly in 2.3. See the next section on "Migrating applications from CSPro 2.2 to 2.3" for more details. ============================================================================ [8] What was New in CSPro 2.2 Installation ============ - Support for installing and changing language used for minimum language features. CSPro (all modules) =================== - Minimal language support. Default small words in Tables and Maps are available in Armenian, English, French, Spanish, Portuguese, Russian, and Ukrainian. The Armenian, Russian, and Ukrainian alphabets are supported. - Toggle (Ctrl+U) between full screen (no tree) or split screen (with tree). - Toolbar buttons to change between the dictionary, data entry forms, batch edit code, and cross tabulations. - Tool tips work thoughout CSPro. CSPro (Data Dictionary) ======================= - Save dictionary under a different file name (Save As). CSPro (Data Entry Designer) =========================== - Better reconcilation of CSPro data entry applications with changes in the data dictionary. - Cut, Copy, and Paste objects while designing forms. - Create operator directed skips under field properties. - Specify force out-of-range, upper case alpha, and verify at the individual field level. Specify verification of every nth case. CSPro (Edit Designer) ===================== - Better reconciliation of CSPro edit applications with changes in the data dictionary. Option to specify dictionary or custom order of edits. CSPro (Cross Tabulation) ======================== - Option to show or not show area tables where no tallies occurred. - Apply a universe definition to ALL tables by pressing the "Apply to All Tables" button in the universe dialog box. CSPro (Language) ================ - Tooltips displayed when entering function names in code. Data Entry ========== - Can change the order cases are listed between entry order and case id sort order. - Can use + key on numeric pad to perform operator directed skip. - Can set full screen mode and initialize persistent fields in .PFF file. - Can perform interactive edits in modify mode using F11. - Verification of only selected fields. - Verification of every nth case. Text Viewer =========== - Option to show DOS Line Draw characters (OEM) rather than Windows characters (ANSI). Tabulate Frequencies ==================== - Toggle (Ctrl+T) between labels and names in the dictionary tree. - Select a universe for frequencies. Sort Data ========= - Sort by records within questionnaires. - Sort by quesetionnaires using non-id items. Export Data =========== - Toggle (Ctrl+T) between labels and names in the dictionary tree. Whatever text (labels or names) that appears in the tree will be the header row in the file. - Export single as well as multiple output files. - Select a specific occurrence of a subitem of a multiply occurring data item. Reformat Data ============= - More information provided about differences between dictionaries. - Can move items from a single record to another single or a mulitiple record. Compare Data ============ - New Tool to compare two data files and list the differences. ============================================================================ Comments, questions, and suggestions should be addressed to: Methodology & Software Development Branch International Programs Center U.S. Census Bureau Washington, DC 20233-8860 USA Phone: 1 (301) 763-1451 Fax: 1 (301) 457-3033 E-mail: CSPro@lists.census.gov Web site: www.census.gov/ipc/www/cspro