TXSeries for Multiplatforms
CICS Problem Dete rmination Guid e
Ve r s i o n 6. 0
SC34-6636-00
TXSeries for Multiplatforms
CICS Problem Dete rmination Guid e
Ve r s i o n 6. 0
SC34-6636-00
Note
Before using this information and the product it supports, be sure to read the general information under “Notices” on page
145.
First Edition (November 2005)
This edition replaces SC09-4465-05.
Order publications through your IBM representative or through the IBM branch office serving your locality.
© Copyright International Business Machines Corporation 1999, 2005. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures . . . . . . . . . . . . . . vii
Tables . . . . . . . . . . . . . . .ix
About this book . . . . . . . . . . .xi
Who should read this book . . . . . . . . .xi
Document organization . . . . . . . . . .xi
Conventions used in this book . . . . . . . . xii
How to send your comments . . . . . . . . xiii
Part 1. Approach to problem
determination . . . . . . . . . . .1
Chapter 1. Introduction to problem
determination . . . . . . . . . . . .3
Working through a problem . . . . . . . . .3
Before you start—preliminary checks . . . . . .4
Classifying the problem . . . . . . . . . . .6
Using the symptoms to classify the problem . . . .7
Chapter 2. Sources of information . . .9
Product publications . . . . . . . . . . . .9
Customer forums . . . . . . . . . . . . .9
Abnormal termination codes and error messages . .9
Symptom records file . . . . . . . . . .11
Toolkit messages and status codes . . . . . .12
SNA messages . . . . . . . . . . . .13
Database messages . . . . . . . . . . .13
Tailing message files . . . . . . . . . .13
CICS tools . . . . . . . . . . . . . . .14
CICS-supplied transactions . . . . . . . . .15
Command-line utilities . . . . . . . . . .16
Transaction inputs and outputs . . . . . . . .17
Your own documentation . . . . . . . . . .18
Part 2. Dealing with the problem . .19
Chapter 3. Dealing with abnormal
terminations . . . . . . . . . . . .21
Using trace-back files . . . . . . . . . . .21
Chapter 4. Distinguishing between
waits, loops, and poor performance . .25
Is the problem caused by a wait? . . . . . . .25
Is the problem caused by a loop? . . . . . . .25
Is the problem a performance problem? . . . . .26
Chapter 5. Dealing with waits . . . . .27
CICS system waits . . . . . . . . . . . .27
Maximum server condition waits . . . . . . .28
Terminal waits . . . . . . . . . . . . .28
Intersystem waits . . . . . . . . . . . .29
Transient data waits . . . . . . . . . . .30
File control waits . . . . . . . . . . . .31
Temporary storage queue waits . . . . . . . .31
Not enough storage . . . . . . . . . .31
Temporary storage queue already in use . . . .32
System dump waits . . . . . . . . . . .32
ENQ and SUSPEND task control waits . . . . .32
Enqueueing a locked resource . . . . . . .32
Suspending a transaction . . . . . . . . .33
Journal waits . . . . . . . . . . . . . .33
Syncpoint waits . . . . . . . . . . . . .34
Non-distributed transactions . . . . . . . .34
Distributed transactions . . . . . . . . .34
CICS system process waits . . . . . . . . .35
What to do if CICS has stalled . . . . . . . .35
CICS has stalled during initialization . . . . .35
CICS has stalled during a run . . . . . . .36
CICS has stalled during termination . . . . .37
Chapter 6. Dealing with loops . . . . .41
Different types of loop . . . . . . . . . . .41
Classifying loops by their symptoms . . . . .41
Investigating loops . . . . . . . . . . . .42
The documentation you need . . . . . . .42
Identifying the loop . . . . . . . . . .42
Finding the reason for the loop . . . . . . .43
What to do if you cannot find the cause of a loop 43
Chapter 7. Dealing with performance
problems . . . . . . . . . . . . . .45
Finding the bottleneck in scheduled transactions . .45
Tasks not given to the transaction scheduler . .45
Task is not scheduled . . . . . . . . . .45
Terminal definitions not removed from the
system . . . . . . . . . . . . . . .45
Why tasks are not given to the scheduler . . . .46
Terminal and remotely initiated tasks . . . . .46
Interval control transactions . . . . . . . .46
Why tasks are not scheduled . . . . . . . .47
Task is held by class . . . . . . . . . .47
No application server available . . . . . . .47
Task priority . . . . . . . . . . . . .48
Why the scheduler refuses to schedule tasks . .48
The scheduler dump information . . . . . .48
Scheduler statistics . . . . . . . . . . .49
Short on storage . . . . . . . . . . . .50
Incorrect settings of region attributes . . . . . .50
Incorrect settings of SFS attributes . . . . . . .51
Chapter 8. Dealing with unanticipated
output . . . . . . . . . . . . . . .53
An output device displays unanticipated data . . .53
Preliminary information . . . . . . . . .53
Specific types of unanticipated output . . . .53
© Copyright IBM Corp. 1999, 2005 iii