COM/MTS Guide - Prolifics

More documents

Recommendations

Info

Saving as a COM ComponentAs in JPL, the functions sm_receive_args and sm_return_args take a list ofPanther variables as a single string. The variables can be comma or space-delimitedand can include the use of the property API syntax to refer to properties of fields onthe component.To make your C code accessible at runtime, your code must be prototyped and installedin Panther by customizing the DLL template, PrlServer.dll. For more information,refer to page 3-12, “DLL Template.”Implementing Methods in JavaThe ComFunctionsInterface contains methods for log, receive_args,return_args, and raise_exception. This interface also contains methods for aseries of C functions that implement some of the MTS methods for properties, securitychecking, and database transactions.Saving as a COM ComponentA COM component developed by Panther consists of the following pieces: a Pantherservice component, a DLL, a type library, and an .inf file.The Panther service component and the DLL have the same name, such asmy_component.dll and the service component my_component. The DLL lives in aparticular directory; the library containing the corresponding service component mustalso be in the same directory. During development, the DLL is stored in the directoryspecified on the COM card of the Component Interface window.To name a service component, choose File→Save As→Library Member, enter aname, and choose the library to save it in, generally server.lib.When you save a service component, you are asked whether to generate a DLL for it.When you generate the DLL, you also generate the type library and a .inf file for theCOM component. If you have changed the interface definition for the component since3-16 Building COM Components
Logging Server Messagesthe last time the component was saved, you should choose Yes. Otherwise, you canchoose No. Choosing Yes if the component's interface hasn't been changed will haveno ill effects; the new type library and .inf file will be the same as the old ones.Once the DLL and the service component are complete, you are ready to deploy yourCOM component. For more information, refer to Chapter 5, “Deploying COMComponents.”You can view the contents of a type library using Microsoft tools, such as OleView.Logging Server MessagesYou can send server messages to a log file. Because of performance considerations,this is not suggested for application deployment, only for application testing.How to Activate Message LoggingPlace a file named server.log in the application directory, along with server.liband the COM component's DLLs. Messages are automatically written to this file whena component is created and destroyed and when an error message is generated. Youcan write additional messages to this file using the JPL log command or its Cequivalent sm_log.The following sample log file illustrates some server messages:Mon Jun 21 22:06:30 1999: Component cCustomersCreated.Mon Jun 21 22:06:44 1999: Component cCustomers, Method GetCustomerSearching on SMon Jun 21 22:06:50 1999: Component cCustomersDestroyed.Mon Jun 21 22:07:03 1999: Component cCustomersCreated.Mon Jun 21 22:08:07 1999: Component cCustomersDestroyed.COM/MTS Guide 3-17
Page 1 and 2: TABLE OFCONTENTSContents:About This
Page 3 and 4: PantherCOM/MTS GuideRelease 5.4Docu
Page 5 and 6: TABLE OFCONTENTSContents:About This
Page 8 and 9: C. New Windows ExecutablesClient an
Page 10: Related InformationRelated Informat
Page 13 and 14: Contact Us!! Prolifics web site at
Page 15 and 16: CHAPTER1 OverviewPanther's COM supp
Page 17 and 18: COM Features! Security for componen
Page 20 and 21: COM/MTS Applications1-6 Overview
Page 22 and 23: Preparing for Application Developme
Page 24 and 25: Accessing Databases2-4 Starting Dev
Page 26 and 27: Creating Service ComponentsFigure 3
Page 29 and 30: Defining the Component's Interface!
Page 31 and 32: Defining the Component's InterfaceC
Page 33 and 34: Defining the Component's Interface!
Page 35 and 36: Defining the Component's InterfaceA
Page 37 and 38: Implementing MethodsImplementing Me
Page 39: Implementing MethodsJPL VariablesFi
Page 43 and 44: Sample COM ComponentsProgramming fo
Page 45 and 46: Sample COM ComponentsFor informatio
Page 47 and 48: CHAPTER4 Building ClientScreensIn P
Page 49 and 50: Working with COM ComponentsIf a com
Page 51 and 52: Working with COM Componentsvars wsi
Page 53 and 54: Sample Client ScreensSample Client
Page 55 and 56: Sample Client Screens(Constants.PR_
Page 57 and 58: CHAPTER5 Deploying COMComponentsA C
Page 59 and 60: Steps for DeploymentThe default loc
Page 61 and 62: Registering Components for MTSCreat
Page 63 and 64: Registering Components for MTS4. Ch
Page 65 and 66: Using Database Transactions! sm_mts
Page 67 and 68: APPENDIXACOM/MTS UtilitiesThis chap
Page 69 and 70: APPENDIXBCOM SamplesThe Panther dis
Page 71 and 72: Description of the COM SamplesCalli
Page 76 and 77: Client and Web Application Broker E
Page 78 and 79: # Register the COM component using
Page 81: INDEXIndexAApplication directoryfor
Page 84: IndexI-4 COM/MTS Guide

COM/MTS Guide - Prolifics

Create successful ePaper yourself

Delete template?

Save as template?