Activate the CICS Component - Optional
Activation of the CICS® Component of Connect:Direct® for z/OS® requires additional items to be updated. An overview is presented followed by a task checklist.
CICS Customization Overview
To run the CICS Component, IBM® Connect:Direct contains code that runs as an exit in CICS/TS to handle the data movement between CICS and IBM Connect:Direct. To perform the install, several transactions must be defined. These transactions are in the RDO source provided. The default transaction codes start with "DGA".
The interface between CICS and IBM Connect:Direct can start up during the CICS start, or it may be manually activated after CICS is running. If you want the interface to start up automatically, you must modify the CICS PLTPI. If you want the interface to shut down automatically, you must customize the CICS PLTSD.
If you want to process Event Data within CICS, you must customize and install DGAQ247. If you need to customize DGAQ249 and DGAQM98, search for Using ESS with the CICS API. If you do not want to use them, you can remove these entries from DGACCSD.
DGAQ249 reads Event Records out of the TDQ. If you need to add logic to DGAQ249 to do more than just read some records, you must customize it. Otherwise, you can remove its entries from DGACCSD.
You must define a few files, including the CONFIG file, which is handled with a REXX exec.
The CICS component has a set of transaction codes that you can accept as they are, or you may set your own. The CICS component uses the following default transaction codes:
Transaction Code | Description |
---|---|
DGA | User Transaction |
DGAA | Administrator Transaction |
DGAE | Event Services |
DGAI | Initial Startup |
DGAM | API Monitor |
DGAN | User ESS Process Interface |
DGAP | Printer Driver Transaction |
DGAT | User Read/Process ESS |
CICS Customization Checklist
- Customize the RDO source.
The members to be customized are located in $CD.SDGACNTL.
Member | Description |
---|---|
DGACCSD | RDO source containing the Transactions, Program, File, Mapset, TDQ, and List definitions |
DGACBCKO | RDO source to remove prior release(s) |
DGACBACK | RDO source to back out the 5.1 release |
- If you plan to migrate to this release from a prior release, review the IBM Connect:Direct for z/OS Release Notes for migration instructions. See Build the CICS Configuration File through ISPF for the panels that the REXX will display.