2 Installing Oracle Connect for IMS, VSAM, and Adabas Gateways

Hardware Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways

Table 2-1 lists the hardware requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways.

Software Requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways

Table 2-2 lists the software requirements for Oracle Connect for IMS, VSAM, and Adabas Gateways.

^Footnote 1 Oracle certifies its connectivity with the versions listed explicitly. Backward compatibility of higher versions relies on SoftwareAG's backward compatibility policies.

Downloading Oracle Software from the Oracle Technology Network Web Site

This section describes how to download the installation archive files and extract them on your hard disk. It contains the following topics:

• Downloading the Installation Archive File

• Extracting the Installation Files

Copying the Oracle Software to a Hard Disk

Before installing Oracle Connect for IMS, VSAM, and Adabas Gateways, you might want to copy the software to the hard disk. This enables the installation process to run a bit faster. Before copying the installation media content to the hard disk, you must mount the installation media. The following section describes how to mount discs and copy their content to the hard disk.

Installation Worksheet

Verify that you have all the information detailed in Table 2-3 so you can refer to it during the configuration process.

Preinstallation Instructions

Before starting the installation, make sure that you have the following information available:

• The output class for the installation output if you do not want to use the default value A.

• If you use SMS to manage all datasets, then you cannot provide unit and volume information, which is the unit where SMS is located.

Before starting the installation, make sure that you have the following permissions:

• Permission to define an APF-authorized library.

• Permission to write to an active proclib, such as user.proclib.

• Permission to read the CICS EXCI library when accessing data under CICS.

• Permission to update the security manager, such as RACF.

• Optionally, permission to specify an output class for Oracle Connect for IMS, VSAM, and Adabas Gateways output. Assigning a device that is set on HOLD prevents the loss of log information when the started tasks of Oracle Connect for IMS, VSAM, and Adabas Gateways finish.

Oracle Connect for IMS, VSAM, and Adabas Gateways for the IBM z/OS platform is included in the following datasets:

• [INSTROOT].TRANSMIT.KIT

• [INSTROOT].TRANSMIT.LOAD

where INSTROOT is the high-level qualifier of the installation, such as AC10131.

Kit Installation Instructions

Perform the following on the mainframe:

1. Run the following command:

   tso profile noprefix
   

   The user name will not be used as part of the dataset name. On some systems this is the default.

2. Allocate datasets with the following space for each of these files:

   • [INSTROOT].TRANSMIT.KIT = 130 tracks (3380 and 3390 disks)

   • [INSTROOT].TRANSMIT.LOAD = 500 tracks (3380 and 3390 disks)

   For each dataset: RECFM=FB and LRECL=80. The block size is 3120.

Installation Instructions

Perform the following steps to install Oracle Connect for IMS, VSAM, and Adabas Gateways:

1. From within TSO, run the following command at the TSO prompt:

   RECEIVE INDSNAME('INSTROOT.TRANSMIT.KIT')
   

   where INSTROOT represents the high-level qualifier you want to assign to the Oracle Connect for IMS, VSAM, and Adabas Gateways installation. The default value is AC10131.

   Note:

   You can use more than one high-level qualifier (such as ACME.DEV.AC10131) with the following conditions:

   • The total length must be less than twenty characters.

   • The words transmit and buildkit cannot be used as high-level qualifiers.

2. Enter the following command when prompted for the restore parameters:

   da('INSTROOT.TRANSMIT.LIB') [UNIT (unit), VOLUME (volume)]
   

   This extracts the INSTROOT.TRANSMIT.LIB library from the INSTROOT.TRANSMIT.KIT kit to the specified unit and volume. If a unit and volume are not specified, the library is extracted to the current unit and volume.

3. Run the PREPARE member of the [INSTROOT].TRANSMIT.LIB library:

   ex PREPARE
   

   Follow the instructions in the Response column in Table 2-4 for each entry in the Screen column.

   Table 2-4 Installation Prepare Job Prompts and Responses

   Screen	Response
   DO YOU WANT TO USE SMS MANAGED STORAGE FOR THIS INSTALLATION Y/N [N]:	If you want to manage the storage using SMS, answer Y, otherwise answer N.
   ENTER THE STORCLASS FOR INSTALLATION TEMP DATASETS [ ]:	This prompt is displayed only if SMS is used to manage the installation (you answered Y to the first prompt). Enter the storage class
   ENTER THE UNIT NAME FOR INSTALLATION TEMP DATASETS [3390]:	If a storage class is not specified, then enter the unit name for temporary datasets used during the installation procedure
   ENTER THE VOLUME NAME FOR INSTALLATION TEMP DATASETS:	This prompt is displayed only if SMS is not used to manage the installation (you answered N to the first prompt). The volume name for temporary datasets used during the installation procedure
   ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:	Enter the output class only if you do not want the default class used (the default is A)
   DO YOU WANT TO USE THE DEFAULT JOB CARD Y/N [Y]:	A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input. If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.
   DO YOU WANT TO PERFORM A MANUAL (M) OR AUTOMATIC (A) INSTALLATION [A]:	If you want to review the JCL used to install Oracle Connect for IMS, VSAM, and Adabas Gateways before it is submitted, then respond M for a manual installation.
   PLEASE REVIEW AND SUBMIT FOR EXECUTION THE HLQ.TRANSMIT.LIB(INSTJO)	This prompt is displayed only if a manual installation is requested (you answered M to the previous prompt).

   
   

   The following libraries are generated:

   INSTROOT.BUILDKIT.LOAD
   INSTROOT.BUILDKIT.SRC
   INSTROOT.BUILDKIT.GENDEMO
   

   Where INSTROOT is the high-level qualifier you assigned in step 0.

4. In the INSTROOT.BUILDKIT.SRC library, run the NAVINST member:

   ex NAVINST
   

   Follow the instructions in the Response column in Table 2-5 for each entry in the Screen column.

   Table 2-5 Installation Prompts and Responses

   Screen	Response
   DO YOU WANT TO USE SMS MANAGED STORAGE FOR THIS INSTALLATION Y/N [N]:	If you want to manage the storage using SMS, then answer Y, otherwise answer N.
   THE SOFTWARE WILL BE INSTALLED UNDER THE HIGH LEVEL QUALIFIER THAT YOU WILL CHOOSE. ENTER THE HIGH LEVEL QUALIFIER ["QUALIFIER"]:	This prompt is displayed only if SMS is used to manage the installation (you answered Y to the first prompt). The high-level qualifier for the installation (referred to as INSTROOT throughout this guide). You can use more than one high-level qualifier (such as ACME.DEV.VA10). The total length must be less than or equal to twenty characters. The qualifiers can be the same as the ones used for the installation (step 0). The words "transmit" and "buildkit" cannot be used as high-level qualifiers.
   ENTER THE STORCLASS FOR TEMP DATASETS ['STORCLASS']:	This prompt is displayed only if SMS is used to manage the installation (you answered Y to the first prompt). Enter the storage class.
   ENTER THE UNIT NAME FOR INSTALLATION TEMP DATASETS [3390]:	The unit name for temporary datasets used during the installation procedure.
   ENTER THE VOLUME NAME FOR INSTALLATION TEMP DATASETS:	This prompt is displayed only if SMS is not used to manage the installation (you answered N to the first prompt). The volume name for temporary datasets used during the installation procedure.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:	Enter the output class for Oracle Connect for IMS, VSAM, and Adabas Gateways output. Assigning a device that is set on HOLD prevents the loss of log information when the Oracle Connect for IMS, VSAM, and Adabas Gateways started tasks finish (the default is A).
   ADDING AND UPDATING ORACLE CONNECT CONFIGURATION ON THIS MACHINE, FROM A REMOTE ORACLE ADMINISTRATION CONSOLE, CAN ONLY BE DONE BY SOMEONE DEFINED AS AN ADMINISTRATOR FOR ORACLE CONNECT ON THIS MACHINE. ENTER A VALID USER NAME FOR AN ORACLE CONNECT ADMINISTRATOR [ALL]:	To manage Oracle Connect for IMS, VSAM, and Adabas Gateways on this computer from Oracle Studio for IMS, VSAM, and Adabas Gateways, you need to enter a user account of a user who will have administrative authorization, or press Enter to enable any user to administer Oracle Connect for IMS, VSAM, and Adabas Gateways on this computer. The administrative rights can be changed from within Oracle Studio for IMS, VSAM, and Adabas Gateways after the installation.
   DO YOU WANT TO USE THE DEFAULT JOB CARD Y/N [Y]	A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input. If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.
   DO YOU WANT TO PERFORM A MANUAL (M) OR AUTOMATIC (A) INSTALLATION [A]:	If you want to review the JCL used to install Oracle Connect for IMS, VSAM, and Adabas Gateways, before it is submitted, then respond M for a manual installation.
   PLEASE REVIEW AND SUBMIT FOR EXECUTION THE DSN1 (INSTJBOR)	This prompt is displayed only if a manual installation is requested (you answered M to the previous prompt). DSN1 is the dataset name where INSTJBOR is located.

   
   

