Claims
- 1. An apparatus for accessing a database management system, comprising:
(a) a Connector, executed by a computer, for interfacing an application program to a database management system (DBMS), (b) wherein the DBMS includes an Open Transaction Manager Access (OTMA) that provides an application programming interface (API) for the application program to access the DBMS and its datastores, and the OTMA allows the application program to create an authorized connection with the DBMS, (c) wherein the Connector includes one or more objects for establishing a connection between the application program and the OTMA, for transmitting transactions from the application program to the DBMS over the established connection between an application program and the OTMA, and for receiving results of the transactions from the DBMS to the application program over the established connection between an application program and the OTMA, and (d) wherein the objects include a Connection Spec bean representing the connection between the application program and the TOC, as well as the DBMS and its datastores, and an Interaction Spec bean representing the type of interaction that the application program has with the TOC, as well as the DBMS and its datastores.
- 2. The apparatus of claim 1, wherein the Connector establishes a connection between the application program and the OTMA via a TCP/IP OTMA Connection (TOC).
- 3. The apparatus of claim 2, wherein the Connector comprises a TOC Connector for Java.
- 4. The apparatus of claim 3, wherein the Connection Spec bean provides information about connection management between the application program and the TOC, as well as the DBMS.
- 5. The apparatus of claim 4, wherein the Connection Spec bean provides information about a TCP/IP connection between the application program and the TOC, as well as the DBMS.
- 6. The apparatus of claim 4, wherein the Connection Spec bean provides information selected from a group comprising:
a TCP/IP hostname of a server computer, and a Port number associated with the DBMS.
- 7. The apparatus of claim 3, wherein the Interaction Spec bean provides information about the interaction between the application program and the TOC, as well as the OTMA and DBMS.
- 8. The apparatus of claim 7, wherein the Interaction Spec bean provides information selected from a group comprising:
a Datastore Name that identifies a name of the datastore, an LTerm Name that identifies a name of a logical terminal, a Map Name that identifies output from a transaction, a Mode that identifies a type of interaction to be carried out between the application program and the DBMS, a Sync Level that specifies a transaction synchronization level between the application program and the DBMS.
- 9. The apparatus of claim 3, wherein the TOC Connector for Java further comprises one or more of the objects selected from a group comprising:
a Communication bean representing the communications between the application program and the TOC, as well as the DBMS and its datastores, a Logon Info bean representing logon information for the duration of a session between the application program and the TOC, as well as the DBMS and its datastores, and at least one bean for processing potential error messages returned from the DBMS to the application program.
- 10. The apparatus of claim 9, wherein the error messages are DFS messages.
- 11. The apparatus of claim 9, wherein the a plurality of beans for error messages are used to handle differently formatted error messages.
- 12. The apparatus of claim 1, wherein the application program includes one or more of the objects selected from a group comprising:
a Record Selector bean that discriminates between normal input/output messages and error messages, an Input Message bean representing the input to the transaction, and an Output Message bean representing the output from the transaction.
- 13. The apparatus of claim 12, wherein Input Message bean is generated from one or more COBOL source files that contain definitions of the transactions.
- 14. The apparatus of claim 12, wherein Output Message bean is generated from one or more COBOL source files that contain definitions of the transactions.
- 15. A method for accessing a database management system, comprising:
(a) interfacing an application program to a database management system (DBMS) using a Connector executed by a computer, (b) wherein the DBMS includes an Open Transaction Manager Access (OTMA) that provides an application programming interface (API) for the application program to access the DBMS and its datastores, and the OTMA allows the application program to create an authorized connection with the DBMS, (c) wherein the Connector includes one or more objects for establishing a connection between the application program and the OTMA for transmitting transactions from the application program to the DBMS over the established connection between an application program and the OTMA, and for receiving results of the transactions from the DBMS to the application program over the established connection between an application program and the OTMA, and (d) wherein the objects include a Connection Spec bean representing the connection between the application program and the TOC, as well as the DBMS and its datastores, and an Interaction Spec bean representing the type of interaction that the application program has with the TOC, as well as the DBMS and its datastores.
- 16. The method of claim 15, wherein the Connector establishes a connection between the application program and the OTMA via a TCP/IP OTMA Connection (TCC).
- 17. The method of claim 16, wherein the Connector comprises a TOC Connector for Java.
- 18. The method of claim 17, wherein the Connection Spec bean provides information about connection management between the application program and the TOC, as well as the DBMS.
- 19. The method of claim 18, wherein the Connection Spec bean provides information about a TCP/IP connection between the application program and the TOC, as well as the DBMS.
- 20. The method of claim 18, wherein the Connection Spec bean provides information selected from a group comprising:
a TCP/IP hostname of a server computer, and a Port number associated with the DBMS.
- 21. The method of claim 17, wherein the Interaction Spec bean provides information about the interaction between the application program and the TOC, as well as the OTMA and DBMS.
- 22. The method of claim 21, wherein the Interaction Spec bean provides information selected from a group comprising:
a Datastore Name that identifies a name of the datastore, an LTerm Name that identifies a name of a logical terminal, a Map Name that identifies output from a transaction, a Mode that identifies a type of interaction to be carried out between the application program and the DBMS, a Sync Level that specifies a transaction synchronization level between the application program and the DBMS.
- 23. The method of claim 17, wherein the TOC Connector for Java further comprises one or more of the objects selected from a group comprising:
a Communication bean representing the communications between the application program and the TOC, as well as the DBMS and its datastores, a Logon Info bean representing logon information for the duration of a session between the application program and the TOC, as well as the DBMS and its datastores, and at least one bean for processing potential error messages returned from the DBMS to the application program.
- 24. The method of claim 23, wherein the error messages are DFS messages.
- 25. The method of claim 23, wherein the a plurality of beans for error messages are used to handle differently formatted error messages.
- 26. The method of claim 15, wherein the application program includes one or more of the objects selected from a group comprising:
a Record Selector bean that discriminates between normal input/output messages and error messages, an Input Message bean representing the input to the transaction, and an Output Message bean representing the output from the transaction.
- 27. The apparatus of claim 26, wherein the Input Message bean is generated from one or more COBOL source files that contain definitions of the transactions.
- 28. The apparatus of claim 26, wherein the Output Message bean is generated from one or more COBOL source files that contain definitions of the transactions.
- 29. At least one article of manufacture embodying an apparatus for accessing a database management system, the apparatus comprising:
(a) a Connector, executed by a computer, for interfacing an application program to a database management system (DBMS), (b) wherein the DBMS includes an Open Transaction Manager Access (OTMA) that provides an application programming interface (API) for the application program to access the DBMS and its datastores, and the OTMA allows the application program to create an authorized connection with the DBMS, (c) wherein the Connector includes one or more objects for establishing a connection between the application program and the OTMA, for transmitting transactions from the application program to the DBMS over the established connection between an application program and the OTMA, and for receiving results of the transactions from the DBMS to the application program over the established connection between an application program and the OTMA, and (d) wherein the objects include a Connection Spec bean representing the connection between the application program and the TOC, as well as the DBMS and its datastores, and an Interaction Spec bean representing the type of interaction that the application program has with the TOC, as well as the DBMS and its datastores.
- 30. The method of claim 29, wherein the Connector establishes a connection between the application program and the OTMA via a TCP/IP OTMA Connection (TOC).
- 31. The method of claim 30, wherein the Connector comprises a TOC Connector for Java.
- 32. The method of claim 31, wherein the Connection Spec bean provides information about connection management between the application program and the TOC, as well as the DBMS.
- 33. The method of claim 32, wherein the Connection Spec bean provides information about a TCP/IP connection between the application program and the TOC, as well as the DBMS.
- 34. The method of claim 32, wherein the Connection Spec bean provides information selected from a group comprising:
a TCP/IP hostname of a server computer, and a Port number associated with the DBMS.
- 35. The method of claim 31, wherein the Interaction Spec bean provides information about the interaction between the application program and the TOC, as well as the OTMA and DBMS.
- 36. The method of claim 35, wherein the Interaction Spec bean provides information selected from a group comprising:
a Datastore Name that identifies a name of the datastore, an LTerm Name that identifies a name of a logical terminal, a Map Name that identifies output from a transaction, a Mode that identifies a type of interaction to be carried out between the application program and the DBMS, a Sync Level that specifies a transaction synchronization level between the application program and the DBMS.
- 37. The method of claim 31, wherein the TOC Connector for Java further comprises one or more of the objects selected from a group comprising:
a Communication bean representing the communications between the application program and the TOC, as well as the DBMS and its datastores, a Logon Info bean representing logon information for the duration of a session between the application program and the TOC, as well as the DBMS and its datastores, and at least one bean for processing potential error messages returned from the DBMS to the application program.
- 38. The method of claim 37, wherein the error messages are DFS messages.
- 39. The method of claim 37, wherein the a plurality of beans for error messages are used to handle differently formatted error messages.
- 40. The method of claim 29, wherein the application program includes one or more of the objects selected from a group comprising:
a Record Selector bean that discriminates between normal input/output messages and error messages, an Input Message bean representing the input to the transaction, and an Output Message bean representing the output from the transaction.
- 41. The apparatus of claim 40, wherein the Input Message bean is generated from one or more COBOL source files that contain definitions of the transactions.
- 42. The apparatus of claim 40, wherein the Output Message bean is generated from one or more COBOL source files that contain definitions of the transactions.
CROSS-REFERENCE TO RELATED APPLICATION
[0001] This application is related to the following co-pending and commonly-assigned patent applications:
[0002] U.S. patent application Ser. No. ______, entitled “SYSTEM MESSAGE OBJECTS FOR COMMUNICATING BETWEEN AN APPLICATION AND A DATABASE MANAGEMENT SYSTEM”, filed on same date herewith, by Haley Fung, Judith E. Hill, and Steve T. Kuo, attorneys' docket number ST9-99-067;
[0003] U.S. patent application Ser. No. 09/342,010, entitled “APPLICATION PROGRAMMING INTERFACE FOR CREATING AUTHORIZED CONNECTIONS TO A DATABASE MANAGEMENT SYSTEM”, filed by Gerald L. Carpenter, Richard D. Housh, Steve T. Kuo, Bruce E. Naylor, Richard L. Stone, and Jack C. Yuan, on Jun. 28, 1999, attorneys' docket number ST9-99-014;
[0004] which applications are incorporated by reference herein.