Centura Team Developer (CTD) 1.5.

1 Release Notes
Thank you for choosing Centura Team Developer 1.5.1 for your application development and deployment needs.

Table of Contents
New features in Centura Team Developer 1.5.1 Certification Information New features in Centura Team Developer 1.5 Features removed in Centura Team Developer 1.5 pplication Notes for Centura Team Developer 1.5 Deplo!in" Centura pplications and Components to #nd $sers %nown &roblems and 'imitations

New features in Centura Team Developer 1.5.1

Features
Stability Completion of the CTD Package Reporting and uerying !nhancements Team "b#ect $anager !nhancements Connectivity !nhancements Third Party Components %pdates &ctive ' Support !nhancements Documentation Changes

(tabilit!
(ncluded in CTD 1.5.1 are the fi)es found in PT*s 1+ , and - for CTD 1.5+ as .ell as any additional fi)es created after PT*-. CTD 1.5.1 improves core functionality+ like database connectivity+ and fi)es problems in the ne. &ctive' support and else.here.

Completion of t)e CTD &ac*a"e

+b,ect Nationali-er. The "b#ect /ationali0er is a locali0ation tool for CTD applications. (t has been available as a separately do.nloadable add1on since it .as released for CTD 1.1. The "b#ect /ationali0er is included in the CTD package for the first time in CTD 1.5.1. CTD 1.5.1 also includes an "b#ect /ationali0er enhancement .hich allo.s the programmer to hide top level or pop1up menus. +b,ect Compiler. The "b#ect Compiler+ .hich compiles S&2 code to C33+ .as omitted from the CTD 1.5 package+ due to the time constraints on the 1.5 release. (t is re1included in CTD 1.5.1+ having been fully tested. 'otus Notes /uic*+b,ect. The 2otus /otes included in CTD 1.5.1. uick "b#ect .as omitted from CTD 1.5+ but is

Connectivit! #n)ancements
(ee also Certification Infor ma tion. #0tended fetc) for +D1C. Centura4s "D5C router lacked the feature to fetch multiple ro.s from the database server at a time. CTD 1.5.1 addresses this deficiency by introducing a ne. key.ord+ *!TC6R"7. S 2!)tended*etch is the "D5C function call that allo.s fetching multiple ro.s at a time+ but Centura8s "D5C router binds only one ro. of data at a time and sets the ro.set si0e to 1. The enhancement is allo.ing the router to bind multiple ro.s at a time based on the setting of *!TC6R"7+ and then fetch that many ro.s at a time from the database server. (!base 11.2.3. (n the previous versions 9prior to 11.:.,; of Sybase S 2 Server and &daptive Server+ transaction isolation level , 9repeatable reads; .as supported by re<uiring users to specify transaction isolation level - 9seriali0able reads;. (n version 11.:.,+ transaction isolation level , is e)plicitly provided for data only1locked tables. This is supported by the Sybase router in CTD 1.5.1. & S 2.ini key.ord is introduced to allo. the control of the default behavior of S!2!CT statements. This has been a migration issue for users of the1= bit Sybase router+ .here the default behavior .as different. %se D!*&%2TS!2!CT*"R%PD&T!>"/ to allo. updates on S!2!CT statements. 9This .as the 1= bit default behavior.; In"res 3.4. Support of 2"/? @&RC6&R. +racle 5.4.5. CTD 1.5.1 is certified to support "racle A.B.5. (/' (erver 6.4 en)ancementsC $icrosoft S 2 Server D.B introduces ne. features that CTD 1.5.1 .ill support. The main issues are the ne. si0es of data types and support for integrated security. The ma)imum length of the C6&R+ @&RC6&R+ 5(/&RE+ and @&R5(/&RE data types in S 2 Server D.B has been upgraded to ABBB bytes+ an increase from the limit of ,55 bytes in S 2 Server =.). 5y upgrading our "D5C router to support "D5C -.5 9albeit at the ,.5 feature level;+ Centura supports the ne. length of these data types in CTD 1.5.1. Customers .ho .ant to use the ne. si0es from CTD may encounter binding problems especially .ith long binding unless and until they do the follo.ingC To use $icrosoft "D5C version ,.=5.B,B1 drivers or above+ you should turn off the S!T &/S(FD!*&%2TS "**+ S!T &/S(FP&DD(/? "** and S!T &/S(F7&R/(/?S "**. %se the check bo) %se G&/S( /ull+ Padding+ and 7arningsG to do this on the "D5C Data Source Dialog bo). 5y default this check bo) is turned on and must altered to use the "D5C drivers. Please refer to $icrosoft Hno.ledge 5ase &rticle (DC 1I::,1 for additional information. 7hen defining a S 2 Server D.B data source in the "D5C administrator+ there is an option to use either integrated security 9/T authentication;+ or the username and pass.ord. &ll the programmer needs to do is to enable the integrated security option .hen connecting to S 2 Server.

Reportin" and /uer!in" #n)ancements

Report 5uilder is enhanced considerably for the 1.5.1 release. &s a result+ it functions more effectively as an end1user ad1hoc <uery and reporting tool+ and a migration path for uest Reporter. &ddressed in the 1.5.1 release are problems .ith importing <uery files from uest and defining ne. <ueries.

Team +b,ect 7ana"er #n)ancements

T+7 Repositor! C)an"es. Previous versions of the T"$ Repository presented a challenge to Repository administrators .hen attempting to %/2"&DJ2"&D or R!"R?&/(K! the S 25ase based Repository 9Defect 5:=-=;. This release of T"$ introduces modifications to the Repository schema for S 25ase1based Repositories onlyL specifically the vie.

