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


Chapter 6 Installing the Service Gateway for IMS TM : Required System Changes

Required System Changes
The following system changes are required to allow TIBCO Object Service Broker to run.
Allocate the TIBCO Object Service Broker Load Library
The TIBCO Object Service Broker load library must be allocated in the startup JCL for the IMS TM Control Region. Use one of the following methods:
Concatenate it to the existing STEPLIB statement and, if the STEPLIB already points to an APF non-authorized library, include a HRNLIB DD statement that also points to the TIBCO Object Service Broker load library.
See Also
TIBCO Object Service Broker for z/OS External Environments for a definition of the HRNLIB DDname.
Configuring Authorized Libraries for information on making the load library authorized.
Define TIBCO Object Service Broker IMS Transactions
A number of TIBCO Object Service Broker transactions must be defined to IMS. Sample definitions are shown below. Member IMSDCTRN in the ASM data set provides a copy of these definitions.
SPA Size and Transaction Class
Some of the default definitions contain a scratch pad area (SPA) size of 4096. This value must be a minimum of 14 bytes, and the maximum depends on the SPA size of the transactions with which TIBCO Object Service Broker interacts. TIBCO Object Service Broker itself does not update any space within the SPA. Specify a value appropriate for your site.
A transaction class of 2 is specified by default. Specify a transaction class appropriate for your site.
Mixed Case Data Input
Customers who require data input at IMS TM terminals to be saved in uppercase and lowercase must specify EDIT=ULC on the TRANSACT macro to avoid possible data translation problems.
Sample Transactions Defined to IMS
The definitions in sample member IMSDCTRN fall into three basic categories:
The first section defines the conversational and non-conversational transactions that resume TIBCO Object Service Broker in an MPR.
The second section defines PSB names that start with S6BIMS. These definitions use the IMS TM environment ID as the TIBCO Object Service Broker login ID.
The last section defines PSB names that start with S6BIMT. These definitions use the IMS TM environment transaction ID as the TIBCO Object Service Broker login ID.
Create PSBs
Create PSBs to define each TIBCO Object Service Broker program to run in the IMS MPR. Refer to member IMSDCPSB in the ASM data set for a source copy of these definitions.
Build ACBs
Run the IMS utility to build the ACBs, using the PSBs just created.
Authorize Library
The following are required to use Cross Memory Services:
The Supervisor Call (SVC) parameter must be specified in the PARMDC IMS TM Execution Environment initialization parameter member in the CNTL data set.
If you want to run with Cross Memory Services and the MPR’s STEPLIB DD concatenation is not authorized, the TIBCO Object Service Broker load library must be allocated in the MPR’s JCL with a HRNLIB DD statement.
Modify and Compile the Sample IMS Logon Format Panel
The XIDCMFS0 member in the CNTL data set provides a sample TIBCO Object Service Broker IMS logon panel defined using IMS Message Format Services. Modify the sample as required and compile it with the Message Format Service utilities provided with your IMS system. Store it in your IMS FORMAT library. To use the sample logon panel, type:
/FOR HURON:
After entering this command, the screen named TIBCO Object Service Broker appears. The user is then able to type in their TIBCO Object Service Broker user ID, password, and session parameters.
Enable Printing from IMS TM
To print output generated from an IMS TM Execution Environment, modify the @SCHEDULEMODEL(MVS,SPOOLSTRIP) table instance as explained in Customization of the TIBCO Object Service Broker @SCHEDULEMODEL Table.

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