kixpkggen.py is used to generate Oracle Tuxedo domain package for CICS application.

kixpkggen.py is written in Python, which requires Python version 2.6.6 or higher to run.

Input

kixpkggen.py takes an XML configuration file and CICS asset as input. The CICS asset is a compressed file in ZIP format and should follow this structure.

Listing CICS Asset Structure

CICS_ASSET.zip
|---- CICS/     #Source directory, contains COBOL source & compiled binaries
|---- MAP/      #BMS MAP directory, contains compiled BMS defines
|---- COPY/     #COBOL COPYBOOK directory
|---- bin/      #Binary directory, such as customized ART servers, TMS
`---- config/
      `----resources/   #ART CICS resource files, must exist in CICS_ASSET.zip

Output

kixpkggen.py generates an Oracle Tuxedo domain package for CICS in ZIP format. In the package, kixpkggen.py generates configuration files that ART for CICS application needs, including UBBCONFIG file, resource files, scripts, and so on. This output package has the following structure.

Listing Output Package Structure

{DOMAINID}_{IPCKEY}.zip
|---- CICS/
|---- MAP/
|---- COPY/
|---- bin/
|---- config/
|   |---- resources/
|   |   |---- list_of_groups.desc
|   |   |---- systems.desc
|   | `---- tuxgrp_cics.desc
|   `---- tux/
|         |---- envfile
|         `---- ubbconfig
|---- scripts/
|   |---- boot.sh
|   |---- deploy.sh
|   |---- shutdown.sh
|   |---- setenv.hostname_1
|   |---- setenv.hostname_2
|   `---- setenv.hostname_n
`---- setenv

To deploy and run the application, you should unzip output package to APPDIR on every node of the domain, and then execute the followings.

1. Set up runtime environment variables.

   . ./setenv

2. Set up the application.

   ./scripts/deploy.sh

3. Boot the application. If it is MP domain, run boot script on every node of the domain. You should run boot script on slave machines before you run it on the master machine.

   ./scripts/boot.sh

To shutdown the application, run the followings on the master machine.

./scripts/shutdown.sh