BEA Tuxedo. Using the BEA Tuxedo System on Windows NT

Transcription

1 BEA Tuxedo Usig the BEA Tuxedo System o Widows NT BEA Tuxedo Release 7.1 Documet Editio 7.1 May 2000

2 Copyright Copyright 2000 BEA Systems, Ic. All Rights Reserved. Restricted Rights Leged This software ad documetatio is subject to ad made available oly pursuat to the terms of the BEA Systems Licese Agreemet ad may be used or copied oly i accordace with the terms of that agreemet. It is agaist the law to copy the software except as specifically allowed i the agreemet. This documet may ot, i whole or i part, be copied photocopied, reproduced, traslated, or reduced to ay electroic medium or machie readable form without prior coset, i writig, from BEA Systems, Ic. Use, duplicatio or disclosure by the U.S. Govermet is subject to restrictios set forth i the BEA Systems Licese Agreemet ad i subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR ; subparagraph (c)(1)(ii) of the Rights i Techical Data ad Computer Software clause at DFARS , subparagraph (d) of the Commercial Computer Software--Licesig clause at NASA FAR supplemet ; or their equivalet. Iformatio i this documet is subject to chage without otice ad does ot represet a commitmet o the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, ObjectBroker, TOP END, ad Tuxedo are registered trademarks of BEA Systems, Ic. BEA Builder, BEA Coect, BEA Maager, BEA MessageQ, BEA Jolt, M3, esolutios, elik, WebLogic, ad WebLogic Eterprise are trademarks of BEA Systems, Ic. All other compay ames may be trademarks of the respective compaies with which they are associated. Usig the BEA Tuxedo System o Widows NT Documet Editio Date Software Release 7.1 May 2000 BEA Tuxedo Release 7.1

3 Cotets 1. Differeces Betwee Usig the BEA Tuxedo System o UNIX ad o Widows NT Widows NT Platform Cosideratios Cofiguratio Issues Specifyig Machie Type ad User ID Numbers Usig Network Drives Allocatig ad Releasig Memory Buffers Updatig TxRPC Usig the bakapp Driver Startig BEA Tuxedo System Applicatios Automatically Cofigurig the BEA Tuxedo System for Widows NT Ivokig the Cotrol Pael to Cofigure the BEA Tuxedo System Accessig Machies o a Network Modifyig Eviromet Variables Directig BEA Tuxedo Messages to the Widows NT Evet Log Cofigurig tliste Processes to Start Automatically Maximizig System Performace Developig a BEA Tuxedo Applicatio o Widows NT Usig Developmet Tools Usig the buildserver ad buildcliet Commads Addig BuildTuxedo to the MSDEV Tools Meu Creatig BEA Tuxedo Project Files Settig Up Your Eviromet Specifyig the Build Type, Header File, ad Fileame How BuildTuxedo Uses the Header File Usig the BEA Tuxedo System o Widows NT iii

4 Specifyig Fuctio ad Service Names Specifyig a Resource Maager Debuggig a BEA Tuxedo Server Applicatio Developig a BEA Tuxedo Applicatio Without Visual C Usig the Tuxdev Applicatio Usig the BEA Tuxedo Editors Usig the FML Table Editor Usig the VIEW Table Editor Workig i Multiple Documets Simultaeously How the Editors Validate Etries iv Usig the BEA Tuxedo System o Widows NT

5 CHAPTER 1 Differeces Betwee Usig the BEA Tuxedo System o UNIX ad o Widows NT Widows NT Platform Cosideratios Cofiguratio Issues Specifyig Machie Type ad User ID Numbers Usig Network Drives Updatig TxRPC Usig the bakapp Driver Startig BEA Tuxedo System Applicatios Automatically Usig the BEA Tuxedo System o Widows NT 1-1

6 1 Differeces Betwee Usig the BEA Tuxedo System o UNIX ad o Widows NT See Also For iformatio o istallig the BEA Tuxedo system o a Widows NT system, refer to Istallig the BEA Tuxedo System. For more iformatio o the BEA Tuxedo system, refer to the followig documets: Settig Up a BEA Tuxedo Applicatio Admiisterig a BEA Tuxedo Applicatio at Ru Time Usig the BEA Tuxedo Workstatio Compoet BEA Tuxedo Commad Referece BEA Tuxedo C Fuctio Referece BEA Tuxedo COBOL Fuctio Referece BEA Tuxedo FML Fuctio Referece BEA Tuxedo File Formats ad Data Descriptios Referece Widows NT Platform Cosideratios The followig list summarizes some cosideratios to keep i mid whe usig the BEA Tuxedo system o a Widows NT platform. Whe you specify path ames, use a back slash ( \ ), ot a forward slash ( / ) to delimit file ad directory ames. Use a drive letter (such as C:) for all fully qualified paths. You do ot eed to specify the.exe suffix for executable files. The suffix is always implied for the BEA Tuxedo system for Widows NT. 1-2 Usig the BEA Tuxedo System o Widows NT

