| Using XMLink Universal Gateway | |
This appendix describes changes made from previous releases of XMLink Universal Gateway.
- As of Version 2.2, there is a new
EJBdelivery agent. With this delivery agent, you can interact with the business logic EJBs directly, without using SOAP, Web services, or the Gateway Adapter EJB. With this delivery agent, you also need theEJBServices.xmlfile which contains the service information.
If a field list is provided for a
TuxedoInputTypeofFMLorFML32(even an empty list), input data passed to the delivery agent will be restricted to the fields listed, without warning. Otherwise, whatever fields are present in the input data will be passed to the delivery agent.Similarly, for a
TuxedoOutputTypeofFMLorFML32, if a field list is provided, only fields listed will be returned to the Tuxedo client. Otherwise, if the output data contains named parameters for aTuxedoOutputTypeofFMLorFML32, an attempt will be made to use those names as Tuxedo field names for the output data. If the output data forFMLorFML32does not contain named parameters, the first field name listed for theTuxedoOutputTypewill be used. In this case, if no field list is provided a default field name ofreturnwill be used, or, if an empty field list is provided, no data will be returned.
- If you are upgrading from Version 1.0 or Version 2.0, the following changes have been implemented:
- Data Translation and Validation
request.xsdandresponse.xsd, the schemas used to transform XML data passing between the Tuxedo server and the EIS server, are now included in theconfigdirectory.- Tuxedo Services File
- As of Version 2.1, the default name of the Tuxedo service definition file (previously
Services.xml) was changed toTuxedoServices.xml.
- The name of the
ServiceListelement was changed totuxedo-service-registry.- SOAP Services File
- As of Version 2.1, the default name of the SOAP services definition file (previously
services.xml) was changed toSoapServices.xml.- Java System Properties
XUG.GatewayAdapter.JNDIName- The default JNDI lookup name for the Gateway Adapter EJB has been updated to:
com/prolifics/xug/dda/adapter/GatewayAdapterHomeXUG.TuxedoServices- For the Tuxedo service definition file, the name of the Java system property was changed from
XUG.TuxedoRegistryFiletoXUG.TuxedoServices.Its default value has been changed fromServices.xmltoTuxedoServices.xml.XUG.SoapServices- For the SOAP service definition file, the name of the Java system property was changed from
XUG.ServicestoXUG.SoapServices.Its default value has been changed fromservices.xmltoSoapServices.xml.
- Specifying FML Formats
- In Version 1.0, the FML results were configured in the files set by
FIELDTBLSandFIELDTBLS32. XMLink Universal Gateway needed the following to be included:# name number type flags comments
XMLINK_SHORT_RESULT 200 short - -
XMLINK_LONG_RESULT 201 long - -
XMLINK_CHAR_RESULT 202 char - -
XMLINK_FLOAT_RESULT 203 float - -
XMLINK_DOUBLE_RESULT 204 double - -
XMLINK_STRING_RESULT 205 string - -As of Version 2.0, this specification was no longer necessary since the FML results are specified in the Tuxedo service definition file.
- Java Environment
- As of Version 2.0, make the following changes to the
CLASSPATHon the Tuxedo server: