1. Mainframe Adapter for SNA User’s Guide
  2. Verifying the Software
  3. Building Verification Tests
  4. Building CICS/ESA Executables
  5. Configure the CICS/ESA Application

4.1.2.6 Configure the CICS/ESA Application

Your installed Oracle Tuxedo Mainframe Adapter for SNA software contains two sample files that can be used to configure the CICS application:

  • The BEACONN file contains the CICS/ESA configuration parameters to the host system. These include connection definitions and session definitions.
  • The BEASNA file contains the application definitions that enable you to perform the installation verification in the CICS/ESA environment. These definitions are required to run the installation verification. They include the program definitions, transaction definitions, and for the CPI-C example, the partner definition.

Caution:

The BEACONN file should only be added to the CICS/ESA System Definition (CSD) file if no definitions currently exist. Check with your system administrator.

One method of adding the files is to use the batch utility program, DFHCSDUP. The following listing is an example of the Job Control Language (JCL) statements you can use to invoke DFHCSDUP as a batch program to add the BEASNA file:

Listing JCL Example for Invoking DFHCSDUP 

//YOURJOB JOB accounting info,name,MSGLEVEL=1
//STEP1 EXEC PGM=DFHCSDUP,REGION=512K,
//      PARM='CSD(READWRITE),PAGESIZE(60),NOCOMPAT'
//STEPLIB   DD DSN=CICSxxx.SDFHLOAD,DISP=SHR
//DFHCSD    DD UNIT=SYSDA,DISP=SHR,DSN=CICSxxx.DFHCSD
//SYSPRINT  DD SYSOUT=A
//SYSIN     DD DSN=YOUR.PDS(BEASNA),DISP=SHR

The definitions in the sample member use an Oracle Tuxedo Mainframe Adapter for SNA Resource Definition Online (RDO) Group name. You may want to add these definitions to an existing RDO group, or you might consider adding them to your CICS/ESA start-up list if you plan to use them often. (This automatically installs the group on start-up of the CICS/ESA region.) To add the groups to the start-up list, un-comment the following statements in the sample RDO. 

ADD GROUP(BEACONN) LIST(**YOURLIST**)
ADD GROUP(BEASNA) LIST(**YOURLIST**)

In these arguments, **YOURLIST** is the name of your startup list.

To manually install the groups after start-up of the CICS/ESA region, issue the following commands from a CICS/ESA terminal session.

CEDA I GROUP(BEACONN)
CEDA I GROUP(BEASNA)

Parent topic: Building CICS/ESA Executables