7 Cofiguratio Issues Fileames follow Widows NT amig covetios. For istace, ames edig i.dll idetify dyamically liked libraries; ames edig i.lib idetify statically liked ad imported libraries; ames edig i.cmd idetify commad scripts. All BEA Tuxedo system executables, commad scripts, ad dyamically-liked libraries are located i %TUXDIR%\bi. Statically-liked libraries are located i %TUXDIR%\lib. Cofiguratio Issues The followig list provides some cofiguratio issues of which you should be aware whe usig the BEA Tuxedo system software o a Widows NT platform. Server ames are case sesitive. Widows NT machie ames specified i BEA Tuxedo applicatio files should always be upper case. The OPENINFO strig i the BEA Tuxedo cofiguratio file must be i the followig format: OPENINFO="resource maagers:resource(s)" For example: OPENINFO="TUXEDO\SQL:APPDIR1\bakdl3;bakdb;readwrite" Note: The first separator i the precedig strig is a colo; subsequet separators are semicolos. Usig the BEA Tuxedo System o Widows NT 1-3

8 1 Differeces Betwee Usig the BEA Tuxedo System o UNIX ad o Widows NT Specifyig Machie Type ad User ID Numbers O the Machies page of the cofiguratio file, iclude the followig three etries. TYPE="WiNT" UID=0 GID=0 Note: These etries require differet settigs o a UNIX platform. Wheever you create a cofiguratio file for a eviromet with both UNIX ad NT machies, iclude these etries i the Machies page for every Widows NT ode i your cofiguratio. Usig Network Drives For reliability purposes, it is recommeded that you ot use etwork drives. If, however, you attempt to start up the BEA Tuxedo system o a Widows NT machie that has the TUXCONFIG file o a etwork drive, you must set the followig permissios: The etwork drive must be coected as admiistrator. The admiistrator must use the same password o the local ad remote systems. I the tuxipc service startup optios, the ENTRY optio must have admiistrator set for Log O As This Accout. The password must be the same as the admiistrator s so that the tuxipc service has full admiistrator access rights. 1-4 Usig the BEA Tuxedo System o Widows NT

9 Allocatig ad Releasig Memory Buffers Allocatig ad Releasig Memory Buffers Whe allocatig ad releasig memory buffers o a Widows NT system,you must esure that the memory buffer is released from the same heap i which it was allocated. Failure to do so results i a segmetatio fault. For example, a memory buffer that is allocated usig Falloc() must be released usig Ffree(). O the other had, a memory buffer that is allocated usig malloc() ad freed usig Ffree() will produce a segmetatio fault. free() must be used, i this case, to free the memory buffer. For more iformatio o Falloc, Falloc32(3fml)ad Ffree, Ffree32(3fml), refer to the BEA Tuxedo FML Fuctio Referece. For more iformatio o malloc() ad free(), refer to the documetatio distributed with your operatig system. Updatig TxRPC Whe the BEA Tuxedo system iteroperates with OSF/DCE, you must update the eviromet file to iclude the appropriate PATH variable for the applicatio, allowig BEA Tuxedo system programs to fid the OSF/DCE DLLs wheever eeded. Review the bldc_dce(1) ad blds_dce(1) referece pages i BEA Tuxedo Commad Referece for iformatio pertaiig to usig these commads o the Widows NT platform: The bldc_dce commad builds a BEA Tuxedo system cliet that ca be called via OSF/DCE RPC. The blds_dce commad builds a BEA Tuxedo system server that calls OSF/DCE. Usig the BEA Tuxedo System o Widows NT 1-5

10 1 Differeces Betwee Usig the BEA Tuxedo System o UNIX ad o Widows NT Usig the bakapp Driver The bakapp program is a small example applicatio budled with the BEA Tuxedo system for Widows NT. Besides demostratig the operatio of the BEA Tuxedo system ad providig a example of BEA Tuxedo system applicatio code, the %APPDIR%\UBB file geerated by the bakapp driver (driver.exe is located i %TUXDIR%\APPS\bakapp\NT\driver) ca act as a template for cofiguratios for ay ew applicatios. Startig BEA Tuxedo System Applicatios Automatically Whe the BEA Tuxedo system is istalled o Widows NT as a server, it may be useful to cofigure the machie to start a BEA Tuxedo system applicatio automatically whe bootig up your system usig the srvay.exe utility program cotaied i Microsoft s Resource Kit for Widows NT. Refer to srvay.wri ad rktools.hlp for istructios o this procedure. To esure proper operatio of BEA Tuxedo system programs that start automatically whe bootig up, you must set the BEA Tuxedo system eviromet variables %TUXDIR% ad %NLSPATH%. Set these variables usig the covetioal Widows NT method or by usig the BEA Tuxedo system BEA Tuxedo cotrol pael. For more iformatio, refer to Modifyig Eviromet Variables o page Usig the BEA Tuxedo System o Widows NT

11 CHAPTER 2 Cofigurig the BEA Tuxedo System for Widows NT Ivokig the Cotrol Pael to Cofigure the BEA Tuxedo System Accessig Machies o a Network Modifyig Eviromet Variables Cofigurig tliste Processes to Start Automatically Maximizig System Performace Note: The BEA Admiistratio Cosole offers extesive olie help. Through the BEA Admiistratio Cosole help, you ca fid istructios for all the admiistrative tasks that the BEA Admiistratio Cosole helps you perform, plus referece iformatio for all cofiguratio tool folders. Usig the BEA Tuxedo System o Widows NT 2-1

