Provide the following information for the annotations to be generated:
Full path to a j2ee.jar file in the @LIB annotation
Host address
Port number from a CITA configuration
Name of one transaction on the 2200 host
Class name for the connection class and the transaction classes that will be generated (optional)
@LIB (
OS2200Path = "string", Location of OS2200.Jar
J2EEPath="string"); Location of J2EE.jar: for example, J2EE.jar, jboss-j2EE.jar
where:
OS2200Path is the full path specification of the OS2200.jar file to be used to build this project. Default = Path to the copy of OS2200.jar carried in the CA feature.
J2EEPath is the full path specification of a jar file compliant with Java connector specification. Default = Path to the copy of Connector-api-j2ee.jar carried in the CA feature.
@TIP (
classname="string", User-specified name of generated class (optional)
host="string", IP address of the host
port= int, Port number of configured in CITA configuration
factory="string", Name on connection factory in App Server (needed in JBoss AS)
transactions={@Transaction(,..)}; List of transactions for this port
@Transaction (
classname="string", User-specified name of generated class (optional)
name="string", Name of transaction being invoked
view="string"); Name of the view being invoked in the transaction
where:
host is the name of the host. This must be an IP address or host name, sufficient to establish a network connection to the host.
port is an integer specifying the port number that is configured in CITA through which transactions on the host are invoked. For more information, see Communications Interface for Transaction Applications Configuration and Operations Guide (7862 6470).
factory is the name by which the connection factory will be located. You need to specify this when running the TIP connector from an application server such as JBoss Application Server.
classname (optional) is a name to be assigned to the class supporting this connection. Default = ConnHostPort, where Host and Port are the parameters specified previously.
transactions is a comma-separated list of annotations, as described below.
@Transaction (
classname="string", User-specified name of generated class (optional)
name="string", Name of transaction being invoked
view="string"); Name of the view being invoked in the transaction
where:
name is the transaction name being invoked on the 2200.
view is the name of the View the transaction expects on the call, if any. Omit the field if no view is expected.
classname (optional) is a name to be assigned to the class supporting this transaction. Default = TransName, where Name is the parameter specified previously.
@LIB(
OS2200Path="D:/2200IDE/OS2200.jar",
J2EEPath="c:/sun/appserver/lib/j2ee.jar"
)
@TIP(host="rs02fe",
port=2700,
classname="Freshman",
transactions={@Transaction(name="TW01",view="EMP_BUF"),
@Transaction(classname="TransTwo",
name="TW02",view="EMP_BUF2")}
)
In this example, the j2ee.jar file comes from a Sun application server, the 2200 host name is rs02fe, and the configured CITA port is 2700. The Freshman connection class will be generated and two transactions will be accessed through this connection: TW01 and TW02, with views EMP_BUF and EMP_BUF2, respectively. The TransTW01 class is generated for TW01 and the TransTwo class is generated for TW02.
@LIB(
OS2200Path="D:/2200IDE/OS2200.jar",
J2EEPath="c:/sun/appserver/lib/j2ee.jar"
)
@TIP(host="rs02fe",
port=2700,
classname="Freshman",
factory="java:/eis/UNISYS_EIS_11_0/ConnectionFactory",
transactions={@Transaction(name="TW01",view="EMP_BUF"),
@Transaction(classname="TransTwo",name="TW02",view="EMP_BUF2")}
)
These entries will have the same results, except the connection will be made using the factory specification indicated rather than by generating an unmanaged connection factory. Get this information from your administrator and see the section on using OS 2200 Connector with JBoss in J2EE™ Connector for OS 2200 Transactions User's Guide (4729 1992).
@LIB(
OS2200Path="D:/2200IDE/OS2200.jar",
J2EEPath="D:/jboss-4.0.2/server/default/lib/jboss-j2ee.jar"
)
@TIP(host="rs02fe",
port=2700,
factory="java:/eis/UNISYS_EIS_11_0/ConnectionFactory",
transactions={@Transaction(name="Transit")}
)
In this example, the j2ee library comes from a JBoss Application Server. The Connrs02fe2700 connection class will be generated, and the connection factory will be used to generate the connection. Only one transaction, Transit, is specified for the connection and it has no view. The TransTransit class will be generated for it.
For examples of using the generated connector classes, see Using the Generated Connector Classes.