(ZOS) Displaying information about current application server work
We can use either the administrative console or z/OS MVS™ console commands to accomplish multiple operator tasks 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. We can also use these commands to perform tasks that are useful in diagnosing application server problems.
We can use the z/OS display or modify commands to perform the following actions:
- Set parameters that control application server operations.
- Display information about the work an application server or servant is handling.
- Dynamically change values related to tracing activity for a server or servant.
With the modify command, we 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
Tasks
- Display the options for the modify command.
We can use the help parameter to display the options that we 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 (YES/NO) BBOO0179I MDBSTATS - MDB DETAILED STATISTICS BBOO0179I PAUSELISTENERS - PAUSE THE COMMUNICATION LISTENERS BBOO0179I RESUMELISTENERS - RESUME THE COMMUNICATION LISTENERS BBOO0179I TIMEOUTDUMPACTION - SET TIMEOUT DUMP ACTION BBOO0179I TIMEOUTDUMPACTIONSESSION - SET TIMEOUT DUMP ACTION SESSION BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE DD CARD (YES/NO) BBOO0179I MDBSTATS - MDB DETAILED STATISTICSBBOO0179I PAUSELISTENERS - PAUSE THE COMMUNICATION LISTENERS BBOO0179I RESUMELISTENERS - RESUME THE COMMUNICATION LISTENERS BBOO0179I STACKTRACE - LOG JAVA THREAD STACK TRACEBACKS BBOO0179I TIMEOUTDUMPACTION - SET TIMEOUT DUMP ACTION BBOO0179I TIMEOUTDUMPACTIONSESSION - SET TIMEOUT DUMP ACTION SESSION BBOO0179I WLM_MIN_MAX - RESET WLM MIN/MAX SERVANT SETTINGS
- 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
- Use the z/OS modifyserver,display,work command to obtain information that might help diagnose problems,
or to display application server information.
We can enter the command, f server,display,work,display_work_parameters, whereserver is the name of the server about which we 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 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.
- SIP
- Displays the Session Initiation Protocol (SIP) requests driven, including total, current, dispatched and timed out.
- SIP,SRS
- Displays the SIP requests broken down by servant.
- OLA
- Displays inbound Optimized Local Adapter (OLA) requests driven by services BBOA1INV and BBOA1SRQ, including total, current, dispatched, and timed out.
- OLA,SRS
- Displays, by servant name, OLA requests driven by services BBOA1INV and BBOA1SRQ.
- 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 we 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 - Dynamically change values related to tracing activity for
a server or servant using the z/OS modify command.
z/OS modify command parameter Equivalent WebSphere variable See (ZOS) TRACEALL (ZOS) ras_trace_defaultTracingLevel (ZOS) 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.
Set trace controls for IBM service TRACEDETAIL ras_trace_detail Do not change this variable unless directed to do so by IBM Support.
Set trace controls for IBM service TRACESPECIFIC ras_trace_specific Do not change this variable unless directed to do so by IBM Support.
Set 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.
Set 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 (ZOS) TRACETOSYSPRINT (ZOS) ras_trace_outputLocation=SYSPRINT (ZOS) Internal tracing tips for WebSphere for z/OS (ZOS) TRACETOTRCFILE (ZOS) ras_trace_outputLocation=TRCFILE (ZOS) 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 Application server custom properties for z/OS TIMEOUTDUMPACTIONSESSION control_region_timeout_dump_action_session Application server custom properties for z/OS
Example
The following command examples demonstrate how to use various display,work parameters and the resulting output. If we 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 Jan 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 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
Some points to consider:
- Add,help at the end of the command displays your choices. For example, entering the command, display,work,help, displays the options that we 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 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.
