Contents

Preface
Who this book is for
What this book is about
What you need to know before reading this book
How to use this book
Terms used
Summary of changes
Figures
Tables
Overview of Database Control (DBCTL)
Summary of the benefits of DBCTL
Overview of DL/I request handling in CICS
Connecting to DBCTL
CICS-IMS DBCTL environment
CICS-IMS DBCTL environment--description of components
CICS-DBCTL interface control components in CICS address space
Components of DBCTL in IMS address spaces
Coordinator control subsystem (CCTL)
Resources you can access from a CICS environment that includes DBCTL
Benefits of using DBCTL
Functional benefits of DBCTL
Data availability
Batch message processing programs (BMPs)
System service requests
Access to data entry databases (DEDBs)
System availability benefits of DBCTL
Release independent interface
Improved sharing of databases between multiple CICS systems
Failure isolation
Operational flexibility
Ability to use XRF
Performance benefits of DBCTL
Virtual storage constraint relief
Improved throughput on multiprocessors
Migration considerations for DBCTL
Other methods for accessing DL/I
Withdrawn support of local DL/I and shared database
Possible migration paths to CICS Transaction Server for z/OS, Version 3 Release 1 with DBCTL
CICS with local DL/I
CICS with local DL/I and data sharing
CICS with shared database
CICS with IMS data sharing and batch
CICS with function shipping
CICS with IMS DM/TM
Suggested migration procedure to DBCTL
Planning your new DBCTL setup
Setting up test and production systems for CICS DBCTL
Number of DBCTL subsystems to use
Installing DBCTL, and defining CICS and IMS system resources
Checklist for installing and generating DBCTL
Defining CICS system resources for DBCTL
System initialization parameters
PSB directories (PDIRs)
DD statements
CICS-supplied groups within CICS system definition
Log management
Monitoring control table (MCT)
Program list table (PLT)
Transient data queues
Generating DBCTL
Defining the DBCTL subsystem
IMS logging
IMS dynamic allocation macro (DFSMDA)
Database buffer specifications and option parameters
Overriding DBCTL generation parameters at execution time
Starting DBCTL, DLISAS, and DBRC
Defining the IMS DRA startup parameter table
Example JCL to generate a DRA startup table
Customizing DBCTL
DFHDBUEX
Global user exits XDLIPRE and XDLIPOST
Global user exits XRMIIN and XRMIOUT
Global user exits for XRF
Operations with DBCTL
Connecting to DBCTL: overview
Connecting DBCTL to CICS automatically
Connecting to DBCTL after a CICS WARM or EMERGENCY start
Connecting to DBCTL after a CICS COLD or INITIAL start
Connecting to DBCTL after a CICS XRF takeover
Connection, disconnection, and inquiry transactions for the CICS DBCTL interface
CDBC transaction for connect and disconnect
What happens when you have requested connection to DBCTL
Deciding whether to use orderly or immediate disconnection
CDBI transaction for inquiry
Operator communication with DBCTL -- overview
DBCTL operator commands
Format of DBCTL operator commands
Multisegment DBCTL operator commands
CDBM operator transaction
DFHDBFK - The CDBM GROUP command file
The MAINTENANCE panel for DFHDBFK
Input fields
Issuing DBRC commands
Authorizing access to DBCTL databases and PSBs
Changing IMS passwords
Deleting IMS password security authorization
Controlling tracing of DBCTL events
Finding out current status of DBCTL activities
Specifying messages to be logged on IMS log
Changing DBCTL resources online
Preventing programs and transactions from updating DBCTL databases
Switching to a new OLDS
Entering external subsystem commands from DBCTL
Making DBCTL resources available
Preventing scheduling of PSBs and use of DBCTL databases
Purging a transaction that is using DBCTL
Stopping DBCTL normally
Stopping DBCTL abnormally
Dealing with messages from DBCTL and CICS
Recovery and restart operations for DBCTL
Overview of CICS and IMS recovery and restart
CICS initialization and termination
Restarting DBCTL
CICS keypoints and IMS checkpoints
Log records
Database recovery control (DBRC)
Recovery control (RECON) data sets
Commit protocols and units of recovery for DBCTL
Two-phase commit for DBCTL
DBCTL unit of recovery
CICS DBCTL recovery tokens
Resolving in-doubt CICS DBCTL units of work manually
Using DBCTL operator commands to resolve in-doubts
IMS database utilities
IMS log utilities
Component failures in the CICS DBCTL environment
CICS failure
Database resource adapter (DRA) failure
DBCTL failure
IRLM failure
Transaction and thread failures
BMP failures
MVS, processor, or power failures
Application programming for DBCTL
Overview of application programming for DBCTL
Programming languages and environments for DL/I
Issue IMS AIB call format
Additional facilities available with DBCTL
Application program access to DEDBs
Additional EXEC DLI keywords
Keywords and corresponding command codes
POS command and call
Addressing and residency mode
Enhanced scheduling
Obtaining information about database availability
Accepting database availability status codes
Status codes and backout
Batch message processing programs (BMPs)
System service requests
Comparing EXEC DLI commands and DL/I calls
DL/I requests supported
Migrating programs to DBCTL
Migrating a DL/I program to a DBCTL program
Migrating CICS shared database batch jobs to BMPs
Migrating native IMS batch jobs to BMPs
Summary of DBCTL abends and return codes
Security checking with DBCTL
PSB authorization checking by CICS
Resource access security checking by DBCTL
Relationships between AGNs, PSBs, and DBCTL ID in security checking
DBCTL password security checking
Security considerations for using BMPs with DBCTL
Migration considerations for security with DBCTL
Security migration scenarios
Problem determination for DBCTL
Interactions between CICS and DBCTL
Interactions between CICS and DBCTL at the interface level
Interactions between CICS and DBCTL caused by requests
DBCTL error scenarios
Connection to DBCTL has failed to complete
Disconnection from DBCTL has failed to complete
Failures during PSB scheduling
Failures during DL/I request processing
Trace for CICS DBCTL
Trace entries produced by CICS
Connection to DBCTL
Disconnection from DBCTL
PSB schedule
PSB scheduling failure
CICS task issuing DL/I requests to be processed by DBCTL
Thread termination
Trace entries produced by DBCTL
Printing and formatting IMS X'67FA' log records
Dumps for CICS DBCTL
CICS transaction dump
CICS system dump
Determining whether a problem is occurring in CICS or DBCTL
DRA snap data set
What is provided in a CICS dump
Dumps produced by the DRA
Dumps produced by DBCTL
Messages for CICS DBCTL
Return codes in DBCTL
PAPL request and return codes
Using CICS EDF to debug application programs in DBCTL
Statistics, monitoring, and performance for DBCTL
Data available for a CICS-DBCTL system
DBCTL statistics
Monitoring DBCTL--transaction level data
DBCTL monitoring data returned to CICS
IMS monitor reports with DBCTL
Data contained in relevant IMS monitor reports
Regions and jobname report
Region summary report
DBCTL data returned to IMS log
DL/I trace
Trace facilities
Additional performance tools
Tuning a CICS-DBCTL system
Performance parameters in CICS
Performance parameters in IMS
Using DEDBs
IMS asynchronous database buffer purge facility
Virtual storage usage
Improved throughput on multiprocessors
Appendix A. Migration task summary for DBCTL
Education task list
Installation, system and resource definition task list
Operations task list
Recovery and restart task list
Application programming task list
Security task list
Problem determination task list
Monitoring, statistics, and performance task list
Appendix B. Illustration of DBCTL startup parameter creation and selection
Appendix C. Messages issued during DBCTL startup and termination
Messages issued by DBCTL during startup
Messages issued by DLISAS during startup
Messages issued by DBRC during startup
Messages issued by DBCTL during normal termination
Messages issued by DLISAS during normal termination
Messages issued by DBRC during normal termination
Appendix D. Summary of DBCTL operator commands
Appendix E. Using global user exit XDLIPRE to change PSB to be scheduled
Glossary
Bibliography
The CICS Transaction Server for z/OS library
The entitlement set
PDF-only books
Other CICS books
Accessibility
Index
Notices
Programming interface information
Trademarks
[[ Contents Previous Page | Next Page Index ]]