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

Displaying information about current application server work

You can use either the administrative console or z/OS MVS console commands to accomplish multiple operator tasks that are related to application servers. The z/OS display or modify console commands can be used to obtain information about the work an application server is performing. You can also use these commands to perform tasks that are useful in diagnosing application server problems.

About this task

You can use the z/OS display or modify commands to perform the following actions:

With the modify command, you can display information about the following functions:
  • Active controllers (servers)
  • Servants
  • Sessions
  • Trace settings
  • Java trace
  • Java virtual machine (JVM) heap statistics
  • Work elements
  • Error logs

Procedure

  1. Display the options for the modify command.

    You can use the help parameter to display the options that you can specify for the modify command. For example, entering the command, f azsr01a,help, generates information that is similar to the following information:

    BBOO0178I THE COMMAND MODIFY MAY BE FOLLOWED BY ONE OF THE FOLLOWING KEYWORDS:
    BBOO0179I CANCEL - CANCEL THIS CONTROL REGION
    BBOO0179I TRACEALL - SET OVERALL TRACE LEVEL
    BBOO0179I TRACEBASIC - SET BASIC TRACE COMPONENTS
    BBOO0179I TRACEDETAIL - SET DETAILED TRACE COMPONENTS
    BBOO0179I TRACESPECIFIC - SET SPECIFIC TRACE POINTS
    BBOO0179I TRACEINIT - RESET TO INITIAL TRACE SETTINGS
    BBOO0179I TRACENONE - TURN OFF ALL TRACING
    BBOO0179I TRACETOSYSPRINT - SEND TRACE OUTPUT TO SYSPRINT (YES/NO)
    BBOO0179I DISPLAY - DISPLAY STATUS
    BBOO0179I TRACE_EXCLUDE_SPECIFIC - EXCLUDE SPECIFIC TRACE POINTS
    BBOO0179I TRACEJAVA - SET JAVA TRACE OPTIONS
    BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE DD CARD (YES/NO)
    BBOO0179I MDBSTATS - MDB DETAILED STATISTICS
  2. Use the display,help parameter to display the parameters for the DISPLAY command.

    Entering the command, f azsr01a,display,help, generates information that is similar to the following information:

    BBOO0178I THE COMMAND DISPLAY, MAY BE FOLLOWED BY ONE OF THE FOLLOWING KEYWORDS:
    BBOO0179I SERVERS - DISPLAY ACTIVE CONTROL PROCESSES
    BBOO0179I SERVANTS - DISPLAY SERVANT PROCESSES OWNED BY THIS CONTROL PROCESS
    BBOO0179I SESSIONS - DISPLAY INFORMATION ABOUT COMMUNICATIONS SESSIONS
    BBOO0179I TRACE - DISPLAY INFORMATION ABOUT TRACE SETTINGS
    BBOO0179I JVMHEAP - DISPLAY JVM HEAP STATISTICS
    BBOO0179I WORK - DISPLAY WORK ELEMENTS
    BBOO0179I ERRLOG - DISPLAY THE LAST 10 ENTRIES IN THE ERROR LOG
    BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,HELP
    
  3. Use the z/OS modifyserver,display,work command to obtain information that might help diagnose problems, or to display application server information.

    You can enter the command, f server_name,display,work,display_work_parameters, whereserver_name is the name of the server about which you need to obtain information, and display_work_parameters is one of the following parameters:

    HELP
    Displays the display,work parameters.
    CLINFO
    Displays transaction classification information.
    EJB
    Displays IIOP driven Enterprise JavaBeans (EJB) requests, including total, current, dispatched and timed out.
    EJB,SRS
    Displays, by servant name, the IIOP driven EJB requests.
    SERVLET
    Displays HTTP driven servlet requests driven by HTTP, including total, current, dispatched and timed out.
    SERVLET,SRS
    Displays, by servant name, HTTP driven servlet requests.
    MDB
    Displays Java Message Service (JMS) driven message-driven bean (MDB) requests, including total, current, dispatched and timed out. Only messages received via MQ Message Listener Port (MLP) listeners in the controller are displayed.
    MDB,SRS
    Displays, by servant name, Java Message Service (JMS) driven message-driven bean (MDB) requests. Only messages received via MQ Message Listener Port (MLP) listeners in the controller are displayed.
    ALL
    Displays all of the preceding information for enterprise beans, servlets, and MDBs.
    ALL,SRS
    Displays, by servant name, all of the preceding information for enterprise beans, servants, and MDBs.
    SUMMARY
    Displays all of the current in-progress, and in-dispatch requests for enterprise beans, servlets, and MDBs.
    SUMMARY,SRS
    Displays, by servant name, all of the current in-progress, and in-dispatch requests for enterprise beans, servlets, and MDBs.
  4. Display the content of the product error log using the display,errlog parameter of the modify command.

    The output from this command displays the last ten messages in the error log even if you are not routing them to a log stream. For example, entering the command, f x5sr01b,display,errlog, generates information that is similar to the following information:

    BBOO0266I (STC18876) BossLog: { 0001} 2003/11/25 20:08:55.120 01   
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    c=UNK ./bborjtr.cpp+812 ... BBOO0222I TRAS0017I: The startup trace      
    state is *=all=disabled.                                                
    BBOO0266I (STC18876) BossLog: { 0002} 2003/11/25 20:09:08.255 01    
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    c=UNK ./bborjtr.cpp+812 ... BBOO0222I SECJ0231I: The Security           
    component's FFDC Diagnostic Module com.ibm.ws.security.core.SecurityDM  
    registered successfully: true.                                          
    BBOO0266I (STC18876) BossLog: { 0003} 2003/11/25 20:09:09.562 01    
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    c=UNK ./bborjtr.cpp+812 ... BBOO0222I SECJ0212I: WCCM JAAS              
    configuration information successfully pushed to login provider class.  
    BBOO0266I (STC18876) BossLog: { 0004} 2003/11/25 20:09:09.573 01    
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    c=UNK ./bborjtr.cpp+812 ... BBOO0222I SECJ0240I: Security service       
    initialization completed successfully                                   
    BBOO0266I (STC18876) BossLog: { 0005} 2003/11/25 20:09:18.304 01    
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    
    c=UNK ./bborjtr.cpp+812 ... BBOO0223I PMI0023W: Unable to register 
    PMI module due to duplicate name: SoapConnectorThreadPool               
    BBOO0266I (STC18876) BossLog: { 0006} 2003/11/25 20:09:29.451 01    
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    c=UNK ./bborjtr.cpp+812 ... BBOO0222I SECJ0243I: Security service 
    started successfully                                                    
    BBOO0266I (STC18876) BossLog: { 0007} 2003/11/25 20:09:29.464 01     
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    c=UNK ./bborjtr.cpp+812 ... BBOO0222I SECJ0210I: Security enabled false 
    BBOO0266I (STC18876) BossLog: { 0008} 2003/11/25 20:09:35.772 01    
    SYSTEM=SYSB SERVER=X5SR01B  PID=0X010201B2 TID=0X12FB3F00 00000000      
    c=UNK ./bborjtr.cpp+812 ... BBOO0223I PMI0023W: Unable to register PMI  
    module due to duplicate name: ProcessDiscovery                          
    . . . .
    BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,ERRLOG
    
  5. Dynamically change values related to tracing activity for a server or servant using the z/OS modify command.

    Table 1 lists the modify command parameters and the WebSphere variable that provides equivalent functionality.

    Table 1. z/OS modify command parameters and their equivalent WebSphere variables
    z/OS modify command parameter Equivalent WebSphere variable For more information, see..
    TRACEALL ras_trace_defaultTracingLevel Internal tracing tips for WebSphere for z/OS
    TRACEBASIC ras_trace_basic

    Do not change this variable unless directed to do so by IBM Support.

    Setting trace controls for IBM service
    TRACEDETAIL ras_trace_detail

    Do not change this variable unless directed to do so by IBM Support.

    Setting trace controls for IBM service
    TRACESPECIFIC ras_trace_specific

    Do not change this variable unless directed to do so by IBM Support.

    Setting trace controls for IBM service
    TRACE_EXCLUDE_SPECIFIC ras_trace_exclude_specific

    Do not change this variable unless directed to do so by IBM Support.

    Setting trace controls for IBM service
    TRACEINIT (no equivalent variable) Example: Getting help for the modify command
    TRACENONE (no equivalent variable) Example: Getting help for the modify command
    TRACETOSYSPRINT ras_trace_outputLocation=SYSPRINT Internal tracing tips for WebSphere for z/OS
    TRACETOTRCFILE ras_trace_outputLocation=TRCFILE Internal tracing tips for WebSphere for z/OS
    TRACEJAVA (no equivalent variable) Example: Getting help for the modify command
    TIMEOUTDUMPACTION control_region_timeout_dump_action Example: Getting help for the modify command
    TIMEOUTDUMPACTIONSESSION control_region_timeout_dump_action_session Example: Getting help for the modify command

