CICS Debugging Aids

CICS can experience two types of abnormal ends-abends that affect one-transaction and abends that affect CICS itself.
cadts151
CICS can experience two types of abnormal ends-abends that affect one-transaction and abends that affect CICS itself.
CICS transaction and system dumps should be produced for use in the debugging process. The CSMT Log, produced when CICS is brought down, can also be useful.
The CICS Statistics Report is produced when CICS is brought down. Statistics shown include task control, storage, transactions, programs, dumps, and temporary storage. This report can be valuable in identifying what happened to CICS when a problem was encountered.
For more information, see the IBM documentation for CICS Transaction Server.
If you are serious about improving the performance of your CICS production environments, you should be running your
CA Ideal™ for CA Datacom®
programs in load module format.
Load modules provide performance benefits and an additional means of monitoring and tuning your environment. Using load modules can also reduce the impact on your system of migrating production applications.
This page contains the following topics:
Monitoring
With load modules, there are many tools to aid you in gathering statistics on the performance of individual modules.
Sites which see excessive use of the U suffixed load module can identify overuse of the RELEASE command in
CA Ideal™ for CA Datacom®
. Sites can identify which modules are highly used and loaded and should possibly be made resident.
It is also important when running load modules exclusively to check your CICS statistics. You should see no I/O to the user panel or object libraries. If you do, VLS is active. You might think you are using 100 percent load modules online when you are actually running some programs in VLS format. Somehow these programs missed the conversion to load modules after they were object transported.
If this situation occurs, you can run a Datadictionary alias report. User entity type MODULE,$IP* gets a listing of all the programs and MODULE,$IM* gets a listing of all panels. These listings can be compared against a VLS library listing for missing modules.
An application load module cannot execute outside of the
CA Ideal™ for CA Datacom®
environment. For a complete description of
CA Ideal™ for CA Datacom®
load modules, see Application Migration Considerations.
DISPLAY PCT Command
Displays the CICS Program Table entries
CA Ideal™ for CA Datacom®
uses. Enter this command in the following format:
DISPLAY PCT
The following is an example of the report this command displays:
TRAN  INITIAL   TYPE OF     TWA    PRD                                  ID   PROGRAM   ENTRY       SIZE                                                                                                              scfd  SC00DISP  ACCOUNT-ID   64                                        ASYN  SC00NATD  ASYNC        64         WWW.ASYNC   (0001)             CWBA  DFHWBA    WEB INTF.     0         Transaction not in SCWBTRAN    DDOL  SC00INIT               12    DDO                                 DDOX  SC00INIT               12    DDO                                 DEBB  SC00INIT               64         Transaction not in SC00TRAN    DEBG  DFHWBA    WEB INTF.    64         Transaction not in SCWBTRAN    DIAL  DFHWBA    WEB INTF.    64         Transaction not in SCWBTRAN    EMPL  SC00NATD  ASYNC        64         Transaction not in SCASTRAN    HBRX  DFHWBA    WEB INTF.     0         Transaction not in SCWBTRAN    HBR1  SC00INIT  FINAL-ID     64    IDL  $ID.HBR1   HTTU  DFHWBA    WEB INTF.     0         Transaction not in SCWBTRAN  HWBA  DFHWBA    WEB INTF.     0         Transaction not in SCWBTRAN  IBIN  DFHWBA    WEB INTF.    64         WWW.WEBIMAGE(001)            IDBA  DFHWBA    WEB INTF.    64         WWW.BBSDEMOA(001) IDEA  SC00INIT               64    IDL                        IDLX  SC00INIT  FINAL-ID     64    IDL                        IPCV  SC00INIT               64    IPC                               IPCX  SC00INIT               64    IPC                               JULC  SC00NATD  ASYNC        60         Transaction not in SCASTRAN  SAST  SC00SAST  COMP/PRINT   64                                      SCFD  SC00DISP  ACCOUNT-ID   64                                      S318  SC00NATD  ASYNC        64         Transaction not in SCASTRAN           
Display LMT Command
This command can display different results from the DISPLAY INDEX ALL MODULE command, which reflects only the Datadictionary MODULE entities.
The DISPLAY LMT command displays the content of the Load Module Table, which may be a composite of entries loaded from Application Module Tables, and entries retrieved from the dictionary. For more information about load module format, see Module Format for Programs and Panels.
The following is an example of the report this command displays:
PGM  $ID  CICSWEB   (PRD)  IS MODULE  CICSWEB                           PGM  CTH  A8842296  (PRD)  IS MODULE  ADAM1                             PGM  CTH  B8842296  (PRD)  IS MODULE  ADAM2                             PGM  CTH  A7698144  (PRD)  IS MODULE  A769814                           PGM  CTH  B7698144  (PRD)  IS MODULE  B769814                           PGM  CTH  C1198608  (PRD)  IS MODULE  CM98608                           PGM  QAT  CUST      (PRD)  IS MODULE  CUST                              PGM  CTH  C9370687  (PRD)  IS MODULE  C937068                           PGM  CHE  DATE      (PRD)  IS MODULE  D1                                PGM  SOL  ID#2192   (PRD)  IS MODULE  ID#2192                           PGM  SOL  ID#2773   (PRD)  IS MODULE  ID#2773                           PGM  SOL  ID#2818   (PRD)  IS MODULE  ID#2818                           PGM  SOL  ID#2854   (PRD)  IS MODULE  ID#2854