管理コンソールまたは z/OS® MVS™
コンソール・コマンドのいずれかを使用して、
アプリケーション・サーバーに関連する複数のオペレーター・タスクを実行できます。
z/OS display または modify コンソール・コマンドは、
アプリケーション・サーバーで実行中の作業についての情報を取得するために使用することができます。
また、これらのコマンドを使用して、
アプリケーション・サーバー問題の診断に役立つタスクを実行することもできます。
このタスクについて
z/OS display または modify
コマンドを実行して、以下のアクションを実行することができます。
- アプリケーション・サーバーの操作を制御するパラメーターを設定します。
- アプリケーション・サーバーまたはサーバントで処理中の作業についての情報を表示します。
- サーバーまたはサーバントのトレース・アクティビティーに関連した値を動的に変更します。
modify コマンドを使用して、以下の機能に関する情報を表示することができます。
- アクティブ・コントローラー (サーバー)
- サーバント
- セッション
- トレース設定
- Java™
トレース
- Java
仮想マシン (JVM) ヒープ統計
- 作業エレメント
- エラー・ログ
手順
- modify コマンドのオプションを表示します。
help パラメーターを使用して、modify コマンドに指定できるオプションを表示することができます。
例えば、コマンド f azsr01a,help を入力すると、以下の情報に類似した情報が生成されます。
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 STATISTICSBBOO0179I 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
- DISPLAY コマンドのパラメーターを表示するには、display,help パラメーターを使用します。
コマンド f azsr01a,display,help を入力すると、以下の情報に類似した情報が生成されます。
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
- 診断問題に役に立つ情報を入手したり、アプリケーション・サーバー情報を表示するには、
z/OS modifyserver,display,work
コマンドを使用します。
コマンド f server_name,display,work,display_work_parameters を入力することができます。
ここで、server_name は情報を入手する必要のあるサーバーの名前で、display_work_parameters は、以下のパラメーターのいずれかです。
- HELP
- display,work パラメーターを表示します。
- CLINFO
- トランザクション種別情報を表示します。
- EJB
- total、current、dispatched、および timed out を含む、IIOP 主導型
Enterprise JavaBeans (EJB) 要求を表示します。
- EJB,SRS
- サーバント名別に、IIOP 主導型 EJB 要求を表示します。
- SERVLET
- total、current、dispatched、および timed out を含む、HTTP による HTTP 主導型サーブレット要求を表示します。
- SERVLET,SRS
- サーバント名別に、HTTP 主導型 servlet 要求を表示します。
- MDB
- total、current、dispatched、および timed out を含む、Java Message Service (JMS) 主導型メッセージ駆動型
(MDB) Bean 要求を表示します。
コントローラー内の MQ Message Listener Port (MLP) リスナーを介して受け取ったメッセージのみが表示されます。
- MDB,SRS
- サーバント名別に、Java Message Service (JMS) 主導型メッセージ駆動型 Bean (MDB) 要求を表示します。
コントローラー内の MQ Message Listener Port (MLP) リスナーを介して受け取ったメッセージのみが表示されます。
- ALL
- エンタープライズ Bean、サーブレット、および MDB の先行する情報のすべてを表示します。
- ALL,SRS
- サーバント名別に、エンタープライズ Bean、サーバント、および MDB の先行する情報のすべてを表示します。
- SUMMARY
- エンタープライズ Bean、サーブレット、および MDB の現在進行中の要求、およびディスパッチ中の要求のすべてを表示します。
- SUMMARY,SRS
- サーバント名別に、エンタープライズ Bean、サーブレット、および MDB の現在進行中の要求、およびディスパッチ中の要求のすべてを表示します。
- SIP
- total、current、dispatched、および timed out を含む、Session
Initiation Protocol (SIP) の主導型要求を表示します。
- SIP,SRS
- サーバントによって分割される SIP 要求を表示します。
- OLA
- サービス BBOA1INV および BBOA1SRQ によって駆動される、total、current、dispatched、timed out を含む最適化されたローカル・アダプター (OLA) のインバウンド要求を表示します。
- OLA,SRS
- サービス BBOA1INV および BBOA1SRQ によって駆動される OLA 要求をサーバント名ごとに表示します。
- modify コマンドの display,errlog
パラメーターを使用して製品のエラー・ログの内容を表示します。
このコマンドの出力には、メッセージをログ・ストリームにルーティングしていない場合でも、エラー・ログ内の最近の 10 個のメッセージが表示されます。例えば、コマンド f
x5sr01b,display,errlog を入力すると、以下の情報に類似した情報が生成されます。
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 コマンドを使用して、サーバーまたはサーバントのトレース・アクティビティーに関連した値を動的に変更します。
例
以下のコマンドの例で、さまざまな display,work パラメーターの使用方法と、
その結果の出力を示します。
コマンド f azsr01a,display,work,all を入力した場合、
以下の個別コマンドごとに表示される情報のすべてが表示されます。
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
考慮すべきいくつかの点: - コマンドの末尾に ,help を追加すると、選択項目の内容が表示されます。例えば、
コマンド display,work,help を入力すると、display,work コマンドに指定できるオプションが表示されます。
- display,work を入力すると、display,work,summary を入力した場合と同じ出力が得られます。
- display,EJB コマンドで、IIOP 要求のみが表示されます。したがって、HTTP 主導型要求が JavaServer page (JSP)、
およびエンタープライズ Bean を呼び出すサーブレットを実行する場合、
コントローラーに到達するために使用される要求のみがカウントされるため、
サーブレット・カウントのみが増加します。JSP では、コントローラーが使用されません。
- サーバントによる作業を表示する場合、要求の合計数およびディスパッチ中の要求のみが表示されます。
SRS パラメーターがない場合は、現在の要求とタイムアウトも表示されます。
- データが収集されている間は、作業が継続します。現在のデータは、
次のコマンドが発行される場合、差分を計算するために保存され、使用されます。負荷が大きい状況の場合、表示される値と差分が予想どおりに加算されない場合があります。
- TOTAL を入力すると、最後の display,work コマンドが入力されてから処理された作業項目のすべてが表示されます。この表示には現在フライト中の要求は含まれません。