Creating a TIP RA Project

You can perform a TIP transaction by mapping the underlying COBOL record which is used for the transaction into a Java object using Eclipse. Import TIP Records wizard generates a set of Java helper classes based on the information provided in the COBOL or View file.

TIP RA implementation is based on the DTP RA for Java platform. For more information on DTP RA, refer to the following documents:

• Open Distributed Transaction Processing Programming Guide (7833 5049-008)

• Open Distributed Transaction Processing Resource Adapter for the Java Platform Studio Help (3827 9295-004)

• Open Distributed Transaction Processing Resource Adapter for the Java Platform User’s Guide (7833-5056-006)

Prerequisite

You must have the following information for configuring a TIP transaction using the TIP RA configuration wizard:

• OS 2200 Host details

• CITA Port Number
  For more information on CITA, see Communications Interface for Transaction Applications Configuration and Operations Guide (7862 6470).

• TIP Transaction Name

• COBOL/View file used for compiling the transaction

To create a TIP RA project

1. From the OS 2200 menu, select OS 2200 Resource Adapters, and then click Add TIP RA ().
   
   The Import TIP Records wizard appears.

2. In the Computer Name/IP Address box, enter the address of the OS 2200 host.

3. In the CITA Port Number box, enter the configured CITA port number.

4. In the Transaction Name box, enter the configured transaction name for executing the transaction.

5. Under Record Source Type, select any one of the following options:

   • COBOL

   • View

   The OS 2200 Eclipse IDE generates Java objects for the specified record type.

6. Under Record Source Location, do any one of the following:

• Click Browse Workspace to open the source file from your workspace or press Alt+W.
  
  The Select Record Source File from Workspace dialog box appears.

• Click Browse File System to open the source file from your system or press Alt+F.
  
  The Open dialog box appears.

7. Browse and specify the source file containing the COBOL or View records.

8. Click Next.
   
   A list displays the records that can be imported.

9. Select the check boxes corresponding to the records to be imported.
   
   The details of the selected record is displayed in the right pane.

10. Click Next.
    
    The list of the imported records appears.

11. Edit the imported records, if required and then click Next. You can also add the following validations for a String variable in this step.

• Trim white space: Trims the leading and trailing white space characters from the string.

• Retain white space: Retains the leading and trailing white space characters from the string.

• Truncate overflow: Truncates the string to the field size.

• Error on overflow: Displays an error if the string length is longer than the length of the field size.

• Send white space for null value: Sends the string of space characters if the value of the string is null.

• Error for null value: Displays an error if the value of the string is null.

• Justify left (available only for View records): Inserts white space characters to the right of the string so that the string length is equal to the length of the field size. This validation is applicable only for Open DTP transactions.

• Justify right (available only for View records): Inserts white space characters to the left of the string so that the string length is equal to the  field size. This validation is applicable only for Open DTP transactions.

Note: You cannot edit the records of a View file.

12. Enter the details required to generate the Java custom record(s) and then click Next.

Note: The COBOL variable names are not validated for Java Keywords while generating the Java files from the COBOL or View files. If you use the Java keywords as variable names, the compilation error appears.

13. Click Finish.
    
    The following tasks are done by OS 2200 IDE for Eclipse:

    • Java buffer classes are generated and these classes act as a buffer class for storing the transaction output.

    • TipTransaction.java file is generated and can be used to test the transactions.

    • ra.xml is generated and can be used to configure the OS 2200 host and CITA port dynamically.

    • DTP RA Buffer classes are generated and these classes can be used for running the DTP transactions.