Problem Determination


 Return to Library  Contents  Previous Topic  Bottom of Topic  Next Topic  Index  Help


Chapter 4. Using the CallCoordinator Panels for Problem Determination

CallCoordinator provides you with some panels for problem determination. To access these panels:

  1. Type V800 and press Enter on a blank CICS panel. The System Administration Main Menu (V800) is displayed:
      V800             CallCoordinator V 2.1   System Administration    1999/11/02
                                       Main Menu                        04:30:11PM
     
      Select one of the following.  Then press Enter.
     
      _  1. COR Operations
         2. Switch Operations
         3. System Configuration
         4. Resource Definition
     
     
     
     
     
     
     
     
     
     
     
      COR Sysid:  CORF        TermID: S209            Local System Status:  ACTIVE
      5655-B34 (C) Copyright IBM Corp. 1992, 1999. All rights reserved
      F1=Help      F2=           F3=Exit      F4=2         F5=Refresh   F6=
      F7=          F8=           F9=          F10=         F11=         F12=
    

  2. Choose option 1. COR Operations (CallPath Owning Region Operations). The COR Operations panel is displayed:  
     VA10             CallCoordinator V2.1   System Administration
                                 COR Operations
     
       Type an action code, then press Enter
     
     
            1=Start CC  2=Stop CC  3=Set Trace On  4=Set Trace Off
            5=CC Status  6=Table Reload
     
       Act       COR      COR     CC      Trace
       Code     ApplID    SysID  Status    Status
        _                 CORA   INACTIVE  INACTIVE
        _                 CORB   INACTIVE  INACTIVE
        _                 CORC   INACTIVE  INACTIVE
        _       IYCLZC0D  CORD   INACTIVE  INACTIVE
        _                 CORE   INACTIVE  INACTIVE
        _       IYCLZC0F  CORF   ACTIVE    ACTIVE
        _                 COR3   INACTIVE  ACTIVE
        _                 COR5   INACTIVE  INACTIVE
     
     COR Sysid:  CORF        TermID: S208
     
     
     F1=Help  F3=Exit  F5=Refresh                    F12=
    

      Codes for the status of the system (CC Status) are:

    Code
    Meaning

    ACTIVE
    CallCoordinator is currently active.

    INACTIVE
    CallCoordinator is inactive either because it was not started since CICS came up, or because it was shut down manually.

    STARTING
    CallCoordinator is in the process of starting the LRTs, loading tables, and other startup tasks.

    STOPPING
    Shutdown has been requested and CallCoordinator is stopping the LRTs.

    FAILED
    CallCoordinator failed during startup; check the CICS syslog for additional information (see "CICS system log for COR").

    PURGED
    The CallCoordinator Status Manager V884 detected that an LRT has not posted its time in a 2-minute period and therefore has shutdown the subsystem. Check for an LRT abend or purge; check the CICS syslog for additional information (see "CICS system log for COR").

  3. Type an action code on the required line. The problem determination functions are:

    3=Set Trace On,
    4=Set Trace Off, see "Using Trace"

    5=CC Status, see "CallCoordinator Status"


Using Trace

 

If you encounter a problem in running CallCoordinator you may need to collect data for IBM to solve the problem. Use the trace facility to help you collect the data.

You can use the Set Trace On activity code (3) on the COR Operations panel (VA10) to turn on trace record generation separately for each COR. In routine operation, the trace facility should be turned off to avoid logging unneeded messages and slowing down the system. The trace may be started or stopped in any COR from any COR, in a multiple COR environment.

When a problem occurs, the IBM Software Support Center will tell you if trace needs to be turned on.

Note: The trace selection remains in effect until it is turned off by selecting option 4 from the COR Operations panel. Remember to turn it off so as not to cause unnecessary logging.

If Trace is set on, it will remain on until it is explicitly turned off, even when the CICS region is recycled. This is to allow for tracing of CallCoordinator startup.


CallCoordinator Status

This allows you to view information on the status of the system and the long running tasks in CallCoordinator, and to view table usage statistics online.
VA12              CallCoordinator V2.1   COR Operations           1999/10/29
                     CallCoordinator Status                      02:21:0 2PM
 
 For COR: CORF                       System Status: ACTIVE
 
 -------- CallCoordinator Long Running Task Status --------
        Item          Date         Time       Status
      CSM (V884)   1999/12/18   01:54:57PM   A
      CTM (V200)   1999/12/18   01:55:24PM   A
      MIS (V400)   1999/12/18   01:55:24PM   A
      CTR (V220)   1999/12/18   01:55:24PM   A
 ---------------- CallCoordinator Tables ------------------
 Counts        Current   Hi-water  Maximum   Utilization
  Event Msg Q  0000000   0000015    N/A           %
  Calls (CMCT) 00000     00000     03000          %
  Parties      00000     00000     04000          %
  Connections  00000     00000     09000          %
  Agents       00000     00000     00000          %
  MIS Msg Q    00000     00000     00000          %
 
COR Sysid:  CORF        TermID: S208
 
F1=Help   F3=Exit   F5=Refresh   F12=

CallCoordinator Status Fields

The following is an explanation of the display only fields on the CallCoordinator Status panel.

Field
Description

For COR:
This is the name of the COR for which the status information is displayed. You can query the status of one COR from another, so this may be the same or different from the COR SysId shown at the bottom of the screen.

System Status
Codes for the status of the system are:

Code
Meaning

ACTIVE
CallCoordinator is currently active.

INACTIVE
CallCoordinator is inactive either because it was not started since CICS came up, or because it was shut down manually.

STARTING
CallCoordinator is in the process of starting the LRTs, loading tables, and other startup tasks.

STOPPING
Shutdown has been requested and CallCoordinator is stopping the LRTs.

FAILED
CallCoordinator failed during startup; check the CICS syslog for additional information (see "CICS system log for COR").

PURGED
The CallCoordinator Status Manager V884 detected that an LRT has not posted its time in a 2-minute period and therefore has shutdown the subsystem. Check for an LRT abend or purge.

Item
This is the name of the component or long running task for which information is displayed. The components are:

Code
Meaning

CSM
CallCoordinator Status Manager    

CTM
Call Tracking Manager

MIS
MIS Log Interface

CTR
Call Tracking Receiver

Date
This field displays the date on which the status of CallCoordinator and its components was last recorded.

Time
This field displays the time at which the status of CallCoordinator and its components was last recorded.

Status
Codes for the status of the long running tasks are:

Code
Meaning

A
Active. This task is running.

I
Inactive. This task is not running. You can refer to the CICS system log to determine if an error condition exists.

What the System and Task Status Information Fields Mean

Long running tasks (LRT) are those tasks that begin running when the system is started, and run in the background without operator instruction until the system is shut down, unless an error condition occurs.

When a long running task is not active, the system as a whole is not active. To make the system active, identify which LRT is inactive and correct its problem, then restart the system.

The CallCoordinator long running tasks are:

CICS system log for COR

 

The CICS syslog message will appear in the syslog associated with the COR being started, not the COR from where it was started. For example, if you are on the COR Operations panels in COR A and you request a startup for COR B, the system messages will be in the COR B syslog.


 Return to Library  Contents  Previous Topic  Top of Topic  Next Topic  Index  Help