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 commandf azsr01a,helpgenerates 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 OPTIONSYou can display the DISPLAY options with the display,help parameter. For example, the command
f azsr01a,display,helpgenerates 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 parameterswhere the display work parameters can be one of the following:
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,SRSTo 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,errloggenerates 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 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 |