Dimensions Component Pack 4.

5 ReadMe
Installing Dimensions Component Pack
For information about installing the Dimensions Component Pack, see the Dimensions Component Pack Installation Instructions. You can view these by selecting Installation Instructions from the Dimensions Component Pack Installer window. If the Dimensions Component Pack Installer window does not open automatically when you insert the CD !"# into the CD !"# drive, you can open it manually. $here are two ways to do this. %rowse the CD !"# using &indows '(plorer and double click the autoplay.exe file. )lternatively, choose Run from the &indows *tart menu, and then enter d:\autoplay in the !un dialog bo(, where d:\ is the CD !"# drive.

Documentation
$he documentation for the Dimensions Component Pack is provided in the Dimensions Development +ibrary ,DD+- ../, which is available on the Dimensions Component Pack CD !"# and as a free download from http011www.spss.com1DD+1. You may want to check the download site from time to time, because a new version of the DD+ sometimes becomes available between releases of the Dimensions Component Pack itself. $he DD+ includes information on using the Dimensions Component Pack, a 2etting *tarted guide for data management scripting, table scripting tutorials, and numerous sample scripts.

Viewing Documentation on a Remote Server

!ecent security updates for #icrosoft &indows may prevent you from viewing the Dimensions Component Pack Installation Instructions or the DD+ if they are located on a remote server. You may find that the help window opens with an empty topic pane or that the topic pane contains the message 3$he page cannot be displayed4. $o resolve this problem, copy the files DCP_Installation_Guide.chm and DDL.chm to the local machine and open the files from there. For more information about this issue, see http011support.microsoft.com1kb156789/1 and http011support.microsoft.com1kb1568:/.1.

Changes to Daylight Saving Time DST! in "##$ in the %nited States

*P** has carried out testing of the Dimensions products to ensure that there are no issues with respect to the changes to D*$. ;owever, if you have not done so already, you must install &indows update <%6=>5=8 on any computer on which you intend to run Dimensions products.

Issues Resolved &y Dimensions Component Pack '()

$his section lists issues resolved since the release of Dimensions ..:. For details of new features in Dimensions Component Pack ../, see the Dimensions Development +ibrary ,DD+documentation.

Ta&le Scripting *ption

+"+,$ It is now possible to choose which of the cell items on a table to use in a chart. '-+"" In release ..:, tabulating a variable containing a mean that referred to a variable containing certain ?apanese characters caused 'rror @Anable to populate tables0 )ggregator error

Page > of 6