12 2 Cofigurig the BEA Tuxedo System for Widows NT Ivokig the Cotrol Pael to Cofigure the BEA Tuxedo System I additio to the BEA Admiistratio Cosole, the BEA Tuxedo system for Widows NT provides a cotrol pael that you ca use to cofigure the BEA Tuxedo system for Widows NT. You ca use the BEA Tuxedo cotrol pael to perform the followig tasks: Access machies o a etwork by settig the Machies page Modify eviromet variables o the Eviromet page Direct BEA Tuxedo system messages to the Widows NT Evet Log by settig the Loggig page Cofigure oe or more tliste processes to start automatically by settig the Listeer page Maximize system performace by tuig the IPC Resources page settig To ope the cotrol pael: 1. Select Start >Cotrol Pael. The Microsoft Widows Cotrol Pael opes, similar to that which is show i the followig figure. 2-2 Usig the BEA Tuxedo System o Widows NT

13 Accessig Machies o a Network Figure 2-1 Microsoft Widows Cotrol Pael 2. Double-click o the BEA Tuxedo ico to ope the BEA Tuxedo cotrol pael. Accessig Machies o a Network The Machies page of the BEA Tuxedo cotrol pael eables a BEA Tuxedo admiistrator to access ay machie o the Microsoft Widows Network ruig Widows NT, where the admiistrator has logo privileges. The admiistrator ca the: set eviromet variables remotely; determie the locatio of BEA Tuxedo evet loggig; add, start, or remove tliste services; ad tue IPC resources. The followig figure shows the Machies page. Usig the BEA Tuxedo System o Widows NT 2-3

14 2 Cofigurig the BEA Tuxedo System for Widows NT Figure 2-2 Machies Page A admiistrator ca access a remote machie by locatig the machie i a etwork tree. If you kow the ame of a machie, but ot its work group: 1. Click Select. The Eter Machie Name dialog box is displayed, as show i the followig figure. 2-4 Usig the BEA Tuxedo System o Widows NT

15 Modifyig Eviromet Variables Figure 2-3 Eter Machie Name Dialog Box 2. Eter the ame of the remote machie i the field (for example, \\itrepid i the previous figure) ad click OK. All subsequet actios o other folders listed i the BEA Tuxedo cotrol pael take place o the selected machie. Modifyig Eviromet Variables The Eviromet page of the BEA Tuxedo cotrol pael eables a BEA Tuxedo admiistrator to modify BEA Tuxedo eviromet variables i a way that is similar to the method used to modify Widows NT eviromet variables. The followig figure shows the Eviromet page. Usig the BEA Tuxedo System o Widows NT 2-5

16 2 Cofigurig the BEA Tuxedo System for Widows NT Figure 2-4 Eviromet Page The Variable field cotais a list of the most commoly used BEA Tuxedo eviromet variables. To add or edit a variable, select the variable, eter a value for it i the Value field, ad click Set. To delete a variable, click the variable you wat to delete ad click Delete. Clickig Set saves ay chages made to the BEA Tuxedo eviromet. 2-6 Usig the BEA Tuxedo System o Widows NT

17 Directig BEA Tuxedo Messages to the Widows NT Evet Log Directig BEA Tuxedo Messages to the Widows NT Evet Log The Loggig page of the BEA Tuxedo cotrol pael eables you to direct BEA Tuxedo system messages to the Widows NT Evet Log. The followig figure shows the Loggig page. Figure 2-5 Loggig Page You ca select the Loggig optio (Widows NT Evet Log) or the traditioal ULOG (Disk File), or both. If you wat traditioal ULOG messages, select the directory ito which ULOG messages will be writte, as well as a prefix for the ame of the log file. The default prefix is ULOG, ad the default fileame is ULOG.mmddyy. Usig the BEA Tuxedo System o Widows NT 2-7

18 2 Cofigurig the BEA Tuxedo System for Widows NT To view Evet Log etries, from the Widows NT desktop select Start >Programs >Admiistrative Tools >Evet Viewer. I the Evet Viewer Log widow, verify that Applicatio is checked. The followig figure shows the Widows NT Evet Detail widow with some sample etries. Figure 2-6 Evet Detail Widow The etry for each evet idetifies the message umber ad catalog that you ca use to look up the descriptio ad recommeded actio for that evet i the BEA Tuxedo System Messages. Also provided are the type (that is, Iformatio, Warig, or Error) ad a brief descriptio. 2-8 Usig the BEA Tuxedo System o Widows NT

19 Cofigurig tliste Processes to Start Automatically Cofigurig tliste Processes to Start Automatically The Listeer page of the BEA Tuxedo cotrol pael eables you to cofigure oe or more tliste(1) processes to start automatically whe you boot up your system. The followig figure shows the Listeer page. Figure 2-7 Listeer Page Usig the BEA Tuxedo System o Widows NT 2-9

