![[z/OS]](../images/ngzos.gif)
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:
- Set parameters that control application server operations.
- Display information about the work that an application server or servant is handling.
- Dynamically change values related to tracing activity for a server or servant.
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
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 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:
- 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.