Contents

Dedication
Preface
What this book is about
Who this book is for
What you need to know to understand this book
Road map
A note on terminology
Figures
Tables
Overview of BTS
Why do I need CICS business transaction services?
Business transactions and CICS transactions
Business transactions
CICS transactions
The problems
The solution
What are CICS business transaction services?
What is a BTS application?
Control flow
Recovery and restart in BTS
Client/server support in BTS
Web Interface support in BTS
Support for existing code in BTS
Sysplex support in BTS
Dynamic routing of BTS activities
Audit trails
Monitoring in BTS
The BTS sample application
Requirements for BTS
BTS Application Programming Guide
Using the BTS API to write business applications
BTS activities and processes
Names and identifiers
Activation sequences
Synchronous and asynchronous activations
Lifetime of activities
Processing modes
User syncpoints
BTS data-containers
Lifetime of data-containers
BTS timers
Timer management tips
BTS events
Atomic events
Composite events
Event pools
Deleting events
Reattachment events and activity activation
The Sale example application
Overview of the Sale application
Data flows
CICS transactions and programs
The initial request
Creating the business transaction
Starting the business transaction
The root activity
Transferring input and output data
Dealing with BTS errors and response codes
Checking the response from a synchronous activity
Checking the response from an asynchronous activity
Getting details of activity ABENDs
Retrying failed activities
Running parallel BTS activities
An example of parallel activities
Data flow
The root activity
Interacting with BTS processes and activities
Introduction
Acquiring processes and activities
Using client/server processing
A client/server example
Acquiring an activity
A user-related example
Transferring data to asynchronous activations
Compensation in BTS
Implementing compensation
A compensation example
Process flow
The root activity
Dealing with application locking
Reusing existing 3270 applications in BTS
Running a 3270 transaction from BTS
Resource definition
Running more complex transactions
Intermediate output messages
Conversational transactions
Pseudoconversational transactions
Things to consider
Using timers
Abend processing
Transaction restart
Sample programs
Administering CICS business transaction services
System definition for BTS
Defining BTS data sets
Repository data sets
Local request queue data set
Naming the routing program
Resource definition for BTS
Defining the LRQ file to the CSD
Defining repository files to the CSD
CEDA DEFINE PROCESSTYPE
Security in BTS
Resource security in BTS
Process and activity userids
Attach-time security for processes and activities
Command security in BTS
BTS operator commands
CBAM--BTS browser
Running the transaction
CEMT INQUIRE PROCESSTYPE
CEMT INQUIRE TASK
CEMT SET PROCESSTYPE
Using BTS in a sysplex
The scope of a BTS-set
A note about audit logs
Dynamic routing of BTS activities
Which BTS activities can be dynamically routed?
Understanding distributed routing
Controlling BTS dynamic routing
Creating a BTS-set
Naming the routing program
Using a CICS distributed routing program
How the distributed routing program relates to the dynamic routing program
Writing a distributed routing program
Using CICSPlex SM with BTS
Overview of CICSPlex SM Workload Management
Using CICSPlex SM to route BTS activities
BTS problems and performance
Having problems?
Dealing with stuck processes
Application design errors
Restarting stuck processes
Dealing with activity abends
Dealing with unserviceable requests
Unserviceable routing requests
How CICS handles unserviceable requests
Resolving unserviceable requests
Dealing with CICS failures
Emergency starts
Initial and cold starts
Creating a BTS audit trail
Introduction to BTS audit trails
Specifying the level of audit logging
Audit trail constraints--using DASD-only logstreams
Audit trail examples
Process-level auditing
Activity-level auditing
Full auditing
Using the audit trail utility program, DFHATUP
Using DFHATUP to read audit logs
Sample job stream to run the DFHATUP program
Example output from the DFHATUP utility
Examining BTS repository records
Introduction to the repository utility program, DFHBARUP
The repository utility program, DFHBARUP
Using DFHBARUP
Sample job stream to run the DFHBARUP program
Example output from the DFHBARUP utility
BTS messages, trace, and dump
BTS messages
Using BTS trace
Setting trace levels for BTS
The BTS trace points
Extracting BTS information from a CICS system dump
Tuning BTS performance
BTS monitoring data
Performance class data
Using the monitoring data print program, DFH$MOLS
BTS Application Programming Reference
Overview of BTS API commands
Process- and activity-related commands
Creating, activating, and terminating processes and activities
Retrieving information about activities
Relating UOWs and activities
Container commands
Event-related commands
Terminology
The event-related commands
Browsing and inquiry commands
Browsing commands
Inquiry commands
Tokens and identifiers
Commands which take identifiers returned by browse operations
Browsing examples
System events
BTS application programming commands
BTS System Programming Reference
Overview of BTS system programming commands
Control commands
Inquiry command
BTS system programming commands
CREATE PROCESSTYPE
DISCARD PROCESSTYPE
INQUIRE PROCESSTYPE
Browsing
INQUIRE TASK
SET PROCESSTYPE
Appendixes
Appendix. The BTS sample application
Running the sample application from the WWW
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 ]]