20 2 Cofigurig the BEA Tuxedo System for Widows NT To add a listeer, eter a port umber i the Port Number field ad click Add. After you click OK or Apply, ad reope the BEA Tuxedo cotrol pael, you ca start or stop tliste(1) services right o the Listeer page. You ca also use the Widows NT Services cotrol pael to start or stop a tliste service or to cofigure a tliste service to start automatically. You ca use the tliste(1) program to perform admiistrative actios i a applicatio distributed across multiple computers. You must start the tliste program o each computer before ruig the applicatio. Geerally, you eed oe tliste for each BEA Tuxedo applicatio ruig o the computer. Maximizig System Performace The BEA Tuxedo system for Widows NT provides you with the BEA Tuxedo IPC Helper (TUXIPC), a iterprocess commuicatio subsystem that is istalled with the product. O most systems IPC Helper rus as istalled; however, you ca use the IPC Resources page of the BEA Tuxedo cotrol pael to tue the TUXIPC subsystem ad maximize performace. The followig figure shows the IPC Resources page Usig the BEA Tuxedo System o Widows NT

21 Maximizig System Performace Figure 2-8 IPC Resources Page With the IPC Resources page of the BEA Tuxedo cotrol pael, you ca set a variety of IPC resources to the right of each box. I the Select IPC Resources field, you ca ame a set of resources. Selectig the default Medium disables ay chages to the parameters. If you backspace over Medium (a sigle backspace removes the whole strig), the parameters are made available for chages. To add a ew cofiguratio, select <ew>, edit the BEA Tuxedo IPC parameters as eeded, ad click OK to associate the ame with the revised set of resources. The click Apply to save the chages i the Registry table. You must stop ad the restart the tuxipc.exe service to make the chages take effect. Usig the BEA Tuxedo System o Widows NT 2-11

22 2 Cofigurig the BEA Tuxedo System for Widows NT Whe iterpretig the Maximum Number of Processes Usig IPC parameter o the IPC Resources page, please remember: You must cout ay multicotexted BEA Tuxedo cliet multiple times. Your total should match the umber of applicatio associatios (cotexts) that ca be outstadig cocurretly. You must cout ay multicotexted BEA Tuxedo server multiple times. Your total should match the umber of cotexts calculated by addig 1 to the value of MAXDISPATCHTHREADS, where 1 represets the mai dispatcher thread. You ca view the performace of a ruig BEA Tuxedo applicatio from the Performace Moitor, as show i the followig figure. Figure 2-9 Performace Moitor 2-12 Usig the BEA Tuxedo System o Widows NT

23 CHAPTER 3 Developig a BEA Tuxedo Applicatio o Widows NT Usig Developmet Tools Usig the buildserver ad buildcliet Commads Addig BuildTuxedo to the MSDEV Tools Meu Creatig BEA Tuxedo Project Files Settig Up Your Eviromet Debuggig a BEA Tuxedo Server Applicatio Developig a BEA Tuxedo Applicatio Without Visual C++ Usig the Tuxdev Applicatio Usig the BEA Tuxedo Editors Usig the BEA Tuxedo System o Widows NT 3-1

24 3 Developig a BEA Tuxedo Applicatio o Widows NT See Also For iformatio o the BEA Tuxedo ATMI, refer to the followig documets: Programmig a BEA Tuxedo Applicatio Usig C Programmig a BEA Tuxedo Applicatio Usig COBOL Programmig a BEA Tuxedo Applicatio Usig FML Programmig a BEA Tuxedo Applicatio Usig TxRPC BEA Tuxedo Commad Referece BEA Tuxedo C Fuctio Referece BEA Tuxedo COBOL Fuctio Referece BEA Tuxedo File Formats ad Data Descriptios Referece Usig Developmet Tools The BEA Tuxedo system itegrates ito the Microsoft Visual C++ (msdev) eviromet ad emulates the fuctioality of msdev whe itegratio is ot possible. This itegratio makes it easier for you to develop BEA Tuxedo applicatios for 16-bit ad 32-bit Widows operatig systems. The codig required to create BEA Tuxedo service requests, sed requests, set up coversatioal coectios, ad get replies is fudametally the same i both UNIX ad NT eviromets. BuildTuxedo ad TUXDEV are tools that help you i your developmet eviromet. BuildTuxedo is a sigle tool, tightly itegrated with the msdev build eviromet, that developers ca use istead of the buildserver, buildcliet, ad buildclt commads. (Of course, these commads are still available for those who prefer to use them.) The BuildTuxedo system operates seamlessly o Widows 95 ad Widows 98, ad all curretly supported Widows NT eviromets (Itel ad Alpha). 3-2 Usig the BEA Tuxedo System o Widows NT

