Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 6 Installing the Service Gateway for IMS TM : Installing OTMA Support

Installing OTMA Support
IMS TM Open Transaction Manager Access (OTMA) allows access to IMS applications and is supported by TIBCO Object Service Broker. Use of OTMA is discussed in TIBCO Object Service Broker for z/OS External Environments; the underlying rule interface tools are described in TIBCO Object Service Broker Shareable Tools.
Refer to the IBM IMS documentation for configuration guidance; in particular, the IMS V9 OTMA Guide and Reference manual. This document also contains the return codes you may encounter when using the OTMA interface. Pay particular attention to the values specified for the IMS TM started task parameters:
 
Some of these values will have to be specified in calls from TIBCO Object Service Broker to OTMA.
To configure your IMS TM system to support OTMA, apply USERMODF in the CNTL library to link the OTMA interface stub DFSYCRET into S6BDRSES.
A sample rule, SAMPLE_OTMA_CALL, is provided to invoke the IMS sample verification transaction PART. You will need to modify this sample rule to be compatible with the IMS TM started task parameters mentioned above. Specifically, the values in statement 3 of the sample rule must be changed to match your IMS parameters, as follows:
 
CALL @OTMAOPEN('<GRNAME_IMS_parm_value>', MEMBER, '<OTMANM_IMS_parm_value>')
 
The value of the GRNAME parameter should replace <GRNAME_IMS_parm_value> and the value of the OTMANM parameter should replace <OTMANM_IMS_parm_value>.
To verify the interface, run the IBM sample transaction PART under IMS TM. If successful, modify and execute the sample rule as shown above.
 
EX: SAMPLE_OTMA_CALL(USER01)
A successful OTMA call will provide the following output:

 
OTMA error Function=OPEN RC=0 reason1=0 reason2=0 reason3=0 reason4=0
OTMA error Function=ALLO RC=0 reason1=0 reason2=0 reason3=0 reason4=0
OTMA error Function=SEND RC=0 reason1=0 reason2=0 reason3=0 reason4=0
 
          Part........... AN960C10; Desc........... WASHER
          Proc Code...... 74; Inv Code....... 2
          Make Dept...... 12-00; Plan Rev Num...
          Make Time...... 63; Comm Code...... 14
 
OTMA error Function=FREE RC=0 reason1=0 reason2=0 reason3=0 reason4=0
OTMA error Function=CLOS RC=0 reason1=0 reason2=0 reason3=0 reason4=0

 
 
 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved