Copyright © Cloud Software Group, Inc. All Rights Reserved

Installing the Software

 

You must perform the installation under an ISPF environment only.

This section describes the procedure for installing the Service Gateway for IMS/DB.

You can start the installation if you have the following data sets ready:

•	<HLQ>.INSTALL

•	<HLQ>.IMSDB.XM1

 

You must use the <HLQ>.INSTALL data set that was created during the installation of the TIBCO Object Service Broker base component.

Installation Overview

To install Service Gateway for IMS/DB, perform the following:

1.	Edit the properties file by specifying the keywords for installing this component.

2.	Install the software.

Edit the Properties File

Edit the PROPERTY member in <HLQ>.INSTALL. Table 3 describes keywords in the properties file for installing this component.

 

Table 3 Properties File Keywords

Keyword	Description
INSTALL=	To install Service Gateway for IMS/DB, specify IMSDB: INSTALL=IMSDB
RESLIB=	Fully qualified IMS RESLIB library.

 

Initial Installation

 

STEP 1:	Execute File Tailoring EXEC to start installation.
Member in:	<HLQ>.INSTALL
Member:	INSTALL (EX member)
	The IMSDB.JCL data set is created at the successful completion of this step.
STEP 2:	Run Job IMSDB.JCL.
	This batch job will uncompress the IMSDB.XM1 file to produce the distribution library.
JCL in:	<HLQ>.IMSDB.JCL (Edit JOB card to your site’s standards)
Data Set:	<HLQ>.IMSDB.JCL (SUB data set)
	Uncompressing <HLQ>.IMSDB.XM1 produces the distribution library <HLQ>.IMSDB.FILEI.
STEP 3:	Create and customize work copies of data sets.
Member in:	<HLQ>.IMSDB.FILEI
Member:	S6D1CUST (EX member)
	The following work copies are created and customized with values specified by OSEMOD variables: Customized copy – Library Description • <HLQNONV>.<INSTVER>.JCL – Sample JCL • <HLQNONV>.<INSTVER>.IMSDB.JOBS – Install jobs for IMS/DB
STEP 4:	Initiate install jobs.
Member in:	<HLQNONV>.<INSTVER>.IMSDB.JOBS
Member:	S6D2RUNJ (EX member)
	SEND messages are directed to the userid specified in the NOTIFY parameter of each job submitted, informing user of submission and normal completion or abnormal termination. The successful completion of the final job in JOBSD list is accompanied by the message ALL MEMBERS PROCESSED. This completes the installation process for IMS/DB.
	You can modify the STATUS of any job as per your requirement. For example, if your shop normally ACCEPTs the product FMID at some future time, then change the status of S6D4ACPT from INSTALL to FUTURE. Note that you must ACCEPT the Service Gateway for IMS/DB component before applying any hotfix maintenance using SMP/E.
STEP 5:	Perform APPLY of CICS DL/I (Optional).
	If there is a requirement to run an instance of the Gateway in a CICS Execution Environment, modify the STATUS of job S6D5APLY in member JOBSD from OPTIONAL to INSTALL.
Member in:	<HLQNONV>.<INSTVER>.IMSDB.JOBS
Member:	JOBSD (EDIT member)
Member in:	<HLQNONV>.<INSTVER>.IMSDB.JOBS
Member:	S6D2RUNJ (EX member)
STEP 6:	Perform the final ACCEPT of CICS DL/I (Optional).
	If the standard in your site is to test a product prior to accepting it, leave the original STATUS of job S6D6ACPT as OPTIONAL so the job will not be submitted for execution. When you are ready to accept the Service Gateway for CICS DL/I product, perform the final ACCEPT.
Member in:	<HLQNONV>.<INSTVER>.IMSDB.JOBS
Member:	S6D6ACPT (SUB member)

 

.

Copyright © Cloud Software Group, Inc. All Rights Reserved