Displaying WebSphere Application Server work

This file lists parameters that allow you to dynamically change values related to tracing activity for a server or servant.

You may use either the WebSphere Application Server administrative console or the z/OS MVS console to accomplish many operator tasks related to WebSphere Application Server for z/OS servers. Entering the z/OS display or modify commands through the MVS console can provide information or perform tasks that are useful for diagnosing problems.

In particular, the z/OS modify command provides parameters that not only allow you to control WebSphere Application Server for z/OS operations, but also to:

Recent additions to the modify command enable you to display information about the following:

Displaying the options on the modify command

You can display the options on the modify command with the help parameter. For example, the command
f azsr01a,help
generates the following output:
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 TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE DD CARD (YES/NO)
BBOO0179I DISPLAY - DISPLAY STATUS
BBOO0179I TRACE_EXCLUDE_SPECIFIC - EXCLUDE SPECIFIC TRACE POINTS
BBOO0179I TRACEJAVA - SET JAVA TRACE OPTIONS
You can display the DISPLAY options with the display,help parameter. For example, the command
f azsr01a,display,help
generates the following output:
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

Displaying work elements

The z/OS modifyserver,display,work command can provide useful information for diagnosing problems, or displaying what is going on inside your application servers. The syntax is:

f servername,display,work,display work parameters
where the display work parameters can be one of the following:
HELP
displays the DISPLAY,WORK parameters
CLINFO
EJB
EJB requests driven by IIOP: total, current, dispatched & timed out
EJB,SRS
EJB requests driven by IIOP by servant region
SERVLET
Servlet requests driven by HTTP: total, current, dispatched & timed out
SERVLET,SRS
Servlet requests by each servant region
MDB
MDB requests driven by JMS: total, current, dispatched & timed out
MDB,SRS
MDB requests broken down by servant region
ALL
Combines the above for EJBs, servlets, and MDBs
ALL,SRS
EJBs, servants, and MDBs by servlets region
SUMMARY
total requests, current in progress, and in dispatch for all types
SUMMARY,SRS
total received by each servant region, current in dispatch in each servant region for all types

The following examples demonstrate how to use various display,work parameters and the resulting output:

f azsr01a,display,work,servlet

BBOO0255I TIME OF LAST WORK DISPLAY Wed Dec 3 19:17:54 2003     
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 Dec 3 19:18:01 2003          
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 Dec  3 19:18:38 2003         
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 Dec  3 19:27:01 2003         
BBOO0264I STC18964:  TOTAL REQUESTS       173591    (DELTA 0) 
BBOO0265I STC18964:  TOTAL REQUESTS IN DISPATCH  0                   
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,SUMMARY,SRS         
To display a combination of all information with one command, use the all keyword, as follows:
f azsr01a,display,work,all

BBOO0255I TIME OF LAST WORK DISPLAY Wed Dec  3 19:27:07 2003            
BBOO0256I TOTAL EJB REQUESTS         0    (DELTA 0)                     
BBOO0257I CURRENT EJB REQUESTS       0                                  
BBOO0258I EJB REQUESTS IN DISPATCH   0                                  
BBOO0267I TOTAL EJB TIMEOUTS         0    (DELTA 0)                     
BBOO0256I TOTAL SERVLET REQUESTS         173591    (DELTA 0)            
BBOO0257I CURRENT SERVLET REQUESTS       0                              
BBOO0258I SERVLET REQUESTS IN DISPATCH   0                              
BBOO0267I TOTAL SERVLET TIMEOUTS         0    (DELTA 0)                 
BBOO0256I TOTAL MDB REQUESTS         0    (DELTA 0)                     
BBOO0257I CURRENT MDB REQUESTS       0                                  
BBOO0258I MDB REQUESTS IN DISPATCH   0                                  
BBOO0267I TOTAL MDB TIMEOUTS         0    (DELTA 0)                     
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,ALL                    

f azsr01a,display,work,all,srs

BBOO0255I TIME OF LAST WORK DISPLAY Wed Dec  3 19:30:06 2003            
BBOO0259I STC18964:  TOTAL EJB REQUESTS          0    (DELTA 0)         
BBOO0260I STC18964:  EJB REQUESTS IN DISPATCH    0                      
BBOO0259I STC18964:  TOTAL SERVLET REQUESTS      173591  (DELTA 0) 
BBOO0260I STC18964:  SERVLET REQUESTS IN DISPATCH    0                  
BBOO0259I STC18964:  TOTAL MDB REQUESTS          0    (DELTA 0)         
BBOO0260I STC18964:  MDB REQUESTS IN DISPATCH    0                      
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,ALL,SRS                

Note: Some points to consider:

Displaying the error log

You can display the contents of the product error log with the DISPLAY,ERRLOG option of the modify command. This shows the last ten messages in the error log even if you are not routing them to a log stream. For example, the command

f x5sr01b,display,errlog
generates the following output:

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

z/OS modify command parameters and their equivalent WebSphere variables

The z/OS modify command provides parameters that allow you to dynamically change values related to tracing activity for a server or servant. Table 2 lists the modify command parameters and the WebSphere variable that provides equivalent function.

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 Note: Do not change this variable unless directed by IBM service personnel. Setting trace controls for IBM service
TRACEDETAIL ras_trace_detail Setting trace controls for IBM service
TRACESPECIFIC ras_trace_specific Note: Do not change this variable unless directed by IBM service personnel. Setting trace controls for IBM service
TRACE_EXCLUDE_SPECIFIC ras_trace_exclude_specific Note: Do not change this variable unless directed by IBM service personnel. Setting trace controls for IBM service
TRACEINIT n/a Example: Getting help for the modify command
TRACENONE n/a 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 n/a Example: Getting help for the modify command



Related topics
MVS System Commands



Searchable topic ID:   rtrb_usingzosmodify
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/rtrb_usingzosmodify.html

Library | Support | Terms of Use | Feedback