25 Usig the buildserver ad buildcliet Commads TUXDEV allows you to create, edit, ad compile multiple 16/32-bit FML tables ad multiple 16/32-bit VIEW files. It also uses Multiple Documet Iterface (MDI) architecture so that you ca use multiple views of these file types simultaeously. Usig the buildserver ad buildcliet Commads Although the buildserver(1) ad buildcliet(1) commads are available o the Widows NT platform, there are differeces betwee how the optios to these commads work o NT platforms ad o-nt platforms. The followig table lists these differeces. Table 3-1 Usig the buildserver ad buildcliet Commads To... I a No-Itegrated Developmet Eviromet, Use This Optio... I a Itegrated Developmet Eviromet... Tur o verbose mode -v All optios are displayed o tabs by default. (The -v optio is uecessary ad usupported.) Specify a output file -o (output_fileame) 1. Select Settigs from the msdev Build meu. 2. Select the Lik tab i the Project Settigs dialog box. 3. Specify the ame of your output file by usig the edit cotrol. Specify the first file to be liked -f 1. Select Settigs from the msdev Build meu. 2. Select the Lik tab i the Project Settigs dialog box. 3. Specify the first file to be liked by usig the edit cotrol. Usig the BEA Tuxedo System o Widows NT 3-3

26 3 Developig a BEA Tuxedo Applicatio o Widows NT To... I a No-Itegrated Developmet Eviromet, Use This Optio... I a Itegrated Developmet Eviromet... Specify the last file to be liked Specify a resource maager Specify services that will be available o a server Use the COBOL compiler -l 1. Select Settigs from the msdev Build meu. 2. Select the Lik tab i the Project Settigs dialog box. 3. Specify the last file to be liked by usig the edit cotrol. -r 1. Access the BuildTuxedo GUI. 2. Access the BuildTuxedo Test widow ad select the Resources page. 3. I the Tuxedo Resource Maager field, eter the ame of the resource maager. -s 1. Access the BuildTuxedo GUI. 2. Access the BuildTuxedo Test widow ad select the Services page. 3. I the Service Names field, eter the ame of each service o a separate lie. -c COBOL is uavailable. To modify the build eviromet i a itegrated developmet eviromet: (a) select Settigs from the msdev Build meu, ad the (b) select either the C/C++ or Lik tab. Note: CC ad CFLAGS are o loger eeded. To specify the library ad iclude paths i a itegrated developmet eviromet, select Optios from the MSDEV Tools meu. From the Optios dialog box, select the Directories tab. 3-4 Usig the BEA Tuxedo System o Widows NT

27 Addig BuildTuxedo to the MSDEV Tools Meu Addig BuildTuxedo to the MSDEV Tools Meu To add BuildTuxedo to the MSDEV Tools meu: 1. From withi the Microsoft Visual C++ (msdev) graphical user iterface (GUI), select Tools >Customize >Tools. The Customize widow is displayed, as show i the followig figure. Figure 3-1 Customize Meu 2. Click New (broke box ico with twikle) ad type &BuildTuxedo i the blak box at the ed of the Meu Cotets box. Note: Placig a ampersad (&) before ay letter eables that letter as a hot key. 3. I the Commad field, type the etire path ame of BuildTuxedo (%TUXDIR%\bi\BuildTuxedo), or select... to search for the ame, ad click Ope to display the ame i the Commad field. Usig the BEA Tuxedo System o Widows NT 3-5

28 3 Developig a BEA Tuxedo Applicatio o Widows NT 4. I the Iitial Directory field, click the right arrow ad select Curret Directory. Note: 5. Click Close. To modify a item, highlight it ad type over it. To move ay item, highlight it ad select the up or dow arrow at the top of the Meu Cotets box. BuildTuxedo is ow part of the msdev Tools meu. Creatig BEA Tuxedo Project Files BuildTuxedo maitais a separate project file i the curret directory for each BEA Tuxedo applicatio usig it. Whe BuildTuxedo begis, it searches for a valid project file i the curret directory. If oe is foud, the various dialog cotrols are set to the values stored i the file ad the dialog is displayed. The title bar displays the followig iformatio. BuildTuxedo project_ame Because your BuildTuxedo project is closely associated with the msdev project i the curret directory, BuildTuxedo also searches for two other files: A valid msdev make file (fileame.mak) A msdev project file (fileame.mdp, fileame.dsw, or fileame.dsp) If BuildTuxedo caot fid either of these files, it displays a warig ad/or fails to activate. If the directory cotais multiple BuildTuxedo project files, or multiple msdev project files or make files, meu items that cotai appropriate target ames are added to the System meu. To save the curret project file, select OK or Apply. To cacel ay chages that you make to the project file or ay file maitaied by the BEA Tuxedo system, select Cacel or Esc. 3-6 Usig the BEA Tuxedo System o Widows NT

29 Settig Up Your Eviromet Settig Up Your Eviromet Before you ca build your BEA Tuxedo applicatio i a IDE, you must set the followig fudametal parameters i your eviromet: Build type Header file Fileame of the C or C++ file to be created ad maitaied by BuildTuxedo Fuctio ames Service ames To provide this iformatio, access the BuildTuxedo Project dialog box i the msdev GUI. Specifyig the Build Type, Header File, ad Fileame To specify the build type, header file, ad fileame: 1. From the BuildTuxedo dialog box, select the Build tab. Usig the BEA Tuxedo System o Widows NT 3-7