Data Source Configuration Instructions

Perform the following steps to configure the different data sources:

1. In the INSTROOT.BUILDKIT.SRC library, run the following command:

   ex CUSTOCL

2. Follow the instructions on the screen.

   See Table 2-6 for installation prompts and responses when configuring the VSAM data source.

   See Table 2-7 for installation prompts and responses when configuring the IMS/DB data source.

   See Table 2-8 for installation prompts and responses when configuring the Adabas data source.

   Table 2-6 VSAM Gateway-Specific Installation Prompts and Responses

   Screen	Response
   ORACLE CONNECT ADAPTERS CUSTOMIZATION HLQ IS [TEST.OR5021]:	Specify the high-level qualifier of the installation.
   DO YOU WANT ORACLE CONNECT TO WORK WITH ADABAS (YES/NO) [YES]:	Answer NO to this prompt.
   DO YOU WANT ORACLE CONNECT TO WORK WITH IMS/DB (YES/NO) [NO]:	Answer NO to this prompt.
   DO YOU WANT ORACLE CONNECT TO WORK WITH CICS APP ADAPTER (YES/NO) [YES]:	Answer NO to this prompt.
   THE VSAM DRIVER IS INSTALLED AUTOMATICALLY. DO YOU ALSO WANT ORACLE CONNECT TO WORK WITH VSAM UNDER CICS (YES/NO) [NO]:	If you want to access VSAM data under CICS, answer YES to this prompt.
   ENTER THE CICS EXCI LOAD LIBRARY NAME [CICSTS13.CICS.SDFHEXCI]:	This prompt is displayed only if you answered YES to the previous prompt. Enter the EXCI LOAD library name only if you do not want to use the default.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   ENTER THE ISPF LOAD LIBRARY NAME [ISP.SISPLOAD]:	Enter the ISPF load library name only if you do not want to use the default.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:	Enter the output class character for the job automatically generated for the installation process.
   DO YOU WANT TO USE THE DEFAULT JOB CARD (Y/N) [Y]:	A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input. If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.

   
   

   Table 2-7 IMS/DB Gateway-Specific Installation Prompts and Responses

   Screen	Response
   ORACLE CONNECT ADAPTERS CUSTOMIZATION HLQ IS:	Specify the high-level qualifier of the installation.
   DO YOU WANT ORACLE CONNECT TO WORK WITH ADABAS (YES/NO) [YES]:	Answer NO to this prompt.
   DO YOU WANT ORACLE CONNECT TO WORK WITH IMS/DB (YES/NO) [NO]	Answer YES to this prompt.
   ENTER DBD LIBRARY NAME [IMS.DBDLIB]:	Enter the IMS DBD library name for IMS on your system only if you do not want to use the default.
   ENTER PSB LIBRARY NAME [IMS.PSBLIB]:	Enter the IMS PSB library name for IMS on your system only if you do not want to use the default.
   ENTER RES LIBRARY NAME [IMS.SDFRESL]:	Enter the IMS RES library name for IMS on your system only if you do not want to use the default.
   ENTER PROC LIBRARY NAME [IMS.PROCLIB]:	Enter the IMS PROC library name for IMS on your system only if you do not want to use the default.
   ENTER PGM LIBRARY NAME [IMS.PGMLIB]	Enter the IMS PGM library name for IMS on your system only if you do not want to use the default.
   ENTER YOUR PSB NAME [HOSPPSB]:	Enter the PSB name only if you do not want to use the default.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   DO YOU WANT ORACLE CONNECT TO WORK WITH CICS TO ACCESS IMS/DB OR VSAM (YES/NO) [NO]:	If you want to access IMS/DB data under CICS, answer YES to this prompt.
   ENTER THE CICS EXCI LOAD LIBRARY NAME [CICSTS13.CICS.SDFHEXCI]:	This prompt is displayed only if you answered YES to the previous prompt. Enter the EXCI LOAD library name only if you do not want to use the default.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   DO YOU WANT ORACLE CONNECT SERVER TO WORK WITH CICS APP ADAPTER (YES/NO) [YES]:	Answer NO to this prompt.
   ENTER THE ISPF LOAD LIBRARY NAME [ISP.SISPLOAD]:	Enter the ISPF load library name only if you do not want to use the default.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:	Enter the output class character for the job automatically generated for the installation process.
   DO YOU WANT TO USE THE DEFAULT JOB CARD (Y/N) [Y]:	A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input. If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.

   
   

   Table 2-8 Adabas Gateway-Specific Installation Prompts and Responses

   Screen	Response
   ADAPTERS CUSTOMIZATION HLQ IS:	Specify the high-level qualifier of the installation.
   DO YOU WANT ORACLE CONNECT TO WORK WITH ADABAS (YES/NO) [NO]:	Answer YES to this prompt.
   ENTER THE ADABAS SVC NUMBER [249]:	Enter the SVC number only if you do not want to use the default number.
   ENTER THE ADABAS DATABASE NUMBER:	Enter the number of the Adabas database.
   ENTER THE ADABAS LOAD LIBRARY NAME [ADA622.LOAD]:	Enter the Adabas load library name only if you do not want to use the default library.
   ENTER THE UNIT FOR ADABAS LOAD LIBRARY [3390]:	Enter the unit only if you do not want to use the default library. The unit to use is the number that you prepared during the preinstallation.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   DO YOU WANT ORACLE CONNECT TO WORK WITH IMS/DB (YES/NO) [YES]:	Answer NO to this prompt.
   DO YOU WANT ORACLE CONNECT TO WORK WITH CICS APP ADAPTER (YES/NO) [YES]:	Answer NO to this prompt.
   THE VSAM DRIVER IS INSTALLED AUTOMATICALLY. DO YOU ALSO WANT ORACLE CONNECT TO WORK WITH VSAM UNDER CICS (YES/NO) [NO]:	Answer NO to this prompt.
   ENTER THE ISPF LOAD LIBRARY NAME [ISP.SISPLOAD]:	Enter the ISPF load library name only if you do not want to use the default.
   PLEASE CONFIRM (YES/NO/QUIT) [YES]:	Confirm the entered details.
   ENTER THE OUTPUT CLASS FOR INSTALLATION OUTPUT [A]:	Enter the output class character for the job automatically generated for the installation process.
   DO YOU WANT TO USE THE DEFAULT JOB CARD (Y/N) [Y]:	A job card is displayed. If you want to use a replacement card, then it must be entered as it will appear in the job. You can enter up to six lines. Enter a blank card to end input. If you do not enter a card, then the Oracle Connect for IMS, VSAM, and Adabas Gateways default card is used.

   
   

