Obtaining diagnostics

Edit online

In the event that OMEGAMON for CICS (3270) experiences a problem, you might be asked to capture debugging information. OMEGAMON for CICS (3270) diagnostics use the Snapshot facility and produce both CICS® and OMEGAMON for CICS (3270) debugging information.

To obtain OMEGAMON for CICS (3270) diagnostics, select the Debug option (O) on the Utilities menu or enter fast path U.O from any panel. A Debug introductory panel appears.

Figure 1. Diagnostics Introduction Panel (U.O)

________________ ZUDBUG   VTM     CICSR41L V530./C SYS  06/04/30 14:24:59
> PF1 Help     PF3 Back     PF4 Main Menu                                 
                                                                          
>        **************************************************************   
>        *      OMEGAMON II for CICS AUTOMATIC DIAGNOSTIC FACILITY    *   
>        **************************************************************   
>        *                                                            *   
>        *    This is the OMEGAMON automatic SNAPSHOT facility     *   
>        *    which will record comprehensive details on both the     *   
>        *    CICS region being monitored and OMEGAMON/CICS itself.   *   
>        *    It is intended as an IBM Software Support diagnostic    *   
>        *    aid.                                                    *   
>        *                                                            *   
>        *    The results of the SNAPSHOT will be directed straight   *   
>        *    to the JES print queue without any required action on   *   
>        *    your part. The resultant output does include a banner   *   
>        *    page which should be "filled-in" before sending to      *   
>        *    IBM Software Support.                                   *   
>        *                                                            *   
>        *    Press ENTER to proceed with SNAPSHOT or PF3 to cancel   *   
>        *                                                            *   
>        *                                                            *   
>        **************************************************************   
 .SGO DEBUG01                                                             
+       >> OB0161: Screen Space Fetch Pending <<

The next panel collects information about your site which will appear as a banner page when the OMEGAMON for CICS (3270) diagnostics are printed. Type the requested information in the spaces provided. Then press Enter to proceed or if you prefer to bypass the diagnostics, press PF3 to cancel and return to the Utilities menu.

This option is composed of a sequence of predefined OMEGAMON for CICS (3270) displays, similar to the real time OMEGAMON displays you are currently using in the OMEGAMON for CICS (3270) interface. The displays contain everything included in the Snapshot option (fast path U.N) which reports on the target CICS region. In addition, this option also produces extensive diagnostics and statistics about the OMEGAMON for CICS (3270) region itself.

This Debug option is designed as a service and debugging aid to reduce the time taken to resolve problems with OMEGAMON for CICS (3270).

The complete sequence of the Snapshot and Debug displays execute without any intervention on your part. After invoking Debug, the next panel you see is the completion panel. There is a short time interval between invoking Debug and completing the process. The time period depends largely on the size and state of the CICS region being diagnosed.