Example

The following command examples demonstrate how to use various display,work parameters and the resulting output. If you enter the command, f azsr01a,display,work,all, all of the information that is shown for each of the following individual commands is displayed.

f azsr01a,display,work,servlet

BBOO0255I TIME OF LAST WORK DISPLAY Wed Dec 3 19:17:54 2008     
BBOO0256I TOTAL SERVLET REQUESTS         150670    (DELTA 1654)  
BBOO0257I CURRENT SERVLET REQUESTS       1                       

BBOO0258I SERVLET REQUESTS IN DISPATCH   0                       
BBOO0267I TOTAL SERVLET TIMEOUTS         0    (DELTA 0)          
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,SERVLET
                
f azsr01a,display,work,servlet,srs
 
BBOO0255I TIME OF LAST WORK DISPLAY Wed Jan 3 19:18:01 2008          
BBOO0259I STC18964:  TOTAL SERVLET REQUESTS  152344   (DELTA 1675)                                                                 
BBOO0260I STC18964:  SERVLET REQUESTS IN DISPATCH    0      
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,SERVLET,ALL          

 (EJB and MDB displays would look the same except for the request type.)

f azsr01a,display,work,summary
 
BBOO0255I TIME OF LAST WORK DISPLAY Wed Jan  3 19:18:38 2008         
BBOO0261I TOTAL REQUESTS TO SERVER     173591    (DELTA 13944)       
BBOO0262I TOTAL CURRENT REQUESTS       0                             
BBOO0263I TOTAL REQUESTS IN DISPATCH   0                             
BBOO0268I TOTAL TIMED OUT REQUESTS     0    (DELTA 0)                
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,SUMMARY  