The installation is completed. All JCL jobs and REXX procedures are included in the INSTROOT.USERLIB library. INSTROOT is the high-level qualifier for the installation.

Postinstallation Instructions

The following postinstallation tasks must be done to work with Oracle Connect for IMS, VSAM, and Adabas Gateways:

• Postinstallation Tasks

• Starting the Daemon

• Setting Up Oracle Connect for IMS, VSAM, and Adabas Gateways for Reentrancy

• Configuring Additional Settings for Working with CICS

• Configuring OTMA for Working with IMS/TM

• Setting Up Oracle Connect for IMS, VSAM, and Adabas Gateways to Update VSAM, IMS, or Adabas Data

'/s ATTDAEMN'

//*ATTDAEMN JOB 'RR','TTT',MSGLEVEL=(1,1),CLASS=A,
//* MSGCLASS=A,NOTIFY=&SYSUID,REGION=8M
//STEP1 EXEC PGM=IRPCD,
// PARM='-B  START IRPCDINI'
//* PARM='-B -L :8883 START'
//STEPLIB DD DSN=INSTROOT.LOADAUT,DISP=SHR
//SYSPRINT DD SYSOUT=A
//GBLPARMS DD DSN=INSTROOT.DEF.GBLPARMS,DISP=SHR
// EXEC PGM=IRPCD,COND=((1,EQ,STEP1),(2,EQ,STEP1)),
// PARM='-KATTDAEMN START ''INSTROOT.DEF.IRPCDINI'''
//STEPLIB DD DSN=INSTROOT.LOADAUT,DISP=SHR
//SYSPRINT DD SYSOUT=A
//GBLPARMS DD DSN=INSTROOT.DEF.GBLPARMS,DISP=SHR
//SYSDUMP DD DUMMY

CEDA DEF PROG(UPDTRNS) G(group_name) LANG(C) DA(ANY) DE(ORACLE data source UPDATE PROG)

CEDA IN G(group_name)

CEDA DEF PROG(ATYDBCTL) G(group_name) LANG(C) DA(ANY) DE(ORACLE data source UPDATE PROG)

CEDA IN G(group_name)