Enabling RAS1 Tracing for the enhanced 3270UI
You can choose from several different types of tracing that can be enabled to debug the OMEGAMON enhanced 3270 user interface (enhanced 3270UI) and Tivoli OMEGAMON Manager Address Space.
Tracing can be enabled at Tivoli OMEGAMON Manager startup, at user
start, or dynamically turned on and off for either the Address Space
or a particular user. Trace messages are produced in the Tivoli OMEGAMON
Manager's SYSPRINT location, SYSTRACE DD location, or both.
An enhanced 3270UI user can use TRACE commands or pull-down menus to enable UI tracing. Both of these methods enable UI tracing for actions that are initiated only by that particular user. To enable tracing for the entire Tivoli OMEGAMON Manager Address Space, use modify commands to the Tivoli OMEGAMON Manager Address Space, or use enhanced 3270UI TRACE commands or pull-down menus.
The pull-down method is initiated by clicking (or positioning the cursor and pressing Enter) on the Tools pull-down. A pull-down menu appears where you can select either UI tracing or Address Space tracing.
After you select one of the tracing options, a Trace menu pop-up will display all of the components that can be selected for tracing.
The command method is initiated by entering a TRACE command on the command line, or the action line, on the enhanced 3270UI.
After you initiate tracing, a TRACE indicator is displayed the drawer section of the footer.
Clicking (or positioning the cursor and pressing Enter) on the TRACE box displays the Trace menu where more tracing can be initiated, or turned off altogether.
Additionally, the Modify system command can
be used to directly communicate with the Tivoli OMEGAMON Manager started
task to start and stop address space level tracing. The syntax of
the modify command is: /F tomjobname, TRACE KOBcomp n, where - tomjobname is the Tivoli OMEGAMON Manager
started task name. IBMTOM is the default started
task name. - comp is the component for which you
want to start/stop tracing, and - n is the trace
level, which can have the value 0 - 4. A trace level of 0 indicates
that no tracing takes place, and disables tracing if it was already
enabled. A trace level of 1 - 4 enables tracing; 1 generates the least
number of trace messages, while 4 generates the most trace messages.
This table lists the pull-down options that are available to the user, and the corresponding TRACE and modify commands:
| UI trace pulldown options: | Corresponding TRACE command: | Corresponding modify command: (that is, /F IBMTOM, TRACE KOBcomp where n is the level of tracing) |
|---|---|---|
| 1. B Basic UI Flow of Control | TRACE BASIC | (not applicable) |
| 2. V VTAM Data Stream Analysis | TRACE VTAM | (not applicable) |
| 3. I Input Field Processing | TRACE INPUT | (not applicable) |
| 4. P 3270 Presentation Services | TRACE 3270 | (not applicable) |
| 5. O Source ODI Interchange | TRACE ODI | (not applicable) |
| 6. Q SQL and Live Data Analysis | TRACE DATA | (not applicable) |
| 7. U Screen Popups | TRACE POPUP | (not applicable) |
| 8. S Screen Scrolling | TRACE SCROLL | (not applicable) |
| 9. R REXX Processing | TRACE REXX | (not applicable) |
| 10. X Turn All UI Trace Off | TRACE OFF | (not applicable) |
| Address Space pulldown options: | ||
| 1. R Request Router | TRACE RR | TRACE KOBRRWKR 1, KOBRRUIA 1 |
| 2. C Conduit Manager | TRACE CM | TRACE KOBGWCND 1 |
| 3. G Registry | TRACE RG | TRACE KOBGWREG 1 |
| 4. T Status and Thresholding | TRACE ST | TRACE KOBTHRMT 1, KOBTHRSH 2 |
| 5. S Session Control | TRACE SC | TRACE KOBOBVAP 1, KOBGWOBV 2 |
| 6. W OMEGAMON Gateway | TRACE GW | TRACE KOBGATW0 1 |
| 7. O Binary ODI | TRACE BO | TRACE KOBODUTL 1, KOBODILD 1 |
| 8. A SAF Authorization | TRACE SAF | TRACE KOBCRACF 1 |
| 9. X Turn All Component Trace Off | TRACE MOFF | TRACE KOBcomp 0 |