f azsr01a,display,work,summary,srs
           
BBOO0255I TIME OF LAST WORK DISPLAY Wed Jan  3 19:27:01 2008         
BBOO0264I STC18964:  TOTAL REQUESTS       173591    (DELTA 0) 
BBOO0265I STC18964:  TOTAL REQUESTS IN DISPATCH  0                   
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,SUMMARY,SRS         
Some points to consider:
  • Adding ,help at the end of the command displays your choices. For example, entering the command, display,work,help, displays the options that you can specify for the display,work command.
  • Entering display,work produces the same output as entering display,work,summary.
  • The display,EJB command only displays IIOP requests. Therefore, if an HTTP driven request runs a JavaServer page (JSP), and a servlet that calls an enterprise bean, only the servlet count increases, because only requests that are used to get to the controller are counted. The JSP does not use the controller.
  • When displaying the work by servant, only the total and in-dispatch requests display. Without the SRS parameter, the current requests and timeouts also display.
  • Work continues while the data is collected. The current data is saved and used to calculate the delta when the next command is issued. In a heavy load situation, the displayed values and deltas might not add up as you expect.
  • Entering TOTAL displays all of the work items that were handled since the last display,work command was entered. This display does not include the current in-flight requests.



In this information ...


Related 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: Sep 20, 2010 11:08:29 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-mp&topic=rtrb_usingzosmodify
File name: ttrb_usingzosmodify.html