SESS 2.SES%S!R&%T6 is dropped and replaced .ith the vie. T$&D$.SES%S!R&%T6. This change in the Repository schema has necessitated a Repository version change 9from Compatibility 2evel 5+ $odification 2evel 5; to Compatibility 2evel =+ $odification 2evel 1. 7hen you first connect to an e)isting S 25ase1based Repository using T"$ 1.5.1+ it .ill automatically prompt you for the SES&D$ pass.ord and then proceed .ith the necessary modifications. (f you are using a non1S 25ase1based Repository 9"racle+ Sybase+ or $icrosoft S 2 Server;+ your Repository Compatibility and $odification 2evels .ill be upgraded for synchroni0ation even though no schema changes .ill take place. (n order to successfully upgrade a S 25ase1based Repository to Compatibility 2evel =+ $odification 2evel 1+ the e)isting Repository must be at Compatibility 2evel 5+ $odification 2evel 5. (f you have an earlier Repository version 9for e)ample+ from T"$ 1.B;+ you must first upgrade it to Compatibility 2evel 5+ $odification 2evel 5 .ith T"$ 1.1.) or T"$ 1.5.B.

ctive8 (upport #n)ancement

ctive8 containment fi0es. & number of defects have been resolved in the CTD support of &ctive ' controls. Specifically+ support for stream1based controls and controls .ritten using $icrosoft &ctive ' Template 2ibrary 9&T2;. (upport for International ctive8 ob,ects. CTD 1.5.1 uses a language independent means to access &ctive ' methods and properties .hen provided by the control or server. & method or property (D is used .hen the names the control or server declare are not language neutral. Correct 9eneration of Constants. 7hen &ctive' pro)y classes .ere generated in CTD 1.5+ not all the enumeration definitions .ere included in the .&P2 file produced. CTD 1.5.1 correctly generates these enumerators as constants. New (amples. /e. &ctive' samples are added to CTD 1.5.1 to better demonstrate Centura8s support for &ctive'. !)amples of $icrosoft "ffice automation are also included. +'#3 /uic*+b,ect. Centura .ill not support the "2!, release. uick"b#ect in the ne)t ma#or CTD

T)ird &art! Components $pdates

Ima"e7an $pdate. The version of (mage$an integrated .ith CTD 1.5.1 is updated to =.B.1 this adds support for interlaced ?(* images. $pdated 9rap)ics (erver. CTD 1.5.1 no. ships .ith version 5.5 of the 5PS ?raphics Server.