78>0Failed to select variables from CD*C.,$"# 'rror-@. $his has now been resolved. '-'#$ ) new e(port option, Wrap Description Text, has been added to the #icrosoft '(cel and PowerPoint e(ports, to enable you to choose whether or not to wrap long descriptions onto the ne(t line. $he default is to wrap the te(t. '-')+. '-/)/ In release ..:, the base and percentages disappeared after editing a variable, where the data source was a *)B file created from a Cuanvert data set. $his was because non category elements, like bases, are stored in an '( helper field and the *)B D*C does not merge these back to the main variable. $his has now been resolved. '-'," In previous releases, an n:>De(E element was treated by the Data #odel as a plain n:> with no condition and not as a Cuantum e(E manip statement. $his has now been resolved. '-$#,. '-0-0 $he ColumnProportions and Column#eans tests in mr*tudio, mr$ables, and Desktop !eporter previously used the e(pression0 DF E e> F e7 e: > to calculate the degrees of freedom. $his matches the calculation used in Cuantum1Cuanvert. From release ..: patch > the e(pression has changed to0 DF E e> F e7 e: 7 For backwards compatibility, the formula invoked by setting the UseQFormula property continues to use the original e(pression. '-/,) In release ..:, e(porting to #icrosoft &ord 7::: failed if the ;ide )pplication option was set to $rue. $his has now been resolved. Gote that running #icrosoft &ord at the same time as e(porting tables to &ord can cause errors and is not recommended. '"-#$ '(porting tables with only one variable on the side of the table from Desktop !eporter to PowerPoint caused an error or resulted in empty tables. $his has now been resolved. '")$) &hen e(porting large numbers of tables to #icrosoft '(cel, the e(port stopped before e(porting all the tables. $his was due to a limit on the number of font formats that can e(ist in a #icrosoft '(cel workbook. $he e(port process now handles this by not setting the font once this limit is reached. *ome incorrect formatting may be noticed as a result. '"$,# )dding HIsFi(ed E $rueI to a variable element in an . mdd file was being ignored by the $able "bJect #odel when the variable was used in a sorted table. $his has now been resolved.

Dimensions Data 1odel

"0)+$. +'#,&hen writing to a .sav file, the *P** *)B D*C now correctly handles accented or multibyte characters in field names.

Page 7 of 6

+)0'+. '++0$he *P** *)B D*C now correctly reads .sav files that contain a multiple response set that has the same name as an *P** variable. +,/$/ $he CDI1D!* D*C now correctly reads records where the DataCollection.*tart$ime or DataCollection.Finish$ime is between ::0::0:: and ::0/60/6. '#++) $he Import Data #ap feature of the #D#7Cuantum accessory now imports correctly when variable or category names include non )*CII characters. '-##) In the Dimensions Function +ibrary, the Find function can now find categories in a categorical value created by the *plit function. '-#/" $he Cuantum D*C is now much faster than before when used to calculate weights. '-''+ )n error no longer occurs when using #D#7Cuantum to check the card and column definitions in a .mdd file that has more than one loop that contains the same field name. '-),, &hen reading an #D# boolean or other non categorical variable that includes categories, the Cuantum metadata D*C ,#D*C- now ignores those categories. '-$$0 $he errors in the Dimensions Development +ibrary ,DD+- topic for the Contains*ome function have now been corrected. '-/+0 $he In7data metadata D*C ,#D*C- now correctly interprets unbounded loops in the . i2d file. '")$' &hen e(porting a Cuantum specification, #D#7Cuantum no longer fails when the #D# document contains loops that do not have any fields. '+-+) Cuantum specification files created by #D#7Cuantum no longer contain invalid characters at the beginning of each file. $his problem used to occur because the files were always saved using the A$F 5 encoding. '+"/" &hen using the Cuanvert D*C to read data, variables that have n:= elements with no te(t will no longer cause any subseKuent manipulation statements ,#- to appear undefined.

2nown Pro&lems
Installation
+#-/" $he Interview "ption in mr*tudio no longer works after installing DCP on the same computer. $he DCP installation overwrites the &indows registry entry that contains the location of the mr*tudio license folder with the location of the DCP license folder. $his means that mr*tudio can no longer

Page = of 6

locate the license information for the Interview "ption. $o resolve this problem, modify the registry entry HKEY_LOCAL_MACHINE\SO !"A#E\SPSS\m$Studio\%&e$sionnum'e$(\m$StudioLicen seDi$ so that the value is the path to the mr*tudio =.> installation folder, which by default is C)\Documents*and*Settin+s\%,ou$*"indo-s*use$*name(\A..lication* Data\SPSS\m$Studio\%&e$sionnum'e$(. $hen restart mr*tudio. +'/$' ItLs not possible to add the Interview or $ables options to an e(isting installation. $his may be a feature of a future version.

Data 1anagement Scripting