30 3 Developig a BEA Tuxedo Applicatio o Widows NT Figure 3-2 Build Page 2. I the Build Types field, click the dow arrow ad choose oe of the followig: l Server l Native cliet or Workstatio cliet Note: Widows 95 ad Widows 98 users ca select Workstatio Cliet type oly. If you Select... The, After Your Selectio... Server Eter iformatio i the Iitializatio, Cleaup, ad Etry Poit fields. Proceed to Step 3. Native Cliet or Workstatio Cliet Proceed to Step Usig the BEA Tuxedo System o Widows NT

31 Settig Up Your Eviromet The Iitializatio ad Cleaup optios allow you to override the default iit/exit fuctios by specifyig valid fuctio ames. The Etry Poit optio allows you to specify the ame of the fuctio that BuildTuxedo geerates. You ca the call this fuctio from aywhere i the applicatio. 3. I the Header File field, eter stdafx.h. 4. I the File Name field, eter the ame of the C or C++ file to be geerated ad maitaied by BuildTuxedo. How BuildTuxedo Uses the Header File I the header file, BuildTuxedo adds the ecessary pragma statemets to build the curret BEA Tuxedo project correctly. BuildTuxedo opes the file specified i the Header File field of the Build page, if the file is preset; otherwise, it creates a ew oe. A sectio startig with //Begi Tuxedo Sectio*****DO NOT EDIT***** ad edig with //Ed Tuxedo Sectio desigates the area i the header file that BuildTuxedo maitais ad ito which pragma statemets are writte. If BuildTuxedo does ot locate this sectio i the file, it appeds it to the ed of the header file. Because all other text withi the file remais uchaged, you ca specify stdafx.h as the header file. Note: If your project is ew, ad you select OK or Apply, you must select Files ito Project from the msdev Isert meu. You the add the file geerated by BuildTuxedo to the curret project. You eed to do this oly for a ew project or whe you chage the ame of the C/C++ output file. Specifyig Fuctio ad Service Names Select the Services tab to specify fuctio ad service ames. The followig figure illustrates the Services page. Usig the BEA Tuxedo System o Widows NT 3-9

32 3 Developig a BEA Tuxedo Applicatio o Widows NT Figure 3-3 Services Page Two lists are used to maitai the service dispatch table. Fuctio Names is a user-maitaied list of fuctios that you ca associate with a service. Service Names is a user-maitaied list of the associated services. Note: To scroll up ad dow either list, use the arrow keys. Geerally, the service ad the fuctio that performs the service are represeted by the same ame. For example, fuctio x performs service x. I some cases, the fuctio may have a differet ame from the service it performs. For example, i oe case, fuctio abc performs services x, y, ad z. I aother case, the service ame may ot be kow util ru time. You must specify ay fuctio associated with a service whe you build the server. For ay fuctio associated with a service, you must specify the service, the appropriate prototype, a C likage, a void retur, ad a sigle TPSVCINFO poiter parameter. To specify a fuctio to which a service ame ca be mapped, you must add the fuctio to the Fuctio Name list. This iformatio is required for the service dispatch table Usig the BEA Tuxedo System o Widows NT

33 Settig Up Your Eviromet (If you are usig the buildserver(1) commad, you ca provide this iformatio with the -s optio. Refer to Programmig a BEA Tuxedo Applicatio Usig C or Programmig a BEA Tuxedo Applicatio Usig COBOL for more iformatio o the -s optio.) To add or edit ames o the Fuctio Names list: 1. I the Services folder, choose oe of the followig actios. To Actio Add a item 1. Click New (broke box with twikle i the upper left corer). 2. Click Isert, or select a blak area o the list (that is, a dotted lied box). 3. Type the ame of the ew fuctio. Modify a existig ame Delete a ame Highlight the ame, ad type over it. Highlight the ame o the list ad click the X ico or click Delete. 4. Whe complete, click Eter to save your chages ad exit. (To exit without savig your chages, click Esc or Tab.) Usig the BEA Tuxedo System o Widows NT 3-11

34 3 Developig a BEA Tuxedo Applicatio o Widows NT Specifyig a Resource Maager To specify a resource maager: 1. Select the Resources tab from the BuildTuxedo meu to display the Resources page, as show i the followig figure. Figure 3-4 Resources Page \ 2. I the Tuxedo Resource Maager field, type the etire path ame of the resource maager for your applicatio. Note: The Tuxedo Resource Maager field cotais a list of BEA Tuxedo resource maagers available o the system as defied i the %TUXDIR%\udataobj\RM file. If the file is ot preset, a default (NONE) is displayed Usig the BEA Tuxedo System o Widows NT

