Starting a transaction trace online

To start a trace

1. Type ST on the COMMAND line of any view and press Enter.The Start IMS Trace Request dialog box is displayed, as shown in the following figure.

   For additional information about a field, place the cursor on the field and press F1 for online Help.

   --------------------------- Start IMS Trace Request --------------------------|
   |                                                                             |
   |                                                           Target I14E52CT   |
   | Trace Attributes:                                                           |
   | PARM             (Trace Identifier)      START          (hh:mm:ss)          |
   | TYPE    S        (S-Summary,D-Detail     STOP           (hh:mm/mins)        |
   |                   A-Abbrev Summary)                                         |
   | STORAGE 400K     (Display Buffer Size)   WRAP  YES      (Y/N wrap buffer)   |
   | LOGTRAC N        (Y/N log trace)         RST   HOT      (HOT,PUR,QIS)       |
   |                                          QIS   YES      (YES/NO)            |
   | TITLE   WORKLOAD TRACE                                                      |
   |                                                                             |
   | Specify additional trace options: (*-processed)                             |
   |  Selection Criteria           N  (Y/N)                                      |
   |  Exception Filters            N  (Y/N)                                      |
   |  Trace Log Data Set Options   N  (Y/N)                                      |
   |                                                                             |
   |  Additional Trace Targets     N  (Y/N)   Context                            |
   |                                                                             |
   |                                                                             |
   |                                                                             |
   |                                                                             |
   | ENTER to process the request                                                |
   | END to cancel the request                                                   |
   | HELP to display related help                                                |
   | COMMAND ===>                                              SCROLL ===> PAGE  |
   |-----------------------------------------------------------------------------|
2. Ensure that the region name shown in the Target field is the region in which you want to start the trace.
   
   

3. Specify the trace attributes, as described in the following table:

   Field	Description	Default
   PARM	Unique name for the trace	Blanks
   TYPE	Type of transaction trace to perform	S (Summary), a summarized trace is performed
   START	Start time of the trace	Current time
   STOP	Stop time of the trace	Trace continues indefinitely
   STORAGE	Size of the trace display buffer	As specified in IMFBEX00 or in BBIISPxx if IMFBEX00 is not defined For information about IMFBEX00, see theMainView for IMS and MainView for DBCTL Customization. To determine the current settings of the STORAGE parameter, use the IBEXSUMR view.
   LOGTRAC	Whether to perform trace logging for this trace	N, no trace logging is performed
   WRAP	Determines the trace data wrap in the PAS trace buffer	YES, new data overlays old data
   RST	Restart option to be used when a service is quiesced because of an inactive target region	HOT, restarts the trace automatically without loss of previous data
   QIS	Action to be taken when an IMS target is not active	YES, the service is quiesced
   TITLE	Display title for the trace	Name of the service

4.  (Optional) Specify additional trace options:

   • Selection Criteria: Limit the amount of data saved.
   • Exception Filters: Limit the amount of data saved by exceptions.
   • Trace Log Data Set Options: Record traces to external VSAM data sets.

   Take the following steps for each option:

   1. Type Y in an additional option field and press Enter.
      A list of options is displayed. For information about each option, place the cursor in the field and press F1 for online Help.

   1. Specify values for the options and press Enter.
      The Start IMS Trace Request dialog is displayed with an asterisk in the selected additional option field.
      
      

   For more information, view the Quick Course Summary trace from OLDS.

   
   

5.  To start a trace on one or more systems, use one of the following methods:

   • Specify a target system in the Context field.

   • Type Y in the Additional Trace Targets field, press Enter, select target systems from the displayed list (use the Target Filter field to limit the systems listed), and press Enter.

     The Start IMS Trace Request dialog is displayed with an asterisk in the Additional Trace Targets field.

   
   

6. (Optional) Adjust the values you entered:
   • For the trace attributes, type over any of the values.
   • For the Selection Criteria and Exception Filters options, repeat Step 4, changing or deleting the values you specified. Alternatively, you can type N in either option field to ignore all of the values you specified.
   • For the Trace Log Data Set Options, repeat Step 5, changing or deleting the values you specified, or in the Trace Log Data Set Options dialog, type RESET to change all the values to their default settings. Alternatively, you can type N in the option field to ignore all of the values you specified.
   • For the Additional Trace Targets option, repeat Step 5, changing the targets you selected. Alternatively, you can type N in the option field to ignore all of the values you specified.
7. Press Enter.
   The trace is started and the Current Traces (CT) view is displayed with the new trace listed.