no re3erence num&er! Data +ink Properties dialog bo( sometimes creates the 3mr"leD%.Provider.74 Provider connection property without the trailing @.7@. &hen using the Data +ink Properties dialog bo( to select data sources and generate a connection string, either by double clicking on a . udl file, or from within &inD#*!un, the Provider connection property may sometimes be created as mr*leD4(Provider instead of mr*leD4(Provider(". ;owever, this does not appear to lead to any problems. no re3erence num&er! &orking with *P** .sav files. DCP ../ provides only limited support for running multiple e(ports to the same .sav file and for .sav files that contain ?apanese characters. For further information, please refer to the topics entitled 3$ransferring Data From *P**4 and 3$ransferring Data $o *P**4 in the mr*tudio Data #anagement *cripting section of the Dimensions Development +ibrary. --0##. -"0+" 'mpty #etadata and 'vent sections. !unning a D#* file that contains an empty #etadata or 'vent section leads to the error @'rror e(tracting section body, section is empty@. $o avoid this problem, do not create empty sections. -"$0) Go records selected for a transfer. If there are no rows selected by the &;'!' clause in the input select Kuery, the following unhelpful message is generated0 @'rror0 !owset.!ead #oveFirst, #essage0 'ither %"F or '"F is $rue, or the current record has been deleted. !eKuested operation reKuires a current record.@ -+-"+ogging fails when the logging folder contains ?apanese characters. If the folder specified for the log file contains ?apanese characters, the folder is created but the log file is not created. ;owever, this problem does not occur if you are using a ?apanese version of &indows. $o avoid this problem, do not use ?apanese characters in the logging folder if you are not using a ?apanese version of &indows. "+)//. "+$-/ $he #sPowerPointChartsFromCuanvert.dms sample script fails to run. $he error message is 3'(ecute 'rror,5-0 $he MPresentationsM type does not support the M)ddM method and a function of the same name does not e(ist4. $o avoid this problem, do not run this script on a computer with less than 7/8#b of memory. "$"'+ Double Kuotation marks within connection strings are ignored when the script is run. )n error will occur if a parameter value Kuoted by double Kuotation marks contains semicolons. $his bug does not apply to mr*cript%asic scripts as they correctly handle double Kuotation marks within

Page . of 6

connection strings. $o resolve this problem, use single Kuotation marks to Kuote parameter values in connection strings. "$-'' $he message 3Andefined variable, NOL 4 is displayed when using line continuation characters. $his may indicate that you have one or more spaces following a line continuation character ,O-. 'nsure that you have no spaces after line continuation characters. "$"'+ Double Kuotation marks within connection strings are ignored when the script is run. )n error will occur if a parameter value Kuoted by double Kuotation marks contains semicolons. $his bug does not apply to mr*cript%asic scripts as they correctly handle double Kuotation marks within connection strings. $o resolve this problem, use single Kuotation marks to Kuote parameter values in connection strings. +)-)In the metadata section of a D#* script, new variables that include an e(pression are not saved correctly to the output metadata file. +,-,$ )(is e(pressions in the master .mdd file are dropped during a merge. )(is e(pressions in the master input metadata source are not included in the output data source. You might be able to resolve this problem by switching the master and second input data sources. +0)') Custom properties in the master .mdd file are dropped during a merge. Custom properties in the master input metadata source are not included in the output metadata data source. $his problem might be fi(ed in a future version of DCP. In the meantime, you might be able to resolve this problem by switching the master and second input data sources. +/,$Cannot transfer from a Cuantum file to another Cuantum file when creating a new variable in the metadata section. 'ven if you attempt to allocate card and column information in the "n)fter#etaData$ransformation event section, the transfer still fails with message 3Bariable Pnew variable nameQ has no Card*tart property4. $o resolve this problem, transfer the Cuantum file to an R#+ data source ,while adding the new variable-, and then transfer the R#+ data source to the second Cuantum file. +//)$ ) comment immediately before 3'nd #etadata4 in the metadata section causes the script to fail. $his happens when there is a comment on the line preceding the 'nd #etadata statement. $o resolve this problem, add a blank line after the comment. '###0 &rong error message displayed when running a D#* script that includes a metadata section and has an incorrectly specified data source. If one of the data source sections is incorrectly specified, you might see the message 3'rror parsing mr*cript#etadata Current datasource not set4 when you attempt to run the script. $o see which data source section is at fault, temporarily remove ,or comment out- the metadata section and rerun the script. $he error message should then be correct. '#0)+ #etadata Bersions are lost during a data transfer. If the input metadata source contains one or more versions and the most recent version is being used by default ,that is, the 3#! Init #D# Bersion4 connection property has not been set-, the output metadata should contain all of the

Page / of 6

versions that e(ist in the input metadata. Instead, the output metadata does not contain any versions. $his problem might be fi(ed in a future version of DCP. '"00# In a D#* script, itLs not possible to assign a random value to a variable by using the %&a$ia'le_name(.#an/01 synta(. You have to use %&a$ia'le_name(.#es.onse.#an/01. '+#$# If using 3*'+'C$ Pspecific variable name,s-Q F!"# vdata4 in the InputData*ource section of a D#* script, an error occurs when transferring a Kuestion that is in a loop and contains more than one other specify category. '+#0)n 3"bJect reference not set to an instance of an obJect4 error occurs if a D#* script contains an "nGe(tCase event section, and in the *electCuery statement of the InputData*ource section you specify an alias name for a column. '+$,) ) D#* script fails if the "nGe(tCase even section contains references to category names that include currency symbols such as dollar signs.

Ta&le Scripting *ption

56porting Charts to 7ord &hen you use the option to e(port charts to &ord, the &ord '(port component creates the charts using '(cel. $his reKuires that &ord has been installed with the option to embed '(cel charts enabled. If this option is not enabled, e(ports of charts to &ord will fail. You can tell whether this option is enabled as follows0 >. "pen a new document in &ord. 7. From the Insert menu, choose *&8ect. =. From the list of obJect types, select 1icroso3t 56cel Chart. .. Click *2. If this fails, it generally means that the option is not enabled and you will need to install the option before you can e(port charts to &ord. *ther 56port Pro&lems -,"'/ +imitations in Internet '(plorer 8 mean that the ;$#+ '(port component cannot handle any tables that have more than >::: columns. -0,0In the table of contents created by the ;$#+ '(port component, the Filter column does not indicate the level of the filters. "#+"+ '(ports to &ord will fail if the specified output file is open. $his problem is most likely to arise if you attempt to repeat an e(port to the same output file without closing it first. "+)//. "+$-/ $he #sPowerPointChartsFromCuanvert.dms e(port sample will not work on a computer with less than 7/8#% of !)#.

Page 8 of 6

+',$#. +',$-. +/$"0 &hen e(porting to '(cel, in some circumstances the e(port fails with the message 3!un time error N>::.L4. $his can be resolved by installing the latest service packs for #icrosoft "ffice. 9eneral Ta&les Pro&lems --,)+. -)+$+. -,00" $e(t only elements on the top a(is. &hen te(t only elements are used on the top a(is of a table, they are displayed as an empty column. You can work around this problem by not using te(t only elements on the top of the table. &hen variables have these elements built in, you can remove them from the table specification when necessary. -0"-/ &hen rules are defined to hide rows or columns in a table that contains nesting, the rules for hiding entire columns and rows are applied to the sections of the table formed from the element of the outermost variable. *uppose you have a rule to hide all columns in which all of the values are Sero in a table of counts that has 2ender nested within )ge on the top a(is. If there are no female respondents for any of the age groups, the nested Female column will not be hidden if there are any #ale respondents for that age group. If there are no respondents of either gender in an age group, the entire age group will be hidden. -0"/0. -0+#$ Problems sorting a nested table. $his problem has been seen in a table that has nesting on the top a(is and in which sorting has been reKuested on a row. $he table was not sorted and no error message was issues to alert you to this. -0$+". -/-+" ;ide rule problems. &hen a hide rule results in the first cell of a column being hidden, the entire column is always hidden. *ometimes this may apply to all of the non base columns in a table, and then all of those columns will be hidden. -/'#) Anweighted base elements not removed when weighting is removed. %y default, an unweighted base element is added to all weighted tables. ;owever, if you subseKuently remove the weighting from the tables these unweighted base elements are not removed. +"#$, $he ability to tabulate grid slices by lower level variables in a hierarchical dataset and aggregate them at the lower level is currently not supported ,originally raised as =>/=8-. For e(ample, 3+oop>HT*lice)UI.C> V +oop7.C74 can be aggregated at the ;D)$) level but not at the level of +oop7. ) workaround for this situation is to create a derived variable at the upper level that references the grid slice. $his can then be aggregated at the lower level. '#0/$ *etting the )utoAnweighted%ases table property to false does not remove the unweighted base, if one was previously added.

Dimensions Data 1odel

"-#/,. "+/)'. "$-"#. +-)/0. '-0), #D#7Cuantum can allocate duplicate punch values when categorical Kuestions contain a mi(ture of categories and defined ,shared- lists. ++"#/. '+/$+ $he Cuanvert D*C does not correctly recogniSe some n:> elements as categories.

Page 9 of 6

++"+0. ++,0+. +)0+) D# Cuery does not display multibyte category names correctly. +'/'# $he superversion of a categorical Kuestion is incorrect when the categories are replaced with a defined list. ) problem can occur when a KuestionLs categories are replaced with a defined list whose categories have the same names as the KuestionLs original categories. &hen any version or superversion of the metadata is used for the connection, the case data returned for this Kuestion may be incomplete. +,",+ &hen using the Cuanvert D*C, categories that have the Dnoe(port Cuantum keyword are put into the .'( variable. $hese categories are then unavailable for use in mr$ables. $o resolve this problem, create an .mdd file and use that to load the Cuanvert proJect. $he Dimensions Development +ibrary ,DD+- includes a script called Create#ddFromCuanvert.mrs that you can use to do this. +,0,, &hen using the Cuantum D*C to write a .dat file, carriage return linefeed combinations in te(t variables are written to the file. $he results in records being split over multiple lines, making the file unusable. +,/,, $he Cuantum D*C does not recogniSe T as a valid punch character. $he T character is used by Cuancept to code the !efused ,!'F- special response. +$#$$ #D# error when a categorical loop contains a Kuestion whose name is the same as one of the controlling categories. If you attempt to access any properties from the Fields collection for a combination of Kuestion and controlling category that have the same name ,for e(ample, MDM. ields23Loo.024A056.A036. ullLa'el-, the message 3$he MI'lementInstanceM type does not support the Pproperty nameQ property4 appears. '#00/ *aving a metadata document that was opened with oG"*)B' results in the loss of labels and custom properties. For e(ample, card and column information, and custom properties for analysis elements are lost. '")$# #D#7Cuantum allocates a default punch value of W7 to all categories. Previously, the default punch value was a blank. '"/)# *P** *)B D*C returns incorrect data when a #D# categorical loop contains a Kuestion whose name is the same as one of the controlling categories. $his issue is related to issue =9:99 above. '+"), +eading and trailing spaces are removed from #D# labels when displaying the labels in mr*tudio or #D# '(plorer. '+/'0 $he result of the following e(pression in mr*cript%asic is False0 I7*//8.89*:*8.801*;*8.8<1*!hen

Page 5 of 6

Third Party :greements

+egal Gotice %oost *oftware +icense Bersion >.: )ugust >9th, 7::= Permission is hereby granted, free of charge, to any person or organiSation obtaining a copy of the software and accompanying documentation covered by this license ,the @*oftware@- to use, reproduce, display, distribute, e(ecute, and transmit the *oftware, and to prepare derivative works of the *oftware, and to permit third parties to whom the *oftware is furnished to do so, all subJect to the following0 $he copyright notices in the *oftware and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the *oftware, in whole or in part, and all derivative works of the *oftware, unless such copies or derivative works are solely in the form of machine e(ecutable obJect code generated by a source language processor. $;' *"F$&)!' I* P!"BID'D @)* I*@, &I$;"A$ &)!!)G$Y "F )GY <IGD, 'RP!'** "! I#P+I'D, IGC+ADIG2 %A$ G"$ +I#I$'D $" $;' &)!!)G$I'* "F #'!C;)G$)%I+I$Y, FI$G'** F"! ) P)!$ICA+)! PA!P"*', $I$+' )GD G"G IGF!IG2'#'G$. IG G" 'B'G$ *;)++ $;' C"PY!I2;$ ;"+D'!* "! )GY"G' DI*$!I%A$IG2 $;' *"F$&)!' %' +I)%+' F"! )GY D)#)2'* "! "$;'! +I)%I+I$Y, &;'$;'! IG C"G$!)C$, $"!$ "! "$;'!&I*', )!I*IG2 F!"#, "A$ "F "! IG C"GG'C$I"G &I$; $;' *"F$&)!' "! $;' A*' "! "$;'! D')+IG2* IG $;' *"F$&)!'.

Copyright X 7::.W7::9 *P** +td. )ll rights reserved.

Page 6 of 6