35 Debuggig a BEA Tuxedo Server Applicatio Debuggig a BEA Tuxedo Server Applicatio To debug a server that has ot bee booted, complete the followig procedure. Note: You should use this procedure oly if you have built the server applicatio usig the Debug cofiguratio for your project. 1. At ay Widows NT commad prompt, type tmboot - -d 1 -s serverame to display the commad-lie optios that tmboot(1) uses to start serverame. 2. Execute the tmboot -M commad to boot the BBL. (If ecessary, boot additioal applicatio servers or machies.) 3. Select Project >Settigs i msdev. 4. I the Program Argumets field, select Debug ad type the commad-lie optios used i Step Start the debugger ad proceed as eeded to debug the server applicatio. Note: Because BEA Tuxedo libraries are ot built with debuggig iformatio ad source code is ot provided, you caot access the BEA Tuxedo code directly. 6. To ed the debuggig sessio, type tmshutdow at ay Widows NT prompt. Warig: Do ot select Debug >Stop to stop the server as the BEA Tuxedo system may subsequetly attempt to restart it. Note: To debug a server that is already ruig, type msdev -p at ay Widows NT commad prompt, replacig with the server s process ID (represeted by a decimal umber). Usig the BEA Tuxedo System o Widows NT 3-13

36 3 Developig a BEA Tuxedo Applicatio o Widows NT Developig a BEA Tuxedo Applicatio Without Visual C++ If you eed to develop a BEA Tuxedo applicatio without Visual C++, use the buildserver(1) ad buildcliet(1) commads. To do this, specify the compiler ad lik optios ecessary to build a BEA Tuxedo applicatio. Refer to BEA Tuxedo File Formats ad Data Descriptios Referece, Tutorials for Developig a BEA Tuxedo Applicatio, ad Programmig a BEA Tuxedo Applicatio Usig C or Programmig a BEA Tuxedo Applicatio Usig COBOL for iformatio o usig these tools. To build a debug versio of your applicatio usig buildserver or buildcliet, you must compile all source files with the /Zi ad /Od optios. The /Zi optio eables debuggig; the /Od optio disables optimizatio. I additio, you may eed to defie the _DEBUG preprocessor directive. To complete the process, idicate the lik optio as follows. -l"/lik/debug:full /debugtype:both" Usig the Tuxdev Applicatio To istall the Tuxdev applicatio: 1. I the Microsoft Visual C++ (msdev) eviromet, select Tools >Customize >Tools >Add. 2. I the Add Tool dialog box, type the etire path ame i the Commad field (TuxDev.exe is located i %TUXDIR%\bi), or select Browse to search for the ame ad click OK to display the path ame i the Customize widow. 3. To chage the item displayed o the Tools meu, chage the etry i the Meu Text field Usig the BEA Tuxedo System o Widows NT

37 Usig the BEA Tuxedo Editors Note: To create a hot key for a tool, iclude a ampersad (&) before ay letter i the tool ame. This eables you to ivoke the tool at ay time simply by typig that letter. 4. I the Iitial Directory field, click o the right arrow ad select Curret Directory to display its ame ($CurDir). Usig the BEA Tuxedo Editors Two editors are available i this eviromet: the FML Table Editor ad the VIEW Table Editor. The user iterface for both editors is similar to a workbook i which you ca work o multiple documets/views simultaeously. You ca also edit multiple files of various types at the same time. Both editors closely resemble a Microsoft Excel spreadsheet with all of the associated fuctioality: The FML Table Editor eables you to create ad/or edit a FML field table easily, ad to geerate user-selectable 16- or 32-bit field header files. The VIEW Table Editor eables you to create ad/or edit a VIEW Table file easily, ad to geerate user-selectable 16- or 32-bit VIEWS ad header files. Usig the FML Table Editor To ivoke the FML Table Editor: 1. O the commad lie, eter the etire path ame of Tuxdev (%TUXDIR%\bi) ad select Eter. 2. Eter tuxdev ad select Eter. The BEA Tuxedo Developer widow is displayed. 3. Choose oe of the followig actios. Usig the BEA Tuxedo System o Widows NT 3-15

38 3 Developig a BEA Tuxedo Applicatio o Widows NT To... Complete These Steps... Create a file Modify a existig file I the BEA Tuxedo Developer widow, select File >New to display the New widow show i the followig figure. Proceed to Step 4. I the BEA Tuxedo Developer widow, select File >Ope. Select the file (FML fileames have a.fml extesio) to edit. Skip the remaiig steps. The followig figure illustrates the New widow. Figure 3-5 New Widow 4. I the New widow, highlight FML Table ad type i the ame of the ew file i the File Name field. 5. Select OK. The FML Table Editor is ivoked, as show i the followig figure Usig the BEA Tuxedo System o Widows NT

