Modify 指令
您可以從 MVS™ 主控台發出 modify 指令,以動態修改產品作業。
- 作用中控制器
- 追蹤設定
- 僕人
- 階段作業
- Java™ 虛擬機器 (JVM) 資料堆
- Java 追蹤
輸入 modify 指令時,請使用下列格式。
f <server>, parameters
server 是 modify 指令所導向之伺服器的簡稱。 此引數是必要的。
參數
下列參數適用於 modify 指令:
- DISABLEFAILOVER,'<JNDI Name>'
- 用來針對所提供的 JNDI 名稱所識別的資源,手動停用資源失效接手支援。 所提供的 JNDI 名稱會識別主要資源,且必須用單引號括住它,才能保留其大小寫。
- ENABLEFAILOVER,'<JNDI Name>'
- 用來針對所提供的 JNDI 名稱所識別的資源,手動啟用資源失效接手支援。 所提供的 JNDI 名稱會識別主要資源,且必須用單引號括住它,才能保留其大小寫。
- FAILOVER,'<JNDI Name>'
- 用來手動將以主要資源為目的地的要求遞送至其已配置的替代資源。 所提供的 JNDI 名稱會識別主要資源,且必須用單引號括住它,才能保留其大小寫。 若要將要求失效回復至主要資源,請發出 modify 指令並指定參數 FAILBACK,'<JNDI name>'。
- FAILBACK,'<JNDI Name>'
- 用來手動將要求遞送至所提供的 JNDI 名稱所識別的已配置主要資源。 所提供的 JNDI 名稱會識別主要資源,且必須用單引號括住它,才能保留其大小寫。 此指令會自動啟用自動失效接手。 如果在失效回復之後不需要自動失效接手,請使用參數 DISABLEFAILOVER,'<JNDI
Name>'發出 modify 指令。注意: JNDI 名稱輸入區分大小寫。
- CANCEL
- 用來取消指定的伺服器。
您可以為 CANCEL 參數指定下列選項:
- ARMRESTART
- 指定您是否使用應用程式回應管理 (ARM) 代理程式,並希望 ARM 在伺服器終止之後重新啟動伺服器。 如果您未在 CANCEL 參數上指定 ARMRESTART 選項, ARM 就不會重新啟動伺服器。
- 說明
- 指定您要查看說明 CANCEL 語法的說明資訊。
避免麻煩: 您無法從 MVS 主控台使用 CANCEL 參數來取消叢集。 您必須個別取消組成叢集的每一部伺服器。 - DPM , [IIOP=nnn | HTTP=nnn | HTTPS=nnn | MDB=nnn | SIP=nnn | CRA=nnn | SIPS=nnn | OLA=nnn | INTERVAL=nnn | Dump_action={SVCDUMP|JAVACORE|HEAPDUMP|TRACEBACK|JAVATDUMP|NONE|RESET} | clear_all | reset_all]
nnn 位置保留元以秒為單位指定特定通訊協定類型的時間間隔長度。 nnn 位置保留元的值必須是整數 0 - 255或 reset。 0 值說明通訊協定沒有間隔,且對使用該通訊協定的要求停用 DPM。 reset 值說明 DPM 間隔的控制權會回到工作量分類檔中的 dpm_interval 分類屬性。
DPM INTERVAL modify 指令會置換 dpm_interval 分類屬性。 DPM dump_action modify 指令會置換 dpm_dump_action 分類屬性及 server_region_dpm_dump_action 伺服器層面內容。
在傾出動作上指定 RESET 會停用 modify 指令的傾出動作。 dpm_dump_action 分類屬性及 server_region_dpm_dump_action 伺服器層面內容的設定再次生效。
在 INTERVAL 參數上指定的值會將所有六個通訊協定的 DPM 間隔設為相同的值。
clear_all 值會將所有相關要求通訊協定的時間間隔設為 0 ,並將傾出動作設為 None。
reset_all 值會重設所有 DPM 間隔及 dump_action 參數。 DPM 間隔及傾出動作的控制會傳回 WLM 分類檔。
- HEAPDUMP
- 用來產生控制器的 JVM 資料堆傾出,以及與該控制器相關聯的所有服務者。
- JAVACORE
- 用來為控制器產生 JVM 核心傾出,以及為與該控制器相關聯的所有服務者產生 JVM 核心傾出。
- JAVATDUMP
- 用來為所有服務者位址空間產生 JVM 起始的 TDUMP。 您也可以使用 JAVA_DUMP_TDUMP_PATTERN 原生環境變數來指定 TDUMP 資料集名稱。
- JAVAOOM,[INTERVAL=nnn | ACTION=xxx | RESET]
- 用來動態變更在此伺服器中發生 Java 虛擬機器 (JVM) 記憶體不足狀況時所採取的診斷動作。 它也用來動態變更在其中重複診斷動作的時間間隔。
指定 INTERVAL 會設定不重複診斷動作的時間量 (以秒為單位)。 這個屬性會置換指定給 ras_java_oom_interval 環境變數的值。
指定 ACTION 會設定在此伺服器中發生 JVM 記憶體不足狀況時所採取的診斷動作。 這個屬性會置換指定給 ras_java_oom_action 環境變數的值。 下列其中一個值可以指定為 xxx 的值:
- 無
- 不執行診斷動作。
- WTO
- BBOO0404E 錯誤訊息會寫入紙本。
- SVCDUMP
- 會採用受影響位址空間的 SVCDUMP ,次要碼為 C9C2704B。
指定 RESET 會將診斷動作及間隔重設為指定給 ras_java_oom_action 及 ras_java_oom_interval 環境變數的值。
- MSGROUTE,{ERRORLOG|HARDCOPY|CONSOLE|COPYERRORLOG|COPYHARDCOPY|COPYCONSOLE|NONE}{[=xxx][,RESET][,CLEAR]}
- 用來動態變更訊息 ID 的輸出位置。
xxx 位置保留元是要遞送之應用程式伺服器的產品訊息 ID 清單 (以逗點區隔)。 訊息可以遞送至多個位置。
第一次發出位置及一組訊息的指令時,位置的訊息清單是第一個指令的訊息清單。 如果位置的環境變數已定義訊息,則那些訊息會附加至位置的訊息清單。 當您稍後針對相同位置及另一組訊息發出指令時,應用程式伺服器會將後續指令的訊息附加至現有的訊息清單。
指定
ERRORLOG
會將訊息遞送至錯誤日誌,而不是預設位置。指定
HARDCOPY
會將訊息遞送至 SYSLOG 系統日誌 (也稱為印刷本) ,而不是預設位置。指定
CONSOLE
會將訊息遞送至 MVS 操作員主控台,而不是預設位置。指定
COPYERRORLOG
會將訊息複製到錯誤日誌及預設位置。指定
COPYHARDCOPY
會將訊息複製到 SYSLOG 系統日誌 (也稱為印刷本) 以及預設位置指定
COPYCONSOLE
會將訊息複製到 MVS 操作員主控台及預設位置。指定
NONE
會抑制訊息的遞送。NONE
值優先於將訊息遞送至錯誤日誌、系統日誌或 MVS 操作員主控台。將RESET
指定為ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE
或NONE
表示遞送或抑制的訊息是從 was.env 檔案而非 MSGROUTE modify 指令產生。- 指定
RESET
搭配ERRORLOG
,會將 ras_message_routing_errorlog 環境變數上指定的訊息遞送至錯誤日誌,而不是預設位置。 - 指定
RESET
搭配HARDCOPY
,會將 ras_message_routing_hardcopy 環境變數中指定的訊息遞送至 SYSLOG 系統日誌,而非預設位置。 - 將
RESET
指定為CONSOLE
,會將 ras_message_routing_console 環境變數所指定的訊息遞送至 MVS 操作員主控台,而非預設位置。 - 使用
COPYERRORLOG
指定RESET
會將 ras_message_routing_copy_errorlog 環境變數上指定的訊息複製到錯誤日誌及預設位置。 - 指定
RESET
與COPYHARDCOPY
會將 ras_message_routing_copy_hardcopy 環境變數上指定的訊息複製到 SYSLOG 系統日誌及預設位置。 - 指定
RESET
搭配COPYCONSOLE
,會將 ras_message_routing_copy_console 環境變數指定的訊息複製到 MVS 操作員主控台及預設位置。 - 使用
NONE
指定RESET
會暫停遞送 ras_message_routing_hardcopy 環境變數上指定的訊息。
將CLEAR
指定為ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE
或NONE
,表示訊息會遞送至預設位置,或不再暫停。- 以
ERRORLOG
、HARDCOPY
、CONSOLE
、COPYERRORLOG
、COPYHARDCOPY
COPYCONSOLE
或NONE
指定CLEAR
,表示訊息會遞送至預設位置,或不再暫停。 - 以
ERRORLOG
或COPYERRORLOG
指定CLEAR
,會將訊息遞送至預設位置,而不是錯誤日誌。 - 指定
CLEAR
搭配HARDCOPY
或COPYERRORLOG
,會將訊息遞送至預設位置,而不是SYSLOG
系統日誌。 - 指定
CLEAR
搭配 CONSOLE 或COPYCONSOLE
會將訊息遞送至預設位置,而不是遞送至 MVS 操作員主控台。 - 指定
CLEAR
與NONE
會取消抑制訊息。
- 指定
- RECLASSIFY[,FILE=['/path/to/file.xml']]
- 用來動態重新載入工作量分類文件,而不需要重新啟動伺服器。 重新載入的工作量分類設定會立即生效。
指定
RECLASSIFY
會使用 wlm_classification_file 變數上指定的工作量分類檔來執行重新分類。使用 reclassify 參數 (例如
RECLASSIFY,FILE='/path/to/newfile.xml'
) 指定檔名會使用指定的分類檔案執行重新分類。 wlm_classification_file 變數的值會變更為 FILE 選項上指定的檔案。 任何後續使用 wlm_classification_file 變數的 reclassify modify 指令都會重新載入變數上指定的新檔案,而不是原始檔案。指定
RECLASSIFY,FILE=
會停用分類。 wlm_classification_file 變數設為空值。 任何後續使用 wlm_classification_file 變數的 reclassify 修改指令都不會影響伺服器,因為 wlm_classification_file 變數沒有值。注意: 如果無法載入新的工作量分類檔,則應用程式伺服器會捨棄重新載入的分類設定。 在發出 reclassify modify 指令之前,應用程式伺服器會繼續執行有效的分類設定。提示: 每當工作量分類檔案順利載入時,應用程式伺服器會對系統日誌 SYSLOG 發出類似下列訊息的訊息。 該訊息也會顯示在操作員主控台上,以回應 DISPLAY , WORK , CLINFO display 指令。BBOJ0129I: /tmp/wlm4.class.xml 工作量分類檔 於 2009/07/14 19:33:35.297 載入 (GMT)
- ROLL_LOGS
- 用來重新發出服務者輸出日誌重新導向至 USS 檔案系統。 將在相同的輸出目錄下建立一組新的輸出日誌檔,並保留較舊的日誌檔。 訊息將寫入先前日誌的結尾及新日誌的開頭,從而在檔案之間建立邏輯鏈結。
- STACKTRACE
- 用來將伺服器中所有 Java 執行緒的 Java 堆疊追溯記載至錯誤日誌。
- SMF,REQUEST,{ON|OFF|RESET}
- 用來控制 SMF 120-9 記錄的建立。
SMF , REQUEST modify 指令會置換 SMF_request_activity_enabled 分類屬性和 server_SMF_request_activity_enabled 伺服器層面內容。
指定
ON
會開啟 SMF 120-9 記錄的建立。指定
OFF
會關閉 SMF 120-9 記錄的建立。指定
RESET
會取消啟動建立 SMF 120-9 記錄的修改指令設定。 重設時, SMF_request_activity_enabled 分類屬性和 server_SMF_request_activity_enabled 伺服器層面內容的設定會生效。 - SMF,REQUEST,ASYNC,{ON|OFF|RESET}
- 每當建立 SMF 120-9 記錄時,用來收集該記錄的格式化 ASYNC 區段資料。
SMF , REQUEST , ASYNC 修改指令會置換 server_SMF_request_activity_async 伺服器層面內容。
指定
ON
會開啟資料收集。指定
OFF
會關閉資料收集。 當指定此值時,所建立的記錄在記錄開頭的位置三元組中具有此區段的零。指定
RESET
會停用資料收集的修改指令設定。 重設時, server_SMF_request_activity_async 伺服器層面內容的設定生效。 - SMF,REQUEST,CPU,{ON|OFF|RESET}
- 每當建立 SMF 120-9 記錄時,用來收集該記錄的「CPU 使用率明細區段」資料。
SMF , REQUEST , CPU modify 指令會置換 SMF_request_activity_CPU_detail 分類屬性和 server_SMF_request_activity_CPU_detail 伺服器層面內容。
指定
ON
會開啟資料收集。指定
OFF
會關閉資料收集。 當指定此值時,所建立的記錄在記錄開頭的位置三元組中具有此區段的零。指定
RESET
會停用資料收集的修改指令設定。 重設時, SMF_request_activity_CPU_detail 分類屬性及 server_SMF_request_activity_CPU_detail 伺服器層面內容的設定生效。 - SMF,REQUEST,SECURITY,{ON|OFF|RESET}
- 每當建立 SMF 120-9 記錄時,用來收集該記錄之「安全資料區段」的資料。
SMF , REQUEST , SECURITY 修改指令會置換 SMF_request_activity_security 分類屬性和 server_SMF_request_activity_security 伺服器層面內容。
指定
ON
會開啟資料收集。指定
OFF
會關閉資料收集。 當指定此值時,所建立的記錄在記錄開頭的位置三元組中具有此區段的零。指定
RESET
會停用資料收集的修改指令設定。 重設時, SMF_request_activity_security 分類屬性及 server_SMF_request_activity_security 伺服器層面內容的設定生效。 - SMF,REQUEST,TIMESTAMPS,{ON|OFF|RESET}
- 每當建立 SMF 120-9 記錄時,用於收集該記錄的「格式化時間戳記區段」資料。
SMF , REQUEST , TIMESTAMPS 修改指令會置換 SMF_request_activity_timestamps 分類屬性及 server_SMF_request_activity_timestamps 伺服器層面內容。
指定
ON
會開啟資料收集。指定
OFF
會關閉資料收集。 當指定此值時,所建立的記錄在記錄開頭的位置三元組中具有此區段的零。指定
RESET
會停用資料收集的修改指令設定。 重設時, SMF_request_activity_timestamps 分類屬性及 server_SMF_request_activity_timestamps 伺服器層面內容的設定生效。 - SMF,OUTBOUND,ON
- 用來開啟 SMF 120-10 記錄的建立。
- SMF,OUTBOUND,OFF
- 用來關閉 SMF 120-10 記錄的建立。
- SMF,OUTBOUND,RESET
- 用來讓 SMF 120-10 記錄的建立由 server_SMF_outbound_enabled 環境變數上指定的值所控制。
- TIMEOUT_DELAY=n
- 用來將逾時延遲選項變數 control_region_timeout_delay 動態變更為 n 秒。 這個修改指令與 TIMEOUTDUMPACTION modify 指令搭配使用,可設定逾時延遲,以便在發生逾時時時完成指定的傾出動作 (例如 JAVACORE)。 TIMEOUTDUMPACTION
modify 指令上指定的傾出動作需要逾時延遲,服務者能夠在服務者終止之前完成傾出動作。
處理指定的傾出之後,您可以重新發出這個指令,將 control_region_timeout_delay 變數的值變更回先前的設定,而不重新啟動伺服器。
- TIMEOUTDUMPACTION=n
- 當 control_region_timeout_delay 內容設為非零值時,用來指出每當分派給服務者的工作發生逾時時,會執行下列哪些動作:
- 如果指定 NONE或 none ,則不會執行傾出。
- 如果指定 JAVACORE 或 javacore ,則會採用 Java 核心傾出。
- 如果指定 SVCDUMP 或 svcdump ,則會採用 SVC 傾出。
- 如果指定 JAVATDUMP 或 javatdump ,則會採用 JVM 起始的 TDUMP。附註: control_region_timeout_delay 內容必須配置成在控制器終止服務者之前,足以讓服務者收集 JAVATDUMP 的時間長度。 TIMEOUT_DELAY modify 指令可用來動態變更 control_region_timeout_delay 內容的值。
- TIMEOUTDUMPACTIONSESSION=n
- 用來指出每當已分派給服務者的 HTTP、HTTP、SIP 或 SIPS 要求發生逾時,且對應的回復內容設為 SESSION 時,執行下列哪些動作:
- 如果指定 NONE或 none ,則不會執行傾出。
- 如果指定 JAVACORE 或 javacore ,則會採用 Java 核心傾出。
- 如果指定 SVCDUMP 或 svcdump ,則會採用 SVC 傾出。
- 如果指定 JAVATDUMP 或 javatdump ,則會採用 JVM 起始的 TDUMP
以下是對應的回復內容清單:- protocol_http_timeout_output_recovery
- protocol_https_timeout_output_recovery
- protocol_sip_timeout_output_recovery
- protocol_sips_timeout_output_recovery
- TRACEALL=n
- 用來建立伺服器的一般追蹤層次。下列值是有效的追蹤層次。 通常,您指定值 1。
- 0: 不執行追蹤
- 1: 發生異常狀況時執行追蹤
- 2: 執行基本追蹤
- 3: 執行所有元件的詳細追蹤。
避免麻煩: 使用層次 3 時請小心,因為此追蹤層次所產生的資料可能超過可供您檢閱的實際資料。 - TRACEBASIC=n
- 用來指定您要開啟基本追蹤層次的產品元件。這個指令可以置換 TRACEALL 針對那些元件所建立的不同追蹤層次。避免麻煩: 除非 IBM® 支援中心指示,否則請勿變更此變數。
下表包括您可以為此參數指定的值。 您可以為 TRACEBASIC 或 TRACEDETAIL 指定下列一或多個值:
價值 產品元件 0 RAS 1 共用公用程式 3 COMM 4 ORB 6 OTS 7 沙斯塔 9 z/OS® 封套 A 常駐程式 E 安全 F 外部化 J (只應在 IBM 支援中心的指示下使用) JRas L Java EE - TRACEDETAIL=n
- 用來指定您要開啟詳細追蹤層次的產品元件。這個指令會針對指定的產品元件啟動最詳細的追蹤,並置換TRACEALL中的不同設定。 選取的元件由其元件 ID 識別,這些 ID 與針對 TRACEBASIC 參數列出的 ID 相同。 由數字指定的子元件會接收詳細追蹤資料。 產品的其他組件會依照 TRACEALL 參數所指定來接收追蹤。避免麻煩: 除非 IBM 支援中心指示,否則請勿變更此變數。
- TRACESPECIFIC=xxyyyzzz
- 用來指定特定產品追蹤點的追蹤置換。追蹤點由八位數十六進位數指定。 若要指定多個追蹤點,請使用括弧並以逗點區隔數字。 您也可以用單引號括住名稱來指定環境變數名稱。 處理環境變數的值,就像您在 TRACESPECIFIC 參數中指定該值一樣。避免麻煩: 除非 IBM 支援中心指示,否則請勿使用 TRACESPECIFIC 。
- TRACE_EXCLUDE_SPECIFIC=xxyyyzzz
- 用來指定要排除的產品追蹤點。要排除的追蹤點由八位數十六進位數指定。 若要指定多個追蹤點,請使用括弧並以逗點區隔數字。 您也可以用單引號括住名稱來指定環境變數名稱。 處理環境變數的值,就像您在 TRACE_EXCLUDE_SPECIFIC 參數上指定該值一樣。 您可以使用 TRACE_EXCLUDE_SPECIFIC 參數作為遮罩,以關閉目前開啟的追蹤。 例如,使用 TRACESPECIFIC 參數來開啟產品整個部分的追蹤,然後使用 TRACE_EXCLUDE_SPECIFIC 參數來關閉產品該部分內的一個追蹤。避免麻煩: 除非 IBM 支援中心指示您使用 TRACE_EXCLUDE_SPECIFIC 參數。
- TRACEINIT
- 用來重設為起始追蹤設定。
- TRACENONE
- 用來關閉所有追蹤設定。
- TRACETOSYSPRINT={YES|NO}
- 用來選取是否將追蹤傳送至 SYSPRINT。
指定
YES
會將追蹤傳送至 SYSPRINT ,指定NO
會停止將追蹤傳送至 SYSPRINT。 - TRACETOTRCFILE={YES|NO}
- 用來指定是否將追蹤導向 TRCFILE DD 卡。
指定
YES
會將追蹤傳送至 TRCFILE DD 卡,指定指定NO
會停止將追蹤傳送至 TRCFILE DD 卡。 - TRACEJAVA
- 修改 Java 追蹤字串。
Java 追蹤規格是用來控制 Java 追蹤,並符合 Java 追蹤規格規則。 * = all=enabled 表示啟用所有已登錄追蹤元件的所有追蹤類型。
- TRACERECORD,{ON|OFF|RESET}
- 用來控制追蹤記錄的寫入。 此參數與工作量分類檔中定義的 classification_only_trace 屬性搭配使用。
指定
ON
會根據現行追蹤規格來寫入追蹤記錄。 任何 classification_only_trace 屬性都會被忽略。指定OFF
會阻止寫入追蹤記錄。警告:不會寫入基於現行追蹤規格或在正常執行時期處理程序中產生的追蹤記錄。指定RESET
會寫入現行追蹤規格的追蹤記錄,如下所示:- 如果未定義任何 classification_only_trace 屬性,則會寫入所有處理執行緒的追蹤記錄。 此狀況在功能上相當於將 TRACERECORD 設為
ON
。 - 如果定義一個以上 classification_only_trace 屬性,只會針對其分類包含 classification_only_trace 屬性
1
的處理執行緒寫入追蹤記錄。
預設值為
RESET
。 - 如果未定義任何 classification_only_trace 屬性,則會寫入所有處理執行緒的追蹤記錄。 此狀況在功能上相當於將 TRACERECORD 設為
- HELP
- 用來顯示您可以與 modify 指令搭配使用的所有關鍵字的清單。
您也可以在 CANCEL 及 DISPLAY 參數之後使用 HELP 參數,以顯示您可以與這些參數之一搭配使用的所有關鍵字清單。
- PAUSELISTENERS
- 用來防止工作被接受到伺服器中。 請利用這個參數來關閉通訊接聽器,並清除工作登錄中的任何擱置中工作。避免麻煩: MODIFY server, PAUSELISTENERS 指令會停止控制器在 IIOP (ORB_TCP_SECURE 和 ORB_TCP_LISTENER) 以外的所有埠上接聽。 對於 IIOP ,當發出這個修改指令時,常駐程式會停止傳送要求至 IIOP 傳輸通道。 不過,如果您正在執行進行快取的用戶端應用程式 (例如 Bean 快取) ,則可以將來自這些應用程式的要求直接傳送至開啟的 IIOP 埠。 發生此狀況可能是因為 IIOP 接聽器在伺服器啟動程序中提早啟動,因此可能在發出此 modify 指令之前開啟 IIOP 埠。
- WLM_MIN_MAX=min,max
- 用來動態修改服務者設定的數目下限和上限 (wlm_minimumSRCount 和 wlm_maximumSRCount)。 WLM 會動態調整作用中服務者的現行數目,以符合新的限制。 新設定不一定會立即生效; WLM 會考量資源可用性及工作量等因素,盡快處理新的最小及最大目標。避免麻煩: 對於以單一伺服器動態應用程式環境配置的伺服器,即 wlm_dynapplenv_single_server 內容設為 1 ,會忽略 WLM_MIN_MAX 指令。
- WORKERTHREADMAX=n
- 用來增加控制器區域工作程式執行緒儲存區上限。 modify 指令指定的值會置換指定給 control_region_thread_pool_maximum_size 環境變數的值。 上限只能增加。 將拒絕減少上限的要求。 當指定上限時,請確定有足夠的資源可支援指定的上限。 要考量的資源範例是 JVM 資料堆大小。
- RESUMELISTENERS
- 用於在發出包含 PAUSELISTENERS 參數的 modify 指令之後重新啟動通訊接聽器。 此參數容許伺服器接受新工作。
- DISPLAY
- 用來顯示伺服器名稱、伺服器執行所在的系統名稱,以及現行程式碼層次。
您可以對此參數指定下列選項:
SERVERS
會顯示指令所導向的伺服器名稱、系統名稱,以及相同 Cell 之 Sysplex 中每一個作用中伺服器的程式碼層次。SERVANTS
: 顯示附加至您對其發出 display 指令之伺服器的服務者的位址空間 ID (ASID) 清單。TRACE
會顯示伺服器控制器的追蹤資訊。 您可以使用下列其中一個選項來進一步修改此指令:SRS
會顯示所有服務者的追蹤資訊,一次一個服務者。ALL
會顯示控制器及所有服務者的追蹤資訊,一次一個服務者。JAVA
顯示伺服器控制器的 Java 追蹤字串設定。 您可以使用下列其中一個選項來進一步修改此指令:SRS
會顯示所有服務者的 Java 追蹤資訊,一次一個服務者。ALL
會顯示控制器及所有服務者的 Java 追蹤資訊,一次一個服務者。HELP
會顯示您可以與 modify display trace Java 指令搭配使用的所有關鍵字的清單。
HELP
會顯示您可以與 modify display trace 指令搭配使用的所有關鍵字的清單。
JVMHEAP
顯示伺服器控制器的 JVM 資料堆資訊。 您可以使用下列其中一個選項來進一步修改此指令:SRS
會顯示所有服務者的 JVM 資料堆資訊,一次一個服務者。ALL
會顯示控制器及所有服務者的 JVM 資料堆資訊,一次一個服務者。HELP
會顯示您可以與 modify display Javaheap 指令搭配使用的所有關鍵字的清單。
LISTENERS
會顯示連線實例名稱、相關聯的 IP 位址及接聽埠號。 相關聯的 IP 位址可以顯示星號 (*) 作為萬用字元。CONNECTIONS
會顯示每一個連線實例名稱,以及連線數的計數。 每一個連線實例都位於個別行上。 您可以使用下列其中一個選項來進一步修改此指令:NAME='name'
顯示所指定連線實例'name'
的相關聯連線數。 如果找到連線名稱,但連線數為零,則指令會傳回計數零。 如果找不到連線名稱,指令會傳回錯誤訊息。LIST
會顯示每一個連線實例之所有連線的遠端主機資訊。 如果連線實例名稱沒有連線,則指令只會傳回連線實例名稱。LIST, NAME='name'
顯示所指定連線實例'name'
之所有連線的遠端主機資訊。
HELP
會顯示您可以與 modify 指令搭配使用的所有關鍵字的清單。ERRLOG
會顯示錯誤日誌中最後 10 個項目。 您可以使用下列其中一個選項來進一步修改此選項:SRS
會顯示所有服務者的錯誤日誌中最後 10 個項目 (一次一個服務者)。HELP
會顯示您可以與 modify display error log 指令搭配使用的所有關鍵字清單。
MODE
會顯示執行位元模式。MSGROUTE
會顯示所有遞送位置的訊息清單,以及要抑制的訊息。 遞送位置可以是錯誤日誌、系統日誌或 MVS 操作員主控台。ERRORLOG
會顯示要遞送至錯誤日誌的訊息清單。HARDCOPY
會顯示要遞送至 SYSLOG 系統日誌 (也稱為印刷本) 的訊息清單。CONSOLE
顯示要遞送至 MVS 操作員主控台的訊息清單。NONE
會顯示要暫停的訊息清單。
SMF
會顯示伺服器的 SMF 120-9 記錄建立狀態。ASYNC
會針對所有服務者 (一次一個服務者) 上的非同步工作,顯示 SMF 120-9 記錄建立的狀態。HELP
會顯示您可以與 modify display SMF 指令搭配使用的所有關鍵字清單。
WORK
會顯示伺服器的工作元素計數。 您可以使用下列其中一個選項來進一步修改此選項:CRA
會顯示 CRA 訊息驅動 Bean (MDB) 要求計數資訊。 您可以使用下列其中一個選項來進一步修改此指令:SRS
會顯示所有服務者的 CRA 要求計數資訊,一次一個服務者。HELP
會顯示您可以與 modify display work CRA 指令搭配使用的所有關鍵字清單。
ASYNCSERVLET
顯示非同步 Servlet 要求總數,以及目前正在處理的非同步 Servlet 要求數。 非同步 Servlet 要求總數只包含自最近一次啟動或重新啟動整個伺服器以來所提出的要求。 不過,如果已停止或重新啟動一或多個服務者,總數可能會減少。SRS
會顯示每一個服務者的非同步 Servlet 要求總數,以及目前正在處理的非同步 Servlet 要求數。 總數是自前次啟動或重新啟動服務者以來,非同步 Servlet 要求的數目。HELP
會顯示您可以與 modify display work asyncservlets 指令搭配使用的所有關鍵字清單。
EJB
會顯示 Enterprise JavaBeans (EJB) 要求計數資訊。 您可以使用下列其中一個選項來修改此選項:SRS
會顯示所有服務者的 EJB 要求計數資訊,一次一個服務者。HELP
會顯示您可以與 modify display work EJB 指令搭配使用的所有關鍵字清單。
SERVLET
會顯示 Servlet 要求計數資訊。 您可以使用下列其中一個選項來修改此選項:SRS
會顯示所有服務者的 Servlet 要求計數資訊,一次一個服務者。HELP
會顯示您可以與 modify display work servlet 指令搭配使用的所有關鍵字清單。
MDB
會顯示訊息驅動 Bean (MDB) 要求計數資訊。 您可以使用下列其中一個選項來進一步修改此指令:SRS
會顯示所有服務者的 MDB 要求計數資訊,每次一個服務者。HELP
會顯示您可以與 modify display work MDB 指令搭配使用的所有關鍵字清單。
SIP
顯示「階段作業起始通訊協定 (SIP)」要求計數資訊。 您可以使用下列其中一個選項來修改此選項:SRS
會顯示所有服務者的 SIP 要求計數資訊,一次一個服務者。HELP
會顯示您可以與 modify display work SIP 指令搭配使用的所有關鍵字清單。
SUMMARY
顯示摘要要求計數資訊。SRS
會顯示所有服務者的摘要要求計數資訊,一次一個服務者。HELP
會顯示您可以與 modify display work summary 指令搭配使用的所有關鍵字清單。
ALL
會顯示所有要求計數資訊。SRS
會顯示所有服務者的所有要求計數資訊,一次一個服務者。STATS
會顯示所有詳細統計資料。HELP
會顯示您可以與 modify display work all 指令搭配使用的所有關鍵字清單。
CLINFO
會顯示工作分類資訊。HELP
會顯示您可以與 modify display work 指令搭配使用的所有關鍵字清單。OLA
會顯示 BBOA1INV 和 BBOA1SRQ服務所驅動的入埠「最佳化本端配接器 (OLA)」要求。 您可以使用下列其中一個選項來進一步修改此指令:SRS
會顯示所有服務者的 OLA 要求計數資訊,一次一個服務者。HELP
會顯示您可以與 modify display work all 指令搭配使用的所有關鍵字清單。
- 快速回應快取加速器 (FRCA)。 顯示 FRCA 快取統計資料,如下所示:
f <servername>,display,frca
f <servername>,display,frca,content
f <servername>,display,frca,stats
- 配接卡
- STATUS顯示最佳化本端配接器元件的狀態。
- REGISTRATIONS顯示連接這部伺服器的最佳化本端配接器用戶端清單。
- DAEMONRGES會顯示連接這個常駐程式群組中任何伺服器的最佳化本端配接器用戶端清單。
- SEARCHRGES會顯示一份清單,列出連接這個常駐程式群組中的任何伺服器,且符合搜尋準則的最佳化本端配接器用戶端。
- ASIDX=
- 在修改指令之後,以您要傾出之服務者區域的適當 ASID (十六進位) 來新增
ASIDX=
。例如:
在這個範例中,指令會取得其 (十六進位) ASID 為 'F4' 之服務者區域的 JAVACORE。MODIFY server,JAVACORE,ASIDX=F4
範例: 停用失效接手
f bbos001,DISABLEFAILOVER,'jdbc/MySampleDataSource'
範例: 使用 modify 指令來取消應用程式叢集和伺服器
您無法從 MVS 主控台取消叢集。 相反地,您必須取消組成叢集的每一部伺服器。
f bbo6acr,cancel
f bbo6acr,cancel,armrestart
範例: 使用 Scripting 建立一般追蹤層次
f server,traceall=n
有效的追蹤層次為 0 (無)、1 (異常狀況)、2 (基本) 及 3 (詳細追蹤)。 在正常狀況及正式作業環境中,請使用 1 (異常狀況)。
f bbo6acr,traceall=1
f bbo6acr,traceall=1
BBOO0211I MODIFY COMMAND TRACEALL=1 COMPLETED SUCCESSFULLY
範例: 設定 WebSphere z/OS 元件的基本及詳細追蹤層次
f server,tracebasic=(n,...)
f bbo6acr,tracebasic=a
f bbo6acr,TRACEBASIC=A
BBOO0211I MODIFY COMMAND TRACEBASIC=A COMPLETED SUCCESSFULLY
f server,tracedetail=(n,...)
f bbo6acr,tracedetail=e
f bbo6acr,TRACEDETAIL=E
BBOO0211I MODIFY COMMAND TRACEDETAIL=E COMPLETED SUCCESSFULLY
範例: 使用 Scripting 設定特定的追蹤點
f server,tracespecific=n | (n,...)
f bbo6acr,tracespecific=04006001
f bbo6acr,tracespecific=(04006001,04006027)
f bbo6acr,tracespecific='tracepoints'
範例: 使用 Scripting 排除特定的追蹤點
f server,trace_exclude_specific=n | (n,...)
f bbo6acr,tracespecific=04006000
f bbo6acr,trace_exclude_specific=04006031
範例: 使用 Scripting 重設為起始追蹤設定
f server,traceinit
範例: 使用指令行關閉追蹤的指令
f server,tracenone
範例: 使用 Scripting 將追蹤傳送至 SYSPRINT
f server,tracetosysprint=yes
f server,tracetosysprint=no
範例: 使用 modify 指令來取消應用程式叢集和伺服器
此範例示範如何使用 modify 指令來取消應用程式叢集和伺服器。
開始之前: 您無法從 MVS 主控台取消叢集。 相反地,您必須取消組成叢集的每一部伺服器。
f bbo6acr,cancel
f bbo6acr,cancel,armrestart
範例: 取得 modify 指令的說明
您可以取得 modify 指令各層次的語法說明。
f bbo6acr,help
F bbo6acr,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 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
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 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
f bbo6acr,display,help
F BBOS001,DISPLAY,HELP
BBOO0178I THE COMMAND DISPLAY, MAY BE FOLLOWED BY ONE OF THE FOLLOWING
124
KEYWORDS:
BBOO0179I SERVERS - DISPLAY ACTIVE CONTROL PROCESSES
BBOO0179I SERVANTS - DISPLAY SERVANT PROCESSES OWNED BY THIS CONTROL 126
PROCESS
BBOO0179I LISTENERS - DISPLAY LISTENERS
BBOO0179I CONNECTIONS - DISPLAY CONNECTION INFORMATION
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
BBOO0179I MODE - DISPLAY THE EXECUTION BITMODE
BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,HELP
f bbos001,timeoutdumpactionsession=help
BBOO0178I THE COMMAND MODIFY TIMEOUTDUMPACTIONSESSION= MAY BE FOLLOWED BY
ONE OF the FOLLOWING KEYWORDS:
BBOO0179I SVCDUMP - SVC DUMP
BBOO0179I JAVACORE - JAVA CORE DUMP
BBOO0179I NONE - NO DUMP
f bbos001,dpm,help
BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE
FOLLOWING KEYWORDS:
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY
如果您已安裝 Fix Pack 8.5.5.1 或更高版本,則產生的輸出類似於下列範例:BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE
FOLLOWING KEYWORDS:
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I CRA - MDB CRA DISPATCH PROGRESS MONITOR INTERVAL
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY
範例: 修改 Java 追蹤字串
此範例顯示如何使用主控台指令來修改 Java 追蹤字串。
f server, tracejava='trace specification'
f bbo6acr,tracejava='*=all'
範例: 修改發生 JVM 記憶體不足狀況時所採取的診斷動作
此範例顯示如何使用主控台指令來修改發生 Java 虛擬機器 (JVM) 記憶體不足狀況時所採取的診斷動作,請使用下列指令:
f server,javaoom,[interval=xxx | action=xxx]
f bbo6acr,,javaoom,[interval=1200 | action=svcdump]