Modify 指令

您可以從 MVS™ 主控台發出 modify 指令，以動態修改產品作業。

您可以使用 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。

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= 。

例如:

MODIFY server,JAVACORE,ASIDX=F4

在這個範例中，指令會取得其 (十六進位) ASID 為 'F4' 之服務者區域的 JAVACORE。

範例: 停用失效接手

範例 1: 下列指令會針對伺服器上由 jdbc/MySampleDataSource 所識別的主要資源停用失效接手 bbos001:

f bbos001,DISABLEFAILOVER,'jdbc/MySampleDataSource'

範例: 使用 modify 指令來取消應用程式叢集和伺服器

您無法從 MVS 主控台取消叢集。相反地，您必須取消組成叢集的每一部伺服器。

範例 1: 下列指令會取消 bbo6acr 伺服器:

f bbo6acr,cancel

範例 2: 下列指令會取消 bbo6acr 伺服器，並指示 ARM 在終止程序完成之後重新啟動 bbo6acr 伺服器:

f bbo6acr,cancel,armrestart

範例: 使用 Scripting 建立一般追蹤層次

若要建立伺服器的一般追蹤層次，請使用下列指令:

f server,traceall=n

有效的追蹤層次為 0 (無)、1 (異常狀況)、2 (基本) 及 3 (詳細追蹤)。在正常狀況及正式作業環境中，請使用 1 (異常狀況)。

範例: 下列指令會開啟 bbo6acr 伺服器的異常狀況層次追蹤:

f bbo6acr,traceall=1

以下是範例顯示畫面:

f bbo6acr,traceall=1
BBOO0211I MODIFY COMMAND TRACEALL=1 COMPLETED SUCCESSFULLY

範例: 設定 WebSphere z/OS 元件的基本及詳細追蹤層次

使用下列指令:

f server,tracebasic=(n,...)

範例 1: 下列指令會開啟伺服器 bbo6acr上常駐程式元件的基本追蹤層次:

f bbo6acr,tracebasic=a

以下是範例顯示畫面:

f bbo6acr,TRACEBASIC=A
BBOO0211I MODIFY COMMAND TRACEBASIC=A COMPLETED SUCCESSFULLY

若要指定您要開啟其詳細追蹤層次的 WebSphere® for z/OS 元件，請使用下列指令:

f server,tracedetail=(n,...)

範例 2: 下列指令會開啟伺服器 bbo6acr上安全的詳細追蹤層次:

f bbo6acr,tracedetail=e

以下是範例顯示畫面:

f bbo6acr,TRACEDETAIL=E
BBOO0211I MODIFY COMMAND TRACEDETAIL=E COMPLETED SUCCESSFULLY

範例: 使用 Scripting 設定特定的追蹤點

如果要設定特定的追蹤點，請使用下列指令:

f server,tracespecific=n | (n,...)

範例 1: 下列指令會開啟特定的追蹤點 04006001:

f bbo6acr,tracespecific=04006001

範例 2: 下列指令會開啟特定的追蹤點 04006001 和 04006027:

f bbo6acr,tracespecific=(04006001,04006027)

範例 3: 下列指令會開啟環境變數 tracepoints中所設定的特定追蹤點:

f bbo6acr,tracespecific='tracepoints'

範例: 使用 Scripting 排除特定的追蹤點

如果要排除特定的追蹤點，請使用下列指令:

f server,trace_exclude_specific=n | (n,...)

範例: tracespecific 指令會開啟整個組件的追蹤，然後 trace_exclude_specific 會關閉該組件內 04006031 點的追蹤:

f bbo6acr,tracespecific=04006000

f bbo6acr,trace_exclude_specific=04006031

範例: 使用 Scripting 重設為起始追蹤設定

若要重設為起始追蹤設定，請使用下列指令:

f server,traceinit

範例: 使用指令行關閉追蹤的指令

關閉tracing，請使用下列指令:

f server,tracenone

範例: 使用 Scripting 將追蹤傳送至 SYSPRINT

若要將追蹤傳送至 SYSPRINT ，請使用下列指令:

f server,tracetosysprint=yes

如果要停止將追蹤傳送至 SYSPRINT ，請使用下列指令:

f server,tracetosysprint=no

範例: 使用 modify 指令來取消應用程式叢集和伺服器

此範例示範如何使用 modify 指令來取消應用程式叢集和伺服器。

開始之前: 您無法從 MVS 主控台取消叢集。相反地，您必須取消組成叢集的每一部伺服器。

範例 1: 下列指令會取消 bbo6acr 伺服器:




f bbo6acr,cancel

範例 2: 下列指令會取消 bbo6acr 伺服器，並指示 ARM 在終止之後重新啟動它:




f bbo6acr,cancel,armrestart

範例: 取得 modify 指令的說明

您可以取得 modify 指令各層次的語法說明。

範例 1: 輸入下列指令，以顯示可與 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

範例 2: 輸入下列指令，以顯示 modify display 指令所能使用的所有關鍵字清單:

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

範例 3: 輸入下列指令，以顯示可與 modify timeoutdumpaction 或 modify timeoutdumpactionsession 指令搭配使用的所有關鍵字的清單:

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

範例 4: 輸入下列指令，以顯示可與 modify display dpm 指令搭配使用的所有關鍵字清單:

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 追蹤字串。

若要修改 Java 追蹤字串，請使用下列指令:

f server, tracejava='trace specification'

範例: 下列指令會啟用所有已登錄追蹤元件的所有追蹤類型:

f bbo6acr,tracejava='*=all'

附註: 引號是語法的必要部分。

範例: 修改發生 JVM 記憶體不足狀況時所採取的診斷動作

此範例顯示如何使用主控台指令來修改發生 Java 虛擬機器 (JVM) 記憶體不足狀況時所採取的診斷動作，請使用下列指令:

f server,javaoom,[interval=xxx | action=xxx]

範例: 如果發生 JVM 記憶體不足狀況，下列指令會導致採用受影響位址空間的 SVCDUMP ，次要碼為 C9C2704B。這個指令也會防止發生其他診斷動作，直到過了 1200 秒 (20 分鐘) 的時間間隔為止。

f bbo6acr,,javaoom,[interval=1200 | action=svcdump]

附註: 引號是語法的必要部分。