Documentation
Report 1uilder. /e. tutorials for the 5usiness Reporting online book .ill help users learn the features of Report 5uilder 1.5.1. /uic*ToolTips. /e. documentation covers the use of uickToolTips+ special pushbutton class ob#ects that allo. a programmer to assign tooltip and status bar captions.

Certification Information
*ollo.ing are supported databases for .hich en)ancements were made in t)e CTD 1.5.1 releaseC 7icrosoft (/'(erver 6.4. *or support of ABBB byte char+ varchar+ binary and varbinary datatypes. (ncreased from ,55 bytes. &lso to support 7indo.s /T authenication integrated security. (!base (!stem 11.2.3. Support for transaction isolation level , is e)plicitly provided for data only1locked tables. 9as stated belo. in this thread; In"res 1.3. !nables support for users to use long varchar datatypes.

"ther certified databases .ithout changes in 1.5.1C "racle A.B.5 (nformi) D. (ngres ,.B serverJ(ngres 1., client

(/'Router:In"res
The follo.ing section contains information about S 2RouterJ(ngres. This release of S 2RouterJ(ngres supports C&1"pen(ngres v1., for 7indo.s /T. Please read Connecting Centura Objects to Databases for information regarding connectivity to (ngres. (/'Router:In"res Compatibilit! This version of S 2RouterJ(ngres is certified .ithC Centura (oftware ; Centura Team Developer 1.5.1 ; S 2J&P( DB1pI In"res (oftware ; C&1"pen(ngres for 7indo.s /T version ,.B 9.J1., Client; ; C&1"pen(ngres /!T 9int..ntJB-; ; Patch IB15 +peratin" (!stems ; $icrosoft 7indo.s :5 ; $icrosoft 7indo.s :A ; 7indo.s /T I.B Networ* (oftware ; TCPJ(P

(/'Router:7icrosoft (/' (erver 6

S 2RouterJ $icrosoft S 2 Server supports $icrosoft S 2 Server D+ using its native call1level interface1"D5C. The follo.ing section contains information about S 2RouterJ$icrosoft S 2 Server D. (/'Router:7icrosoft (/' (erver Compatibilit! This release of the S 2RouterJ$icrosoft S 2 Server has been tested and certified .ith the follo.ing productsC +peratin" (!stems ; $icrosoft 7indo.s :5 ; $icrosoft 7indo.s :A ; 7indo.s /T I.B Centura software ; Centura Team Developer 1.5.1 ; S 2J&P( DB1pI 7icrosoft software ; $icrosoft "D5C -.B.,A,, Driver $anager 7icrosoft (/' (erver software ; $icrosoft S 2 Server =.5.B,B1 9Service Pack ,; on 7indo.s /T ; $icrosoft S 2 Server D.B. on 7indo.s /T 7icrosoft (/' (erver client software ; $icrosoft S 2 Server "D5C driver version -.DB.B=.,-+ "D5C version -.B1 (/'Router:+D1C Compatibilit! This release has been tested and certified .ith the follo.ing productsC +peratin" s!stems ; $icrosoft 7indo.s :5 ; $icrosoft 7indo.s :A ; 7indo.s /T I.B Centura software ; Centura Team Developer 1.5.1 ; S 2J&P( DB1pI

7icrosoft software ; $icrosoft "D5C -.B.,A,, Driver $anager +D1C drivers certified ; $icrosoft S 2 Server D.B driver from $icrosoft vD.BB.=,; $icrosoft &ccess driver from $icrosoft v-.IB.,,BI. ; $icrosoft S 2 Server =.B driver from $icrosoft v=.BB.1,=. ; "racle A driver from @isigenic vA.BB.B5.BB.

(/'Router:+racle
The follo.ing section contains information about S 2RouterJ"racle. (/'Router:+racle Compatibilit! This version of S 2RouterJ"racle is certified .ithC +peratin" (!stems ; $icrosoft 7indo.s :5 ; $icrosoft 7indo.s :A ; 7indo.s /T I.B Centura (oftware ; Centura Team Developer v1.5.1 ; S 2J&P( DB1pI +racle (oftware ; "racle D., on 7indo.s :5+ :A and 7indo.s /T ; "racle D.- on 7indo.s :5+ :A and 7indo.s /T ; "racle A.B.5 on 7indo.s :5+ :A and 7indo.s /T ; S 2M/et ,.) Networ* (oftware ; TCPJ(P+ SP'J(P'

(/'Router:(!base
S 2RouterJSybase provides native connectivity from Centura Team Developer to Sybase System 1B and Sybase System 11 using Sybase CT12ib. (/'Router:(!base compatibilit! This version of S 2RouterJSybase is certified .ithC +peratin" (!stems ; $icrosoft 7indo.s :5 ; $icrosoft 7indo.s :A ; 7indo.s /T I.B Centura software ; Centura 5uilder 1.5.1 (!base (!stem 11 software ; Sybase S 2 Server Release 11.B for Sun1svrIJ"S 5.I 9Solaris; ; Sybase "pen Client Client12ibrary Release 11.5 for 7indo.s :5J 7indo.s /T ; Sybase "pen Client /et12ibrary Release 11.5 for 7indo.s :5J 7indo.s /T ; Sybase "pen Client Client12ibrary Release 11.:., for 7indo.s :5J 7indo.s /T ; Sybase "pen Client /et12ibrary Release 11.:., for 7indo.s :5J 7indo.s /T

(/'Router:Informi0
(/'Router:Informi0 Compatibilit! This version of S 2RouterJ(nformi) is certified .ithC +peratin" (!stems ; 7indo.s /T I.B Centura software ; Centura Team Developer 1.5.1 ; S 2J&P( DB1pI Informi0 software ; (nformi)1"2 D.- on 7indo.s /T I.B ; (nformi) S! D.- on Solaris ,.I

Informi0 Client software ; (nformi)1/et TCPJ(P D.- TD 1 for 7indo.s /T and 7indo.s :5 Networ* (oftware ; TCPJ(P

New Features in Centura Team Developer 1.5

This release of Centura Team Developer has as its goal &ctive' support+ moderni0ed user interface and increased ease1of1use. The features areC ctive8 Container Centura (/'<indows:=3 user interface Report 1uilder user interface Report 1uilder ctive8 automation #n)anced Team +b,ect 7ana"er *or details about these features+ read N/e. features in this releaseO in the online help. New ( ' s!stem constant. TEP!F&cc*rameC The constant TEP!F&cc*rame is introduced .ith CTD 1.5. This constant is a possible return value from Sal?etType. (f you are migrating a pre1CTD 1.5 application to CTD 1.5 that defines this constant+ you8ll need to remove or comment out that constant definition. P /e. value for TEP!F&cc*rameC Prior to the CTD 1.5 release+ TEP!F&cc*rame 9defined in centura.h; .as defined as the he)adecimal value B)BIBBBBBB. 7ith the CTD 1.5 release+ this value has changed to B)1BBBBBBB. This is also the value for the ne. TEP!F&cc*rame S&2 system constant as described above. P $igration recommendationsC (f your application defines the constant /umberC TEP!F&cc*rame > B)BIBBBBBB .e recommend you comment out or remove this definition 9the constant definition is no longer needed;. (f your application defines a different named constant for comparing the return value from Sal?etType to test for accessory frames+ define your constant as e<ual to TEP!F&cc*rame. (f your application uses the numeric literal B)BIBBBBBB 9or it8s base ten e<uivalent; for comparing .ith the return value from Sal?etType to test for accessory frames+ replace the numeric literal .ith the constant TEP!F&cc*rame. Centura Developer #0tensions %it (CD%). The CDH is included .ith Centura Team Developer 1.5. The CDH+ formerly available only as an add1on to Team Developer+ is no. a part of the product. There are some useful tools included .ith the CDH that demonstrate ho. you can e)tend S 27indo.sJ-, as a development environment. &fter installing these Tools+ you can find them in a subdirectory of your Centura directory+ in CDHQToolsQ&dd"ns. !ach tool has its o.n subdirectory containing source code and a readme..ri file .ith instructions on ho. to build the tool and ho. to add it to your S 27indo.sJ-, toolbar. There are some S&2 libraries 9&P2 files; .hich are installed .ith the S&2 CDH. *or these libraries to be available to your applications+ make sure the CDHJS&2 subdirectory is added to your ?lobal Path. To do this+ select ToolsJPreferences from the menu+ click on the Directories tab+ and add the full path to the CDHJS&2 subdirectory. Runtime Files. *iles that you .ill need to deploy along .ith your S&2 CDH applications areC BCDH(15.D22 1CR(15.D22 These CDH runtime files may be freely distributed to end users+ sub#ect to the terms and conditions of your !lectronic Soft.are 2icense &greement. pplication Notes. The C33 CDH supports $icrosoft $ultithreaded D22 NC runtimeO or !'! applications only. (f you don8t change the default you .ill get link .arning 2/HIB:A. Change this in 5uild Settings J CJC33 J Code ?eneration. (f you include cdk.h in any app file in your pro#ect+ it .ill cause your pro#ect to link .ith C5D22.2(5 and CDH.2(5 9or CDHD.2(5 for debug builds;.

Features Removed
(nformi) 5.)+ =.)+ and D.1 Sybase 1B.) "racle D.1.)

This version of Centura Team Developer .ill not support 7indo.s -.1 9or 7in -.11; deployment. 7indo.s /T -.51 is not supported. Centura no longer supportsC

pplication Notes for Centura Team Developer 1.5

>isual Toolc)est classes. Some of the e)ternal functions called by the @isual Toolchest classes are no longer documented. 7hile these are still available for back.ard compatibility+ Centura Soft.are encourages you to replace calls to these e)ternal functions .ith calls to functions in the classes. To determine if an e)ternal function is one of those no longer documented+ select its name in the outline and press *1. (f a help topic displays .ith the name N(mplementation functions+O then the function is no longer documented. Report 1uilder utomation Interface. (f you are in Previe. mode and you have called !)ecute uery+ you should call ResetPrevie. to update your report. #0ternal Functions. /umeric values are sometimes truncated on overflo.+ .hen the value e)ceeds the allo.able range. 7i"ratin" from +'# 1.4:&icture Controls. The function SalPic?et(mage has been enhanced to support migration from "2! 1.B and the Picture control to the &ctive' Container Control. Eou can no. use SalPic?et(mage to retrieve the data from an embedded ob#ect in a Picture control in a format .hich is compatible .ith the &ctive' Container. *or e)ample+ assume a Picture control named pic"b#ect .hich contains an embedded ob#ect. The follo.ing code fragment retrieves the data of the embedded ob#ect into a String variable called sData. Set nLength = SalPicGetImage( picObject, sData, nType ) Calling this function .ill copy the data from the embedded ob#ect in the picture control to sData+ and set nType to the constant P(CF(mageType"5R!CT. To migrate to an &ctive' container control+ you can then .rite the string to a file and set the &ctive' Container Control contents using Sal&ctive'Create*rom*ile. &ssuming an &ctive' container control named a)1+ the follo.ing code fragment provides a simple e)ample. If SalFileOpen( hFile, sFileName, OF !"ite # OF $"eate # OF %ina"y ) $all SalFile!"ite( hFile, sData, nLength ) $all SalFile$l&se( hFile ) $all Sal'cti(e)$"eateF"&mFile( a*+, sFileName )

Deplo!in" Centura pplications and Components to #nd $sers

Centura Team Developer includes some modules .hich may be freely distributed to end users+ and others .hich re<uire a deployment license. Please refer to your !lectronic Soft.are 2icense &greement for details about your distribution rights and re<uirements. Free Distribution 7odules. The Centura Runtime *iles may be freely distributed to end users. 7hen you select this option in the CTD installer+ it .ill place in your Deploy directory a file installer .hich you may freely distribute to end users. (eparatel! 'icensed Deplo!ment 7odules. Eou must ac<uire an appropriate license from Centura in order to distribute the follo.ing modules to end users or deploy them in a production environmentC Report 1uilder Report 1uilder utomation 'ibrar!

<eb pp 7ana"er +b,ect Nationali-er

%nown &roblems and 'imitations

/ote that the change in Centura Team Developer version number from 1.1 to 1.5 results in changes to the names of some files. *or e)ample+ CD22i11.dll is no. CD22i15.dll. 2inking is not supported for a container control. Cut+ Copy+ and Paste are not supported for a container control. Te)t files 9.&PT; saved in S 27indo.sJ-, can not be opened in versions of CTD released before CTD 1.5 or S 27indo.s releases. *or more+ read G$igrating applicationsG in the online help. ??@52C & S!2!CT C&S! statement treats S,1ID-5,5=5 and ,1ID=1ID-1 as the same number. ?524?C Centura Team Developer version 1.1.) applications .hich are stored as Compiled &pplications re<uire full recompilation in S 27indo.sJ-, 1.5. 6o.ever+ .hen loaded+ some 1.1.) applications appear to be compiled. To force the re<uired recompilation+ you should save the application as G/ormalG and re1open the file. ??245C "b#ect /ationali0er changes to an &PR file .hich is applied to an !'! are not successful the first time+ though a Resources applied successfully dialog is displayed. The &PR must be applied t.ice for the changes to occur. ??454C "b#ect /ationali0er changed to tab titles in D5CS characters can result in corrupted te)t on some of the tab titles. ??245C "b#ect /ationali0erC "pening an !'! built .ith a previous version of the CTD is not supported by "b#ect /ationali0er .hich may crash .hen this is attempted. ?6554C Duplicate constant declarations may be generated in some specific circumstancesC if you generate an &P2 for a Type 2ibrary .hich contains references to !numerations in separate libraries+ the Constants .hich correspond to those enumerations may be generated into both &P2s. This may happen if the generation option G&llG is selected on the second screen of the &ctive' 7i0ard. These duplicate constant definitions .ill cause compilation errors. To .ork around this issue+ manually go into the &ctive' 2ibrary files and delete the constant declarations .hich are duplicated. The constants are usually named in such a .ay that you .ill kno. .hich library the constant definitions should appear in. ?6623. Report 5uilderC 7hen a ne. column is added in a <uery+ the previously generated report loses all its properties. Report 5uilderC Eou may use &/D or "R bet.een conditions in <ueries+ but Report 5uilder does not currently support grouping conditions in parentheses. The database follo.s the order of operations .hen e)ecuting a <uery. &/D takes precedence over "R in the order of operations. So+ for e)ample+ if you have Condition & &/D Condition 5 "R Condition C+ your <uery .ill return all the results that match 9Condition & &/D Condition 5;+ as .ell as all the results that match Condition C. Report 5uilderC (f you are creating a ne. <uery and report+ Report 5uilder8s *ormula !ditor may not display all the names of your <uery columns until you have e)ecuted the <uery and allo.ed Report 5uilder to create a default report. Then you may go back into the Define uery dialog bo) and add formulas to your <uery. Report 5uilderC uest Report Templates 9 RP files; and uest uery Templates 9 T files; can no. be reported into Report 5uilder. 6o.ever+ Report 5uilder does not currently support importing uest S 2 &ctivity *iles 9 SD files;.

?6543 Report 5uilderC & #oin bet.een t.o tables .ith identical column names results in being unable to vie. all the columns on the Result tab of the Define uery dialog bo). ?6564. Report 5uilderC (f you change the order of columns on the Result tab of the Define uery dialog bo)+ the generated report template remains the same. Report 5uilderC 7hen using Report 5uilder .ith a Sybase database+ if you .ant to use the Results tab in the Define uery dialog bo)+ ensure that multiple connections are enabled. To alter this settingC 1. 2aunch the Connectivity &dministrator. ,. Select (!base on the Connectivity tab. -. Click &roperties. I. "n the "ptional Hey.ords tab+ check the #nable 7ultiple Connections bo). Report 5uilderC (f you have a <uery condition that uses the operator G(/G follo.ed by a set+ and you later change the operator to G>G follo.ed by a value+ you may see this error messageC GThe data type of the left columnJformula is different than that of the specified value. Please correct or complete the condition before continuing.G To .ork around this problem+ delete the condition+ re1 e)ecute the <uery by clicking the Result tab+ and then re1add the condition.