This topic applies only on the z/OS operating system.

Formatting CTRACE data with an IPCS dialog

You can set up an IPCS dialog to format applications trace data gathered by WebSphere Application Server for z/OS.

Before you begin

Once activated, the WebSphere Application Server for z/OS always writes trace data into memory buffers. The number and size of these buffers is controlled using WebSphere variables. You can get this trace data from a dump, which may be taken by the system or requested by the operator through DUMP or SLIP commands.

To view messages or application trace data from Component Trace, you must use the interactive problem control system (IPCS) to format the data. The source of the trace data can be a dump data set or a trace data set. When setting up IPCS, your installation may customize IPCS for its users.

IBM recommends providing access to the IPCS dialog through an ISPF panel. If your installation has not customized IPCS as recommended, you need to start the IPCS dialog. See z/OS MVS IPCS User's Guide, SA22-7596 to find out how to start the IPCS dialog.

About this task

Perform the following steps to use the IPCS dialog to format application trace data:

Procedure

  1. From the IPCS Primary Option Menu panel, select option 6 ( COMMAND ).
  2. On the IPCS Subcommand Entry panel:
    1. Issue the SETDEF subcommand to determine the default values for routing displays.
    2. Enter the CTRACE command, with the following required parameters: CTRACE COMP( cell_short_name )

      where cell_short_name is the value specified through the ISPF customization dialog to identify the location of server configuration files. The name must be 8 or fewer characters and all uppercase.

      Note: If you were interested in only JRAS data, you would enter the following:
      CTRACE COMP(
      cell_short_name
      )USEREXIT(JRAS)
      
      
      Specify additional parameters as necessary.

      Example: To direct trace data to the terminal only, you would append the NOPRINT and TERMINAL parameters to the CTRACE command.

    Tip: For a complete list of CTRACE command parameters, see z/OS MVS IPCS Commands, SA22-7594.

  3. View your application's data, basing the method you choose on which one is appropriate for the location of the data:
    If you directed output to the... Then use the...
    IPCS print data set (IPCSPRNT) ISPF/PDF Browse option
    Terminal Dump Display Reporter panel

    Tips: To navigate through the trace data on the Dump Display Reporter panel, use the commands and PF keys listed in z/OS MVS IPCS User's Guide, SA22-7596.

    CTRACE enables you to view multiple traces together with the trace data from the various sources intermixed based on the time stamp. See z/OS MVS IPCS Commands, SA22-7594, for specifics on using this MERGE subcommand.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 10:43:27 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v602web&product=was-nd-mp&topic=ttrbipcsdia
File name: ttrb_ipcsdia.html