04.04.2013 Views

Addressing OLTP Solutions with CICS: The Transaction Server ... - Ibm

Addressing OLTP Solutions with CICS: The Transaction Server ... - Ibm

Addressing OLTP Solutions with CICS: The Transaction Server ... - Ibm

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

At <strong>CICS</strong> startup time, each <strong>CICS</strong> application server process (cicsas) establishes<br />

the XA connection using the XA open string obtained from the XAD stanza file<br />

entry. See <strong>CICS</strong> on Open Systems Administration Reference, SC33-1563-01 for<br />

more details. It is important to define the XAD stanza file entry correctly,<br />

particularly the path location of the switch load file and the XA open string. If the<br />

cicsas cannot connect to the database because either the database is not active<br />

or because the XAD stanza file entries are incorrect, the <strong>CICS</strong> for AIX region will<br />

abend at startup.<br />

Figure 29 shows the local implementation of a DB2 for AIX database being<br />

accessed from a <strong>CICS</strong> for AIX region.<br />

Figure 29. <strong>CICS</strong> Access to Local DB2 for AIX Database<br />

As DB2 for AIX uses a database name in the XA open string, you have to create<br />

the database before region startup.<br />

Switch Load File: <strong>CICS</strong> for AIX provides two versions of the switch load file:<br />

cics1pcdb2 for single-phase commit and cicszadb2 for two-phase commit. Select<br />

the version that is appropriate for your configuration.<br />

Regardless of whether the DB2 for AIX databases are accessed using a local or<br />

remote configuration, the entries in the XAD stanza file for the databases will be<br />

the same; that is, there are no location-specific parameter considerations.<br />

We do not recommend that you create your own version of the switch load file.<br />

<strong>CICS</strong> for AIX Region Environment Setup: In the<br />

/var/cics_regions/ region directory, the environment file is used<br />

to set environment variables on region startup.<br />

<strong>The</strong> environment variable for DB2 for AIX is DB2INSTANCE. This variable<br />

specifies the instance name of the DB2 server to which <strong>CICS</strong> is to refer.<br />

As there is only one DB2INSTANCE variable, a <strong>CICS</strong> for AIX region can only<br />

connect to the databases of that instance.<br />

Shared Object: You have to create a DB2 for AIX shared object code. As its<br />

name suggests, the shared code is loaded into memory once in the shared<br />

library segment and shared by all processes that reference it. <strong>The</strong> <strong>CICS</strong> for AIX<br />

COBOL run-time environment, <strong>CICS</strong> for AIX C transactions, and the switch load<br />

file must reference the DB2 for AIX shared object at run time. See DB2 for AIX<br />

Chapter 7. Interactions <strong>with</strong> the DB2 Family of Products 99

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!