39 Usig the BEA Tuxedo Editors Figure 3-6 FML Table Editor As show i the figure, the FML Table Editor cotais five colums: Name, Number, Type, Flag, ad Commet, with a ulimited umber of rows. The followig table lists the purpose of each colum i the editor. Table 3-2 FML Table Editor Colum Descriptio This Colum... Eables you to... Name Number Type Flag Commet Eter commet ad/or base umbers. Each commet or umber must be preceded by a poud sig (#) or a asterisk (*); otherwise, the lie is assumed to be a active table etry. Data etered i a empty cell is assumed to be a ew etry. (Blak lies are allowed.) Specify the relative umber of the field. Select from a list of all valid values for this field. Select flag settigs (whe the colum is active). Expad or clarify ay etry desigated i the Name colum. Usig the BEA Tuxedo System o Widows NT 3-17

40 3 Developig a BEA Tuxedo Applicatio o Widows NT You ca ope ew (uamed) FML tables. A blak grid is created for the table amed FML Tablex, where x is a value tracked by the MDI ad icremeted by oe each time a ew table is created. You ca specify a ame if ad whe the table is saved. You ca also ope a existig text file for editig. Uless otherwise specified, files are saved i the directory i which the file was opeed i tabbed delimited format, with.fml appeded to the ed of the fileame whe applicable. You ca compile this file to produce either a 16-bit or 32-bit FML header file. Usig the VIEW Table Editor To ivoke the VIEW Table Editor: 1. O the commad lie, eter the etire path ame of Tuxdev (%TUXDIR%\bi) ad select Eter. 2. Eter tuxdev ad select Eter. The BEA Tuxedo Developer widow is displayed. 3. Choose oe of the followig actios. To... Complete These Steps... Create a file 1. I the BEA Tuxedo Developer widow select File >New to display the New widow show i the followig figure. 2. Proceed to Step 4. Modify a existig file 1. I the BEA Tuxedo Developer widow, select File >Ope. 2. Select the file (FML fileames have a.fml extesio) to edit. 3. Skip the remaiig steps. The followig figure illustrates the New widow. 4. I the New widow, highlight VIEW Table ad type the ame of the ew file i the File Name field. 5. Select OK. The VIEW Table Editor is ivoked, as show i the followig figure Usig the BEA Tuxedo System o Widows NT

41 Usig the BEA Tuxedo Editors Figure 3-7 VIEW Table Editor As show i the previous figure, the VIEW Table Editor cotais seve colums: CName, FBName, Type, Cout, Flag, Size, ad Null, with a ulimited umber of rows. You ca eter commets i the CName colum, provided that each commet begis with the required poud sig (#). Blak lies are also allowed. Whe a CName etry is ot preceded by a poud sig ad is ot NULL, the lie is assumed to be a active table etry. Table 3-3 VIEW Table Editor Colum Descriptio This Colum... Eables you to... CName Each commet or umber must be preceded by a poud sig (#) or a asterisk (*); otherwise, the lie is assumed to be a active table etry. (Blak lies are allowed.) Usig the BEA Tuxedo System o Widows NT 3-19

42 3 Developig a BEA Tuxedo Applicatio o Widows NT This Colum... Eables you to... FBName Type Cout Flag Size Null Name the field i the fielded buffer; this ame is displayed i the field table file. Select from a list of all valid values for this field. Specify the umber of elemets to allocate (that is, the maximum umber of occurreces to be stored for this member). Select flag settigs (whe the colum is active). Idicate the size of the member if the type is strig, carray, or dec_t. Otherwise, you ca specify -, ad the view compiler computes the size. Specify a ull value or - (default ull value) for that field. Note: You must specify the followig iformatio to deote the start ad ed of the view iformatio: VIEW table_ame... END The iformatio must appear i the CName colum i a row by itself. You ca eter multiple views withi the same file, provided that each table etry is preceded by VIEW table_ame ad followed by END. You ca ope ew (uamed) view files i which a blak grid is created for the view, Viewx, where x is a value tracked by the MDI ad icremeted by oe each time you create a ew view. You ca specify a ame if ad whe you save the view file. You ca also edit a existig view file (either text or biary). Uless otherwise specified, files are saved i the directory where the file was opeed i tabbed delimited format, with.v appeded to the fileame whe applicable. You ca compile this file to produce either 16- or 32-bit biary VIEW ad header files Usig the BEA Tuxedo System o Widows NT

43 Usig the BEA Tuxedo Editors Workig i Multiple Documets Simultaeously The MDI, as part of the basic framework, provides a multiple-documet architecture i which you ca ope documets ad views, regardless of type, at the same time. Examples of this desig are msdev, Excel, ad Word. I BEA Tuxedo terms, you ca ope x umber of FML tables ad y umber of VIEW Table files at ay time, ad the use ay oe of them. Each documet looks ad feels like a workbook that cotais tabs for each ope documet. How the Editors Validate Etries The followig table describes the iformatio that is validated i each colum of the FML Table Editor. Table 3-4 Iformatio Validated i the FML Table Editor I This Colum... This Iformatio Is Validated... Name Number Type Flag Commet Commets, base umbers, ad valid text strigs Numbers oly. (The rage is determied by a 16/32-bit user mode.) Valid FML types Valid FML flags. Extra checkig is doe for mutually exclusive flags. Etries are ot validated. Usig the BEA Tuxedo System o Widows NT 3-21

44 3 Developig a BEA Tuxedo Applicatio o Widows NT The followig table describes the iformatio that is validated i each colum of the VIEW Table Editor. Table 3-5 Iformatio Validated i the VIEW Table Editor I This Colum... This Iformatio Is Validated... CName FBName Type Cout Flag Size Null Etries are ot validated. Etries are ot validated. Valid BEA Tuxedo types Numbers oly. (The rage is determied by a 16/32-bit user mode.) Valid FML flags. Extra checkig is doe for mutually exclusive flags. Numbers oly. (The rage is determied by a 16/32-bit user mode.) Etries are ot validated Usig the BEA Tuxedo System o Widows NT